ucar.ma2

Class StructureData

java.lang.Object

ucar.ma2.StructureData

Direct Known Subclasses:

StructureDataA, StructureDataAscii, StructureDataComposite, StructureDataProxy, StructureDataRegexp, StructureDataW

public abstract class StructureData
extends java.lang.Object

A container for a Structure's data. Is normally contained within an ArrayStructure, which is an Array of StructureData. This is the abstract supertype for all implementations.

   for (Iterator iter = sdata.getMembers().iterator(); iter.hasNext(); ) {
      StructureMembers.Member m = (StructureMembers.Member) iter.next();
      Array sdataArray = sdata.getArray(m);
      ...
   }
  

General ways to access data in an StructureData are:

 Array getArray(Member m) 

 Array getArray(String memberName) 

The following will return an object of type Byte, Char, Double, Float, Int, Long, Short, String, or Structure, depending upon the member type:

 Object getScalarObject( Member m) 

A number of convenience routines may be able to avoid extra Object creation, and so are recommended for efficiency. These require that you know the data types of the member data, but they are the most efficent:

    getScalarXXX(int recnum, Member m)
    getJavaArrayXXX(int recnum, Member m) 

where XXX is Byte, Char, Double, Float, Int, Long, Short, or String. For members that are themselves Structures, the equivilent is:

    StructureData getScalarStructure(int recnum, Member m)
    ArrayStructure getArrayStructure(int recnum, Member m) 

These will return any compatible type as a double or float, but may have extra overhead when the types dont match:

    convertScalarXXX(int recnum, Member m)
    convertJavaArrayXXX(int recnum, Member m) 

where XXX is Double or Float

See Also:

ArrayStructure

Field Summary

Fields

Modifier and Type	Field and Description
static StructureData	EMPTY
protected StructureMembers	members

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StructureData(StructureMembers members) Constructor.

Method Summary

Modifier and Type	Method and Description
double	convertScalarDouble(java.lang.String memberName) Get scalar value as a double, with conversion as needed.
abstract double	convertScalarDouble(StructureMembers.Member m) Get scalar value as a double, with conversion as needed.
float	convertScalarFloat(java.lang.String memberName) Get scalar value as a float, with conversion as needed.
abstract float	convertScalarFloat(StructureMembers.Member m) Get scalar value as a float, with conversion as needed.
int	convertScalarInt(java.lang.String memberName) Get scalar value as a int, with conversion as needed.
abstract int	convertScalarInt(StructureMembers.Member m) Get scalar value as a int, with conversion as needed.
long	convertScalarLong(java.lang.String memberName) Get scalar value as a int, with conversion as needed.
abstract long	convertScalarLong(StructureMembers.Member m) Get scalar value as a int, with conversion as needed.
StructureMembers.Member	findMember(java.lang.String memberName) Find a member by its name.
Array	getArray(java.lang.String memberName) Get member data array of any type as an Array.
abstract Array	getArray(StructureMembers.Member m) Get member data array of any type as an Array.
ArraySequence	getArraySequence(java.lang.String memberName) Get ArraySequence for a member of type Sequence.
abstract ArraySequence	getArraySequence(StructureMembers.Member m) Get ArraySequence for a member of type Sequence.
ArrayStructure	getArrayStructure(java.lang.String memberName) Get member data of type Structure.
abstract ArrayStructure	getArrayStructure(StructureMembers.Member m) Get ArrayStructure for a member of type Structure.
byte[]	getJavaArrayByte(java.lang.String memberName) Get java byte array for a member of type byte.
abstract byte[]	getJavaArrayByte(StructureMembers.Member m) Get java byte array for a member of type byte.
char[]	getJavaArrayChar(java.lang.String memberName) Get java char array for a member of type char.
abstract char[]	getJavaArrayChar(StructureMembers.Member m) Get java char array for a member of type char.
double[]	getJavaArrayDouble(java.lang.String memberName) Get java double array for a member of type double.
abstract double[]	getJavaArrayDouble(StructureMembers.Member m) Get java double array for a member of type double.
float[]	getJavaArrayFloat(java.lang.String memberName) Get java float array for a member of type float.
abstract float[]	getJavaArrayFloat(StructureMembers.Member m) Get java float array for a member of type float.
int[]	getJavaArrayInt(java.lang.String memberName) Get java int array for a member of type int.
abstract int[]	getJavaArrayInt(StructureMembers.Member m) Get java int array for a member of type int.
long[]	getJavaArrayLong(java.lang.String memberName) Get java long array for a member of type long.
abstract long[]	getJavaArrayLong(StructureMembers.Member m) Get java long array for a member of type long.
short[]	getJavaArrayShort(java.lang.String memberName) Get java short array for a member of type short.
abstract short[]	getJavaArrayShort(StructureMembers.Member m) Get java short array for a member of type short.
java.lang.String[]	getJavaArrayString(java.lang.String memberName) Get java String array for a member of type String.
abstract java.lang.String[]	getJavaArrayString(StructureMembers.Member m) Get java array of Strings for a member of type char or String.
java.util.List<StructureMembers.Member>	getMembers()
java.lang.String	getName()
byte	getScalarByte(java.lang.String memberName) Get member data of type byte.
abstract byte	getScalarByte(StructureMembers.Member m) Get member data of type byte.
char	getScalarChar(java.lang.String memberName) Get member data of type char.
abstract char	getScalarChar(StructureMembers.Member m) Get member data of type char.
double	getScalarDouble(java.lang.String memberName) Get member data of type double.
abstract double	getScalarDouble(StructureMembers.Member m) Get member data of type double.
float	getScalarFloat(java.lang.String memberName) Get member data of type float.
abstract float	getScalarFloat(StructureMembers.Member m) Get member data of type float.
int	getScalarInt(java.lang.String memberName) Get member data of type int.
abstract int	getScalarInt(StructureMembers.Member m) Get member data of type int.
long	getScalarLong(java.lang.String memberName) Get member data of type long.
abstract long	getScalarLong(StructureMembers.Member m) Get member data of type long.
java.lang.Object	getScalarObject(java.lang.String memberName) Get member data array of any type as an Object, eg, Float, Double, String etc.
java.lang.Object	getScalarObject(StructureMembers.Member m) Get member data array of any type as an Object, eg, Float, Double, String etc.
short	getScalarShort(java.lang.String memberName) Get member data of type short.
abstract short	getScalarShort(StructureMembers.Member m) Get member data of type short.
java.lang.String	getScalarString(java.lang.String memberName) Get String value, from rank 0 String or rank 1 char member array.
abstract java.lang.String	getScalarString(StructureMembers.Member m) Get String value, from rank 0 String or rank 1 char member array.
StructureData	getScalarStructure(java.lang.String memberName) Get member data of type Structure.
abstract StructureData	getScalarStructure(StructureMembers.Member m) Get member data of type Structure.
StructureMembers	getStructureMembers()
void	showInternal(java.util.Formatter f, Indent indent)
void	showInternalMembers(java.util.Formatter f, Indent indent)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY

public static final StructureData EMPTY

members

protected StructureMembers members

Constructor Detail

StructureData

protected StructureData(StructureMembers members)

Constructor.

Parameters:

members - StructureData is always contained in a StructureArray.

Method Detail

getName

public java.lang.String getName()

Returns:

name of Structure

getStructureMembers

public StructureMembers getStructureMembers()

Returns:

StructureMembers object

getMembers

public java.util.List<StructureMembers.Member> getMembers()

Returns:

List of StructureMembers.Member

findMember

public StructureMembers.Member findMember(java.lang.String memberName)

Find a member by its name.

Parameters:

memberName - find member with this name

Returns:

StructureMembers.Member matching the name, or null if not found

getArray

public abstract Array getArray(StructureMembers.Member m)

Get member data array of any type as an Array.

Parameters:

m - get data from this StructureMembers.Member.

Returns:

Array values.

getArray

public Array getArray(java.lang.String memberName)

Get member data array of any type as an Array. For more efficiency, use getScalarXXX(Member) or getJavaArrayXXX(Member) is possible.

Parameters:

memberName - name of member Variable.

Returns:

member data array of any type as an Array.

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarObject

public java.lang.Object getScalarObject(java.lang.String memberName)

Get member data array of any type as an Object, eg, Float, Double, String etc.

Parameters:

memberName - name of member Variable.

Returns:

value as Float, Double, etc..

getScalarObject

public java.lang.Object getScalarObject(StructureMembers.Member m)

Get member data array of any type as an Object, eg, Float, Double, String etc.

Parameters:

m - get data from this StructureMembers.Member.

Returns:

value as Float, Double, etc..

convertScalarFloat

public float convertScalarFloat(java.lang.String memberName)

Get scalar value as a float, with conversion as needed. Underlying type must be convertible to float.

Parameters:

memberName - name of member Variable. Must be convertible to float.

Returns:

scalar value as a float

Throws:

ForbiddenConversionException - if not convertible to float.

convertScalarFloat

public abstract float convertScalarFloat(StructureMembers.Member m)

Get scalar value as a float, with conversion as needed. Underlying type must be convertible to float.

Parameters:

m - member Variable.

Returns:

scalar value as a float

Throws:

ForbiddenConversionException - if not convertible to float.

convertScalarDouble

public double convertScalarDouble(java.lang.String memberName)

Get scalar value as a double, with conversion as needed. Underlying type must be convertible to double.

Parameters:

memberName - name of member Variable. Must be convertible to double.

Returns:

scalar value as a double

Throws:

ForbiddenConversionException - if not convertible to double.

convertScalarDouble

public abstract double convertScalarDouble(StructureMembers.Member m)

Get scalar value as a double, with conversion as needed. Underlying type must be convertible to double.

Parameters:

m - member Variable.

Returns:

scalar value as a double

Throws:

ForbiddenConversionException - if not convertible to double.

convertScalarInt

public int convertScalarInt(java.lang.String memberName)

Get scalar value as a int, with conversion as needed. Underlying type must be convertible to int.

Parameters:

memberName - name of member Variable. Must be convertible to double.

Returns:

scalar value as a int

Throws:

ForbiddenConversionException - if not convertible to int.

convertScalarInt

public abstract int convertScalarInt(StructureMembers.Member m)

Get scalar value as a int, with conversion as needed. Underlying type must be convertible to int.

Parameters:

m - member Variable.

Returns:

scalar value as a int

Throws:

ForbiddenConversionException - if not convertible to int.

convertScalarLong

public long convertScalarLong(java.lang.String memberName)

Get scalar value as a int, with conversion as needed. Underlying type must be convertible to int.

Parameters:

memberName - name of member Variable. Must be convertible to double.

Returns:

scalar value as a int

Throws:

ForbiddenConversionException - if not convertible to int.

convertScalarLong

public abstract long convertScalarLong(StructureMembers.Member m)

Get scalar value as a int, with conversion as needed. Underlying type must be convertible to int.

Parameters:

m - member Variable.

Returns:

scalar value as a int

Throws:

ForbiddenConversionException - if not convertible to int.

getScalarDouble

public double getScalarDouble(java.lang.String memberName)

Get member data of type double.

Parameters:

memberName - name of member Variable. Must be of type double.

Returns:

scalar value as a double

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarDouble

public abstract double getScalarDouble(StructureMembers.Member m)

Get member data of type double.

Parameters:

m - get data from this StructureMembers.Member. Must be of type double.

Returns:

scalar double value

getJavaArrayDouble

public double[] getJavaArrayDouble(java.lang.String memberName)

Get java double array for a member of type double.

Parameters:

memberName - name of member Variable. Must be of type double.

Returns:

1D java array of doubles

getJavaArrayDouble

public abstract double[] getJavaArrayDouble(StructureMembers.Member m)

Get java double array for a member of type double.

Parameters:

m - get data from this StructureMembers.Member. Must be of type double.

Returns:

1D java array of doubles

getScalarFloat

public float getScalarFloat(java.lang.String memberName)

Get member data of type float.

Parameters:

memberName - name of member Variable. Must be of type float.

Returns:

scalar float value

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarFloat

public abstract float getScalarFloat(StructureMembers.Member m)

Get member data of type float.

Parameters:

m - get data from this StructureMembers.Member. Must be of type float.

Returns:

scalar double value

getJavaArrayFloat

public float[] getJavaArrayFloat(java.lang.String memberName)

Get java float array for a member of type float.

Parameters:

memberName - name of member Variable. Must be of type float.

Returns:

1D java array of floats

getJavaArrayFloat

public abstract float[] getJavaArrayFloat(StructureMembers.Member m)

Get java float array for a member of type float.

Parameters:

m - get data from this StructureMembers.Member. Must be of type float.

Returns:

1D java array of floats

getScalarByte

public byte getScalarByte(java.lang.String memberName)

Get member data of type byte.

Parameters:

memberName - name of member Variable. Must be of type byte.

Returns:

scalar byte value

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarByte

public abstract byte getScalarByte(StructureMembers.Member m)

Get member data of type byte.

Parameters:

m - get data from this StructureMembers.Member. Must be of type byte.

Returns:

scalar byte value

getJavaArrayByte

public byte[] getJavaArrayByte(java.lang.String memberName)

Get java byte array for a member of type byte.

Parameters:

memberName - name of member Variable. Must be of type byte.

Returns:

1D java array of bytes

getJavaArrayByte

public abstract byte[] getJavaArrayByte(StructureMembers.Member m)

Get java byte array for a member of type byte.

Parameters:

m - get data from this StructureMembers.Member. Must be of type byte.

Returns:

1D java array of bytes

getScalarInt

public int getScalarInt(java.lang.String memberName)

Get member data of type int.

Parameters:

memberName - name of member Variable. Must be of type int.

Returns:

scalar int value

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarInt

public abstract int getScalarInt(StructureMembers.Member m)

Get member data of type int.

Parameters:

m - get data from this StructureMembers.Member. Must be of type int.

Returns:

scalar int value

getJavaArrayInt

public int[] getJavaArrayInt(java.lang.String memberName)

Get java int array for a member of type int.

Parameters:

memberName - name of member Variable. Must be of type int.

Returns:

1D java array of ints

getJavaArrayInt

public abstract int[] getJavaArrayInt(StructureMembers.Member m)

Get java int array for a member of type int.

Parameters:

m - get data from this StructureMembers.Member. Must be of type int.

Returns:

1D java array of ints

getScalarShort

public short getScalarShort(java.lang.String memberName)

Get member data of type short.

Parameters:

memberName - name of member Variable. Must be of type short.

Returns:

scalar short value

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarShort

public abstract short getScalarShort(StructureMembers.Member m)

Get member data of type short.

Parameters:

m - get data from this StructureMembers.Member. Must be of type short.

Returns:

scalar short value

getJavaArrayShort

public short[] getJavaArrayShort(java.lang.String memberName)

Get java short array for a member of type short.

Parameters:

memberName - name of member Variable. Must be of type short.

Returns:

1D java array of shorts

getJavaArrayShort

public abstract short[] getJavaArrayShort(StructureMembers.Member m)

Get java short array for a member of type short.

Parameters:

m - get data from this StructureMembers.Member. Must be of type short.

Returns:

1D java array of shorts

getScalarLong

public long getScalarLong(java.lang.String memberName)

Get member data of type long.

Parameters:

memberName - name of member Variable. Must be of type long.

Returns:

scalar long value

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarLong

public abstract long getScalarLong(StructureMembers.Member m)

Get member data of type long.

Parameters:

m - get data from this StructureMembers.Member. Must be of type long.

Returns:

scalar long value

getJavaArrayLong

public long[] getJavaArrayLong(java.lang.String memberName)

Get java long array for a member of type long.

Parameters:

memberName - name of member Variable. Must be of type long.

Returns:

1D java array of longs

getJavaArrayLong

public abstract long[] getJavaArrayLong(StructureMembers.Member m)

Get java long array for a member of type long.

Parameters:

m - get data from this StructureMembers.Member. Must be of type long.

Returns:

1D java array of longs

getScalarChar

public char getScalarChar(java.lang.String memberName)

Get member data of type char.

Parameters:

memberName - name of member Variable. Must be of type char.

Returns:

scalar char value

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarChar

public abstract char getScalarChar(StructureMembers.Member m)

Get member data of type char.

Parameters:

m - get data from this StructureMembers.Member. Must be of type char.

Returns:

scalar char value

getJavaArrayChar

public char[] getJavaArrayChar(java.lang.String memberName)

Get java char array for a member of type char.

Parameters:

memberName - name of member Variable. Must be of type char.

Returns:

1D java array of chars

getJavaArrayChar

public abstract char[] getJavaArrayChar(StructureMembers.Member m)

Get java char array for a member of type char.

Parameters:

m - get data from this StructureMembers.Member. Must be of type char.

Returns:

1D java array of chars

getScalarString

public java.lang.String getScalarString(java.lang.String memberName)

Get String value, from rank 0 String or rank 1 char member array.

Parameters:

memberName - name of member Variable.

Returns:

scalar String value

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarString

public abstract java.lang.String getScalarString(StructureMembers.Member m)

Get String value, from rank 0 String or rank 1 char member array.

Parameters:

m - get data from this StructureMembers.Member. Must be of type char or String.

Returns:

scalar String value

getJavaArrayString

public java.lang.String[] getJavaArrayString(java.lang.String memberName)

Get java String array for a member of type String.

Parameters:

memberName - name of member Variable. Must be of type char or String.

Returns:

1D java array of String

getJavaArrayString

public abstract java.lang.String[] getJavaArrayString(StructureMembers.Member m)

Get java array of Strings for a member of type char or String.

Parameters:

m - get data from this StructureMembers.Member. Must be of type char or String.

Returns:

1D java array of String

getScalarStructure

public StructureData getScalarStructure(java.lang.String memberName)

Get member data of type Structure.

Parameters:

memberName - name of member Variable.

Returns:

scalar StructureData value

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getScalarStructure

public abstract StructureData getScalarStructure(StructureMembers.Member m)

Get member data of type Structure.

Parameters:

m - get data from this StructureMembers.Member. Must be of type Structure.

Returns:

StructureData

getArrayStructure

public ArrayStructure getArrayStructure(java.lang.String memberName)

Get member data of type Structure.

Parameters:

memberName - name of member Variable.

Returns:

array of StructureData

Throws:

java.lang.IllegalArgumentException - if name is not legal member name.

getArrayStructure

public abstract ArrayStructure getArrayStructure(StructureMembers.Member m)

Get ArrayStructure for a member of type Structure.

Parameters:

m - get data from this StructureMembers.Member. Must be of type Structure.

Returns:

ArrayStructure

getArraySequence

public ArraySequence getArraySequence(java.lang.String memberName)

Get ArraySequence for a member of type Sequence.

Parameters:

memberName - name of member Variable. Must be of type Sequence.

Returns:

ArrayStructure

getArraySequence

public abstract ArraySequence getArraySequence(StructureMembers.Member m)

Get ArraySequence for a member of type Sequence.

Parameters:

m - get data from this StructureMembers.Member. Must be of type Sequence.

Returns:

ArrayStructure

showInternal

public void showInternal(java.util.Formatter f,
                         Indent indent)

showInternalMembers

public void showInternalMembers(java.util.Formatter f,
                                Indent indent)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object