org.jlab.coda.jevio

Class EvioNode

java.lang.Object

org.jlab.coda.jevio.EvioNode

All Implemented Interfaces:

java.lang.Cloneable

public class EvioNode
extends java.lang.Object
implements java.lang.Cloneable

This class is used to store relevant info about an evio container (bank, segment, or tag segment), without having to de-serialize it into many objects and arrays. It is not thread-safe and is designed for speed.

Author:

timmer Date: 11/13/12

Field Summary

Fields

Modifier and Type	Field and Description
org.jlab.coda.jevio.BlockNode	blockNode Block containing this node.

Constructor Summary

Constructors

Constructor and Description
EvioNode() Constructor when fancy features not needed.
EvioNode(int pos, int place, BufferNode bufferNode, org.jlab.coda.jevio.BlockNode blockNode) Constructor which creates an EvioNode associated with an event (top level) evio container when parsing buffers for evio data.

Method Summary

Modifier and Type	Method and Description
void	clear() Clear all data in this object.
void	clearAll()
void	clearIntArray()
void	clearLists() Clear the childNode it is exists.
void	clearObjects() Empty all lists and remove all other objects from this object.
java.lang.Object	clone()
void	getAllDescendants(java.util.List<EvioNode> descendants) Get the list of all descendant nodes that this node contains - not only the immediate children.
java.util.ArrayList<EvioNode>	getAllNodes() Get the list of all nodes that this node contains, always including itself.
BufferNode	getBufferNode() Get the object containing the buffer that this node is associated with.
java.nio.ByteBuffer	getByteData(boolean copy) Get the data associated with this node in ByteBuffer form.
EvioNode	getChildAt(int index) Get the child node at the given index (starts at 0).
int	getChildCount() Get the number all children that this node contains.
java.util.ArrayList<EvioNode>	getChildNodes() Get the list of all child nodes that this node contains.
int	getDataLength() Get the length of this evio structure's data only (no header words) in 32-bit words.
int	getDataPosition() Get the file/buffer byte position of this evio structure's data.
int	getDataType() Get the evio type of the data this evio structure contains.
DataType	getDataTypeObj() Get the evio type of the data this evio structure contains as an object.
int	getEventNumber() If this object represents an event (top-level, evio bank), then returns its number (place in file or buffer) starting with 1.
int[]	getIntData() Get the data associated with this node as an 32-bit integer array.
int[]	getIntData(int[] intData, int[] length) Get the data associated with this node as an 32-bit integer array.
int	getLength() Get the length of this evio structure (not including length word itself) in 32-bit words.
long[]	getLongData() Get the data associated with this node as an 64-bit integer array.
long[]	getLongData(long[] longData, int[] length) Get the data associated with this node as an 64-bit integer array.
int	getNum() Get the num of this evio structure.
int	getPad() Get the padding of this evio structure.
int	getPosition() Get the file/buffer byte position of this evio structure.
short[]	getShortData() Get the data associated with this node as an 16-bit integer array.
short[]	getShortData(short[] shortData, int[] length) Get the data associated with this node as an 16-bit integer array.
java.nio.ByteBuffer	getStructureBuffer(boolean copy) Get this node's entire evio structure in ByteBuffer form.
int	getTag() Get the tag of this evio structure.
int	getTotalBytes() Get the length of this evio structure including entire header in bytes.
int	getType() Get the evio type of this evio structure, not what it contains.
DataType	getTypeObj() Get the evio type of this evio structure as an object.
boolean	isEvent() Does this object represent an event?
boolean	isObsolete() Has the data this node represents in the buffer been removed?
java.lang.String	toString()
void	updateNum(int newNum) Update, in the buffer, the num of the bank header this object represents.
void	updateTag(int newTag) Update, in the buffer, the tag of the structure header this object represents.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

blockNode

public org.jlab.coda.jevio.BlockNode blockNode

Block containing this node.

Constructor Detail

EvioNode

public EvioNode()

Constructor when fancy features not needed.

EvioNode

public EvioNode(int pos,
                int place,
                BufferNode bufferNode,
                org.jlab.coda.jevio.BlockNode blockNode)

Constructor which creates an EvioNode associated with an event (top level) evio container when parsing buffers for evio data.

Parameters:

pos - position of event in buffer (number of bytes)

place - containing event's place in buffer (starting at 1)

bufferNode - buffer containing this event

blockNode - block containing this event

Method Detail

clone

public final java.lang.Object clone()

Overrides:

clone in class java.lang.Object

toString

public final java.lang.String toString()

Overrides:

toString in class java.lang.Object

clearLists

public final void clearLists()

Clear the childNode it is exists. Place only this or eventNode object into the allNodes list if it exists.

clear

public final void clear()

Clear all data in this object.

clearObjects

public final void clearObjects()

Empty all lists and remove all other objects from this object.

clearAll

public final void clearAll()

clearIntArray

public final void clearIntArray()

isObsolete

public final boolean isObsolete()

Has the data this node represents in the buffer been removed?

Returns:

true if node no longer represents valid buffer data, else false.

getAllNodes

public final java.util.ArrayList<EvioNode> getAllNodes()

Get the list of all nodes that this node contains, always including itself. This is meaningful only if this node has been scanned, otherwise it contains only itself.

Returns:

list of all nodes that this node contains; null if not top-level node

getChildNodes

public final java.util.ArrayList<EvioNode> getChildNodes()

Get the list of all child nodes that this node contains. This is meaningful only if this node has been scanned, otherwise it is null.

Returns:

list of all child nodes that this node contains; null if not scanned or no children

getAllDescendants

public final void getAllDescendants(java.util.List<EvioNode> descendants)

Get the list of all descendant nodes that this node contains - not only the immediate children. This is meaningful only if this node has been scanned, otherwise nothing is added to the given list.

Parameters:

descendants - list to be filled with EvioNodes of all descendants

getChildAt

public final EvioNode getChildAt(int index)

Get the child node at the given index (starts at 0). This is meaningful only if this node has been scanned, otherwise it is null.

Parameters:

index - into list of children.

Returns:

child node at the given index; null if not scanned or no child at that index

getChildCount

public final int getChildCount()

Get the number all children that this node contains. This is meaningful only if this node has been scanned, otherwise it returns 0.

Returns:

number of children that this node contains; 0 if not scanned

getBufferNode

public final BufferNode getBufferNode()

Get the object containing the buffer that this node is associated with.

Returns:

object containing the buffer that this node is associated with.

getLength

public final int getLength()

Get the length of this evio structure (not including length word itself) in 32-bit words.

Returns:

length of this evio structure (not including length word itself) in 32-bit words

getTotalBytes

public final int getTotalBytes()

Get the length of this evio structure including entire header in bytes.

Returns:

length of this evio structure including entire header in bytes.

getTag

public final int getTag()

Get the tag of this evio structure.

Returns:

tag of this evio structure

getNum

public final int getNum()

Get the num of this evio structure. Will be zero for tagsegments.

Returns:

num of this evio structure

getPad

public final int getPad()

Get the padding of this evio structure. Will be zero for segments and tagsegments.

Returns:

padding of this evio structure

getPosition

public final int getPosition()

Get the file/buffer byte position of this evio structure.

Returns:

file/buffer byte position of this evio structure

getType

public final int getType()

Get the evio type of this evio structure, not what it contains. Call DataType.getDataType(int) on the returned value to get the object representation.

Returns:

evio type of this evio structure, not what it contains

getTypeObj

public final DataType getTypeObj()

Get the evio type of this evio structure as an object.

Returns:

evio type of this evio structure as an object.

getDataLength

public final int getDataLength()

Get the length of this evio structure's data only (no header words) in 32-bit words.

Returns:

length of this evio structure's data only (no header words) in 32-bit words.

getDataPosition

public final int getDataPosition()

Get the file/buffer byte position of this evio structure's data.

Returns:

file/buffer byte position of this evio structure's data

getDataType

public final int getDataType()

Get the evio type of the data this evio structure contains. Call DataType.getDataType(int) on the returned value to get the object representation.

Returns:

evio type of the data this evio structure contains

getDataTypeObj

public final DataType getDataTypeObj()

Get the evio type of the data this evio structure contains as an object.

Returns:

evio type of the data this evio structure contains as an object.

getEventNumber

public final int getEventNumber()

If this object represents an event (top-level, evio bank), then returns its number (place in file or buffer) starting with 1. If not, return -1.

Returns:

event number if representing an event, else -1

isEvent

public final boolean isEvent()

Does this object represent an event?

Returns:

true if this object represents an event, else false

updateTag

public final void updateTag(int newTag)

Update, in the buffer, the tag of the structure header this object represents. Sometimes it's necessary to go back and change the tag of an evio structure that's already been written. This will do that.

Parameters:

newTag - new tag value

updateNum

public final void updateNum(int newNum)

Update, in the buffer, the num of the bank header this object represents. Sometimes it's necessary to go back and change the num of an evio structure that's already been written. This will do that .

Parameters:

newNum - new num value

getByteData

public final java.nio.ByteBuffer getByteData(boolean copy)

Get the data associated with this node in ByteBuffer form. Depending on the copy argument, the returned buffer will either be a copy of or a view into this node's buffer. Position and limit are set for reading.

This method is not synchronized.

Parameters:

copy - if true, then return a copy as opposed to a view into this node's buffer.

Returns:

ByteBuffer containing data. Position and limit are set for reading.

getIntData

public final int[] getIntData()

Get the data associated with this node as an 32-bit integer array. Store it for future 2nd gets (like in event builder). If data is of a type less than 32 bits, the last int will be junk. Call this to avoid calling getByteData(boolean) and converting it to an int array which involves creating additional objects and calling additional methods. This method is not synchronized.

Returns:

integer array containing data.

getIntData

public final int[] getIntData(int[] intData,
                              int[] length)

Get the data associated with this node as an 32-bit integer array. Place data in the given array. Only allocate memory if array is too small. If data is of a type less than 32 bits, the last int may be junk. Call this to avoid calling getByteData(boolean) and converting it to an int array which involves creating additional objects and calling additional methods. This method is not synchronized.

Parameters:

intData - integer array in which to store data.

length - set first element to contain number of valid array elements of the returned array.

Returns:

integer array containing data, or null if length array arg is null or 0 length.

getLongData

public final long[] getLongData()

Get the data associated with this node as an 64-bit integer array. If data is of a type less than 64 bits, the last long will be junk. Make sure we don't try to read beyond the end. Call this to avoid calling getByteData(boolean) and converting it to a long array which involves creating additional objects and calling additional methods. This method is not synchronized.

Returns:

long array containing data.

getLongData

public final long[] getLongData(long[] longData,
                                int[] length)

Get the data associated with this node as an 64-bit integer array. Place data in the given array. Only allocate memory if array is too small. If data is of a type less than 64 bits, the last element may be junk. Call this to avoid calling getByteData(boolean) and converting it to an long array which involves creating additional objects and calling additional methods. This method is not synchronized.

Parameters:

longData - long array in which to store data.

length - set first element to contain number of valid array elements of the returned array.

Returns:

long array containing data, or null if length array arg is null or 0 length.

getShortData

public final short[] getShortData()

Get the data associated with this node as an 16-bit integer array. If data is of a type less than 16 bits, the last int will be junk. Call this to avoid calling getByteData(boolean) and converting it to a short array which involves creating additional objects and calling additional methods. This method is not synchronized.

Returns:

short array containing data.

getShortData

public final short[] getShortData(short[] shortData,
                                  int[] length)

Get the data associated with this node as an 16-bit integer array. Place data in the given array. Only allocate memory if array is too small. If data is of a type less than 16 bits, the last element may be junk. Call this to avoid calling getByteData(boolean) and converting it to an short array which involves creating additional objects and calling additional methods. This method is not synchronized.

Parameters:

shortData - short array in which to store data.

length - set first element to contain number of valid array elements of the returned array.

Returns:

short array containing data, or null if length array arg is null or 0 length.

getStructureBuffer

public final java.nio.ByteBuffer getStructureBuffer(boolean copy)

Get this node's entire evio structure in ByteBuffer form. Depending on the copy argument, the returned buffer will either be a copy of or a view into the data of this node's buffer. Position and limit are set for reading.

This method is not synchronized.

Parameters:

copy - if true, then return a copy as opposed to a view into this node's buffer.

Returns:

ByteBuffer object containing evio structure's bytes. Position and limit are set for reading.