com.soa.agent

Class AgentBroker

java.lang.Object

com.soa.agent.AgentBroker

public class AgentBroker
extends java.lang.Object

Singleton shared across application/classloader boundaries for publishing an agent and obtaining published agents. The agent application will publish agent implementations supporting 0 or more bindings identified by URI's. The absence of any binding, the normalized binding, is identified by the URI urn:soa.com:binding:normalized.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CONSUMER_ROLE
static java.lang.String	NORMALIZED_URI Identifies the normalized binding.
static java.lang.String	PROVIDER_ROLE

Method Summary

Modifier and Type	Method and Description
void	addAgent(java.lang.String uri, SoaAgent agent) Called by the agent to publish an agent implementation.
void	addAgent(java.lang.String uri, java.lang.String role, SoaAgent agent) Called by the agent to publish an agent implementation.
SoaAgent	getAgent() Returns the published agent implementation that handles normalized messages.
SoaAgent	getAgent(java.lang.String uri) Returns the published agent implementation that handles the given binding.
SoaAgent	getAgent(java.lang.String uri, java.lang.String role) Returns the published agent implementation that handles the given binding.
SoaAgent	getDelegate() Returns the published delegate implementation that handles normalized messages.
SoaAgent	getDelegate(java.lang.String uri) Returns the published delegate implementation that handles the given binding.
static AgentBroker	getInstance() Returns the broker singleton instance.
void	removeAgent(java.lang.String uri) Called by the agent to remove an agent implementation.
void	removeAgent(java.lang.String uri, java.lang.String role) Called by the agent to remove an agent implementation.

Methods inherited from class java.lang.Object

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

Field Detail

NORMALIZED_URI

public static final java.lang.String NORMALIZED_URI

Identifies the normalized binding. urn:soa.com:binding:normalized

See Also:

Constant Field Values

CONSUMER_ROLE

public static final java.lang.String CONSUMER_ROLE

See Also:

Constant Field Values

PROVIDER_ROLE

public static final java.lang.String PROVIDER_ROLE

See Also:

Constant Field Values

Method Detail

getAgent

public SoaAgent getAgent()

Returns the published agent implementation that handles normalized messages.

Returns:

SoaAgent published to handle normalized messages, null if none published.

getAgent

public SoaAgent getAgent(java.lang.String uri)

Returns the published agent implementation that handles the given binding. The agent fulfilling the default role PROVIDER will be returned.

Parameters:

uri - URI of the binding being used.

Returns:

SoaAgent implementation for the given binding, null if none published.

getAgent

public SoaAgent getAgent(java.lang.String uri,
                         java.lang.String role)

Returns the published agent implementation that handles the given binding.

Parameters:

uri - URI of the binding being used.

role - Role of the agent.

Returns:

SoaAgent implementation for the given binding, null if none published.

getDelegate

public SoaAgent getDelegate()

Returns the published delegate implementation that handles normalized messages.

Returns:

SoaAgent published to handle normalized messages, null if none published.

getDelegate

public SoaAgent getDelegate(java.lang.String uri)

Returns the published delegate implementation that handles the given binding. The agent fulfilling the default role CONSUMER will be returned.

Parameters:

uri - URI of the binding being used.

Returns:

SoaAgent implementation for the given binding, null if none published.

addAgent

public void addAgent(java.lang.String uri,
                     SoaAgent agent)

Called by the agent to publish an agent implementation. The agent will fulfill the default PROVIDER role.

Parameters:

uri - URI of the binding the agent implementation supports.

agent - SoaAgent implementation.

addAgent

public void addAgent(java.lang.String uri,
                     java.lang.String role,
                     SoaAgent agent)

Called by the agent to publish an agent implementation.

Parameters:

uri - URI of the binding the agent implementation supports.

role - Role of the agent.

agent - SoaAgent implementation.

removeAgent

public void removeAgent(java.lang.String uri)

Called by the agent to remove an agent implementation. The agent fulfilling the default PROVIDER role will be removed.

Parameters:

uri - URI of the binding the agent implementation supports.

removeAgent

public void removeAgent(java.lang.String uri,
                        java.lang.String role)

Called by the agent to remove an agent implementation.

Parameters:

uri - URI of the binding the agent implementation supports.

role - Role of the agent.

getInstance

public static AgentBroker getInstance()

Returns the broker singleton instance.

Returns:

AgentBroker singleton.