IORInterceptorOperations


1   package org.omg.PortableInterceptor;
2   
3   
4   /**
5   * org/omg/PortableInterceptor/IORInterceptorOperations.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     * Interceptor used to establish tagged components in the profiles within 
14     * an IOR.
15     * <p>
16     * In some cases, a portable ORB service implementation may need to add 
17     * information describing the server's or object's ORB service related 
18     * capabilities to object references in order to enable the ORB service 
19     * implementation in the client to function properly. 
20     * <p>
21     * This is supported through the <code>IORInterceptor</code> and 
22     * <code>IORInfo</code> interfaces. 
23     *
24     * @see IORInfo
25     */
26  public interface IORInterceptorOperations  extends org.omg.PortableInterceptor.InterceptorOperations  
27  {
28  
29    /**
30       * A server side ORB calls the <code>establish_components</code> 
31       * operation on all registered <code>IORInterceptor</code> instances 
32       * when it is assembling the list of components that will be included 
33       * in the profile or profiles of an object reference. This operation 
34       * is not necessarily called for each individual object reference. 
35       * In the case of the POA, this operation is called each time POA::create_POA
36       * is called.  In any case, <code>establish_components</code> is 
37       * guaranteed to be called at least once for each distinct set of 
38       * server policies. 
39       * <p>
40       * An implementation of <code>establish_components</code> must not 
41       * throw exceptions. If it does, the ORB shall ignore the exception 
42       * and proceed to call the next IOR Interceptor's 
43       * <code>establish_components</code> operation. 
44       *
45       * @param info The <code>IORInfo</code> instance used by the ORB 
46       *     service to query applicable policies and add components to be 
47       *     included in the generated IORs.
48       */
49    void establish_components (org.omg.PortableInterceptor.IORInfo   info);
50  } // interface IORInterceptorOperations
51
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags