OPeNDAP Hyrax Back End Server (BES)  Updated for version 3.8.3
NCMLContainer Class Reference

Container representing a NCML request. More...

#include <NCMLContainer.h>

Inheritance diagram for NCMLContainer:
Inheritance graph
Collaboration diagram for NCMLContainer:
Collaboration graph

Public Member Functions

virtual string access ()
 access the NCML target response by making the NCML request More...
 
virtual void dump (ostream &strm) const
 dumps information about this object More...
 
string get_attributes () const
 retrieve the attributes desired from this container More...
 
string get_constraint () const
 retrieve the constraint expression for this container More...
 
string get_container_type () const
 retrieve the type of data this container holds, such as cedar or netcdf. More...
 
string get_dap4_constraint () const
 retrieve the constraint expression for this container More...
 
string get_dap4_function () const
 retrieve the constraint expression for this container More...
 
string get_real_name () const
 retrieve the real name for this container, such as a file name. More...
 
string get_symbolic_name () const
 retrieve the symbolic name for this container More...
 
 NCMLContainer (const string &sym_name, const string &real_name)
 Creates an instances of NCMLContainer with the symbolic name and the xml document string. More...
 
 NCMLContainer (const NCMLContainer &copy_from)
 
virtual BESContainerptr_duplicate ()
 pure abstract method to duplicate this instances of BESContainer More...
 
virtual bool release ()
 release the NCML cached resources More...
 
void set_attributes (const string &attrs)
 set desired attributes for this container More...
 
void set_constraint (const string &s)
 set the constraint for this container More...
 
void set_container_type (const string &type)
 set the type of data that this container represents, such as cedar or netcdf. More...
 
void set_dap4_constraint (const string &s)
 set the constraint for this container More...
 
void set_dap4_function (const string &s)
 set the constraint for this container More...
 
void set_real_name (const string &real_name)
 set the real name for this container, such as a file name if reading a data file. More...
 
virtual ~NCMLContainer ()
 

Protected Member Functions

void _duplicate (NCMLContainer &copy_to)
 
void _duplicate (BESContainer &copy_to)
 duplicate this instance into the passed container More...
 

Detailed Description

Container representing a NCML request.

The real name of a NCMLContainer is the actual NCML request. When the access method is called the NCML request is made, the response cached if successfull, and the target response returned as the real container that a data handler would then open.

See also
NCMLContainerStorage

Definition at line 51 of file NCMLContainer.h.

Constructor & Destructor Documentation

NCMLContainer::NCMLContainer ( const string &  sym_name,
const string &  xml_doc 
)

Creates an instances of NCMLContainer with the symbolic name and the xml document string.

The xml document is contained within the DHI, so must be passed in here.

The type of the container is ncml. This way we know to use the ncml handler for this container.

Parameters
sym_namesymbolic name representing this NCML container
ncml_docstring of the xml document
See also
NCMLGatewayUtils

Definition at line 68 of file NCMLContainer.cc.

NCMLContainer::NCMLContainer ( const NCMLContainer copy_from)

Definition at line 73 of file NCMLContainer.cc.

NCMLContainer::~NCMLContainer ( )
virtual

Definition at line 103 of file NCMLContainer.cc.

References release().

Here is the call graph for this function:

Member Function Documentation

void NCMLContainer::_duplicate ( NCMLContainer copy_to)
protected

Definition at line 84 of file NCMLContainer.cc.

References BESContainer::_duplicate().

Referenced by ptr_duplicate().

Here is the call graph for this function:

void BESContainer::_duplicate ( BESContainer copy_to)
protectedinherited

duplicate this instance into the passed container

Parameters
copy_toThe container to copy this instance into

Definition at line 50 of file BESContainer.cc.

Referenced by _duplicate(), GatewayContainer::_duplicate(), BESFileContainer::_duplicate(), and BESFileContainer::ptr_duplicate().

string NCMLContainer::access ( )
virtual

access the NCML target response by making the NCML request

Returns
full path to the NCML request response data file
Exceptions
BESErrorif there is a problem making the NCML request

Implements BESContainer.

Definition at line 115 of file NCMLContainer.cc.

References BESDEBUG, and NCMLContainerStorage::NCML_TempDir.

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

dumps information about this object

Displays the pointer value of this instance along with information about this container.

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

Reimplemented from BESContainer.

Definition at line 191 of file NCMLContainer.cc.

References BESContainer::dump(), BESIndent::Indent(), BESIndent::LMarg(), and BESIndent::UnIndent().

Here is the call graph for this function:

string BESContainer::get_attributes ( ) const
inlineinherited

retrieve the attributes desired from this container

Returns
attributes desired from this container

Definition at line 217 of file BESContainer.h.

string BESContainer::get_constraint ( ) const
inlineinherited
string BESContainer::get_container_type ( ) const
inlineinherited

retrieve the type of data this container holds, such as cedar or netcdf.

Returns
type of data this container represents, such as cedar or netcdf

Definition at line 208 of file BESContainer.h.

Referenced by GatewayContainer::access(), BESContainerStorageVolatile::add_container(), BESRequestHandlerList::execute_current(), FONcTransform::FONcTransform(), BESContainerStorageVolatile::isData(), BESContainerStorageFile::isData(), and BESContainerStorageVolatile::show_containers().

string BESContainer::get_dap4_constraint ( ) const
inlineinherited

retrieve the constraint expression for this container

Returns
constraint expression for this execution for the symbolic name

Definition at line 179 of file BESContainer.h.

Referenced by BESDapResponse::set_dap4_constraint().

string BESContainer::get_dap4_function ( ) const
inlineinherited

retrieve the constraint expression for this container

Returns
constraint expression for this execution for the symbolic name

Definition at line 188 of file BESContainer.h.

Referenced by BESDapResponse::set_dap4_function().

string BESContainer::get_real_name ( ) const
inlineinherited

retrieve the real name for this container, such as a file name.

Returns
real name, such as file name

Definition at line 161 of file BESContainer.h.

Referenced by GatewayContainer::access(), BESFileContainer::access(), BESRequestHandlerList::execute_current(), and BESContainerStorageVolatile::show_containers().

BESContainer * NCMLContainer::ptr_duplicate ( )
virtual

pure abstract method to duplicate this instances of BESContainer

Implements BESContainer.

Definition at line 96 of file NCMLContainer.cc.

References _duplicate().

Here is the call graph for this function:

bool NCMLContainer::release ( )
virtual

release the NCML cached resources

Release the resource

Returns
true if the resource is released successfully and false otherwise

Implements BESContainer.

Definition at line 174 of file NCMLContainer.cc.

Referenced by ~NCMLContainer().

void BESContainer::set_attributes ( const string &  attrs)
inlineinherited

set desired attributes for this container

Parameters
attrsattributes desired to access for this container

Definition at line 151 of file BESContainer.h.

Referenced by BESXMLDefineCommand::prep_request().

void BESContainer::set_constraint ( const string &  s)
inlineinherited
void BESContainer::set_container_type ( const string &  type)
inlineinherited

set the type of data that this container represents, such as cedar or netcdf.

Parameters
typetype of data, such as cedar or netcdf

Definition at line 142 of file BESContainer.h.

Referenced by GatewayContainer::access(), and GatewayContainer::GatewayContainer().

void BESContainer::set_dap4_constraint ( const string &  s)
inlineinherited

set the constraint for this container

Parameters
sconstraint

Definition at line 113 of file BESContainer.h.

Referenced by BESXMLDefineCommand::prep_request().

void BESContainer::set_dap4_function ( const string &  s)
inlineinherited

set the constraint for this container

Parameters
sconstraint

Definition at line 122 of file BESContainer.h.

Referenced by BESXMLDefineCommand::prep_request().

void BESContainer::set_real_name ( const string &  real_name)
inlineinherited

set the real name for this container, such as a file name if reading a data file.

Parameters
real_namereal name, such as the file name

Definition at line 132 of file BESContainer.h.


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