KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > omg > PortableInterceptor > InterceptorOperations


1 package org.omg.PortableInterceptor;
2
3
4 /**
5 * org/omg/PortableInterceptor/InterceptorOperations.java .
6 * Generated by the IDL-to-Java compiler (portable), version "3.2"
7 * from ../../../../src/share/classes/org/omg/PortableInterceptor/Interceptors.idl
8 * Saturday, February 9, 2008 9:40:08 AM GMT
9 */
10
11
12 /**
13    * All Portable Interceptors implement Interceptor.
14    */
15 public interface InterceptorOperations
16 {
17
18   /**
19      * Returns the name of the interceptor.
20      * <p>
21      * Each Interceptor may have a name that may be used administratively
22      * to order the lists of Interceptors. Only one Interceptor of a given
23      * name can be registered with the ORB for each Interceptor type. An
24      * Interceptor may be anonymous, i.e., have an empty string as the name
25      * attribute. Any number of anonymous Interceptors may be registered with
26      * the ORB.
27      *
28      * @return the name of the interceptor.
29      */
30   String JavaDoc name ();
31
32   /**
33      * Provides an opportunity to destroy this interceptor.
34      * The destroy method is called during <code>ORB.destroy</code>. When an
35      * application calls <code>ORB.destroy</code>, the ORB:
36      * <ol>
37      * <li>waits for all requests in progress to complete</li>
38      * <li>calls the <code>Interceptor.destroy</code> operation for each
39      * interceptor</li>
40      * <li>completes destruction of the ORB</li>
41      * </ol>
42      * Method invocations from within <code>Interceptor.destroy</code> on
43      * object references for objects implemented on the ORB being destroyed
44      * result in undefined behavior. However, method invocations on objects
45      * implemented on an ORB other than the one being destroyed are
46      * permitted. (This means that the ORB being destroyed is still capable
47      * of acting as a client, but not as a server.)
48      */
49   void destroy ();
50 } // interface InterceptorOperations
51
Popular Tags