com.pcbsys.nirvana.client.nEventProperties Class Reference

This class contains a collection of key-value pairs, defining event meta data which can be used to create filter rules. More...

Public Member Functions

bool containsKey (string key)
 Returns true if the key is contained within the dictionary More...
 
void copy (nEventProperties p_dictionary)
 Copies the properties from one to this More...
 
object get (string key)
 Get the value as an Object More...
 
object get (object key)
 Get the value as an Object If the input paramter is not of type String, returns null More...
 
bool getBoolean (string key)
 Retrieves the data from the table based on the key as a bool More...
 
bool[] getBooleanArray (string key)
 Retrieves a bool[] from the properties More...
 
byte getByte (string key)
 Retrieves a byte by the name given More...
 
byte[] getByteArray (string key)
 Retrieves a byte[] from the dictionary More...
 
char getChar (string key)
 Retrieves a char from the properties More...
 
char[] getCharArray (string key)
 Retrieves a char[] from the properties More...
 
string getClass (string key)
 Get the class name of the value represented by the key More...
 
nEventProperties getDictionary (string key)
 Retrieve a nEventProperty from this one More...
 
nEventProperties[] getDictionaryArray (string key)
 Return an array of nEventProperties More...
 
double getDouble (string key)
 Retrieves the data from the table based on the key as a double More...
 
double[] getDoubleArray (string key)
 Retrieves a double[] from the properties More...
 
nEventPropertiesIterator getEntrySet ()
 Get an iterator of the key and values in an Map.Entry. More...
 
float getFloat (string key)
 Retrieves a float from the properties More...
 
float[] getFloatArray (string key)
 Retrieves a float[] from the properties More...
 
int getInt (string key)
 Retrieves an int from the properties More...
 
int[] getIntArray (string key)
 Gets an int[] from the properties More...
 
IEnumerator< string > getKeys ()
 Get an IEnumerator of keys More...
 
IEnumerator< string > getKeysAsStrings ()
 Get an IEnumerator of keys as Strings More...
 
long getLong (string key)
 Retrieves the data from the table based on the key as a long More...
 
long[] getLongArray (string key)
 Retrieves a long[] from the properties More...
 
short getShort (string key)
 Retrieves a short from the properties More...
 
short[] getShortArray (string key)
 Retrieves an array of shorts More...
 
int getSize ()
 Return the number of properties held More...
 
string getString (string key)
 Retrieves the data from the table based on the key as a string More...
 
string[] getStringArray (string key)
 Retrieves a String[] More...
 
IEnumerator< object > getValues ()
 Get an IEnumerator of values More...
 
bool isValid ()
 Returns true if the dictionary is consistent and contains no errors More...
 
void merge (nEventProperties props, bool overwrite)
 Adds the values from the supplied properties to this object. More...
 
 nEventProperties ()
 Default constructor
 
 nEventProperties (nEventProperties ed)
 Constructs an event properties object that is a copy of the specified event properties. More...
 
 nEventProperties (nEventProperties ed, bool copyNew)
 Constructs an event properties object that is a copy of the specified event properties, but depending on the copyNew, will construct new dictionary entries to prevent dictionary entries being overwritten by subsequent uses of the event object and event properties. More...
 
 nEventProperties (string serializedString)
 Constructor using a string from the .toString() method More...
 
void put (string key, nEventProperties value)
 Put an nEventproperties into this one to enable nested properties More...
 
void put (string key, nEventProperties[] value)
 Put an nEventProperies[] into this property to enable nested properties More...
 
void put (string key, string value)
 Places a key value pair into the dictionary More...
 
void put (string key, string[] value)
 Places a String[] into the properties More...
 
void put (string key, short s)
 places a short into the properties More...
 
void put (string key, short[] s)
 Places an array of shorts into the properties More...
 
void put (string key, byte b)
 Places a byte into the properties More...
 
void put (string key, byte[] b)
 Places a byte[] into the properties More...
 
void put (string key, char c)
 Puts a char into the properties More...
 
void put (string key, char[] c)
 Puts an array of chars into the properties More...
 
void put (string key, bool value)
 Places a key value pair into the dictionary More...
 
void put (string key, bool[] value)
 Places a bool[] into the properties More...
 
void put (string key, int value)
 Places a key value pair into the dictionary More...
 
void put (string key, int[] value)
 Places a int[] into the properties More...
 
void put (string key, long value)
 Places a key value pair into the dictionary More...
 
void put (string key, long[] value)
 Places a long[] into the properties More...
 
void put (string key, float value)
 Places a key value pair into the properties More...
 
void put (string key, float[] value)
 Puts a float[] into the properties More...
 
void put (string key, double value)
 Places a key value pair into the dictionary More...
 
void put (string key, double[] value)
 Places a double[] into the properties More...
 
void remove (string key)
 Removes the value index by the key More...
 
string ToString ()
 Converts this object into a string More...
 

Detailed Description

This class contains a collection of key-value pairs, defining event meta data which can be used to create filter rules.

Constructor & Destructor Documentation

com.pcbsys.nirvana.client.nEventProperties.nEventProperties ( nEventProperties  ed)

Constructs an event properties object that is a copy of the specified event properties.

Parameters
edthe event properties object to be copied
com.pcbsys.nirvana.client.nEventProperties.nEventProperties ( nEventProperties  ed,
bool  copyNew 
)

Constructs an event properties object that is a copy of the specified event properties, but depending on the copyNew, will construct new dictionary entries to prevent dictionary entries being overwritten by subsequent uses of the event object and event properties.

Parameters
edthe event properties object to be copied
copyNewre-construct the entries rather than copying the references to the new event properties
com.pcbsys.nirvana.client.nEventProperties.nEventProperties ( string  serializedString)

Constructor using a string from the .toString() method

Parameters
serializedStringserialized string used to construct the nEventProperties

Member Function Documentation

bool com.pcbsys.nirvana.client.nEventProperties.containsKey ( string  key)

Returns true if the key is contained within the dictionary

Parameters
keyName of the key to search for
Returns
True if the properties contains the key
void com.pcbsys.nirvana.client.nEventProperties.copy ( nEventProperties  p_dictionary)

Copies the properties from one to this

Parameters
p_dictionarydictionary to copy
object com.pcbsys.nirvana.client.nEventProperties.get ( string  key)

Get the value as an Object

Parameters
keyString key to return
Returns
Object of the value
object com.pcbsys.nirvana.client.nEventProperties.get ( object  key)

Get the value as an Object If the input paramter is not of type String, returns null

Parameters
keyString key to return
Returns
Object of the value
bool com.pcbsys.nirvana.client.nEventProperties.getBoolean ( string  key)

Retrieves the data from the table based on the key as a bool

Parameters
keyKey to reference the data
Returns
a bool with the value associated with this key
bool [] com.pcbsys.nirvana.client.nEventProperties.getBooleanArray ( string  key)

Retrieves a bool[] from the properties

Parameters
keyName of the bool[]
Returns
bool[]
byte com.pcbsys.nirvana.client.nEventProperties.getByte ( string  key)

Retrieves a byte by the name given

Parameters
keyName for the byte
Returns
byte value
byte [] com.pcbsys.nirvana.client.nEventProperties.getByteArray ( string  key)

Retrieves a byte[] from the dictionary

Parameters
keyname for the byte[]
Returns
byte[]
char com.pcbsys.nirvana.client.nEventProperties.getChar ( string  key)

Retrieves a char from the properties

Parameters
keyname of the char
Returns
char
char [] com.pcbsys.nirvana.client.nEventProperties.getCharArray ( string  key)

Retrieves a char[] from the properties

Parameters
keyname of the char array
Returns
char[]
string com.pcbsys.nirvana.client.nEventProperties.getClass ( string  key)

Get the class name of the value represented by the key

Parameters
keyString value to lookup
Returns
String class name of the value
nEventProperties com.pcbsys.nirvana.client.nEventProperties.getDictionary ( string  key)

Retrieve a nEventProperty from this one

Parameters
keyName of the nEventProperty
Returns
a nEventProperty
nEventProperties [] com.pcbsys.nirvana.client.nEventProperties.getDictionaryArray ( string  key)

Return an array of nEventProperties

Parameters
keyname of the array to return
Returns
nEventproperty[]
double com.pcbsys.nirvana.client.nEventProperties.getDouble ( string  key)

Retrieves the data from the table based on the key as a double

Parameters
keyKey to reference the data
Returns
a double with the value associated with this key
double [] com.pcbsys.nirvana.client.nEventProperties.getDoubleArray ( string  key)

Retrieves a double[] from the properties

Parameters
keyName of the double[]
Returns
double[]
nEventPropertiesIterator com.pcbsys.nirvana.client.nEventProperties.getEntrySet ( )

Get an iterator of the key and values in an Map.Entry.

Allows the user to get both the key and value from one iteration of the nEventProperties.

Returns
nEventPropertiesIterator Map.Entrys in the properties
float com.pcbsys.nirvana.client.nEventProperties.getFloat ( string  key)

Retrieves a float from the properties

Parameters
keyName of the float
Returns
float value
float [] com.pcbsys.nirvana.client.nEventProperties.getFloatArray ( string  key)

Retrieves a float[] from the properties

Parameters
keyName of the float[]
Returns
float[]
int com.pcbsys.nirvana.client.nEventProperties.getInt ( string  key)

Retrieves an int from the properties

Parameters
keyName of the int
Returns
int value
int [] com.pcbsys.nirvana.client.nEventProperties.getIntArray ( string  key)

Gets an int[] from the properties

Parameters
keyName of the int[]
Returns
int[]
IEnumerator<string> com.pcbsys.nirvana.client.nEventProperties.getKeys ( )

Get an IEnumerator of keys

Returns
IEnumerator of keys
IEnumerator<string> com.pcbsys.nirvana.client.nEventProperties.getKeysAsStrings ( )

Get an IEnumerator of keys as Strings

Returns
an IEnumerator of String objects representing the keys
long com.pcbsys.nirvana.client.nEventProperties.getLong ( string  key)

Retrieves the data from the table based on the key as a long

Parameters
keyKey to reference the data
Returns
a long with the value associated with this key
long [] com.pcbsys.nirvana.client.nEventProperties.getLongArray ( string  key)

Retrieves a long[] from the properties

Parameters
keyName of the long[]
Returns
long[]
short com.pcbsys.nirvana.client.nEventProperties.getShort ( string  key)

Retrieves a short from the properties

Parameters
keyname of the short
Returns
short value
short [] com.pcbsys.nirvana.client.nEventProperties.getShortArray ( string  key)

Retrieves an array of shorts

Parameters
keyname of the short array
Returns
short[]
int com.pcbsys.nirvana.client.nEventProperties.getSize ( )

Return the number of properties held

Returns
int size
string com.pcbsys.nirvana.client.nEventProperties.getString ( string  key)

Retrieves the data from the table based on the key as a string

Parameters
keyKey to reference the data
Returns
a string with the value associated with this key
string [] com.pcbsys.nirvana.client.nEventProperties.getStringArray ( string  key)

Retrieves a String[]

Parameters
keyName of the String[]
Returns
String[]
IEnumerator<object> com.pcbsys.nirvana.client.nEventProperties.getValues ( )

Get an IEnumerator of values

Returns
IEnumerator of values
bool com.pcbsys.nirvana.client.nEventProperties.isValid ( )

Returns true if the dictionary is consistent and contains no errors

Returns
bool flag
void com.pcbsys.nirvana.client.nEventProperties.merge ( nEventProperties  props,
bool  overwrite 
)

Adds the values from the supplied properties to this object.

If this object already has keys with the same name then the behaviour is driven by the bool overwrite.

Parameters
propsThe nEventProperties object to merge with this copy
overwriteIf true then duplicate values will take the new value
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
nEventProperties  value 
)

Put an nEventproperties into this one to enable nested properties

Parameters
keyname of this value
valuenEventProperty to insert
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
nEventProperties[]  value 
)

Put an nEventProperies[] into this property to enable nested properties

Parameters
keyName to call this
valueArray of nEventProperties
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
string  value 
)

Places a key value pair into the dictionary

Parameters
keyKey to reference the data
valueData to be stored
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
string[]  value 
)

Places a String[] into the properties

Parameters
keyName for the value
valueString[]
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
short  s 
)

places a short into the properties

Parameters
keyname of the short
sshort value
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
short[]  s 
)

Places an array of shorts into the properties

Parameters
keyName for the array
sshort[]
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
byte  b 
)

Places a byte into the properties

Parameters
keyname for the byte
bbyte
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
byte[]  b 
)

Places a byte[] into the properties

Parameters
keyname for the byte[]
bbyte[]
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
char  c 
)

Puts a char into the properties

Parameters
keyName of the char
cchar value
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
char[]  c 
)

Puts an array of chars into the properties

Parameters
keyName of the char[]
cchar[]
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
bool  value 
)

Places a key value pair into the dictionary

Parameters
keyKey to reference the data
valueData to be stored
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
bool[]  value 
)

Places a bool[] into the properties

Parameters
keyName of the boolean[]
valuebool[]
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
int  value 
)

Places a key value pair into the dictionary

Parameters
keyKey to reference the data
valueData to be stored
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
int[]  value 
)

Places a int[] into the properties

Parameters
keyName of the key
valueint[]
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
long  value 
)

Places a key value pair into the dictionary

Parameters
keyKey to reference the data
valueData to be stored
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
long[]  value 
)

Places a long[] into the properties

Parameters
keyname of the long[]
valuelong[]
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
float  value 
)

Places a key value pair into the properties

Parameters
keyKey to reference the data
valueData to be stored
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
float[]  value 
)

Puts a float[] into the properties

Parameters
keyName of the float[]
valuefloat[]
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
double  value 
)

Places a key value pair into the dictionary

Parameters
keyKey to reference the data
valueData to be stored
void com.pcbsys.nirvana.client.nEventProperties.put ( string  key,
double[]  value 
)

Places a double[] into the properties

Parameters
keyName of the double[]
valuedouble[]
void com.pcbsys.nirvana.client.nEventProperties.remove ( string  key)

Removes the value index by the key

Parameters
keyKey to remove
string com.pcbsys.nirvana.client.nEventProperties.ToString ( )

Converts this object into a string

Returns
String representation of this object