home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tolkit45.zip / os2tk45 / som / include / boa.idl < prev    next >
Text File  |  1999-02-22  |  3KB  |  104 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. //#  @(#) 2.7 src/somd/boa.idl, somd, som2.1 9/1/94 16:56:50 [7/30/96 14:45:22]
  14.  
  15.  
  16.  
  17. //   IDL interface spec for CORBA Basic Object Adapter.
  18. //
  19. //   This is an abstract class which defines the CORBA-defined interface
  20. //   for a Basic Object Adapter.
  21. //
  22. //   The SOM Object Adapter interface is derived from this one.
  23. //   SOMOA provides the actual implementation in DSOM.
  24.  
  25.  
  26.  
  27. #ifndef boa_idl
  28. #define boa_idl
  29.  
  30. #include <somobj.idl>
  31. #include <somdtype.idl>
  32. #include <snglicls.idl>
  33.  
  34. interface SOMDObject;
  35. interface Principal;
  36. interface ImplementationDef;
  37. interface InterfaceDef;
  38. interface Context;
  39.  
  40.  
  41. interface BOA : SOMObject
  42. {
  43.   SOMDObject create(in ReferenceData id, in InterfaceDef intf,
  44.             in ImplementationDef impl);
  45.   // Create an object reference.
  46.  
  47.   void dispose(in SOMDObject obj);
  48.   // Destroy an object reference.
  49.  
  50.   ReferenceData get_id(in SOMDObject obj);
  51.   // Return ReferenceData associated with referenced object.
  52.  
  53.   Principal get_principal(in SOMDObject obj, in Environment req_ev);
  54.   // Return a Principal object, which describes who issued a request on
  55.   // the specified object.  The "req_ev" parameter is the Environment
  56.   // which was passed as part of the request.
  57.  
  58.   void set_exception(in exception_type major, in string userid, in void *param);
  59.   // Return an exception to the client.
  60.  
  61.   void impl_is_ready(in ImplementationDef impl);
  62.   // Indicate that the implementation is now ready to process requests.
  63.  
  64.   void deactivate_impl(in ImplementationDef impl);
  65.   // Indicate that the implementation is no longer ready to process reqs.
  66.  
  67.   void change_implementation(in SOMDObject obj, in ImplementationDef impl);
  68.   // Change the implementation associated with the referenced object.
  69.   // (NOTE: Null implementation in this release of DSOM.)
  70.  
  71.   void obj_is_ready(in SOMDObject obj, in ImplementationDef impl);
  72.   // Indicate that the object is ready to process requests.
  73.   // (NOTE: Null implementation in this release of DSOM.)
  74.  
  75.   void deactivate_obj(in SOMDObject obj);
  76.   // Indicate that the object is no longer ready to process requests.
  77.   // (NOTE: Null implementation in this release of DSOM.)
  78.  
  79.  
  80. #ifdef __SOMIDL__
  81.  
  82.   implementation
  83.   {
  84.     releaseorder: create, dispose, get_id,
  85.                   change_implementation,
  86.           get_principal, set_exception,
  87.           impl_is_ready, deactivate_impl,
  88.           obj_is_ready, deactivate_obj,
  89.           activate_impl, activate_obj;
  90.  
  91.     //# Class Modifiers
  92.     callstyle = idl;
  93.     metaclass = SOMMSingleInstance;
  94.     dllname = "somd.dll";
  95.     majorversion = 2;
  96.     minorversion = 1;
  97.   };
  98.  
  99. #endif /* __SOMIDL__ */
  100.  
  101. };
  102.  
  103. #endif  /* boa_idl */
  104.