(file) Return to ModuleController.h CVS log (file) (dir) Up to [Pegasus] / pegasus / src / Pegasus / Common

Diff for /pegasus/src/Pegasus/Common/ModuleController.h between version 1.7 and 1.17

version 1.7, 2002/03/22 19:51:37 version 1.17, 2002/04/01 22:58:52
Line 38 
Line 38 
 #include <Pegasus/Common/Cimom.h> #include <Pegasus/Common/Cimom.h>
 #include <Pegasus/Common/CimomMessage.h> #include <Pegasus/Common/CimomMessage.h>
 #include <Pegasus/Common/MessageQueueService.h> #include <Pegasus/Common/MessageQueueService.h>
   #include <Pegasus/Common/peg_authorization.h>
   
   
 PEGASUS_NAMESPACE_BEGIN PEGASUS_NAMESPACE_BEGIN
  
 class ModuleController; class ModuleController;
  
       class PEGASUS_COMMON_LINKAGE module_rep  
   class PEGASUS_COMMON_LINKAGE pegasus_module : pegasus_authorization_handle
   {
      private:
         class module_rep
       {       {
          public:          public:
             module_rep(ModuleController *controller,             module_rep(ModuleController *controller,
                        const String & name,                        const String & name,
                        void *module_address,                        void *module_address,
                        Message * (*receive_message)(Message *),                         Message * (*receive_message)(Message *, void *),
                        void (*async_callback)(Uint32, Message *),                         void (*async_callback)(Uint32, Message *, void *),
                        void (*shutdown_notify)(Uint32 code))                         void (*shutdown_notify)(Uint32 code, void *));
                : _thread_safety(),  
                  _controller(controller),  
                  _name(name),  
                  _reference_count(1),  
                  _shutting_down(0),  
                  _module_address(module_address)  
  
             {              ~module_rep(void) ;
                if(receive_message != NULL)  
                   _receive_message = receive_message;  
                else  
                   _receive_message = default_receive_message;  
                if(async_callback != NULL)  
                   _async_callback = async_callback;  
                else  
                   _async_callback = default_async_callback;  
                if(shutdown_notify != NULL)  
                   _shutdown_notify = shutdown_notify;  
                else  
                   _shutdown_notify = default_shutdown_notify;  
             }  
   
             ~module_rep(void)  
             {  
   
             }  
  
             Boolean operator == (const module_rep *rep) const             Boolean operator == (const module_rep *rep) const
             {              { if (rep == this ) return true; return false; }
                if (rep == this )  
                   return true;  
                return false;  
             }  
  
             Boolean operator == (const module_rep &rep) const             Boolean operator == (const module_rep &rep) const
             {              { if (rep == *this) return true; return false; }
                if (rep == *this)  
                   return true;  
                return false;  
             }  
  
             Boolean operator == (void *rep) const             Boolean operator == (void *rep) const
             {              { if ( (void *)this == rep ) return true; return false; }
                if ( (void *)this == rep )  
                   return true;  
                return false;  
             }  
  
             void reference(void) { _reference_count++; }             void reference(void) { _reference_count++; }
             void dereference(void) { _reference_count--; }             void dereference(void) { _reference_count--; }
             Uint32 reference_count(void)  { return _reference_count.value(); }             Uint32 reference_count(void)  { return _reference_count.value(); }
             const String & get_name(void) const { return _name; }             const String & get_name(void) const { return _name; }
             void *get_module_address(void) const { return _module_address; }             void *get_module_address(void) const { return _module_address; }
             Message * module_receive_message(Message *msg)  
             {  
                Message * ret;  
                _thread_safety.lock(pegasus_thread_self());  
                try {  ret = _receive_message(msg); }  
                catch(...) { _thread_safety.unlock(); throw; }  
                _thread_safety.unlock();  
                return ret;  
             }  
  
             void _send_async_callback(Uint32 msg_handle, Message *msg)              Message * module_receive_message(Message *msg);
             {  
                _thread_safety.lock(pegasus_thread_self());  
                try  { _async_callback(msg_handle, msg); }  
                catch(...) { _thread_safety.unlock(); throw; }  
   
             }  
             void _send_shutdown_notify(Uint32 code)  
             {  
                _thread_safety.lock(pegasus_thread_self());  
                if( _shutting_down == 0 )  
                {  
                   _shutting_down++;  
                   _shutdown_notify(code);  
                }  
                _thread_safety.unlock();  
             }  
             void lock(void)  
             {  
                _thread_safety.lock(pegasus_thread_self());  
             }  
  
             void unlock(void)              void _send_async_callback(Uint32 msg_handle, Message *msg);
             {  
                _thread_safety.unlock();  
             }  
  
               void _send_shutdown_notify(void);
               void lock(void) { _thread_safety.lock(pegasus_thread_self()); }
               void unlock(void) { _thread_safety.unlock(); }
          private:          private:
             module_rep(void);             module_rep(void);
             module_rep(const module_rep & );             module_rep(const module_rep & );
             module_rep& operator= (const module_rep & );              module_rep & operator= (const module_rep & rep);
   
  
             Mutex _thread_safety;             Mutex _thread_safety;
             ModuleController *_controller;             ModuleController *_controller;
             String _name;             String _name;
             AtomicInt _reference_count;             AtomicInt _reference_count;
             Uint32 _shutting_down;              AtomicInt _shutting_down;
  
             void *_module_address;             void *_module_address;
             Message * (*_receive_message)(Message *);              Message * (*_receive_message)(Message *, void *);
             void (*_async_callback)(Uint32, Message *);              void (*_async_callback)(Uint32, Message *, void *);
             void (*_shutdown_notify)(Uint32 code);              void (*_shutdown_notify)(Uint32 code, void *);
  
             static Message * default_receive_message(Message *msg)              static Message * default_receive_message(Message *msg, void *inst)
             {              { throw NotImplemented("Module Receive");}
                throw NotImplemented("Module Receive");  
             }  
  
             static void default_async_callback(Uint32 handle, Message *msg)              static void default_async_callback(Uint32 handle, Message *msg, void *inst)
             {              { throw NotImplemented("Module Async Receive"); }
                throw NotImplemented("Module Async Receive");  
             }  
  
             static void default_shutdown_notify(Uint32 code)              static void default_shutdown_notify(Uint32 code, void *inst)
             {              { return; }
                return;  
             }  
  
             friend class ModuleController;              static Message * closed_receive_message(Message *msg, void *inst)
       };              { throw ModuleClosed();}
  
               static void closed_async_callback(Uint32 handle, Message *msg, void *inst)
               { throw ModuleClosed(); }
  
 class PEGASUS_COMMON_LINKAGE pegasus_module              friend class ModuleController;
 {        };
  
    public:    public:
         typedef pegasus_authorization_handle Base;
  
       pegasus_module(ModuleController *controller,       pegasus_module(ModuleController *controller,
                      const String &id,                      const String &id,
                      void *module_address,                      void *module_address,
                      Message * (*receive_message)(Message *),                       Message * (*receive_message)(Message *, void *),
                      void (*async_callback)(Uint32, Message *),                       void (*async_callback)(Uint32, Message *, void *),
                      void (*shutdown_notify)(Uint32 code)) ;                       void (*shutdown_notify)(Uint32 code, void *)) ;
   
       ~pegasus_module(void)  
       {  
          _rep->dereference();  
          if( 0 == _rep->reference_count())  
             delete _rep;  
       }  
  
         pegasus_module(const pegasus_module & mod);
       pegasus_module & operator= (const pegasus_module & mod);       pegasus_module & operator= (const pegasus_module & mod);
   
         ~pegasus_module(void);
   
         virtual Boolean authorized(pegasus_base_identity *id, Uint32 operation);
         virtual Boolean authorized(pegasus_base_identity *id);
   
       Boolean operator == (const pegasus_module *mod) const;       Boolean operator == (const pegasus_module *mod) const;
       Boolean operator == (const pegasus_module & mod) const ;       Boolean operator == (const pegasus_module & mod) const ;
       Boolean operator == (const String &  mod) const;       Boolean operator == (const String &  mod) const;
Line 206 
Line 146 
       // introspection interface       // introspection interface
       Boolean query_interface(const String & class_id, void **object_ptr) const;       Boolean query_interface(const String & class_id, void **object_ptr) const;
  
    private:  
  
      private:
         pegasus_base_identity *_id;
       module_rep *_rep;       module_rep *_rep;
   
       pegasus_module(void);       pegasus_module(void);
       pegasus_module(const pegasus_module & mod);  
       Boolean _rcv_msg(Message *) ;       Boolean _rcv_msg(Message *) ;
       Message * _receive_message(Message *msg)        Message * _receive_message(Message *msg);
       {        void _send_async_callback(Uint32 msg_handle, Message *msg) ;
          return _rep->module_receive_message(msg);        void _send_shutdown_notify(void);
       }        Boolean _shutdown(void);
         bitset<32> _allowed_operations;
       void _send_async_callback(Uint32 msg_handle, Message *msg)  
       {  
          _rep->_send_async_callback(msg_handle, msg);  
       }  
       void _send_shutdown_notify(Uint32 code)  
       {  
          _rep->_send_shutdown_notify(code);  
       }  
   
       Boolean _shutdown(Uint32 code) { _send_shutdown_notify(code); return true; }  
  
       void reference(void) { _rep->reference(); }       void reference(void) { _rep->reference(); }
       void dereference(void)  { _rep->dereference(); }       void dereference(void)  { _rep->dereference(); }
   
       friend class ModuleController;       friend class ModuleController;
 }; };
  
Line 238 
Line 168 
 class PEGASUS_COMMON_LINKAGE ModuleController : public MessageQueueService class PEGASUS_COMMON_LINKAGE ModuleController : public MessageQueueService
 { {
  
   
    public:    public:
       typedef MessageQueueService Base;       typedef MessageQueueService Base;
  
         static const Uint32 GET_CLIENT_HANDLE;
         static const Uint32 REGISTER_MODULE;
         static const Uint32 DEREGISTER_MODULE;
         static const Uint32 FIND_SERVICE;
         static const Uint32 FIND_MODULE_IN_SERVICE;
         static const Uint32 GET_MODULE_REFERENCE;
         static const Uint32 MODULE_SEND_WAIT;
         static const Uint32 MODULE_SEND_WAIT_MODULE;
         static const Uint32 MODULE_SEND_ASYNC;
         static const Uint32 MODULE_SEND_ASYNC_MODULE;
         static const Uint32 BLOCKING_THREAD_EXEC;
         static const Uint32 ASYNC_THREAD_EXEC;
         static const Uint32 CLIENT_SEND_WAIT;
         static const Uint32 CLIENT_SEND_WAIT_MODULE;
         static const Uint32 CLIENT_SEND_ASYNC;
         static const Uint32 CLIENT_SEND_ASYNC_MODULE;
         static const Uint32 CLIENT_BLOCKING_THREAD_EXEC;
         static const Uint32 CLIENT_ASYNC_THREAD_EXEC;
   
   
      private:
         class client_handle : pegasus_authorization_handle
         {
            public:
               typedef pegasus_authorization_handle Base;
   
               client_handle(void)
                  :Base(),
                   _id(new pegasus_internal_identity(peg_credential_types::SERVICE)),
                   allowed_operations( GET_CLIENT_HANDLE |
                                       FIND_SERVICE |
                                       FIND_MODULE_IN_SERVICE |
                                       GET_MODULE_REFERENCE |
                                       CLIENT_SEND_WAIT |
                                       CLIENT_SEND_WAIT_MODULE |
                                       CLIENT_SEND_ASYNC |
                                       CLIENT_SEND_ASYNC_MODULE |
                                       CLIENT_BLOCKING_THREAD_EXEC |
                                       CLIENT_ASYNC_THREAD_EXEC)
               {
   
               }
   
               client_handle(pegasus_base_identity *id)
                  :Base(), _id(id)
               {
                  if( id && (id->get_base_id_type() == peg_identity_types::INTERNAL ))
                  {
                     if (id->get_base_cred_type() == peg_credential_types::SERVICE )
                        allowed_operations = ModuleController::CLIENT_SEND_WAIT |
                                             ModuleController::CLIENT_SEND_WAIT_MODULE |
                                             ModuleController::CLIENT_SEND_ASYNC |
                                             ModuleController::CLIENT_SEND_ASYNC_MODULE |
                                             ModuleController::CLIENT_BLOCKING_THREAD_EXEC |
                                             ModuleController::CLIENT_ASYNC_THREAD_EXEC;
                     else
                        allowed_operations = 0;
                  }
   
               }
               ~client_handle(void)
               {
                  delete _id;
               }
   
               virtual Boolean authorized(Uint32 operation);
               virtual Boolean authorized(void);
   
            private:
               pegasus_base_identity *_id;
               bitset<64> allowed_operations;
         };
   
      public:
   
   
       ModuleController(const char *name);       ModuleController(const char *name);
       ModuleController(const char *name,       ModuleController(const char *name,
                        Sint16 min_threads,                        Sint16 min_threads,
Line 252 
Line 259 
  
       ~ModuleController(void);       ~ModuleController(void);
  
         static ModuleController & get_client_handle(const String & controller_name,
                                                     void **handle);
   
   
       // module api       // module api
       ModuleController & register_module(const String & module_name,        static ModuleController & register_module(const String & controller_name,
                                                   const String & module_name,
                                          void *module_address,                                          void *module_address,
                                          Message * (*receive_message)(Message *),                                                  Message * (*receive_message)(Message *, void *),
                                          void (*async_callback)(Uint32, Message *),                                                  void (*async_callback)(Uint32, Message *, void *),
                                          void (*shutdown_notify)(Uint32)) throw(AlreadyExists);                                                  void (*shutdown_notify)(Uint32, void *),
                                                   pegasus_module **instance = NULL)
            throw(AlreadyExists, IncompatibleTypes);
  
       Boolean deregister_module(const String & module_name);        Boolean deregister_module(const String & module_name)
            throw(Permission);
  
       Uint32 find_service(pegasus_module & handle, const String & name) throw(Permission);       Uint32 find_service(pegasus_module & handle, const String & name) throw(Permission);
  
Line 283 
Line 298 
                               String & destination_module,                               String & destination_module,
                               AsyncRequest *message) throw(Permission, Deadlock, IPCException);                               AsyncRequest *message) throw(Permission, Deadlock, IPCException);
  
       // send a message to another service        // send an async message to another service
       Boolean ModuleSendAsync(pegasus_module & handle,       Boolean ModuleSendAsync(pegasus_module & handle,
                               Uint32 msg_handle,                               Uint32 msg_handle,
                               Uint32 destination_q,                               Uint32 destination_q,
                               AsyncMessage *message) throw(Permission, IPCException);                                AsyncRequest *message) throw(Permission, IPCException);
  
       // send a message to another module via another service        // send an async message to another module via another service
       Boolean ModuleSendAsync(pegasus_module & handle,       Boolean ModuleSendAsync(pegasus_module & handle,
                               Uint32 msg_handle,                               Uint32 msg_handle,
                               Uint32 destination_q,                               Uint32 destination_q,
                               String & destination_module,                               String & destination_module,
                               AsyncMessage *message) throw(Permission, IPCException);                                AsyncRequest *message) throw(Permission, IPCException);
  
       void blocking_thread_exec(pegasus_module & handle,       void blocking_thread_exec(pegasus_module & handle,
                                 PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *thread_func)(void *),                                 PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *thread_func)(void *),
Line 302 
Line 317 
       void async_thread_exec(pegasus_module & handle,       void async_thread_exec(pegasus_module & handle,
                              PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *thread_func)(void *),                              PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *thread_func)(void *),
                              void *parm) throw(Permission, Deadlock, IPCException);                              void *parm) throw(Permission, Deadlock, IPCException);
   
       Boolean verify_handle(pegasus_module *);       Boolean verify_handle(pegasus_module *);
    protected:    protected:
         // ATTN-RK-P2-20010322:  These methods are pure virtual in superclass
         virtual void handleEnqueue(void) {}
         virtual void handleEnqueue(Message *) {}
         virtual void _handle_async_request(AsyncRequest *rq);
         virtual void _handle_async_callback(AsyncOpNode *op);
  
    private:    private:
   
   
       static void _async_handleEnqueue(AsyncOpNode *h, MessageQueue *q, void *parm);       static void _async_handleEnqueue(AsyncOpNode *h, MessageQueue *q, void *parm);
   
       DQueue<pegasus_module> _modules;       DQueue<pegasus_module> _modules;
       ThreadPool _thread_pool;       ThreadPool _thread_pool;
 }; };

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.17
No CVS admin address has been configured
 Powered by
ViewCVS 0.9.2