com.archimed.dicom

Class ByteArray

java.lang.Object

com.archimed.dicom.ByteArray

All Implemented Interfaces:

DataElementValue, java.io.Serializable

public class ByteArray
extends java.lang.Object
implements java.io.Serializable, DataElementValue

represents an array of bytes of arbitrary length, exceeding the maximium of 2^31-1 for native byte[] arrays. Constructed and internally backed by an array of byte[] arrays.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAXLENGTH_BYTEARRAY The real maximum length of a byte[] array.

Constructor Summary

Constructors

Constructor and Description
ByteArray(byte[]... arrays) creates a new ByteArray instance out of an array of byte arrays.
ByteArray(long capacity)

Method Summary

Methods

Modifier and Type	Method and Description
int	arrays() returns the number of byte arrays with which this ByteArray is constructed.
byte[]	getArray(int index) returns the byte array at specified index.
java.lang.String	getDescription() returns a description of the value used in dump methods
long	getLength() returns the length the value
long	length() returns the total length of the ByteArray, this is the sum of the lengths of the underlying byte arrays.

Methods inherited from class java.lang.Object

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

Field Detail

MAXLENGTH_BYTEARRAY

public static final int MAXLENGTH_BYTEARRAY

The real maximum length of a byte[] array. Theoretically this is 2^31-1 but typical java VMs have a maximum size that is a bit lower. So we take 2^31 - 10. Note: Must be even to easily support byte swapping in case of Big Endian TS.

See Also:

Constant Field Values

Constructor Detail

ByteArray

public ByteArray(byte[]... arrays)

creates a new ByteArray instance out of an array of byte arrays. All specified arrays should be non-null. No array copying is performed.

Parameters:

arrays - the native byte arrays to be wrapped

ByteArray

public ByteArray(long capacity)

Method Detail

length

public long length()

returns the total length of the ByteArray, this is the sum of the lengths of the underlying byte arrays.

Returns:

long

arrays

public int arrays()

returns the number of byte arrays with which this ByteArray is constructed.

Returns:

int

getArray

public byte[] getArray(int index)

returns the byte array at specified index.

Parameters:

index - the index of the wrapped byte array

Returns:

byte array

getLength

public long getLength()

Description copied from interface: DataElementValue

returns the length the value

Specified by:

getLength in interface DataElementValue

Returns:

-

getDescription

public java.lang.String getDescription()

Description copied from interface: DataElementValue

returns a description of the value used in dump methods

Specified by:

getDescription in interface DataElementValue

Returns:

-