Package de.sfuhrm.radiobrowser4j

Class EndpointDiscovery

java.lang.Object

de.sfuhrm.radiobrowser4j.EndpointDiscovery

public class EndpointDiscovery
extends Object

Discovers the radio browser API endpoint that suits the application.

Constructor Summary

Constructors

Constructor	Description
EndpointDiscovery(@NonNull String myUserAgent)	Constructs a new instance.
EndpointDiscovery(@NonNull String myUserAgent, String myProxyUri, String myProxyUser, String myProxyPassword)	Constructs a new instance.

Method Summary

Modifier and Type	Method	Description
Optional<String>	discover()	Discovers the best performing endpoint.

Methods inherited from class java.lang.Object

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

Constructor Detail

EndpointDiscovery

public EndpointDiscovery(@NonNull
                         @NonNull String myUserAgent)

Constructs a new instance.

Parameters:

myUserAgent - the user agent String to use while discovery.

EndpointDiscovery

public EndpointDiscovery(@NonNull
                         @NonNull String myUserAgent,
                         String myProxyUri,
                         String myProxyUser,
                         String myProxyPassword)

Constructs a new instance.

Parameters:

myUserAgent - the user agent String to use while discovery.

myProxyUri - the optional URI of a HTTP proxy to use.

myProxyUser - the optional username to authenticate with to access the proxy.

myProxyPassword - the optional password to authenticate with to access the proxy.

Method Detail

discover

public Optional<String> discover()
                          throws IOException

Discovers the best performing endpoint.

Returns:

an optional endpoint address that can be passed to the RadioBrowser constructors.

Throws:

IOException - when there is an IO problem while discovery.