jadex.bridge.service.component.interceptors

Class DecouplingInterceptor

java.lang.Object

jadex.bridge.service.component.interceptors.AbstractMultiInterceptor

jadex.bridge.service.component.interceptors.DecouplingInterceptor

All Implemented Interfaces:

IServiceInvocationInterceptor

public class DecouplingInterceptor
extends AbstractMultiInterceptor

Invocation interceptor for executing a call on the underlying component thread. It checks whether the call can be decoupled (has void or IFuture return type) and the invoking thread is not already the component thread. todo: what about synchronous calls that change the object state. These calls could damage the service state.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	DecouplingInterceptor.CopyReturnValueResultListener Copy return value, when service call is finished.
static class	DecouplingInterceptor.InvokeMethodStep Service invocation step.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	copy The argument copy allowed flag.
protected IExternalAccess	ea The external access.
protected IFilter	filter The clone filter (facade for marshal).
protected IInternalAccess	ia The internal access.
protected IMarshalService	marshal The marshal service.
protected static java.util.Set<java.lang.reflect.Method>	NO_DECOUPLING The static set of no decoupling methods.
protected boolean	required Is the interceptor for a required service proxy?
protected static java.util.Map<java.lang.reflect.Method,IServiceInvocationInterceptor>	SUBINTERCEPTORS The static map of subinterceptors (method -> interceptor).

Constructor Summary

Constructors

Constructor and Description
DecouplingInterceptor(IInternalAccess ia, boolean copy, boolean required) Create a new invocation handler.

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object	doCopy(boolean copy, IFilter deffilter, java.lang.Object value) Copy a value, if necessary.
IFuture<java.lang.Void>	doExecute(ServiceInvocationContext sic) Execute the command.
IServiceInvocationInterceptor	getInterceptor(ServiceInvocationContext sic) Get a sub interceptor for special cases.
static java.util.Map<java.lang.reflect.Method,IServiceInvocationInterceptor>	getInterceptors() Get the sub interceptors for special cases.

Methods inherited from class jadex.bridge.service.component.interceptors.AbstractMultiInterceptor

execute, isApplicable

Methods inherited from class java.lang.Object

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

Field Detail

SUBINTERCEPTORS

protected static final java.util.Map<java.lang.reflect.Method,IServiceInvocationInterceptor> SUBINTERCEPTORS

The static map of subinterceptors (method -> interceptor).

NO_DECOUPLING

protected static final java.util.Set<java.lang.reflect.Method> NO_DECOUPLING

The static set of no decoupling methods.

ea

protected IExternalAccess ea

The external access.

ia

protected IInternalAccess ia

The internal access.

required

protected boolean required

Is the interceptor for a required service proxy?

copy

protected boolean copy

The argument copy allowed flag.

marshal

protected IMarshalService marshal

The marshal service.

filter

protected IFilter filter

The clone filter (facade for marshal).

Constructor Detail

DecouplingInterceptor

public DecouplingInterceptor(IInternalAccess ia,
                             boolean copy,
                             boolean required)

Create a new invocation handler.

Method Detail

doExecute

public IFuture<java.lang.Void> doExecute(ServiceInvocationContext sic)

Execute the command.

Specified by:

doExecute in class AbstractMultiInterceptor

Parameters:

args - The argument(s) for the call.

Returns:

The result of the command.

getInterceptor

public IServiceInvocationInterceptor getInterceptor(ServiceInvocationContext sic)

Get a sub interceptor for special cases.

Overrides:

getInterceptor in class AbstractMultiInterceptor

Parameters:

sic - The context.

Returns:

The interceptor (if any).

doCopy

protected java.lang.Object doCopy(boolean copy,
                                  IFilter deffilter,
                                  java.lang.Object value)

Copy a value, if necessary.

getInterceptors

public static java.util.Map<java.lang.reflect.Method,IServiceInvocationInterceptor> getInterceptors()

Get the sub interceptors for special cases.