dap4.dap4shared

Class D4DataAtomic

java.lang.Object

dap4.dap4shared.AbstractData

dap4.dap4shared.AbstractDataVariable

dap4.dap4shared.D4DataVariable

dap4.dap4shared.D4DataAtomic

All Implemented Interfaces:

Data, DataAtomic, DataVariable

public class D4DataAtomic
extends D4DataVariable
implements DataAtomic

Field Summary

Fields

Modifier and Type	Field and Description
protected AtomicType	atomictype
protected DapType	basetype
protected int[]	bytestrings
protected boolean	isbytestring
protected boolean	isscalar
protected long	product
protected long	totalbytestringsize
protected long	varelementsize
protected long	varoffset

Fields inherited from class dap4.dap4shared.D4DataVariable

dsp

Fields inherited from class dap4.dap4shared.AbstractData

sort, template

Constructor Summary

Constructors

Constructor and Description
D4DataAtomic(D4DSP dsp, DapAtomicVariable dap, int offset)

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object	extractObject(DapType basetype, java.nio.ByteBuffer dataset, long index) Extract, as an object, value from a (presumably) atomic typed array of values; dataset position is presumed correct.
protected void	extractObjectVector(DapType basetype, java.nio.ByteBuffer dataset, long start, long count, java.lang.Object vector, long offset) Vector version of extractObject().
long	getCount() Get the total number of elements in the atomic array.
long	getElementSize() Get the s ize of a single element in bytes; 0 => undefined
DapType	getType() Get the type of this atomic variable
void	read(java.util.List<Slice> slices, java.lang.Object data, long offset) Read of multiple values at once.
java.lang.Object	read(long index) Provide a read of a single value at a given offset in a (possibly dimensioned) atomic valued variable.
protected void	setup(long index)

Methods inherited from class dap4.dap4shared.D4DataVariable

getDSP

Methods inherited from class dap4.dap4shared.AbstractDataVariable

getVariable

Methods inherited from class dap4.dap4shared.AbstractData

computesort, getSort, getTemplate

Methods inherited from class java.lang.Object

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

Methods inherited from interface dap4.core.data.DataVariable

getVariable

Methods inherited from interface dap4.core.data.Data

getSort, getTemplate

Field Detail

product

protected long product

basetype

protected DapType basetype

atomictype

protected AtomicType atomictype

isscalar

protected boolean isscalar

varoffset

protected long varoffset

varelementsize

protected long varelementsize

isbytestring

protected boolean isbytestring

totalbytestringsize

protected long totalbytestringsize

bytestrings

protected int[] bytestrings

Constructor Detail

D4DataAtomic

public D4DataAtomic(D4DSP dsp,
                    DapAtomicVariable dap,
                    int offset)
             throws DataException

Throws:

DataException

Method Detail

getType

public DapType getType()

Description copied from interface: DataAtomic

Get the type of this atomic variable

Specified by:

getType in interface DataAtomic

Returns:

the type

getCount

public long getCount()

Description copied from interface: DataAtomic

Get the total number of elements in the atomic array. A scalar is treated as a one element array.

Specified by:

getCount in interface DataAtomic

Returns:

1 if the variable is scalar, else the product of the dimensions of the variable.

getElementSize

public long getElementSize()

Description copied from interface: DataAtomic

Get the s ize of a single element in bytes; 0 => undefined

Specified by:

getElementSize in interface DataAtomic

Returns:

size

read

public void read(java.util.List<Slice> slices,
                 java.lang.Object data,
                 long offset)
          throws DataException

Description copied from interface: DataAtomic

Read of multiple values at once. The returned value (parameter "data") is some form of java array (e.g. int[]). The type depends on the value of getType(). Note that implementations of this interface are free to provide alternate read methods that return values in e.g. a java.nio.Buffer. Note that unsigned types (e.g. UInt64) are returned as a signed version (e.g. Int64), and will have the proper bit pattern for the unsigned value. If the size of the "data" array is not the correct size, then an error will be returned. For opaque data, the result is ByteBuffer[].

Specified by:

read in interface DataAtomic

Parameters:

slices - the set of slices defining which values to return

data - the array into which the values are returned

offset - the offset into data into which to read

Throws:

DataException

read

public java.lang.Object read(long index)
                      throws DataException

Description copied from interface: DataAtomic

Provide a read of a single value at a given offset in a (possibly dimensioned) atomic valued variable. As mentioned above, unsigned types are returned as a signed version. The type of the returned value is the obvious one (e.g. int->Integer, opaque->ByteBuffer, etc.).

Specified by:

read in interface DataAtomic

Throws:

DataException

setup

protected void setup(long index)

extractObject

protected java.lang.Object extractObject(DapType basetype,
                                         java.nio.ByteBuffer dataset,
                                         long index)

Extract, as an object, value from a (presumably) atomic typed array of values; dataset position is presumed correct.

Parameters:

basetype - type of object to extract

dataset - ByteBuffer containing databuffer; position assumed correct

Returns:

resulting value as an Object; value does not necessarily conform to Convert.ValueClass.

extractObjectVector

protected void extractObjectVector(DapType basetype,
                                   java.nio.ByteBuffer dataset,
                                   long start,
                                   long count,
                                   java.lang.Object vector,
                                   long offset)

Vector version of extractObject(). Extract a vector of objects from a (presumably) atomic typed array of values; dataset position is presumed correct.

Parameters:

basetype - type of object to extract ; must not be Enum

dataset - ByteBuffer containing databuffer; position assumed correct

vector -

count -