1. package org.omg.PortableServer;
  2. /**
  3. * org/omg/PortableServer/ServantActivatorOperations.java .
  4. * Generated by the IDL-to-Java compiler (portable), version "3.1"
  5. * from ../../../../src/share/classes/org/omg/PortableServer/poa.idl
  6. * Monday, February 23, 2004 7:03:02 AM GMT
  7. */
  8. /**
  9. * When the POA has the RETAIN policy it uses servant
  10. * managers that are ServantActivators.
  11. */
  12. public interface ServantActivatorOperations extends org.omg.PortableServer.ServantManagerOperations
  13. {
  14. /**
  15. * This operation is invoked by the POA whenever the
  16. * POA receives a request for an object that is not
  17. * currently active, assuming the POA has the
  18. * USE_SERVANT_MANAGER and RETAIN policies.
  19. * @param oid object Id associated with the object on
  20. * the request was made.
  21. * @param adapter object reference for the POA in which
  22. * the object is being activated.
  23. * @return Servant corresponding to oid is created or
  24. * located by the user supplied servant manager.
  25. * @exception ForwardRequest to indicate to the ORB
  26. * that it is responsible for delivering
  27. * the current request and subsequent
  28. * requests to the object denoted in the
  29. * forward_reference member of the exception.
  30. */
  31. org.omg.PortableServer.Servant incarnate (byte[] oid, org.omg.PortableServer.POA adapter) throws org.omg.PortableServer.ForwardRequest;
  32. /**
  33. * This operation is invoked whenever a servant for
  34. * an object is deactivated, assuming the POA has
  35. * the USE_SERVANT_MANAGER and RETAIN policies.
  36. * @param oid object Id associated with the object
  37. * being deactivated.
  38. * @param adapter object reference for the POA in which
  39. * the object was active.
  40. * @param serv contains reference to the servant
  41. * associated with the object being deactivated.
  42. * @param cleanup_in_progress if TRUE indicates that
  43. * destroy or deactivate is called with
  44. * etherealize_objects param of TRUE. FALSE
  45. * indicates that etherealize was called due to
  46. * other reasons.
  47. * @param remaining_activations indicates whether the
  48. * Servant Manager can destroy a servant. If
  49. * set to TRUE, the Servant Manager should wait
  50. * until all invocations in progress have
  51. * completed.
  52. */
  53. void etherealize (byte[] oid, org.omg.PortableServer.POA adapter, org.omg.PortableServer.Servant serv, boolean cleanup_in_progress, boolean remaining_activations);
  54. } // interface ServantActivatorOperations