1. package org.omg.PortableServer;
  2. /**
  3. * org/omg/PortableServer/ServantLocatorOperations.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 NON_RETAIN policy it uses servant
  10. * managers that are ServantLocators. Because the POA
  11. * knows that the servant returned by this servant
  12. * manager will be used only for a single request,
  13. * it can supply extra information to the servant
  14. * manager's operations and the servant manager's pair
  15. * of operations may be able to cooperate to do
  16. * something different than a ServantActivator.
  17. * When the POA uses the ServantLocator interface,
  18. * immediately after performing the operation invocation
  19. * on the servant returned by preinvoke, the POA will
  20. * invoke postinvoke on the servant manager, passing the
  21. * ObjectId value and the Servant value as parameters
  22. * (among others). This feature may be used to force
  23. * every request for objects associated with a POA to
  24. * be mediated by the servant manager.
  25. */
  26. public interface ServantLocatorOperations extends org.omg.PortableServer.ServantManagerOperations
  27. {
  28. /**
  29. * This operations is used to get a servant that will be
  30. * used to process the request that caused preinvoke to
  31. * be called.
  32. * @param oid the object id associated with object on
  33. * which the request was made.
  34. * @param adapter the reference for POA in which the
  35. * object is being activated.
  36. * @param operation the operation name.
  37. * @param the_cookie an opaque value that can be set
  38. * by the servant manager to be used
  39. * during postinvoke.
  40. * @return Servant used to process incoming request.
  41. * @exception ForwardRequest to indicate to the ORB
  42. * that it is responsible for delivering
  43. * the current request and subsequent
  44. * requests to the object denoted in the
  45. * forward_reference member of the exception.
  46. */
  47. org.omg.PortableServer.Servant preinvoke (byte[] oid, org.omg.PortableServer.POA adapter, String operation, org.omg.PortableServer.ServantLocatorPackage.CookieHolder the_cookie) throws org.omg.PortableServer.ForwardRequest;
  48. /**
  49. * This operation is invoked whenener a servant completes
  50. * a request.
  51. * @param oid the object id ssociated with object on which
  52. * the request was made.
  53. * @param adapter the reference for POA in which the
  54. * object was active.
  55. * @param the_cookie an opaque value that contains
  56. * the data set by preinvoke.
  57. * @param the_servant reference to the servant that is
  58. * associated with the object.
  59. */
  60. void postinvoke (byte[] oid, org.omg.PortableServer.POA adapter, String operation, java.lang.Object the_cookie, org.omg.PortableServer.Servant the_servant);
  61. } // interface ServantLocatorOperations