commonj.connector.runtime
Interface FunctionSelector


public interface FunctionSelector

Generates the key name of a function on an InboundServiceDescription given an adapter-specific inbound object. Resource adapter implementations return instances of this interface to assist the application server in correlating incoming messages, or requests, with listeners within the application server.

If the databinding and functionSelector are the same class then the runtime should use the same instance on the inbound invocation.

Since:
1.0

Method Summary
 String generateEISFunctionName(Object[] argObjects)
          Given an adapter specific message listener method parameters, generate a key string (called the EIS function name) representing key information found in the message listener method parameters.
 

Method Detail

generateEISFunctionName

String generateEISFunctionName(Object[] argObjects)
                               throws SelectorException
Given an adapter specific message listener method parameters, generate a key string (called the EIS function name) representing key information found in the message listener method parameters.

This EIS function name must be the same as the EIS function name returned by one of the InboundFunctionDescriptions (via the getEISFunctionName() method) returned by this adapter during metadata discovery and import.

Parameters:
argObjects - Listener method arguments. The argument must not be null.
Returns:
A string representing the native EIS function name
Throws:
SelectorException - if an error occured during execution