Module qilletni.api

Package dev.qilletni.api.music

Interface MusicFetcher

public interface MusicFetcher

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	MusicFetcher.TrackNameArtist	An object to hold a name and artist combination.

Method Summary

Modifier and Type	Method	Description
Optional<Album>	fetchAlbum(String name, String artist)	Gets an Album from a given name and artist.
Optional<Album>	fetchAlbumById(String id)	Gets an Album from a given ID.
List<Track>	fetchAlbumTracks(Album album)	Gets all tracks from a given Album.
Optional<Artist>	fetchArtistById(String id)	Gets an Artist from a given ID.
Optional<Artist>	fetchArtistByName(String name)	Gets an Artist from a given name.
Optional<Playlist>	fetchPlaylist(String name, String author)	Gets a Playlist from a given name and author.
Optional<Playlist>	fetchPlaylistById(String id)	Gets a Playlist from a given ID.
List<Track>	fetchPlaylistTracks(Playlist playlist)	Gets all tracks from a given Playlist.
Optional<Track>	fetchTrack(String name, String artist)	Gets a Track from a given name and artist.
Optional<Track>	fetchTrackById(String id)	Gets a Track from a given ID, specific to the service provider implementation.
List<Track>	fetchTracks(List<MusicFetcher.TrackNameArtist> tracks)	Gets multiple Tracks from a given list of MusicFetcher.TrackNameArtists.
List<Track>	fetchTracksById(List<String> trackIds)	Gets multiple Tracks from a given list of IDs.

Method Details

fetchTrack

Optional<Track> fetchTrack(String name,
 String artist)

Gets a Track from a given name and artist. If multiple tracks are found with the name/artist combination, it is up to the implementation to decide what to pick.

Parameters:

name - The name of the track, not including the artist name

artist - The name of the artist

Returns:

The track with the given name and artist, if any

fetchTrackById

Optional<Track> fetchTrackById(String id)

Gets a Track from a given ID, specific to the service provider implementation.

Parameters:

id - The ID of the track. This is in different formats for each service provider implementation.

Returns:

The track with the given ID, if any

fetchTracks

List<Track> fetchTracks(List<MusicFetcher.TrackNameArtist> tracks)

Gets multiple Tracks from a given list of MusicFetcher.TrackNameArtists. This effectively performs what fetchTrack(String, String) does, but batched for multiple tracks at once.

Parameters:

tracks - The tracks to look up

Returns:

The list of tracks that were found, in the same order as the given list of tracks. If a track isn't found, it is skipped

fetchTracksById

List<Track> fetchTracksById(List<String> trackIds)

Gets multiple Tracks from a given list of IDs. This effectively performs what fetchTrackById(String) does, but batched for multiple tracks at once. The IDs are in different formats for each service provider.

Parameters:

trackIds - The IDs of the tracks to look up

Returns:

The list of tracks that were found, in the same order as the given list of track IDs. If a track isn't found, it is skipped.

fetchPlaylist

Optional<Playlist> fetchPlaylist(String name,
 String author)

Gets a Playlist from a given name and author. If multiple playlists are found with the name/author combination, it is up to the implementation to decide what to pick. If multiple playlists are found with the same name, it is up to the implementation to decide what to pick.

Parameters:

name - The name of the playlist

author - The name of the artist

Returns:

The playlist with the given name and author, if any

fetchPlaylistById

Optional<Playlist> fetchPlaylistById(String id)

Gets a Playlist from a given ID. This is in different formats for each service provider implementation.

Parameters:

id - The ID of the playlist. This is in different formats for each service provider implementation

Returns:

The playlist with the given ID, if any

fetchAlbum

Optional<Album> fetchAlbum(String name,
 String artist)

Gets an Album from a given name and artist. If multiple albums are found with the name/artist combination, it is up to the implementation to decide what to pick. If multiple albums are found with the same name, it is up to the implementation to decide what to pick.

Parameters:

name - The name of the album, not including the artist name

artist - The name of the artist

Returns:

The album with the given name and artist, if any

fetchAlbumById

Optional<Album> fetchAlbumById(String id)

Gets an Album from a given ID. This is in different formats for each service provider implementation.

Parameters:

id - The ID of the album. This is in different formats for each service provider implementation

Returns:

The album with the given ID, if any

fetchAlbumTracks

List<Track> fetchAlbumTracks(Album album)

Gets all tracks from a given Album.

Parameters:

album - The album to get tracks from

Returns:

A list of all tracks in the album, in the order they appear in the album.

fetchPlaylistTracks

List<Track> fetchPlaylistTracks(Playlist playlist)

Gets all tracks from a given Playlist.

Parameters:

playlist - The playlist to get tracks from

Returns:

A list of all tracks in the playlist, in the order they appear in the playlist

fetchArtistById

Optional<Artist> fetchArtistById(String id)

Gets an Artist from a given ID. This is in different formats for each service provider implementation.

Parameters:

id - The ID of the artist. This is in different formats for each service provider implementation.

Returns:

The artist with the given ID, if any

fetchArtistByName

Optional<Artist> fetchArtistByName(String name)

Gets an Artist from a given name. If multiple artists are found with the same name, it is up to the implementation to decide what to pick.

Parameters:

name - The full name of the artist to look up

Returns:

The artist with the given name, if any