com.inprise.vbroker.PortableServerExt
Interface POALifeCycleInterceptor

All Superinterfaces:

IDLEntity, java.io.Serializable

All Known Implementing Classes:

ChainPOALifeCycleInterceptor

public interface POALifeCycleInterceptor
extends IDLEntity

The POALifeCycleInterceptor is a global interceptor which is invoked every time a POA is created or destroyed. All other Server-side interceptors may be installed either as global interceptors, or for a specific POAs. You install the POALifeCycleInterceptor through the InterceptorManager interface. The POALifeCycleInterceptor is called during POA creation and destruction.

Method Summary

void	create(POA poa, PolicyListHolder policies, com.inprise.vbroker.IOP.IORValueHolder iorTemplate, InterceptorManagerControl poaAdmin) This interceptor is called after the parent POA has created the child POA, calling any adapter activators if necessary.
void	destroy(POA poa) This method is called when a POA is just about to be destroyed and all of its objects have been etherealized.

Method Detail

destroy

void destroy(POA poa)

This method is called when a POA is just about to be destroyed and all of its objects have been etherealized. It is guaranteed that destroy will be called on all interceptors before create will be called again for a POA with the same name. If the destroy operation throws a system exception it is ignored, and the remaining interceptors will continue to be called.

Parameters:

poa - Portable Object Adaptor (POA) being destroyed.

create

void create(POA poa,
            PolicyListHolder policies,
            com.inprise.vbroker.IOP.IORValueHolder iorTemplate,
            InterceptorManagerControl poaAdmin)
            throws InvalidPolicy

This interceptor is called after the parent POA has created the child POA, calling any adapter activators if necessary. This method is invoked when a new POA is created either explicitly through a call to create_POA or via AdapterActivator. With AdapterActivator, the interceptor is called only after the unknown_adapter method successfully returns from the AdapterActivator.

Parameters:

poa - The POA that is being created.

policies - The list of policies specified for this POA.

iorTemplate - The IOR template is a full IOR value with the type_id not set, and all GIOP.ProfileBodyValues will have incomplete object keys.

poaAdmin - The InterceptorManagerControl used to obtain other interceptor managers.

Throws:

com.inprise.vbroker.PortableServer.POA.InvalidPolicy - Any of the policy in the policy list is not a valid policy.

InvalidPolicy