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