com.bea.wlcp.wlng.api.plugin
Class RequestFactory

java.lang.Object
  com.bea.wlcp.wlng.api.plugin.RequestFactory

public class RequestFactory

extends java.lang.Object

The Request factory is used to perform traffic path-specific processing before and after a request is processed in the plug-in. There should be one implementation for each application-facing interface.

Constructor Summary

RequestFactory()

Method Summary

java.lang.Throwable	convertEx(java.lang.reflect.Method method, java.lang.Throwable t) Converts a generic exception to a service-specific exception.
java.lang.Object[]	createPartialRequest(java.util.List ris) Create a partial request for a subset of RequestInfos.
RequestInfo	createRequestInfo(java.lang.Class type, java.lang.reflect.Method method, java.lang.Object[] args) Create the request info.
RequestInfo[]	createRequestInfos(java.lang.Class type, java.lang.reflect.Method method, java.lang.Object[] args) Creates multiple RequestInfos for one request.
static java.lang.Object	getArgument(int index, java.lang.Object[] args) Helper method for finding the argument on specific index.
java.lang.Object	mergeResults(RequestInfo[] ris, java.util.List results) Merges partial results into one result.
void	validateRequest(java.lang.reflect.Method method, java.lang.Object[] args) Validate the request.

Methods inherited from class java.lang.Object

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

Constructor Detail

RequestFactory

public RequestFactory()

Method Detail

convertEx

public java.lang.Throwable convertEx(java.lang.reflect.Method method,
                                     java.lang.Throwable t)

Converts a generic exception to a service-specific exception.

Parameters:

method - The method that was called.

t - The exception to convert.

Returns:

A converted exception.

createPartialRequest

public java.lang.Object[] createPartialRequest(java.util.List ris)

Create a partial request for a subset of RequestInfos. This method only needs to be implemented if a request supports multiple plug-ins.

Parameters:

ris - The request information.

Returns:

The request.

createRequestInfo

public RequestInfo createRequestInfo(java.lang.Class type,
                                     java.lang.reflect.Method method,
                                     java.lang.Object[] args)

Create the request info.

Returns:

The request info.

createRequestInfos

public RequestInfo[] createRequestInfos(java.lang.Class type,
                                        java.lang.reflect.Method method,
                                        java.lang.Object[] args)

Creates multiple RequestInfos for one request. Used to route requests to multiple plug-ins. A request factory only needs to implement the createRequestInfo method if this is not supported.

Returns:

The RequestInfo.

getArgument

public static final java.lang.Object getArgument(int index,
                                                 java.lang.Object[] args)

Helper method for finding the argument on specific index.

Parameters:

args - Arguments.

index - Index.

Returns:

The argument or null if not found.

mergeResults

public java.lang.Object mergeResults(RequestInfo[] ris,
                                     java.util.List results)

Merges partial results into one result. This method only needs to be implemented if a request supports multiple plug-ins.

Parameters:

ris - The request information.

results - The result from all requests.

Returns:

The merged result.

validateRequest

public void validateRequest(java.lang.reflect.Method method,
                            java.lang.Object[] args)
                     throws java.lang.Throwable

Validate the request.

Throws:

java.lang.Exception - on validation error.

java.lang.Throwable