com::pcbsys::nirvana::client::nRealm Class Reference

This class represents a nirvana Realm. More...

#include <nRealm.h>

Public Member Functions

std::list< std::string > * getConnections ()
 Gets the collection of the network interfaces this realm listens in. More...
 
const std::string getMountPoint ()
 Returns the relative name of the realm within the namespace. More...
 
std::string getName ()
 Gets the name of this realm. More...
 
std::string * getProtocols (int &nString)
 Returns an array of Strings with the rnames for this realm. More...
 
 nRealm (void)
 Constructs a new nRealm object

Exceptions
nIllegalArgumentExceptionif the parameters are invalid, refer to the exception message for more information.

 
 nRealm (std::string name, std::string *pConnections, int nConnection)
 Constructs a new nRealm object with the specified name and collection of network interfaces. More...
 
 nRealm (std::string name, std::list< fConnectionDetails * > connections)
 Constructs a new nRealm object with the specified name and collection of network interfaces. More...
 
void setMountPoint (const std::string &mountPoint)
 Sets the relative name for the realm within the namespace. More...
 
void setName (std::string data)
 Sets the name on this realm. More...
 

Detailed Description

This class represents a nirvana Realm.

Constructor & Destructor Documentation

com::pcbsys::nirvana::client::nRealm::nRealm ( std::string  name,
std::string *  pConnections,
int  nConnection 
)

Constructs a new nRealm object with the specified name and collection of network interfaces.

Parameters
nameA string specifying the realm's name
pConnectionsAn array of strings specifying the realm's network interfaces.
nConnectionlength of the pConnections array These have to be in the form: protocol://host:port/servlet File , where:

Protocol can be one of nsp, nhp, nsps, nhps where:

nsp => Nirvana Socket Protocol nhp => Nirvana HTTP Protocol nsps => Nirvana Socket Protocol Secure (Socket protocol over SSL/TLS) nhps => Nirvana HTTP Protocol Secure (HTTP protocol over SSL/TLS)

Host is the host the realm is running on

Port is the port the realm is listening on

servlet File specifies the location that servlets are mapped if talking to the realm via a web server (e.g. in a DMZ environment)

Exceptions
nIllegalArgumentExceptionif the parameters are invalid, refer to the exception message for more information
com::pcbsys::nirvana::client::nRealm::nRealm ( std::string  name,
std::list< fConnectionDetails * >  connections 
)

Constructs a new nRealm object with the specified name and collection of network interfaces.

Parameters
nameA string specifying the realm's name
connectionsA list of fConnectionDetails objects. These are created using strings specifying the realm's network interfaces. The strings have to be in the form: protocol://host:port/servlet File , where: Protocol can be one of nsp, nhp, nsps, nhps where:

nsp => Nirvana Socket Protocol nhp => Nirvana HTTP Protocol nsps => Nirvana Socket Protocol Secure (Socket protocol over SSL/TLS) nhps => Nirvana HTTP Protocol Secure (HTTP protocol over SSL/TLS)

Host is the host the realm is running on

Port is the port the realm is listening on

servlet File specifies the location that servlets are mapped if talking to the realm via a web server (e.g. in a DMZ environment)

Exceptions
nIllegalArgumentExceptionif the parameters are invalid, refer to the exception message for more information

Member Function Documentation

std::list<std::string>* com::pcbsys::nirvana::client::nRealm::getConnections ( )

Gets the collection of the network interfaces this realm listens in.

Returns
A list containing an Strings of rnames for each realm interface.
const std::string com::pcbsys::nirvana::client::nRealm::getMountPoint ( )

Returns the relative name of the realm within the namespace.

Returns
String mount point name
std::string com::pcbsys::nirvana::client::nRealm::getName ( )

Gets the name of this realm.

Returns
A string specifying the name of this realm
std::string* com::pcbsys::nirvana::client::nRealm::getProtocols ( int &  nString)

Returns an array of Strings with the rnames for this realm.

Returns
the Protocols, or rnames, supported by this realm
void com::pcbsys::nirvana::client::nRealm::setMountPoint ( const std::string &  mountPoint)

Sets the relative name for the realm within the namespace.

Parameters
mountPointthe name to add this realm in the namespace
Exceptions
nIllegalArgumentExceptionIllegal parameter, check the message for more information
void com::pcbsys::nirvana::client::nRealm::setName ( std::string  data)

Sets the name on this realm.

Parameters
dataa string specifying the name of this realm
Exceptions
nIllegalArgumentExceptionIllegal parameter, check the message for more information