home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / warptlk3.zip / TOOLKIT / SOM / INCLUDE / BOA.IDL < prev    next >
Text File  |  1995-08-24  |  3KB  |  76 lines
  1. //
  2. //   COMPONENT_NAME: somd
  3. //
  4. //   ORIGINS: 27
  5. //
  6. //
  7. //   10H9767, 10H9769  (C) COPYRIGHT International Business Machines Corp. 1992,1994
  8. //   All Rights Reserved
  9. //   Licensed Materials - Property of IBM
  10. //   US Government Users Restricted Rights - Use, duplication or
  11. //   disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
  12. //
  13. //   IDL interface spec for CORBA Basic Object Adapter.
  14. //
  15. //   This is an abstract class which defines the CORBA-defined interface
  16. //   for a Basic Object Adapter.
  17. //
  18. //   The SOM Object Adapter interface is derived from this one.
  19. //   SOMOA provides the actual implementation in DSOM.
  20. #ifndef boa_idl
  21. #define boa_idl
  22. #include <somobj.idl>
  23. #include <somdtype.idl>
  24. #include <snglicls.idl>
  25. interface SOMDObject;
  26. interface Principal;
  27. interface ImplementationDef;
  28. interface InterfaceDef;
  29. interface Context;
  30. interface BOA : SOMObject
  31. {
  32.   SOMDObject create(in ReferenceData id, in InterfaceDef intf,
  33.             in ImplementationDef impl);
  34.   // Create an object reference.
  35.   void dispose(in SOMDObject obj);
  36.   // Destroy an object reference.
  37.   ReferenceData get_id(in SOMDObject obj);
  38.   // Return ReferenceData associated with referenced object.
  39.   Principal get_principal(in SOMDObject obj, in Environment req_ev);
  40.   // Return a Principal object, which describes who issued a request on
  41.   // the specified object.  The "req_ev" parameter is the Environment
  42.   // which was passed as part of the request.
  43.   void set_exception(in exception_type major, in string userid, in void *param);
  44.   // Return an exception to the client.
  45.   void impl_is_ready(in ImplementationDef impl);
  46.   // Indicate that the implementation is now ready to process requests.
  47.   void deactivate_impl(in ImplementationDef impl);
  48.   // Indicate that the implementation is no longer ready to process reqs.
  49.   void change_implementation(in SOMDObject obj, in ImplementationDef impl);
  50.   // Change the implementation associated with the referenced object.
  51.   // (NOTE: Null implementation in this release of DSOM.)
  52.   void obj_is_ready(in SOMDObject obj, in ImplementationDef impl);
  53.   // Indicate that the object is ready to process requests.
  54.   // (NOTE: Null implementation in this release of DSOM.)
  55.   void deactivate_obj(in SOMDObject obj);
  56.   // Indicate that the object is no longer ready to process requests.
  57.   // (NOTE: Null implementation in this release of DSOM.)
  58. #ifdef __SOMIDL__
  59.   implementation
  60.   {
  61.     releaseorder: create, dispose, get_id,
  62.                   change_implementation,
  63.           get_principal, set_exception,
  64.           impl_is_ready, deactivate_impl,
  65.           obj_is_ready, deactivate_obj,
  66.           activate_impl, activate_obj;
  67.     callstyle = idl;
  68.     metaclass = SOMMSingleInstance;
  69.     dllname = "somd.dll";
  70.     majorversion = 2;
  71.     minorversion = 1;
  72.   };
  73. #endif /* __SOMIDL__ */
  74. };
  75. #endif  /* boa_idl */
  76.