Package de.sfuhrm.radiobrowser4j

Klasse RadioBrowser

java.lang.Object
de.sfuhrm.radiobrowser4j.RadioBrowser
public class RadioBrowser extends Object
API facade for the RadioBrowser. You usually create a new instance and then use the methods to invoke API calls.
Autor:
Stephan Fuhrmann

  • Konstruktordetails

    • RadioBrowser

      public RadioBrowser(@NonNull @NonNull ConnectionParams connectionParams)
      Creates a new API client using a proxy.
      Parameter:
      connectionParams - the parameters for creating an API connection.
      Siehe auch:
      • Ungültige Referenz 
        ConnectionParams.ConnectionParamsBuilder

  • Methodendetails

    • listCountries

      public Map<String,Integer> listCountries()
      List the known countries.
      Gibt zurück:
      a list of countries (keys) and country usages (values).
      Siehe auch:

    • listCodecs

      public Map<String,Integer> listCodecs()
      List the known codecs.
      Gibt zurück:
      a list of codecs (keys) and codec usages (values).
      Siehe auch:

    • listLanguages

      public Map<String,Integer> listLanguages()
      List the known languages.
      Gibt zurück:
      a list of languages (keys) and language usages (values).
      Siehe auch:

    • listTags

      public Map<String,Integer> listTags()
      List the known tags.
      Gibt zurück:
      a list of tags (keys) and tag usages (values).
      Siehe auch:

    • listStations

      public List<Station> listStations(@NonNull @NonNull Paging paging, Parameter... listParam)
      Get a list of all stations. Will return a single batch.
      Parameter:
      paging - the offset and limit of the page to retrieve.
      listParam - the optional listing parameters.
      Gibt zurück:
      the partial list of the stations. Can be empty for exceeding the possible stations.

    • listStations

      public Stream<Station> listStations(Parameter... listParam)
      Get a list of all stations. Will return all stations in a stream.
      Parameter:
      listParam - the optional listing parameters.
      Gibt zurück:
      the full stream of stations.

    • listBrokenStations

      public List<Station> listBrokenStations(@NonNull @NonNull Limit limit)
      Get a list of all broken stations. Will return a single batch.
      Parameter:
      limit - the limit of the page to retrieve.
      Gibt zurück:
      the partial list of the broken stations. Can be empty for exceeding the possible stations.

    • listBrokenStations

      public Stream<Station> listBrokenStations()
      Get a list of all broken stations as one continuous stream.
      Gibt zurück:
      the continuous stream of all broken stations.

    • listTopClickStations

      public List<Station> listTopClickStations(@NonNull @NonNull Limit limit)
      Get a list of the top click stations. Will return a single batch.
      Parameter:
      limit - the limit of the page to retrieve.
      Gibt zurück:
      the partial list of the top click stations. Can be empty for exceeding the possible stations.

    • listTopClickStations

      public Stream<Station> listTopClickStations()
      Get a stream of all top click stations.
      Gibt zurück:
      the complete stream of all top click stations.

    • listTopVoteStations

      public List<Station> listTopVoteStations(@NonNull @NonNull Limit limit)
      Get a list of the top vote stations. Will return a single batch.
      Parameter:
      limit - the limit of the page to retrieve.
      Gibt zurück:
      the partial list of the top vote stations. Can be empty for exceeding the possible stations.

    • listTopVoteStations

      public Stream<Station> listTopVoteStations()
      Get a stream of the top vote stations.
      Gibt zurück:
      the complete stream of the top vote stations.

    • listLastClickStations

      public List<Station> listLastClickStations(@NonNull @NonNull Limit limit)
      Get a list of the last clicked stations. Will return a single batch.
      Parameter:
      limit - the limit of the page to retrieve.
      Gibt zurück:
      the partial list of the last clicked stations. Can be empty for exceeding the possible stations.

    • listLastClickStations

      public Stream<Station> listLastClickStations()
      Get a stream of last clicked stations.
      Gibt zurück:
      the complete stream of the last clicked stations.

    • listLastChangedStations

      public List<Station> listLastChangedStations(@NonNull @NonNull Limit limit)
      Get a list of the last changed stations. Will return a single batch.
      Parameter:
      limit - the limit of the page to retrieve.
      Gibt zurück:
      the partial list of the last clicked stations. Can be empty for exceeding the possible stations.

    • listLastChangedStations

      public Stream<Station> listLastChangedStations()
      Get a stream of last changed stations.
      Gibt zurück:
      the complete stream of the last changed stations.

    • getStationByUUID

      public Optional<Station> getStationByUUID(@NonNull @NonNull UUID uuid)
      Get a station referenced by its UUID.
      Parameter:
      uuid - the UUID of the station to retrieve.
      Gibt zurück:
      an optional containing either the station or nothing. Nothing is returned if the API didn't find the station by the given ID.

    • listStationsBy

      public List<Station> listStationsBy(@NonNull @NonNull Paging paging, @NonNull @NonNull SearchMode searchMode, @NonNull @NonNull String searchTerm, Parameter... listParam)
      Get a list of stations matching a certain search criteria. Will return a single batch.
      Parameter:
      paging - the offset and limit of the page to retrieve.
      searchMode - the field to match.
      searchTerm - the term to search for.
      listParam - the optional listing parameters.
      Gibt zurück:
      the partial list of the stations. Can be empty for exceeding the number of matching stations.

    • listStationsBy

      public Stream<Station> listStationsBy(@NonNull @NonNull SearchMode searchMode, @NonNull @NonNull String searchTerm, Parameter... listParam)
      Get a stream of stations matching a certain search criteria.
      Parameter:
      searchMode - the field to match.
      searchTerm - the term to search for.
      listParam - the optional listing parameters.
      Gibt zurück:
      the full stream of matching stations.

    • resolveStreamUrl

      public URL resolveStreamUrl(@NonNull @NonNull UUID stationUUID)
      Resolves the streaming URL for the given station.
      Parameter:
      stationUUID - the station UUID to retrieve the stream URL for.
      Gibt zurück:
      the URL of the stream.
      Löst aus:
      RadioBrowserException - if the URL could not be retrieved

    • postNewStation

      public UUID postNewStation(@NonNull @NonNull Station station)
      Posts a new station to the server. Note: This call only transmits certain fields. The fields are: name, url, homepage, favicon, country, state, language and tags.
      Parameter:
      station - the station to add to the REST service.
      Gibt zurück:
      the uuid of the new station.
      Löst aus:
      RadioBrowserException - if there was a problem creating the station.
      Siehe auch:

    • voteForStation

      public void voteForStation(@NonNull @NonNull UUID stationUUID)
      Votes for a station.
      Parameter:
      stationUUID - The uuid of the station to vote for.
      Löst aus:
      RadioBrowserException - if there was a problem voting for the station.

    • getServerStats

      public Stats getServerStats()
      Get the server statistics.
      Gibt zurück:
      the statistics for the configured server endpoint.

    • listStationsWithAdvancedSearch

      public Stream<Station> listStationsWithAdvancedSearch(@NonNull @NonNull AdvancedSearch advancedSearch)
      Get a stream of stations matching a certain search criteria.
      Parameter:
      advancedSearch - the advanced search query object. A builder can be created by calling AdvancedSearch.builder(), and then when you are finished AdvancedSearch.AdvancedSearchBuilder.build().
      Gibt zurück:
      the full stream of matching stations.