com.netrics.likeit

Class NetricsRecord

java.lang.Object

com.netrics.likeit.NetricsRecord

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

NetricsMappedRecord

public class NetricsRecord
extends java.lang.Object
implements java.io.Serializable

This class is used to hold all the data which will be loaded into a Netrics Server. It is the means by which data is transported. It is used to load, add, and replace records, and is returned (with additional information) by a search.

All records have field structure. The field structure in the record must match the field structure of the table it will be loaded into.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
NetricsRecord(java.lang.String key, java.lang.String[] fields) Create a NetricsRecord object.
NetricsRecord(java.lang.String key, java.lang.String[] fields, java.lang.String[] attr_names, java.lang.String[] attr_values) Create a NetricsRecord object.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	compare(NetricsRecord rec) Compare two records.
java.lang.String	getAttribute(java.lang.String attr_name) Gets the specified attribute value of the record.
java.lang.String[]	getAttrNames() Returns the names of name/value attributes of the record.
java.lang.String[]	getAttrValues() Returns the values of name/value attributes of the record.
java.lang.String[]	getFields() Can be used to get the content of a record returned from a tbldump.
java.lang.String	getKey() Retrieve the unique key of a record.
int	numBytes() Return the number of bytes of data in this record.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NetricsRecord

public NetricsRecord(java.lang.String key,
             java.lang.String[] fields,
             java.lang.String[] attr_names,
             java.lang.String[] attr_values)

Create a NetricsRecord object.

Parameters:

key - A unique (user-specified) identifier for the record.

fields - The actual content associated with the record, one String per field in the table. Use the empty sting ("") for a field with no data in it. A field may be no longer than 2^16-3.

attr_names - Names of attributes associated with this record.

attr_values - Values of attributes associated with this record, in the same order as attr_names.

NetricsRecord

public NetricsRecord(java.lang.String key,
             java.lang.String[] fields)

Create a NetricsRecord object.

Parameters:

key - A unique (user-specified) identifier for the record.

fields - The actual content associated with the record, one String per field in the table. Use the empty sting ("") for a field with no data in it. A field may be no longer than 2^16-3.

Method Detail

getKey

public java.lang.String getKey()

Retrieve the unique key of a record.

See Also:

NetricsServerInterface.tbldump(java.lang.String, com.netrics.likeit.NetricsLock)

numBytes

public int numBytes()

Return the number of bytes of data in this record.

getFields

public java.lang.String[] getFields()

Can be used to get the content of a record returned from a tbldump.

See Also:

NetricsServerInterface.tbldump(java.lang.String, com.netrics.likeit.NetricsLock)

getAttrNames

public java.lang.String[] getAttrNames()

Returns the names of name/value attributes of the record.

This assumes the last field of the record contains the encoded attribute values and attempts to decode them. If the decode fails it returns null, otherwise if returns the list of attribute names in the order they appeared in the record.

Returns:

null if no attributes in this record, array of attribute names otherwise.

getAttrValues

public java.lang.String[] getAttrValues()

Returns the values of name/value attributes of the record.

This assumes the last field of the record contains the encoded attribute values and attempts to decode them. If the decode fails it returns null, otherwise if returns the list of attribute values in the order they appeared in the record.

Returns:

null if no attributes in this record, array of attribute values otherwise.

getAttribute

public java.lang.String getAttribute(java.lang.String attr_name)

Gets the specified attribute value of the record.

This assumes the last field of the record contains the encoded attribute values and attempts to decode them. If the decode fails it returns null, otherwise it attempts to retrieve the named attribute, returning the value if found, null if not.

Parameters:

attr_name - Name of the attribute to retrieve.

Returns:

attribute value for given name if it exists, null otherwise.

compare

public java.lang.String compare(NetricsRecord rec)

Compare two records. This is intended for internal use by the interface.

Returns:

null if the records are identical, description of difference otherwise.