This class contains a persistent identifier for a node in a database exposed by a Wiretap server. More...
Public Member Functions | |
const char * | id () const |
Gets the persistent identifier for a node which is unique for a particular Wiretap server on a particular host. More... | |
bool | operator< (const WireTapNodeId &) const |
WireTapNodeId & | operator= (const WireTapNodeId &src) |
Default assignment operator. Returns a reference to the source object. More... | |
bool | operator== (const WireTapNodeId &) const |
void | setId (const char *idString) |
Sets the persistent identifier for a node which is unique for a particular Wiretap server on a particular host. More... | |
WireTapNodeId (const char *idString="") | |
Constructs a new WireTapNodeId object using a string or, if no string is specified, using an empty string. More... | |
WireTapNodeId (const WireTapStr &idObject) | |
Constructs a new WireTapNodeId object using a reference to a WireTapStr object. More... | |
WireTapNodeId (const WireTapNodeId &nodeId) | |
Copy constructor. More... | |
virtual | ~WireTapNodeId () |
Destructor. More... | |
This class contains a persistent identifier for a node in a database exposed by a Wiretap server.
The persistent identifier should be unique in the context of a particular instance of a particular Wiretap server. Each Wiretap server implementation is responsible for ensuring node IDs are unique.
WireTapNodeHandle uses the combination of this class (WireTapNodeId) and WireTapServerHandle to uniquely refer to a node.
Wiretap clients can store this ID in their own data structure for future reference. If there is a possibility that storage devices (on which nodes are located) will be switched from one Wiretap host to another, Wiretap clients should also retain the storage ID of the Wiretap server from which the client originally obtained an instance of WireTapNodeHandle for the node. See WireTapServerInfo.getStorageId.
WireTapNodeId::WireTapNodeId | ( | const char * | idString = "" | ) |
Constructs a new WireTapNodeId object using a string or, if no string is specified, using an empty string.
Normally, only Wiretap servers call this constructor.
idString | An input parameter. A string that is a persistent identifier for the node that is unique in the context of an instance of a particular Wiretap server. |
WireTapNodeId::WireTapNodeId | ( | const WireTapStr & | idObject | ) |
Constructs a new WireTapNodeId object using a reference to a WireTapStr object.
Normally, only Wiretap servers call this constructor.
idObject | An input parameter. A WireTapStr object that contains a a persistent identifier for the node that is unique in the context of an instance of a particular Wiretap server. |
WireTapNodeId::WireTapNodeId | ( | const WireTapNodeId & | nodeId | ) |
Copy constructor.
Constructs a new WireTapNodeId object that duplicates the content of the original.
nodeId | An input parameter. The WiretapNodeId object that is to be copied. |
|
virtual |
Destructor.
const char* WireTapNodeId::id | ( | ) | const |
Gets the persistent identifier for a node which is unique for a particular Wiretap server on a particular host.
bool WireTapNodeId::operator< | ( | const WireTapNodeId & | ) | const |
WireTapNodeId& WireTapNodeId::operator= | ( | const WireTapNodeId & | src | ) |
Default assignment operator. Returns a reference to the source object.
src | An input parameter. The WireTapNodeId object to which the reference should point. |
bool WireTapNodeId::operator== | ( | const WireTapNodeId & | ) | const |
void WireTapNodeId::setId | ( | const char * | idString | ) |
Sets the persistent identifier for a node which is unique for a particular Wiretap server on a particular host.
idString | An input parameter. A string that contains the persistent identifier for the node. The id should be unique among the nodes for an instance of a particular Wiretap server on a particular host. This parameter cannot be NULL. |
The following are not legal in a node ID: