Class DatabaseApi

java.lang.Object

com.amilesend.discogs.api.ApiBase

com.amilesend.discogs.api.DatabaseApi

public class DatabaseApi
extends ApiBase

The Discogs Database API.
API Documentation
Note: The GET Release Stats API is broken and does not provide meaningful data. It is therefore omitted from this API interface. See this forum post for context.

See Also:

• ApiBase

Constructor Summary

Constructors

Constructor	Description
DatabaseApi(DiscogsConnection connection)	Creates a new DatabaseApi object.

Method Summary

Modifier and Type	Method	Description
void	deleteUserReleaseRating(@NonNull DeleteUserReleaseRequest request)	Deletes a release rating for a user.
GetArtistInformationResponse	getArtistInformation(@NonNull GetArtistInformationRequest request)	Gets information about a specific artists
GetArtistReleasesResponse	getArtistReleases(@NonNull GetArtistReleasesRequest request)	Gets the list of releases and masters associated with an artist.
GetCommunityReleaseRatingResponse	getCommunityReleaseRating(@NonNull GetCommunityReleaseRatingRequest request)	Gets the community rating for a given release.
GetLabelInformationResponse	getLabelInformation(@NonNull GetLabelInformationRequest request)	Gets information about a specific abel.
GetLabelReleasesResponse	getLabelReleases(@NonNull GetLabelReleasesRequest request)	Gets the paginated list of releases for a label.
GetMasterReleaseResponse	getMasterRelease(@NonNull GetMasterReleaseRequest request)	Gets the master release for the given identifier.
GetMasterReleaseVersionsResponse	getMasterReleaseVersions(@NonNull GetMasterReleaseVersionsRequest request)	Gets the master release versions.
GetReleaseResponse	getRelease(@NonNull GetReleaseRequest request)	Gets a release.
GetUserReleaseRatingResponse	getUserReleaseRating(@NonNull GetUserReleaseRatingRequest request)	Gets a release rating for a user.
SearchResponse	search(@NonNull SearchRequest request)	Searches for masters, releases, artists, and labels.
UpdateUserReleaseRatingResponse	updateUserReleaseRating(@NonNull UpdateUserReleaseRatingRequest request)	Updates the release rating for a user.

Methods inherited from class ApiBase

getConnection

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DatabaseApi

public DatabaseApi(DiscogsConnection connection)

Creates a new DatabaseApi object.

Parameters:

connection - the underlying client connection

Method Details

getRelease

public GetReleaseResponse getRelease(@NonNull GetReleaseRequest request)

Gets a release.

Parameters:

request - the request

Returns:

the release

See Also:

• GetReleaseRequest
• GetReleaseResponse

getUserReleaseRating

public GetUserReleaseRatingResponse getUserReleaseRating(@NonNull GetUserReleaseRatingRequest request)

Gets a release rating for a user.

Parameters:

request - the request

Returns:

the response

See Also:

• GetUserReleaseRatingRequest
• GetUserReleaseRatingResponse

updateUserReleaseRating

public UpdateUserReleaseRatingResponse updateUserReleaseRating(@NonNull UpdateUserReleaseRatingRequest request)

Updates the release rating for a user.

Parameters:

request - the request

Returns:

the response

See Also:

• UpdateUserReleaseRatingRequest
• UpdateUserReleaseRatingResponse

deleteUserReleaseRating

public void deleteUserReleaseRating(@NonNull DeleteUserReleaseRequest request)

Deletes a release rating for a user.

Parameters:

request - the request

getCommunityReleaseRating

public GetCommunityReleaseRatingResponse getCommunityReleaseRating(@NonNull GetCommunityReleaseRatingRequest request)

Gets the community rating for a given release.

Parameters:

request - the request

Returns:

the response

See Also:

• GetCommunityReleaseRatingRequest
• GetCommunityReleaseRatingResponse

getMasterRelease

public GetMasterReleaseResponse getMasterRelease(@NonNull GetMasterReleaseRequest request)

Gets the master release for the given identifier.

Parameters:

request - the request

Returns:

the response

See Also:

• GetMasterReleaseRequest
• GetMasterReleaseResponse

getMasterReleaseVersions

public GetMasterReleaseVersionsResponse getMasterReleaseVersions(@NonNull GetMasterReleaseVersionsRequest request)

Gets the master release versions.

Parameters:

request - the request

Returns:

the master release versions

See Also:

• GetMasterReleaseVersionsRequest
• GetMasterReleaseVersionsResponse

getArtistInformation

public GetArtistInformationResponse getArtistInformation(@NonNull GetArtistInformationRequest request)

Gets information about a specific artists

Parameters:

request - the request

Returns:

the response

See Also:

• GetArtistInformationRequest
• GetArtistInformationResponse

getArtistReleases

public GetArtistReleasesResponse getArtistReleases(@NonNull GetArtistReleasesRequest request)

Gets the list of releases and masters associated with an artist.

Parameters:

request - the request

Returns:

the paginated response

See Also:

• GetArtistReleasesRequest
• GetArtistReleasesResponse

getLabelInformation

public GetLabelInformationResponse getLabelInformation(@NonNull GetLabelInformationRequest request)

Gets information about a specific abel.

Parameters:

request - the request

Returns:

the response

See Also:

• GetLabelInformationRequest
• GetMasterReleaseResponse

getLabelReleases

public GetLabelReleasesResponse getLabelReleases(@NonNull GetLabelReleasesRequest request)

Gets the paginated list of releases for a label.

Parameters:

request - the request

Returns:

the paginated response

See Also:

• GetLabelReleasesRequest
• GetLabelReleasesResponse

search

public SearchResponse search(@NonNull SearchRequest request)

Searches for masters, releases, artists, and labels.

Parameters:

request - the request

Returns:

the search response

See Also:

• SearchRequest
• SearchResponse