This class is a container for the attributes necessary to create a Nirvana session.
More...
#include <nSessionAttributes.h>
Inherits Countable.
This class is a container for the attributes necessary to create a Nirvana session.
com::pcbsys::nirvana::client::nSessionAttributes::nSessionAttributes |
( |
const std::string & |
url, |
|
|
long |
initialConnectionRetry = 0 |
|
) |
| |
Constructs an nSessionAttributes object with the string URL specified and retry count for initial connection attempts.
- Parameters
-
url | A string in the form protocol://host:port e.g. nsp://127.0.0.1:9000 Protocol can be one of nsp, nhp, nsps, nhps |
initialConnectionRetry | A long specifying amount of times to retry for initial connection |
- Exceptions
-
com::pcbsys::nirvana::client::nSessionAttributes::nSessionAttributes |
( |
std::string * |
pUrls, |
|
|
int |
nUrl, |
|
|
long |
initialConnectionRetry = 0 |
|
) |
| |
Constructs an nSessionAttributes object with the collection of string URLs specified.
- Parameters
-
*pUrls | A string array, containing strings in the form protocol://host:port e.g. nsp://127.0.0.1:9000 Protocol can be one of nsp, nhp, nsps, nhps |
nUrl | The number of URLs |
initialConnectionRetry | A long specifying amount of times to retry for initial connection |
- Exceptions
-
const std::string com::pcbsys::nirvana::client::nSessionAttributes::getConnectionDetail |
( |
int |
idx | ) |
|
Returns the rname indexed by idx.
These where passed in when the initial nSession was created
- Parameters
-
idx | the index of the connection details to return |
- Returns
- String RNAME value
- Exceptions
-
Exception | If the index is out of bounds |
long com::pcbsys::nirvana::client::nSessionAttributes::getInitialConnectionRetryCount |
( |
| ) |
|
Gets the initial connection retry count.
- Returns
- a long specifying the number of retry attempts for establishing initial connection
int com::pcbsys::nirvana::client::nSessionAttributes::getNumberOfConnections |
( |
| ) |
|
Returns the number of protocols used by this nSession.
- Returns
- Number of rnames used by this nSession
bool com::pcbsys::nirvana::client::nSessionAttributes::isRequestPriorityConnection |
( |
| ) |
|
Queries the property which requests a priority connection to the server.
- Returns
- true if the request attribute is true, false otherwise.
void com::pcbsys::nirvana::client::nSessionAttributes::setInitialKeepAliveInterval |
( |
long |
timeMS | ) |
|
Sets the initial keep alive interval of the session.
- Parameters
-
timeMS | long specifies the initial keep alive interval (in milliseconds) of the first keep alive event sent to the server. |
void com::pcbsys::nirvana::client::nSessionAttributes::setRequestPriorityConnection |
( |
bool |
requestPriorityConnection | ) |
|
Sets the property which requests a priority connection to the server.
If this is true, sessions started with these session attributes will request their connection be a priority connection.
- Parameters
-
requestPriorityConnection | boolean set to true to request a priority connection, false for a normal connection. |