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.1"

  7. * from ../../../../src/share/classes/org/omg/PortableInterceptor/Interceptors.idl

  8. * Monday, February 23, 2004 7:03:06 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.      * For example, the POA specifies policies at POA granularity and 

  36.      * therefore, this operation might be called once per POA rather than 

  37.      * once per object. In any case, <code>establish_components</code> is 

  38.      * guaranteed to be called at least once for each distinct set of 

  39.      * server policies. 

  40.      * <p>

  41.      * An implementation of <code>establish_components</code> must not 

  42.      * throw exceptions. If it does, the ORB shall ignore the exception 

  43.      * and proceed to call the next IOR Interceptor's 

  44.      * <code>establish_components</code> operation. 

  45.      *

  46.      * @param info The <code>IORInfo</code> instance used by the ORB 

  47.      *     service to query applicable policies and add components to be 

  48.      *     included in the generated IORs.

  49.      */

  50.   void establish_components (org.omg.PortableInterceptor.IORInfo info);

  51. } // interface IORInterceptorOperations