org.scion.jpan

Class Scion

java.lang.Object

org.scion.jpan.Scion

public final class Scion
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Scion.CloseableService

Method Summary

Modifier and Type	Method and Description
static void	closeDefault()
static ScionService	defaultService() Returns the default instance of the ScionService.
static Scion.CloseableService	newServiceWithBootstrapServer(String hostAndPort) Create a new service instance that uses a bootstrap server host/port to locate a control server.
static Scion.CloseableService	newServiceWithDaemon(String hostAndPort) Create a new service instance that connects to a daemon.
static Scion.CloseableService	newServiceWithDNS(String hostName) Create a new service instance that uses DNS NAPTR entries to connect to a control service.
static Scion.CloseableService	newServiceWithTopologyFile(String filePath) Create a new service instance that reads a topology file to determine the address of a control server.

Methods inherited from class java.lang.Object

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

Method Detail

defaultService

public static ScionService defaultService()

Returns the default instance of the ScionService. The default instance is connected to the daemon that is specified by the default properties or environment variables.

If no default instance is available, it will try to create an instance as follows:
- CHeck and try daemon port/host
- Check and try properties/environment for topology file location
- Check and try properties/environment for bootstrap server IP address
- Check and try properties/environment for DNS NAPTR record entry name

Returns:

default instance

closeDefault

public static void closeDefault()

newServiceWithDaemon

public static Scion.CloseableService newServiceWithDaemon(String hostAndPort)

Create a new service instance that connects to a daemon. Services created with this method will never be returned by defaultService().

Parameters:

hostAndPort - of the local daemon in the form of IP:port

Returns:

new ScionService instance

newServiceWithDNS

public static Scion.CloseableService newServiceWithDNS(String hostName)

Create a new service instance that uses DNS NAPTR entries to connect to a control service. Services created with this method will never be returned by defaultService().

Parameters:

hostName - of the host whose DNS entry contains hints for control service etc.

Returns:

new ScionService instance

newServiceWithBootstrapServer

public static Scion.CloseableService newServiceWithBootstrapServer(String hostAndPort)

Create a new service instance that uses a bootstrap server host/port to locate a control server. Services created with this method will never be returned by defaultService().

Parameters:

hostAndPort - of the bootstrap server.

Returns:

new ScionService instance

newServiceWithTopologyFile

public static Scion.CloseableService newServiceWithTopologyFile(String filePath)

Create a new service instance that reads a topology file to determine the address of a control server. Services created with this method will never be returned by defaultService().

Parameters:

filePath - name (and location) of the topology json file.

Returns:

new ScionService instance