com.webify.wsf.engine.mediation
Interface EndpointSelector


public interface EndpointSelector

Facilitates context-based routing by determining the best endpoints for a specified context.

Version:
$Revision: $
Author:
msanchez

Field Summary
static java.lang.String ENVIRONMENT
          Context key whose value is the request's operating environment name (String).
static java.lang.String INTERFACE_NAME
          Context key whose value is the URI of the service interface being requested.
static java.lang.String SUBSCRIPTION
          Context key whose value contains the URI of the subscription for the business service being requested.
 
Method Summary
 Endpoint selectEndpoint(Context context)
          Deprecated. use selectEndpoints(Context) instead. This operation is only considered valid for single-threaded use. In practice, this API is safe so long as Endpoint.getComputation() is not invoked on the resulting endpoint.
 EndpointSelection selectEndpoints(Context context)
          Select the best endpoints for the specified context.
 EndpointSelection selectEndpoints(Context context, java.util.Collection listeners)
          Select the best endpoints for the specified context.
 

Field Detail

ENVIRONMENT

static final java.lang.String ENVIRONMENT
Context key whose value is the request's operating environment name (String).

See Also:
Constant Field Values

INTERFACE_NAME

static final java.lang.String INTERFACE_NAME
Context key whose value is the URI of the service interface being requested.

See Also:
Constant Field Values

SUBSCRIPTION

static final java.lang.String SUBSCRIPTION
Context key whose value contains the URI of the subscription for the business service being requested.

See Also:
Constant Field Values
Method Detail

selectEndpoint

Endpoint selectEndpoint(Context context)
                        throws EndpointNotFoundException,
                               InvalidContextException
Deprecated. use selectEndpoints(Context) instead. This operation is only considered valid for single-threaded use. In practice, this API is safe so long as Endpoint.getComputation() is not invoked on the resulting endpoint.

Select the best endpoint for the specified context. The context should contain the following properties:

Parameters:
context - the context to consider for endpoint selection
Returns:
a suitable endpoint for the specified context
Throws:
EndpointNotFoundException - indicates that a suitable endpoint could not be found
InvalidContextException - indicates that the given context is not valid for endpoint selection

selectEndpoints

EndpointSelection selectEndpoints(Context context)
                                  throws EndpointNotFoundException,
                                         InvalidContextException
Select the best endpoints for the specified context. The context should contain the following properties:

Parameters:
context - the context to consider for endpoint selection
Returns:
a suitable set of endpoints for the specified context
Throws:
EndpointNotFoundException - indicates that a suitable endpoint could not be found
InvalidContextException - indicates that the given context is not valid for endpoint selection

selectEndpoints

EndpointSelection selectEndpoints(Context context,
                                  java.util.Collection listeners)
                                  throws EndpointNotFoundException,
                                         InvalidContextException
Select the best endpoints for the specified context. The context should contain the following properties:

Parameters:
context - the context to consider for endpoint selection
listeners - a collection of EndpointSelectionListener instances that want to track endpoint selection details
Returns:
a suitable set of endpoints for the specified context
Throws:
EndpointNotFoundException - indicates that a suitable endpoint could not be found
InvalidContextException - indicates that the given context is not valid for endpoint selection


Copyright © 2002-2009 IBM. All Rights Reserved.