
	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	e-docs.beasys.com \| Site Map \| Search \| PDF Files \| Contact \| Glossary

WLE Doc Home \| CORBA Programming & Related Topics \| Previous \| Next \| Contents \| Index

Deploying the Interceptor

There are three administrative tasks associated with managing the registration of interceptors:

This section explains these three tasks.

Registering an Interceptor

You use the epifregplugin command to register your interceptors with an ORB. When you register an interceptor, the interceptor is added to the end of the list of interceptors already registered with the ORB. This is important when you have multiple interceptors registered with an ORB.

The syntax of the epifregplugin command for registering interceptors is the following:

epifregplugin -t bea/wle -i AppRequestInterceptor \
        -p <InterceptorName> -f <FileName> -e <EntryPoint> \
        -u "DisplayName=<Administrative Name>" -v 1.0

In the preceding command line:

InterceptorName represents the name of the interceptor registered with the ORB, and the name you choose needs to be unique among those previously registered. You use this name for specifying the order of multiple interceptors and for unregistering an interceptor. The FileName , EntryPoint , and DisplayName arguments that follow are associated with this name.
FileName represents the location of the file containing the implementation of the interceptor. This name is operating system and language dependent. For C++ interceptors, this file is a sharable image file. For Java, the file is a java archive file (JAR), and its name ends with .jar .
EntryPoint represents a string value that is the name of the entry point for the interceptor. This name is programming language specific. In Java, this value is the name of the class in which the interceptor is implemented. In C++, this value is the name of the initialization function in the shareable image that creates an instance of the interceptor.
DisplayName specifies a string value used for administrative functions and other reporting purposes. This name is strictly an administrative name.

Unregistering an Interceptor

Use the epifunregplugin command to unregister an interceptor from an ORB. This command has the following syntax:

epifunregplugin -t bea/wle -p <InterceptorName>

The argument <InterceptorName> is the same case-insensitive name specified in the epifregplugin command. Unregistering an interceptor takes it out of the interceptor order.

Changing the Order in which Interceptors are Called

You can see the order in which interceptors are registered, and thus called, by using the following command:

epifregedit -t bea/wle -g -k SYSTEM/interfaces/AppRequestInterceptor

The epifregedit displays the order in which interceptors are executed when the ORB receives a request.

You can change the order in which the interceptors are executed using the following command:

epifregedit -t bea/wle -s -k SYSTEM/interfaces/AppRequestInterceptor \
-a Selector=Order -a Order=<InterceptorName1>,<InterceptorName2>,...

Each <InterceptorName> is the case-insensitive name of the interceptor that must have been previously registered. This command replaces the order currently in the registry. The epifregedit command must specify every interceptor that you want to have loaded and executed by the ORB. If an interceptor is still registered and if you do not specify its name using epifregedit command, the interceptor is not loaded.