version 1.2, 2002/01/18 19:27:48
|
version 1.50.12.3, 2006/06/30 02:52:02
|
|
|
//%////-*-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) | // Author: Mike Day (mdday@us.ibm.com) |
// | // |
// Modified By: |
// Modified By: David Dillard, VERITAS Software Corp. |
|
// (david.dillard@veritas.com) |
|
// Jim Wunderlich (Jim_Wunderlich@prodigy.net) |
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
|
|
| |
#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/IPC.h> |
#include <Pegasus/Common/Thread.h> | #include <Pegasus/Common/Thread.h> |
#include <Pegasus/Common/AsyncOpNode.h> | #include <Pegasus/Common/AsyncOpNode.h> |
#include <Pegasus/Common/Cimom.h> | #include <Pegasus/Common/Cimom.h> |
#include <Pegasus/Common/CimomMessage.h> | #include <Pegasus/Common/CimomMessage.h> |
|
#include <Pegasus/Common/Linkage.h> |
|
#include <Pegasus/Common/RecursiveMutex.h> |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
|
extern const Uint32 CIMOM_Q_ID; |
| |
class PEGASUS_COMMON_LINKAGE MessageQueueService : public MessageQueue |
class message_module; |
|
|
|
class PEGASUS_COMMON_LINKAGE MessageQueueService : |
|
public Linkable, public MessageQueue |
{ | { |
public: | public: |
| |
typedef MessageQueue Base; | typedef MessageQueue Base; |
| |
MessageQueueService(const char *name, Uint32 queueID, Uint32 capabilities, Uint32 mask) ; |
MessageQueueService(const char *name, |
|
Uint32 queueID = MessageQueue::getNextQueueId(), |
|
Uint32 capabilities = 0, |
|
Uint32 mask = message_mask::type_cimom | |
|
message_mask::type_service | |
|
message_mask::ha_request | |
|
message_mask::ha_reply | |
|
message_mask::ha_async ); |
|
|
|
virtual ~MessageQueueService(); |
|
|
|
virtual Boolean isAsync() const { return true; } |
|
|
|
// enqueue may throw an IPCException |
|
virtual void enqueue(Message *); |
|
|
|
AsyncReply *SendWait(AsyncRequest *request); |
|
Boolean SendAsync(AsyncOpNode *op, |
|
Uint32 destination, |
|
void (*callback)(AsyncOpNode *, MessageQueue *, void *), |
|
MessageQueue *callback_q, |
|
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 ForwardOp(AsyncOpNode *, Uint32 destination); |
|
|
|
|
|
Boolean register_service(String name, Uint32 capabilities, Uint32 mask); |
|
Boolean update_service(Uint32 capabilities, Uint32 mask); |
|
Boolean deregister_service(); |
|
virtual void _shutdown_incoming_queue(); |
|
|
|
void find_services(String name, |
|
Uint32 capabilities, |
|
Uint32 mask, |
|
Array<Uint32> *results); |
|
void enumerate_service(Uint32 queue, message_module *result); |
|
Uint32 get_next_xid(); |
|
static AsyncOpNode *get_op(); |
|
void return_op(AsyncOpNode *op); |
|
|
|
Boolean operator ==(const MessageQueueService & svce) const |
|
{ |
|
return operator==((const void *)&svce); |
|
} |
| |
virtual ~MessageQueueService(void); |
Boolean operator ==(const void *svce) const |
|
{ |
|
if((const void *)this == svce) |
|
return true; |
|
return false; |
|
} |
|
|
|
static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL polling_routine(void *); |
|
static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL kill_idle_threads(void *); |
|
static ThreadPool *get_thread_pool(); |
|
|
|
Uint32 _mask; |
|
AtomicInt _die; |
|
AtomicInt _threads; |
|
Uint32 getIncomingCount() {return _incoming.count(); } |
|
|
|
protected: |
|
virtual Boolean accept_async(AsyncOpNode *op); |
|
virtual Boolean messageOK(const Message *msg); |
|
virtual void handleEnqueue() = 0; |
|
virtual void handleEnqueue(Message *) = 0; |
|
Boolean _enqueueResponse(Message *, Message *); |
|
// virtual void _handle_incoming_operation(AsyncOpNode *operation, Thread *thread, MessageQueue *queue); |
|
virtual void _handle_incoming_operation(AsyncOpNode *); |
|
|
|
virtual void _handle_async_request(AsyncRequest *req); |
|
virtual void _handle_async_callback(AsyncOpNode *operation); |
|
virtual void _make_response(Message *req, Uint32 code); |
| |
// don't allow derived classes to override |
|
void handleEnqueue(); |
|
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); |
| |
|
|
virtual void handle_CimServiceResume(CimServiceResume *req); | virtual void handle_CimServiceResume(CimServiceResume *req); |
| |
virtual void handle_AsyncOperationStart(AsyncOperationStart *req); | virtual void handle_AsyncOperationStart(AsyncOperationStart *req); |
virtual void handle_AsyncOperationResult(AsyncOperationResult *req); |
virtual void handle_AsyncOperationResult(AsyncOperationResult *rep); |
|
virtual void handle_AsyncLegacyOperationStart(AsyncLegacyOperationStart *req); |
// virtual Boolean accept_async(Message *message) throw(IPCException); |
virtual void handle_AsyncLegacyOperationResult(AsyncLegacyOperationResult *rep); |
// virtual Boolean messageOK(const Message *msg) ; |
|
| |
// virtual Message *openEnvelope(Message *msg); |
void _completeAsyncResponse(AsyncRequest *request, |
|
|
AsyncMessage *SendWait(AsyncRequest *request); |
|
|
|
void SendWait(AsyncRequest *request, unlocked_dq<AsyncMessage> *reply_list); |
|
// Boolean SendAsync(AsyncMessage *msg); |
|
void _enqueueAsyncResponse(AsyncRequest *request, |
|
AsyncReply *reply, | AsyncReply *reply, |
Uint32 state, | Uint32 state, |
Uint32 flag); | Uint32 flag); |
Boolean register_service(String name, Uint32 capabilities, Uint32 mask); |
void _complete_op_node(AsyncOpNode *, Uint32, Uint32, Uint32); |
Boolean update_service(Uint32 capabilities, Uint32 mask); |
|
Boolean deregister_service(void); |
|
| |
void find_services(String name, |
static cimom *_meta_dispatcher; |
Uint32 capabilities, |
static AtomicInt _service_count; |
Uint32 mask, |
static Mutex _meta_dispatcher_mutex; |
Array<Uint32> *results); |
|
void enumerate_service(Uint32 queue, message_module *result); |
|
Uint32 get_next_xid(void); |
|
AsyncOpNode *get_op(void); |
|
void return_op(AsyncOpNode *op); |
|
Uint32 _capabilities; |
|
Uint32 _mask; |
|
AtomicInt _die; |
|
protected: |
|
| |
// handle all your messages. call Base:_handle_async_msg to |
private: |
// deal with messages you don't handle |
AsyncQueue<AsyncOpNode> _incoming; |
virtual void _handle_async_msg(AsyncMessage *msg); |
static Thread* _polling_thread; |
|
static Semaphore _polling_sem; |
|
static AtomicInt _stop_polling; |
|
static AtomicInt _check_idle_flag; |
| |
|
static List<MessageQueueService, RecursiveMutex> _polling_list; |
| |
cimom *_meta_dispatcher; |
static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL _req_proc(void *); |
private: |
|
| |
|
static void _sendwait_callback(AsyncOpNode *, MessageQueue *, void *); |
| |
struct timeval _default_op_timeout; |
AtomicInt _incoming_queue_shutdown; |
| |
static AtomicInt _xid; |
protected: |
void _handle_async_request(AsyncRequest *req); |
static ThreadPool *_thread_pool; |
void _handle_async_reply(AsyncReply *rep); |
|
void _make_response(AsyncRequest *req, Uint32 code); |
private: |
|
struct timeval _default_op_timeout; |
|
static Mutex _xidMutex; |
|
static Uint32 _xid; |
|
friend class cimom; |
|
friend class CIMServer; |
}; | }; |
| |
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |
| |
#endif /* Pegasus_MessageQueue_Service_h */ | #endif /* Pegasus_MessageQueue_Service_h */ |
|
|
|
|