alma.acs.container

Class ContainerSealant

java.lang.Object

alma.acs.container.ContainerSealant

public class ContainerSealant
extends java.lang.Object

Seals the container to make it a "tight container", as opposed to an "open container". There's one sealant instance per component instance. The sealant is placed between the CORBA POATie on the one side, and the component implementation class or the component interface translator (if present) on the other side. The sealant therefore intercepts all functional calls made to the component.

This sealant class is not only used for components, but also for offshoots from that component, if they follow the tie-approach. Since ACS 9.0 it uses DynamicInterceptor.

Author:

hsommer

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CHECK_NULLS_CORBA_OUT_PROPERTYNAME If this property is enabled, the container will check the return value and out/inout parameters for illegal null values that will cause exceptions during subsequent corba marshalling.

Constructor Summary

Constructors

Constructor and Description
ContainerSealant()

Method Summary

Modifier and Type	Method and Description
static <T> T	createContainerSealant(java.lang.Class<T> corbaInterface, java.lang.Object component, java.lang.String name, boolean isOffShoot, java.util.logging.Logger logger, java.lang.ClassLoader componentContextCL, java.lang.String[] methodNamesExcludedFromInvocationLogging) Creates a ContainerSealant and uses it as the invocation handler for the returned dynamic proxy which implements corbaInterface.

Methods inherited from class java.lang.Object

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

Field Detail

CHECK_NULLS_CORBA_OUT_PROPERTYNAME

public static final java.lang.String CHECK_NULLS_CORBA_OUT_PROPERTYNAME

If this property is enabled, the container will check the return value and out/inout parameters for illegal null values that will cause exceptions during subsequent corba marshalling.

See Also:

Constant Field Values

Constructor Detail

ContainerSealant

public ContainerSealant()

Method Detail

createContainerSealant

public static <T> T createContainerSealant(java.lang.Class<T> corbaInterface,
                                           java.lang.Object component,
                                           java.lang.String name,
                                           boolean isOffShoot,
                                           java.util.logging.Logger logger,
                                           java.lang.ClassLoader componentContextCL,
                                           java.lang.String[] methodNamesExcludedFromInvocationLogging)
                                    throws AcsJContainerEx

Creates a ContainerSealant and uses it as the invocation handler for the returned dynamic proxy which implements corbaInterface.

Parameters:

corbaInterface - the interface that the created sealant will implement; this should be the component's or offshoot's xxxOperations interface.

component - the component/offshoot implementation class, or any translator class in front of the component implementation. componentImpl must implement corbaInterface so that the sealant can forward calls to the component.
Note about usage of java generics: Ideally this would be declared "T" instead of "Object", but did not get it to work with that...

name - the component instance name (used for logging)

isOffShoot - true if the component object is actually an offshoot of a component

logger - logger to be used by this class

componentContextCL - classloader used for Thread.setContextClassLoader(java.lang.ClassLoader setContextClassLoader) before component method gets invoked. (after the call, the old context CL will be restored.)

methodNamesExcludedFromInvocationLogging -

Returns:

an instance of corbaInterface that intercepts calls to componentImpl and forwards them if restrictions allow this.

Throws:

ContainerException - if the given component Object does not implement the given corbaInterface.

AcsJContainerEx