com.nt.udc.ndk.node

Interface StringIdStoreIfc

public interface StringIdStoreIfc

An interface implemented by StringIdNAR which is used for storing data fields using string attribute ids. Data values stored into a StringIdNAR using these methods can be looked up using the methods of StringIdLookupIfc, also implemented by StringIdNAR.

Method Summary

Modifier and Type	Method and Description
void	load(java.lang.String attrId) Stores a null attrubute (with no data) at the specified id Stored type is NAR.NULL_TYPE
void	load(java.lang.String attrId, byte val) Stores a given integer value at the specified id Stored type is NAR.BYTE_TYPE
void	load(java.lang.String attrId, byte[] barr) Stores a data field given as a byte array at the specified id Stored type is NAR.BYTE_ARRAY_TYPE
void	load(java.lang.String attrId, double val) Stores a given floating point value at the specified id Stored type is NAR.DOUBLE_TYPE
void	load(java.lang.String attrId, float val) Stores a given floating point value at the specified id Stored type is NAR.FLOAT_TYPE
void	load(java.lang.String attrId, int val) Stores a given integer value at the specified id Stored type is NAR.INT_TYPE
void	load(java.lang.String attrId, int type, byte[] barr, int barrOffset, int len) Stores a given value of specified type with the specified id.
void	load(java.lang.String attrId, long val) Stores a given integer value at the specified id Stored type is NAR.LONG_TYPE
void	load(java.lang.String attrId, short val) Stores a given integer value at the specified id Stored type is NAR.SHORT_TYPE
void	load(java.lang.String attrId, java.lang.String str) Stores a String object at the specified id Stored type is NAR.STRING_TYPE
void	loadBigEndian(java.lang.String attrId, int attrType, java.io.DataInputStream is) Stores a numeric primitive, e.g.
void	loadByteArray(java.lang.String attrId, java.io.InputStream is, int nbytes) Stores a given number of bytes of data from a given InputeStream at the specified id.
void	loadString(java.lang.String attrId, java.io.Reader rd, char delimChar) Stores a String object by reading it in from a given character Reader.

Method Detail

load

void load(java.lang.String attrId)

Stores a null attrubute (with no data) at the specified id Stored type is NAR.NULL_TYPE

Parameters:

attrId - String identifier for the field

load

void load(java.lang.String attrId,
          byte val)

Stores a given integer value at the specified id Stored type is NAR.BYTE_TYPE

Parameters:

attrId - String identifier for the field

val - byte value to be stored in the given field

load

void load(java.lang.String attrId,
          short val)

Stores a given integer value at the specified id Stored type is NAR.SHORT_TYPE

Parameters:

attrId - String identifier for the field

val - short value to be stored in the given field

load

void load(java.lang.String attrId,
          int val)

Stores a given integer value at the specified id Stored type is NAR.INT_TYPE

Parameters:

attrId - String identifier for the field

val - integer value to be stored in the given field

load

void load(java.lang.String attrId,
          long val)

Stores a given integer value at the specified id Stored type is NAR.LONG_TYPE

Parameters:

attrId - String identifier for the field

val - long value to be stored in the given field

load

void load(java.lang.String attrId,
          float val)

Stores a given floating point value at the specified id Stored type is NAR.FLOAT_TYPE

Parameters:

attrId - String identifier for the field

val - float value to be stored in the given field

load

void load(java.lang.String attrId,
          double val)

Stores a given floating point value at the specified id Stored type is NAR.DOUBLE_TYPE

Parameters:

attrId - String identifier for the field

val - double value to be stored in the given field

load

void load(java.lang.String attrId,
          byte[] barr)

Stores a data field given as a byte array at the specified id Stored type is NAR.BYTE_ARRAY_TYPE

Parameters:

attrId - String identifier for the field

barr - byte array to be stored in the given field

load

void load(java.lang.String attrId,
          java.lang.String str)

Stores a String object at the specified id Stored type is NAR.STRING_TYPE

Parameters:

attrId - String identifier for the field

val - String object to be stored in the given field

loadByteArray

void loadByteArray(java.lang.String attrId,
                   java.io.InputStream is,
                   int nbytes)
            throws java.io.IOException

Stores a given number of bytes of data from a given InputeStream at the specified id. Stored type is NAR.BYTE_ARRAY_TYPE

Parameters:

attrId - String identifier for the field

is - InputStream from which bytes will be read

nbytes - Number of bytes to be read to create this data item

Throws:

java.io.IOException

loadBigEndian

void loadBigEndian(java.lang.String attrId,
                   int attrType,
                   java.io.DataInputStream is)
            throws java.io.IOException,
                   NonNumericTypeException

Stores a numeric primitive, e.g. int, float, long, by reading in appropriate number of bytes from a given DataInputStream. The DataInputStream is assumed to contain the number in big-endian, or network byte order.

Parameters:

attrId - String identifier for the field

attrType - an integer type id which should be one of NAR.INT_TYPE, NAR.FLOAT_TYPE, NAR.SHORT_TYPE, etc.

dis - DataInputStream which contains the big-endian number at the current position of the input-stream.

Throws:

java.io.IOException

NonNumericTypeException

loadString

void loadString(java.lang.String attrId,
                java.io.Reader rd,
                char delimChar)
         throws java.io.IOException

Stores a String object by reading it in from a given character Reader. The end of the string is recognized by the specified delimiting character. It is assumed that the default encoding of the platform is ASCII.

Parameters:

attrId - String identifier for the field

rd - A character Reader from which char's are extracted until a delimChar is seen.

delimChar - byte value of the separation character.

Throws:

java.io.IOException

load

void load(java.lang.String attrId,
          int type,
          byte[] barr,
          int barrOffset,
          int len)

Stores a given value of specified type with the specified id. Numeric values have to be given in network byte order, and strings have to be encoded with the platform's defualt encoding.

Parameters:

attrId - Identifier for the field

type - Data type for the field

barr - byte array containing the data value

barrOffset - offset into the given byte array where field begins

len - number of bytes occupied by field