version 1.23, 2002/04/12 00:58:21
|
version 1.57, 2006/09/13 21:05:37
|
|
|
//%////-*-c++-*-//////////////////////////////////////////////////////////////// |
//%2006//////////////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001 The Open group, BMC Software, Tivoli Systems, IBM |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
|
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
|
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
|
// IBM Corp.; EMC Corporation, The Open Group. |
|
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
|
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; Symantec Corporation; The Open Group. |
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a copy | // Permission is hereby granted, free of charge, to any person obtaining a copy |
// of this software and associated documentation files (the "Software"), to | // of this software and associated documentation files (the "Software"), to |
|
|
// | // |
//============================================================================== | //============================================================================== |
// | // |
// Author: Mike Day (mdday@us.ibm.com) |
|
// |
|
// Modified By: |
|
// |
|
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
#ifndef Pegasus_MessageQueue_Service_h | #ifndef Pegasus_MessageQueue_Service_h |
|
|
| |
#include <Pegasus/Common/Config.h> | #include <Pegasus/Common/Config.h> |
#include <Pegasus/Common/Message.h> | #include <Pegasus/Common/Message.h> |
#include <Pegasus/Common/Exception.h> |
#include <Pegasus/Common/InternalException.h> |
#include <Pegasus/Common/IPC.h> |
|
#include <Pegasus/Common/Thread.h> | #include <Pegasus/Common/Thread.h> |
|
#include <Pegasus/Common/ThreadPool.h> |
#include <Pegasus/Common/AsyncOpNode.h> | #include <Pegasus/Common/AsyncOpNode.h> |
#include <Pegasus/Common/Cimom.h> | #include <Pegasus/Common/Cimom.h> |
|
#include <Pegasus/Common/Mutex.h> |
#include <Pegasus/Common/CimomMessage.h> | #include <Pegasus/Common/CimomMessage.h> |
|
#include <Pegasus/Common/Linkage.h> |
|
#include <Pegasus/Common/Mutex.h> |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
extern const Uint32 CIMOM_Q_ID; | extern const Uint32 CIMOM_Q_ID; |
| |
class message_module; | class message_module; |
|
class cimom; |
|
|
| |
class PEGASUS_COMMON_LINKAGE MessageQueueService : public MessageQueue |
class PEGASUS_COMMON_LINKAGE MessageQueueService : |
|
public Linkable, public MessageQueue |
{ | { |
public: | public: |
| |
typedef MessageQueue Base; | typedef MessageQueue Base; |
| |
MessageQueueService(const char *name, |
MessageQueueService( |
|
const char *name, |
Uint32 queueID = MessageQueue::getNextQueueId(), | Uint32 queueID = MessageQueue::getNextQueueId(), |
Uint32 capabilities = 0, | Uint32 capabilities = 0, |
Uint32 mask = message_mask::type_cimom | |
Uint32 mask = MessageMask::type_cimom | |
message_mask::type_service | |
MessageMask::type_service | |
message_mask::ha_request | |
MessageMask::ha_request | |
message_mask::ha_reply | |
MessageMask::ha_reply | |
message_mask::ha_async ) ; |
MessageMask::ha_async); |
| |
virtual ~MessageQueueService(void); |
virtual ~MessageQueueService(); |
| |
virtual Boolean isAsync(void) { return true; } |
virtual Boolean isAsync() const { return true; } |
| |
virtual void enqueue(Message *) throw(IPCException); |
// enqueue may throw an IPCException |
|
virtual void enqueue(Message *); |
| |
AsyncReply *SendWait(AsyncRequest *request); | AsyncReply *SendWait(AsyncRequest *request); |
Boolean SendAsync(AsyncOpNode *op, | Boolean SendAsync(AsyncOpNode *op, |
|
|
void (*callback)(AsyncOpNode *, MessageQueue *, void *), | void (*callback)(AsyncOpNode *, MessageQueue *, void *), |
MessageQueue *callback_q, | MessageQueue *callback_q, |
void *callback_ptr); | void *callback_ptr); |
|
|
|
Boolean SendAsync(Message *msg, |
|
Uint32 destination, |
|
void (*callback)(Message *response, void *handle, void *parameter), |
|
void *handle, |
|
void *parameter); |
|
|
Boolean SendForget(Message *msg); | Boolean SendForget(Message *msg); |
Boolean ForwardOp(AsyncOpNode *, Uint32 destination); | Boolean ForwardOp(AsyncOpNode *, Uint32 destination); |
| |
| |
Boolean register_service(String name, Uint32 capabilities, Uint32 mask); | Boolean register_service(String name, Uint32 capabilities, Uint32 mask); |
Boolean update_service(Uint32 capabilities, Uint32 mask); | Boolean update_service(Uint32 capabilities, Uint32 mask); |
Boolean deregister_service(void); |
Boolean deregister_service(); |
virtual void _shutdown_incoming_queue(void); |
virtual void _shutdown_incoming_queue(); |
| |
void find_services(String name, | void find_services(String name, |
Uint32 capabilities, | Uint32 capabilities, |
Uint32 mask, | Uint32 mask, |
Array<Uint32> *results); | Array<Uint32> *results); |
void enumerate_service(Uint32 queue, message_module *result); | void enumerate_service(Uint32 queue, message_module *result); |
Uint32 get_next_xid(void); |
static AsyncOpNode *get_op(); |
AsyncOpNode *get_op(void); |
|
void return_op(AsyncOpNode *op); | void return_op(AsyncOpNode *op); |
| |
|
static ThreadPool *get_thread_pool(); |
|
static void cleanupThreadPool(); |
|
|
Uint32 _mask; | Uint32 _mask; |
AtomicInt _die; | AtomicInt _die; |
|
AtomicInt _threads; |
|
Uint32 getIncomingCount() {return _incoming.count(); } |
|
|
protected: | protected: |
virtual Boolean accept_async(AsyncOpNode *op); | virtual Boolean accept_async(AsyncOpNode *op); |
virtual Boolean messageOK(const Message *msg) ; | virtual Boolean messageOK(const Message *msg) ; |
virtual void handleEnqueue(void) = 0; |
virtual void handleEnqueue() = 0; |
virtual void handleEnqueue(Message *) = 0; | virtual void handleEnqueue(Message *) = 0; |
Boolean _enqueueResponse(Message *, Message *); | Boolean _enqueueResponse(Message *, Message *); |
// virtual void _handle_incoming_operation(AsyncOpNode *operation, Thread *thread, MessageQueue *queue); | // virtual void _handle_incoming_operation(AsyncOpNode *operation, Thread *thread, MessageQueue *queue); |
|
|
virtual void _handle_async_callback(AsyncOpNode *operation); | virtual void _handle_async_callback(AsyncOpNode *operation); |
virtual void _make_response(Message *req, Uint32 code); | virtual void _make_response(Message *req, Uint32 code); |
| |
|
|
virtual void handle_heartbeat_request(AsyncRequest *req); | virtual void handle_heartbeat_request(AsyncRequest *req); |
virtual void handle_heartbeat_reply(AsyncReply *rep); | virtual void handle_heartbeat_reply(AsyncReply *rep); |
| |
|
|
Uint32 flag); | Uint32 flag); |
void _complete_op_node(AsyncOpNode *, Uint32, Uint32, Uint32); | void _complete_op_node(AsyncOpNode *, Uint32, Uint32, Uint32); |
| |
|
|
static cimom *_meta_dispatcher; | static cimom *_meta_dispatcher; |
static AtomicInt _service_count; | static AtomicInt _service_count; |
static Mutex _meta_dispatcher_mutex; | static Mutex _meta_dispatcher_mutex; |
|
static ThreadPool *_thread_pool; |
| |
private: | private: |
|
static ThreadReturnType PEGASUS_THREAD_CDECL polling_routine(void *); |
|
static ThreadReturnType PEGASUS_THREAD_CDECL kill_idle_threads(void *); |
|
|
|
AsyncQueue<AsyncOpNode> _incoming; |
|
static Thread* _polling_thread; |
|
static Semaphore _polling_sem; |
|
static AtomicInt _stop_polling; |
|
static AtomicInt _check_idle_flag; |
|
|
|
typedef List<MessageQueueService, Mutex> PollingList; |
|
static PollingList* _polling_list; |
|
static Mutex _polling_list_mutex; |
| |
DQueue<AsyncOpNode> _pending; |
PollingList* _get_polling_list(); |
AsyncDQueue<AsyncOpNode> _incoming; |
|
AsyncDQueue<AsyncOpNode> _callback; |
static ThreadReturnType PEGASUS_THREAD_CDECL _req_proc(void *); |
| |
static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL _req_proc(void *); |
|
static void _sendwait_callback(AsyncOpNode *, MessageQueue *, void *); | static void _sendwait_callback(AsyncOpNode *, MessageQueue *, void *); |
|
|
AtomicInt _incoming_queue_shutdown; | AtomicInt _incoming_queue_shutdown; |
Thread _req_thread; |
|
struct timeval _default_op_timeout; | struct timeval _default_op_timeout; |
static AtomicInt _xid; |
|
friend class cimom; | friend class cimom; |
}; | }; |
| |
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |
| |
#endif /* Pegasus_MessageQueue_Service_h */ | #endif /* Pegasus_MessageQueue_Service_h */ |
|
|
|
|