io.digitalbits.sdk.federation

Class FederationServer

java.lang.Object

io.digitalbits.sdk.federation.FederationServer

public class FederationServer
extends java.lang.Object

FederationServer handles a network connection to a federation server instance and exposes an interface for requests to that instance. For resolving a digitalbits address without knowing which federation server to query use Federation.resolve(String).

See Also:

Federation docs

Constructor Summary

Constructors

Constructor and Description
FederationServer(java.lang.String serverUri, java.lang.String domain) Creates a new FederationServer instance.
FederationServer(java.net.URI serverUri, java.lang.String domain) Creates a new FederationServer instance.

Method Summary

Modifier and Type	Method and Description
static FederationServer	createForDomain(java.lang.String domain) Creates a FederationServer instance for a given domain.
java.lang.String	getDomain() Returns a domain this server is responsible for.
HttpUrl	getServerUri() Returns a federation server URI.
FederationResponse	resolveAddress(java.lang.String address) Resolves a digitalbits address using a given federation server.

Methods inherited from class java.lang.Object

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

Constructor Detail

FederationServer

public FederationServer(java.net.URI serverUri,
                        java.lang.String domain)

Creates a new FederationServer instance.

Parameters:

serverUri - Federation Server URI

domain - Domain name this federation server is responsible for

Throws:

FederationServerInvalidException - Federation server is invalid (malformed URL, not HTTPS, etc.)

FederationServer

public FederationServer(java.lang.String serverUri,
                        java.lang.String domain)

Creates a new FederationServer instance.

Parameters:

serverUri - Federation Server URI

domain - Domain name this federation server is responsible for

Throws:

FederationServerInvalidException - Federation server is invalid (malformed URL, not HTTPS, etc.)

Method Detail

createForDomain

public static FederationServer createForDomain(java.lang.String domain)

Creates a FederationServer instance for a given domain. It tries to find a federation server URL in digitalbits.toml file.

Parameters:

domain - Domain to find a federation server for

Returns:

FederationServer

Throws:

ConnectionErrorException - Connection problems

NoFederationServerException - Digitalbits.toml does not contain federation server info

FederationServerInvalidException - Federation server is invalid (malformed URL, not HTTPS, etc.)

DigitalBitsTomlNotFoundInvalidException - Digitalbits.toml file was not found or was malformed.

See Also:

Digitalbits.toml docs

resolveAddress

public FederationResponse resolveAddress(java.lang.String address)

Resolves a digitalbits address using a given federation server.

Parameters:

address - DigitalBits addres, like tom*digitalbits.io

Returns:

FederationResponse

Throws:

MalformedAddressException - Address is malformed

ConnectionErrorException - Connection problems

NotFoundException - DigitalBits address not found by federation server

ServerErrorException - Federation server responded with error

getServerUri

public HttpUrl getServerUri()

Returns a federation server URI.

Returns:

URI

getDomain

public java.lang.String getDomain()

Returns a domain this server is responsible for.

Returns:

String