rwsf::MessageHandler

rwsf::MessageHandler  rwsf::HandleBase

• Local Index
• Header File
• Description
• Public Constructors
• Public Destructor
• Public Operators
• Public Member Functions
• Global Macros

Members

destroy() init()

invoke() MessageHandler()

operator=() ~MessageHandler()

Non-Members

rwsf_DEFINE_MESSAGE_HANDLER()

rwsf_DEFINE_STATIC_MESSAGE_HANDLER()

#include <rw/rwsf/soapworx/MessageHandler.h> 

The handle class of all proxies, services, skeletons, loggers, and transports are either of type rwsf::MessageHandler or derive from it.

To create a new service handler, derive from the body rwsf::MessageHandlerImp and implement the method invoke(). For more information, see Chapter 15, "SOAP Message Handler SDK," in the HydraExpress Web Service Development Guide

rwsf::MessageHandler implements the handle idiom from the handle-body pattern, where the body is rwsf::MessageHandlerImp. An instance of this class is a handle to a private, reference-counted body. When a handle is copy-constructed, the new handle attaches to the same body as the original. When one handle is assigned to another handle, the handle on the left side detaches from its current body and attaches to the body pointed to by the handle on the right side. Logical operators return truth values based on whether the handles being compared point to the same body instance.

---

NOTE -- Handle methods that just call the corresponding method on the body are described only in the body class. For instance, if the handle class includes a method invoke() that calls the body's corresponding method Invoke(), that method is documented only in the body class.

---

MessageHandler();

Default constructor. Creates an empty handler. To create a valid handler, extend this class and implement the invoke() method.

MessageHandler(const MessageHandler& handler);

Copy constructor.

MessageHandler(MessageHandlerImp *impl);

Constructs a new handle attached to the body impl, and increments a reference count.

~MessageHandler();

Destructor

MessageHandler& 
operator=(const MessageHandler& obj);

Assignment operator.

void 
destroy();
void 
invoke(rwsf::CallInfo& callInfo);
void 
init(const rwsf::Config& initParams);

#define rwsf_DEFINE_MESSAGE_HANDLER(NAME)
#define rwsf_DEFINE_STATIC_MESSAGE_HANDLER(ID, NAME)

See Part II, "Global Reference."

©2004-2007 Copyright Quovadx, Inc. All Rights Reserved.
Quovadx and Rogue Wave are registered trademarks of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.