Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Namespace Members | Class Members | File Members

Request Class Reference

The Request class is a unicast message directed at a given module. More...

#include <modules.h>

Inheritance diagram for Request:

Inheritance graph
[legend]
Collaboration diagram for Request:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 Request (char *anydata, Module *src, Module *dst)
 Create a new Request.
char * GetData ()
 Fetch the Request data.
Module * GetSource ()
 Fetch the request source.
Module * GetDest ()
 Fetch the request destination (should be 'this' in the receiving module).
char * Send ()
 Send the Request.

Protected Attributes

char * data
 This member holds a pointer to arbitary data set by the emitter of the message.
Module * source
 This is a pointer to the sender of the message, which can be used to directly trigger events, or to create a reply.
Module * dest
 The single destination of the Request.

Detailed Description

The Request class is a unicast message directed at a given module.

When this class is properly instantiated it may be sent to a module using the Send() method, which will call the given module's OnRequest method with this class as its parameter.

Definition at line 157 of file modules.h.

Constructor & Destructor Documentation

Request::Request (  char *  anydata,
Module *  src,
Module *  dst
) 
 

Create a new Request.

Definition at line 252 of file modules.cpp.

00252 : data(anydata), source(src), dest(dst) { };

Member Function Documentation

char * Request::GetData (   ) 
 

Fetch the Request data.

Definition at line 254 of file modules.cpp.

References data.

00255 {
00256         return this->data;
00257 }

Module * Request::GetDest (   ) 
 

Fetch the request destination (should be 'this' in the receiving module).

Definition at line 264 of file modules.cpp.

References dest.

00265 {
00266         return this->dest;
00267 }

Module * Request::GetSource (   ) 
 

Fetch the request source.

Definition at line 259 of file modules.cpp.

References source.

00260 {
00261         return this->source;
00262 }

char * Request::Send (   )  [virtual]
 

Send the Request.

Upon returning the result will be arbitary data returned by the module you sent the request to. It is up to your module to know what this data is and how to deal with it.

Implements ModuleMessage.

Definition at line 269 of file modules.cpp.

References dest, and Module::OnRequest().

00270 {
00271         if (this->dest)
00272         {
00273                 return dest->OnRequest(this);
00274         }
00275         else
00276         {
00277                 return NULL;
00278         }
00279 }

Member Data Documentation

char* Request::data [protected]
 

This member holds a pointer to arbitary data set by the emitter of the message.

Definition at line 162 of file modules.h.

Referenced by GetData().

Module* Request::dest [protected]
 

The single destination of the Request.

Definition at line 169 of file modules.h.

Referenced by GetDest(), and Send().

Module* Request::source [protected]
 

This is a pointer to the sender of the message, which can be used to directly trigger events, or to create a reply.

Definition at line 166 of file modules.h.

Referenced by GetSource().

The documentation for this class was generated from the following files:
Generated on Fri Dec 9 20:20:12 2005 for InspIRCd by  doxygen 1.4.4-20050815