OPeNDAP Hyrax Back End Server (BES)  Updated for version 3.8.3
BESResponseHandler Class Referenceabstract

handler object that knows how to create a specific response object More...

#include <BESResponseHandler.h>

Inheritance diagram for BESResponseHandler:
Inheritance graph
Collaboration diagram for BESResponseHandler:
Collaboration graph

Public Member Functions

virtual void dump (ostream &strm) const
 dumps information about this object More...
 
virtual void execute (BESDataHandlerInterface &dhi)=0
 knows how to build a requested response object More...
 
virtual string get_name () const
 return the name of this response object More...
 
virtual BESResponseObjectget_response_object ()
 return the current response object More...
 
virtual BESResponseObjectset_response_object (BESResponseObject *o)
 replaces the current response object with the specified one, returning the current response object More...
 
virtual void transmit (BESTransmitter *transmitter, BESDataHandlerInterface &dhi)=0
 transmit the response object built by the execute command using the specified transmitter object More...
 
virtual ~BESResponseHandler (void)
 

Protected Member Functions

 BESResponseHandler (const string &name)
 

Protected Attributes

BESResponseObject_response
 
string _response_name
 

Detailed Description

handler object that knows how to create a specific response object

A response handler is something that knows how to create a response object, such as a DAS, DDS, DDX, informational response object. It knows how to construct the requested response object but does not necessarily fill in the response object. It does know, however, how to have other objects fill in the response object. For example, a BESDASResponseHandler knows that it needs to go to each of the request handlers (data handlers) for each of the containers requested so that those request handlers can fill in the response object. Another example is the BESHelpResponseHandler, which knows to construct an informational response object and then pass that informational response object to each registered request handler (data handler) so that each of the request handlers has an opportunity to add any help information it needs to add.

Response handlers such as the BESStatusResponseHandler (and others) are able to create the informational response object and fill it in without handing off the response object to any other object. But usually, the response handler passes the response object to another object to have it fill in the response object.

A response handler object also knows how to transmit the response object using a BESTransmitter object.

This is an abstract base class for response handlers. Derived classes implement the methods execute and transmit.

See also
BESResponseObject
BESContainer
BESRequestHandler
BESResponseHandlerList
BESTransmitter

Definition at line 81 of file BESResponseHandler.h.

Constructor & Destructor Documentation

BESResponseHandler::BESResponseHandler ( const string &  name)
protected

Definition at line 37 of file BESResponseHandler.cc.

BESResponseHandler::~BESResponseHandler ( void  )
virtual

Definition at line 43 of file BESResponseHandler.cc.

References _response.

Member Function Documentation

void BESResponseHandler::dump ( ostream &  strm) const
virtual

dumps information about this object

Displays the pointer value of this instance along with the name of this response handler and, if present, dumps the response object itself.

Parameters
strmC++ i/o stream to dump the information to

Implements BESObj.

Reimplemented in BESDefineResponseHandler, BESSetContainerResponseHandler, BESDDXResponseHandler, BESDelDefResponseHandler, BESDelDefsResponseHandler, BESSetContextResponseHandler, BESDataDDXResponseHandler, BESCatalogResponseHandler, BESDelContainersResponseHandler, BESHelpResponseHandler, BESShowContainersResponseHandler, BESDelContainerResponseHandler, BESShowContextResponseHandler, BESDASResponseHandler, BESDataResponseHandler, BESShowErrorResponseHandler, BESVersionResponseHandler, BESDDSResponseHandler, BESConfigResponseHandler, BESShowDefsResponseHandler, BESStatusResponseHandler, BESProcIdResponseHandler, BESServicesResponseHandler, and BESStreamResponseHandler.

Definition at line 74 of file BESResponseHandler.cc.

References _response, _response_name, BESResponseObject::dump(), BESIndent::Indent(), BESIndent::LMarg(), and BESIndent::UnIndent().

Referenced by BESStreamResponseHandler::dump(), BESServicesResponseHandler::dump(), BESProcIdResponseHandler::dump(), BESShowDefsResponseHandler::dump(), BESStatusResponseHandler::dump(), BESConfigResponseHandler::dump(), BESDDSResponseHandler::dump(), BESShowErrorResponseHandler::dump(), BESVersionResponseHandler::dump(), BESDataResponseHandler::dump(), BESDASResponseHandler::dump(), BESDelContainerResponseHandler::dump(), BESShowContextResponseHandler::dump(), BESDataDDXResponseHandler::dump(), BESShowContainersResponseHandler::dump(), BESDelContainersResponseHandler::dump(), BESHelpResponseHandler::dump(), BESCatalogResponseHandler::dump(), BESDelDefsResponseHandler::dump(), BESDDXResponseHandler::dump(), BESSetContextResponseHandler::dump(), BESDelDefResponseHandler::dump(), BESSetContainerResponseHandler::dump(), BESDefineResponseHandler::dump(), and BESDataHandlerInterface::dump().

Here is the call graph for this function:

virtual void BESResponseHandler::execute ( BESDataHandlerInterface dhi)
pure virtual

knows how to build a requested response object

Derived instances of this abstract base class know how to create a specific response object and what objects (including itself) to pass that response object to for it to be filled in.

Parameters
dhistructure that holds request and response information
Exceptions
BESHandlerExceptionif there is a problem building the response object
BESResponseExceptionupon fatal error building the response object
See also
BESDataHandlerInterface
BESResponseObject

Implemented in BESDefineResponseHandler, BESSetContainerResponseHandler, BESDDXResponseHandler, BESDelDefResponseHandler, BESDelDefsResponseHandler, BESSetContextResponseHandler, BESDataDDXResponseHandler, BESCatalogResponseHandler, BESDelContainersResponseHandler, BESHelpResponseHandler, BESShowContainersResponseHandler, BESDelContainerResponseHandler, BESShowContextResponseHandler, BESDASResponseHandler, BESDataResponseHandler, BESShowErrorResponseHandler, BESVersionResponseHandler, BESDDSResponseHandler, BESConfigResponseHandler, BESShowDefsResponseHandler, BESStatusResponseHandler, BESProcIdResponseHandler, BESServicesResponseHandler, and BESStreamResponseHandler.

Referenced by BESInterface::execute_data_request_plan().

virtual string BESResponseHandler::get_name ( ) const
inlinevirtual

return the name of this response object

This name is used to determine which response handler can handle a requested response, such as das, dds, ddx, tab, info, version, help, etc...

Returns
response name

Definition at line 156 of file BESResponseHandler.h.

References _response_name.

BESResponseObject * BESResponseHandler::get_response_object ( )
virtual

return the current response object

Returns the current response object, null if one has not yet been created. The response handler maintains ownership of the response object.

Returns
current response object
See also
BESResponseObject

Definition at line 53 of file BESResponseHandler.cc.

References _response.

Referenced by DapRequestHandler::dap_build_das(), DapRequestHandler::dap_build_data(), DapRequestHandler::dap_build_dds(), DapRequestHandler::dap_build_help(), BESDapRequestHandler::dap_build_help(), DapRequestHandler::dap_build_vers(), BESDapRequestHandler::dap_build_version(), and BESDataHandlerInterface::get_response_object().

BESResponseObject * BESResponseHandler::set_response_object ( BESResponseObject o)
virtual

replaces the current response object with the specified one, returning the current response object

This method is used to replace the response object with a new one, for example if during aggregation a new response object is built from the current response object.

The caller of set_response_object now owns the returned response object. The new response object is now owned by the response object.

Parameters
onew response object used to replace the current one
Returns
the response object being replaced
See also
BESResponseObject

Definition at line 59 of file BESResponseHandler.cc.

References _response.

virtual void BESResponseHandler::transmit ( BESTransmitter transmitter,
BESDataHandlerInterface dhi 
)
pure virtual

Member Data Documentation

BESResponseObject* BESResponseHandler::_response
protected

Definition at line 85 of file BESResponseHandler.h.

Referenced by dump(), BESStreamResponseHandler::execute(), BESServicesResponseHandler::execute(), BESProcIdResponseHandler::execute(), BESStatusResponseHandler::execute(), BESConfigResponseHandler::execute(), BESDDSResponseHandler::execute(), BESShowDefsResponseHandler::execute(), BESDataResponseHandler::execute(), BESDASResponseHandler::execute(), BESVersionResponseHandler::execute(), BESDelContainerResponseHandler::execute(), BESShowContextResponseHandler::execute(), BESHelpResponseHandler::execute(), BESDataDDXResponseHandler::execute(), BESDelContainersResponseHandler::execute(), BESShowContainersResponseHandler::execute(), BESCatalogResponseHandler::execute(), BESSetContextResponseHandler::execute(), BESDelDefResponseHandler::execute(), BESDelDefsResponseHandler::execute(), BESDDXResponseHandler::execute(), BESSetContainerResponseHandler::execute(), BESDefineResponseHandler::execute(), get_response_object(), set_response_object(), BESServicesResponseHandler::transmit(), BESProcIdResponseHandler::transmit(), BESShowDefsResponseHandler::transmit(), BESConfigResponseHandler::transmit(), BESDDSResponseHandler::transmit(), BESStatusResponseHandler::transmit(), BESDASResponseHandler::transmit(), BESVersionResponseHandler::transmit(), BESDataResponseHandler::transmit(), BESDelContainerResponseHandler::transmit(), BESShowContextResponseHandler::transmit(), BESShowContainersResponseHandler::transmit(), BESCatalogResponseHandler::transmit(), BESDataDDXResponseHandler::transmit(), BESHelpResponseHandler::transmit(), BESDelContainersResponseHandler::transmit(), BESDDXResponseHandler::transmit(), BESSetContextResponseHandler::transmit(), BESDelDefsResponseHandler::transmit(), BESDelDefResponseHandler::transmit(), BESSetContainerResponseHandler::transmit(), BESDefineResponseHandler::transmit(), and ~BESResponseHandler().

string BESResponseHandler::_response_name
protected

The documentation for this class was generated from the following files: