fr.gael.drb.value
Class FloatArray

java.lang.Object
  fr.gael.drb.value.AbstractValueArray
      fr.gael.drb.value.AbstractNumericArray
          fr.gael.drb.value.FloatArray

All Implemented Interfaces:

DrbItem, DrbSequence, Comparison, NumericArray, Value, ValueArray, ValueFormat, Serializable

public class FloatArray
extends AbstractNumericArray
implements ValueFormat

The FloatArray class is a generic wrapper for float array values.

See Also:

Serialized Form

Field Summary

Fields inherited from interface fr.gael.drb.value.Value

ARRAY_ID, BINARY_ID, BINARY_INTEGER_ID, BOOLEAN_ID, BYTE_ID, DATE_ID, DATE_TIME_ID, DAY_ID, DAY_TIME_DURATION_ID, DECIMAL_ID, DOUBLE_ID, DURATION_ID, FLOAT_ID, INT_ID, INTEGER_ID, LONG_ID, MONTH_DAY_ID, MONTH_ID, NULL_ID, NUMERIC_ID, OTHER_ID, SHORT_ID, STRING_ID, TIME_ID, UNKNOWN_ID, UNSIGNED_BYTE_ID, UNSIGNED_INT_ID, UNSIGNED_LONG_ID, UNSIGNED_SHORT_ID, YEAR_ID, YEAR_MONTH_DURATION_ID, YEAR_MONTH_ID

Fields inherited from interface fr.gael.drb.DrbItem

ATTRIBUTE_ITEM, NODE_ITEM, UNDEFINED_ITEM, VALUE_ITEM

Constructor Summary

FloatArray(float[] v)
Constructs a FloatArray initialized to the specified float[] value.

FloatArray(int size)
Constructs an FloatArray object with the specified length.

Method Summary

void	assign(int index, boolean value) Assign a new float value to the current Value, at the given index
void	assign(int index, byte value) Assign a new byte value to the current Value, at the given index
void	assign(int index, double value) Assign a new double value to the current Value, at the given index
void	assign(int index, float value) Assign a new float value to the current Value, at the given index
void	assign(int index, int value) Assign a new int value to the current Value, at the given index
void	assign(int index, long value) Assign a new long value to the current Value, at the given index
void	assign(int index, short value) Assign a new short value to the current Value, at the given index
void	assign(int index, Value element) Assign a new Value at the given index.
void	assign(Value v) Assign a new ValueArray to the current one.
boolean	booleanValue(int index) Returns the boolean (logic) Value at the given index.
byte	byteValue(int index) Returns the byte Value at the given index.
Value	convertTo(int type) Convert the value into the specified type.
double	doubleValue(int index) Returns the double Value at the given index.
float	floatValue(int index) Returns the float Value at the given index.
int	getArrayType() Returns the Array type of the current Value.
float[]	getData() Returns the underlying object for optimization.
Value	getElement(int index) Returns the Value at the given index.
byte[]	getFormattedBuffer() Return a byte buffer containing the value in a fixed format.
String	getFormattedString(int length) Return a string containing the value with a fixed format.
int	getItemType() A code that identifies the value items.
String	getName() Name of the item.
String	getNamespaceURI() Get namespace URI.
int	getPriority() Returns the FloatArray priority
int	getType() The type identifier of this FloatArray value.
Value	getValue() The value of the item.
int	intValue(int index) Returns the int Value at the given index.
int	length() Returns the current array length.
long	longValue(int index) Returns the long Value at the given index.
void	rename(String name) Changes the name of the item.
void	setNamespaceURI(String namespace_uri) Sets a namespace resource identifier.
Value	setValue(Value value) Changes the value of the item.
short	shortValue(int index) Returns the short Value at the given index.
Numeric	toNumeric() Convert the value into the numeric type.
String	toString() Returns the String representation of the Value.

Methods inherited from class fr.gael.drb.value.AbstractNumericArray

booleanValues, byteValues, convertArrayTo, doubleValues, floatValues, intValues, longValues, shortValues

Methods inherited from class fr.gael.drb.value.AbstractValueArray

addItem, atomize, compareTo, getItem, getLength, main, removeItem

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface fr.gael.drb.DrbItem

getItemType, getName, getNamespaceURI, getValue, rename, setNamespaceURI, setValue

Methods inherited from interface fr.gael.drb.DrbSequence

addItem, atomize, getItem, getLength, removeItem

Methods inherited from interface fr.gael.drb.value.Comparison

compareTo

Constructor Detail

FloatArray

public FloatArray(float[] v)

Constructs a FloatArray initialized to the specified float[] value.

Parameters:

v - the value of the FloatArray.

FloatArray

public FloatArray(int size)

Constructs an FloatArray object with the specified length.

Parameters:

size - the length of the FloatArray.

Method Detail

getData

public final float[] getData()

Returns the underlying object for optimization.

Specified by:

getData in class AbstractNumericArray

Returns:

a backing array.

getFormattedString

public String getFormattedString(int length)

Return a string containing the value with a fixed format.

Specified by:

getFormattedString in interface ValueFormat

Overrides:

getFormattedString in class AbstractNumericArray

Parameters:

length - The expected length of the output string

Returns:

The formatted string.

getFormattedBuffer

public final byte[] getFormattedBuffer()

Return a byte buffer containing the value in a fixed format.

Specified by:

getFormattedBuffer in interface ValueFormat

Overrides:

getFormattedBuffer in class AbstractNumericArray

Returns:

The formatted buffer.

getType

public final int getType()

The type identifier of this FloatArray value.

Specified by:

getType in interface Value

Returns:

an identifier of the array type, namely ARRAY_ID

getPriority

public final int getPriority()

Returns the FloatArray priority

Specified by:

getPriority in interface Value

Returns:

the FloatArray priority

convertTo

public final Value convertTo(int type)
                      throws ClassCastException

Convert the value into the specified type. In case of identity conversion the value itself is returned. If the conversion is not allowed a ClassCastException is thrown. The types supported are ARRAY_ID and STRING_ID.

Specified by:

convertTo in interface Value

Overrides:

convertTo in class AbstractValueArray

Parameters:

type - The target type.

Returns:

The converted value.

Throws:

ClassCastException - is the convertion is impossible

assign

public final void assign(Value v)
                  throws ClassCastException

Assign a new ValueArray to the current one.

Specified by:

assign in interface Value

Parameters:

v - the new Value.

Throws:

ClassCastException - if the given Value is not a ValueArray.

getArrayType

public final int getArrayType()

Returns the Array type of the current Value.

Specified by:

getArrayType in interface ValueArray

Overrides:

getArrayType in class AbstractNumericArray

Returns:

the Array type of the current Value.

getElement

public final Value getElement(int index)

Returns the Value at the given index.

Specified by:

getElement in interface ValueArray

Parameters:

index - the index to be queried

Returns:

the Value at the given index.

assign

public final void assign(int index,
                         Value element)

Assign a new Value at the given index.

Specified by:

assign in interface ValueArray

Parameters:

index - the index to be changed.

element - the new Value.

length

public final int length()

Returns the current array length.

Specified by:

length in interface ValueArray

Returns:

the current array length.

booleanValue

public final boolean booleanValue(int index)

Returns the boolean (logic) Value at the given index.

Specified by:

booleanValue in interface NumericArray

Overrides:

booleanValue in class AbstractNumericArray

Parameters:

index - the index to be queried.

Returns:

the Value at the given index.

byteValue

public final byte byteValue(int index)

Returns the byte Value at the given index.

Specified by:

byteValue in interface NumericArray

Overrides:

byteValue in class AbstractNumericArray

Parameters:

index - the index to be queried.

Returns:

the Value at the given index.

intValue

public final int intValue(int index)

Returns the int Value at the given index.

Specified by:

intValue in interface NumericArray

Overrides:

intValue in class AbstractNumericArray

Parameters:

index - the index to be queried.

Returns:

the Value at the given index.

longValue

public final long longValue(int index)

Returns the long Value at the given index.

Specified by:

longValue in interface NumericArray

Overrides:

longValue in class AbstractNumericArray

Parameters:

index - the index to be queried.

Returns:

the Value at the given index.

shortValue

public final short shortValue(int index)

Returns the short Value at the given index.

Specified by:

shortValue in interface NumericArray

Overrides:

shortValue in class AbstractNumericArray

Parameters:

index - the index to be queried.

Returns:

the Value at the given index.

floatValue

public final float floatValue(int index)

Returns the float Value at the given index.

Specified by:

floatValue in interface NumericArray

Overrides:

floatValue in class AbstractNumericArray

Parameters:

index - the index to be queried.

Returns:

the Value at the given index.

doubleValue

public final double doubleValue(int index)

Returns the double Value at the given index.

Specified by:

doubleValue in interface NumericArray

Overrides:

doubleValue in class AbstractNumericArray

Parameters:

index - the index to be queried.

Returns:

the Value at the given index.

assign

public final void assign(int index,
                         boolean value)

Assign a new float value to the current Value, at the given index

Specified by:

assign in interface NumericArray

Overrides:

assign in class AbstractNumericArray

Parameters:

index - the index where to set the new Value

value - the new Value

assign

public final void assign(int index,
                         byte value)

Assign a new byte value to the current Value, at the given index

Specified by:

assign in interface NumericArray

Overrides:

assign in class AbstractNumericArray

Parameters:

index - the index where to set the new Value

value - the new Value

assign

public final void assign(int index,
                         int value)

Assign a new int value to the current Value, at the given index

Specified by:

assign in interface NumericArray

Overrides:

assign in class AbstractNumericArray

Parameters:

index - the index where to set the new Value

value - the new Value

assign

public final void assign(int index,
                         short value)

Assign a new short value to the current Value, at the given index

Specified by:

assign in interface NumericArray

Overrides:

assign in class AbstractNumericArray

Parameters:

index - the index where to set the new Value

value - the new Value

assign

public final void assign(int index,
                         long value)

Assign a new long value to the current Value, at the given index

Specified by:

assign in interface NumericArray

Overrides:

assign in class AbstractNumericArray

Parameters:

index - the index where to set the new Value

value - the new Value

assign

public final void assign(int index,
                         float value)

Assign a new float value to the current Value, at the given index

Specified by:

assign in interface NumericArray

Overrides:

assign in class AbstractNumericArray

Parameters:

index - the index where to set the new Value

value - the new Value

assign

public final void assign(int index,
                         double value)

Assign a new double value to the current Value, at the given index

Specified by:

assign in interface NumericArray

Overrides:

assign in class AbstractNumericArray

Parameters:

index - the index where to set the new Value

value - the new Value

toString

public String toString()

Returns the String representation of the Value.

Overrides:

toString in class Object

Returns:

the String representation of the Value.

getItemType

public int getItemType()

A code that identifies the value items.

Specified by:

getItemType in interface DrbItem

Returns:

The code of value items.

getName

public String getName()

Name of the item. This method always returns null.

Specified by:

getName in interface DrbItem

Returns:

null

rename

public void rename(String name)
            throws NullPointerException,
                   UnsupportedOperationException

Changes the name of the item. This method always throw an UnsupportedOperationException.

Specified by:

rename in interface DrbItem

Parameters:

name - Reference to the new name.

Throws:

UnsupportedOperationException - This exception always raised because the name property is not defined for values.

NullPointerException - This exception is overriden by an UnsupportedOperationException.

getNamespaceURI

public String getNamespaceURI()

Get namespace URI. This method always returns null.

Specified by:

getNamespaceURI in interface DrbItem

Returns:

null.

setNamespaceURI

public void setNamespaceURI(String namespace_uri)
                     throws NullPointerException,
                            UnsupportedOperationException

Sets a namespace resource identifier. This method always throw an UnsupportedOperationException.

Specified by:

setNamespaceURI in interface DrbItem

Parameters:

namespace_uri - A reference to the new namespace identifier.

Throws:

UnsupportedOperationException - This exception always raised because the name property is not defined for values.

NullPointerException - This exception is overriden by an UnsupportedOperationException.

getValue

public Value getValue()

The value of the item. The value is expressed according to one of the types supported by the fr.gael.drb.value package. Generally these types correspond to primitive types (e.g. integer, floatting points, etc.) or very low level types (e.g. string, date, etc.). On the contrary to DOM implementation all the types are allowed even the arrays, date etc. Only the Value.NULL_ID type is forbidden.

Specified by:

getValue in interface DrbItem

Returns:

The value of the attribute.

setValue

public Value setValue(Value value)
               throws NullPointerException,
                      ClassCastException,
                      UnsupportedOperationException

Changes the value of the item. This operation sets a new value of the current item.The value type of the item shall be compatible with the item implementation. If the type does not match exactly it is casted to a compatible one based on the the fr.gael.drb.value capabilities. A reference to the effectivelly assigned value is returned by the operation so it is possible to check if a cast has been performed and therefore assess the accuracy of the assignement. If the cast is not possible the operation raises an UnsupportedOperationException. If the assignment is possible and the item implementation has a physical representation the value is updated in the physical source in order to persist among sessions. It therefore possible that this operation consumses an variable time.

Specified by:

setValue in interface DrbItem

Parameters:

value - The new value of the node. This value shall not be null.

Returns:

The effectivelly assigned value. The type of this value may differ from the input one.

Throws:

NullPointerException - This exception is raised when the passed reference to the value is null. This exception may be overriden by an UnsupportedOperationException.

ClassCastException - This exception is raised when the implementation has not succeeded to cast the input value in a type compatible with the current node.

UnsupportedOperationException - This exception is raised when the implementation does not support the requested assignment for any reason.

toNumeric

public Numeric toNumeric()
                  throws ClassCastException

Convert the value into the numeric type. In case of identity conversion the value itself should be returned. If the conversion is not allowed a ClassCastException is thrown.

Returns:

The converted value.

Throws:

ClassCastException - is the convertion is impossible