com.sssw.jbroker.api.cluster
Interface CustomPolicyController

public interface CustomPolicyController

The CustomPolicyController defines a callback interface, which must be provided when specifying the CUSTOM_SCHEME cluster policy. Before each invocation the ORB will ask the policy controller for an address. The ORB will repeatedly ask for an address and invoke on it until either successfull or the policy controller callback method throws an exception.

Since:

jBroker ORB 4.0

See Also:

ClusterPolicyValue.CUSTOM_SCHEME

Method Summary

TCPAddress

getAddress(TCPAddress[] addrs, CustomPolicyContext context) Return an address on which the ORB will invoke.

Method Detail

getAddress

public TCPAddress getAddress(TCPAddress[] addrs,
                             CustomPolicyContext context)
                      throws SystemException

Return an address on which the ORB will invoke.

Parameters:

addrs - array with all Address profiles in the IOR

context - a context with information about previous invocations if any

Returns:

the (next) TCP address on which to invoke

Throws:

SystemException - a controller callback implementation should raise an appropriate system exception when all options have been exhausted. Examples include:

• All available TCP addresses have failed.
• A previous invocation yielded a COMM_FAILURE with Completion status MAYBE. In this case, the exception contained in the context could for instance be re-thrown.