ch.ethz.iks.r_osgi.channels
Interface ChannelEndpointManager

public interface ChannelEndpointManager

Channel endpoint manager. Can be used to add redundant service bindings to alternative endpoints and define policies. Additionally, it provides access to the timestamp transformation.

Author:

Jan S. Rellermeyer, ETH Zurich

Field Summary

static int	FAILOVER_REDUNDANCY_POLICY
static int	LOADBALANCING_ANY_POLICY
static int	LOADBALANCING_ONE_POLICY
static int	NO_POLICY

Method Summary

void	addRedundantEndpoint(URI service, URI redundant) add a reduntant binding for a service.
URI	getLocalAddress() get the local address of the managed channel endpoint.
void	removeRedundantEndpoint(URI service, URI redundant) remove a redundant binding from a service.
void	setEndpointPolicy(URI service, int policy) set a policy for making use of redundant service bindings.
Timestamp	transformTimestamp(Timestamp timestamp) transform a timestamp into the peer's local time.

Field Detail

NO_POLICY

static final int NO_POLICY

See Also:

Constant Field Values

FAILOVER_REDUNDANCY_POLICY

static final int FAILOVER_REDUNDANCY_POLICY

See Also:

Constant Field Values

LOADBALANCING_ANY_POLICY

static final int LOADBALANCING_ANY_POLICY

See Also:

Constant Field Values

LOADBALANCING_ONE_POLICY

static final int LOADBALANCING_ONE_POLICY

See Also:

Constant Field Values

Method Detail

addRedundantEndpoint

void addRedundantEndpoint(URI service,
                          URI redundant)

add a reduntant binding for a service. EXPERIMENTAL.

Parameters:

service - the URI of the service.

redundant - the URI of the redundant service.

removeRedundantEndpoint

void removeRedundantEndpoint(URI service,
                             URI redundant)

remove a redundant binding from a service. EXPERIMENTAL.

Parameters:

service - the URI of the service.

redundant - the URI of the redundant service.

setEndpointPolicy

void setEndpointPolicy(URI service,
                       int policy)

set a policy for making use of redundant service bindings. EXPERIMENTAL.

Parameters:

service - the URI of the service.

policy - the policy to be used.

getLocalAddress

URI getLocalAddress()

get the local address of the managed channel endpoint.

Returns:

the local URI.

transformTimestamp

Timestamp transformTimestamp(Timestamp timestamp)
                             throws RemoteOSGiException

transform a timestamp into the peer's local time.

Parameters:

timestamp - the Timestamp.

Returns:

the transformed timestamp.

Throws:

RemoteOSGiException - if the transformation fails.

Since:

0.2