public class EvioCompactReaderUnsync
extends java.lang.Object
Modifier and Type | Class and Description |
---|---|
static class |
EvioCompactReaderUnsync.ReadStatus
This
enum denotes the status of a read. |
Constructor and Description |
---|
EvioCompactReaderUnsync(java.nio.ByteBuffer byteBuffer)
Constructor for reading a buffer.
|
EvioCompactReaderUnsync(java.nio.ByteBuffer byteBuffer,
EvioNodeSource pool)
Constructor for reading a buffer.
|
Modifier and Type | Method and Description |
---|---|
java.nio.ByteBuffer |
addStructure(int eventNumber,
java.nio.ByteBuffer addBuffer)
This method adds an evio container (bank, segment, or tag segment) as the last
structure contained in an event.
|
void |
close()
This only sets the position to its initial value.
|
int |
getBlockCount()
This is the number of blocks in the file including the empty
block usually at the end of version 4 files/buffers.
|
java.nio.ByteBuffer |
getByteBuffer()
Get the byte buffer being read directly or corresponding to the event file.
|
java.nio.ByteOrder |
getByteOrder()
Get the byte order of the file/buffer being read.
|
java.nio.ByteBuffer |
getData(EvioNode node)
Get the data associated with an evio structure in ByteBuffer form.
|
java.nio.ByteBuffer |
getData(EvioNode node,
boolean copy)
Get the data associated with an evio structure in ByteBuffer form.
|
EvioXMLDictionary |
getDictionary()
Get the evio dictionary if is there is one.
|
java.lang.String |
getDictionaryXML()
Get the XML format dictionary is there is one.
|
EvioNode |
getEvent(int eventNumber)
Get the EvioNode object associated with a particular event number.
|
java.nio.ByteBuffer |
getEventBuffer(int eventNumber)
Get an evio bank or event in ByteBuffer form.
|
java.nio.ByteBuffer |
getEventBuffer(int eventNumber,
boolean copy)
Get an evio bank or event in ByteBuffer form.
|
int |
getEventCount()
This is the number of events in the file/buffer.
|
int |
getEvioVersion()
Get the evio version number.
|
BlockHeaderV4 |
getFirstBlockHeader()
This returns the FIRST block (physical record) header.
|
EvioNode |
getScannedEvent(int eventNumber)
Get the EvioNode object associated with a particular event number
which has been scanned so all substructures are contained in the
node.allNodes list.
|
EvioNode |
getScannedEvent(int eventNumber,
EvioNodeSource nodeSource)
Get the EvioNode object associated with a particular event number
which has been scanned so all substructures are contained in the
node.allNodes list.
|
java.nio.ByteBuffer |
getStructureBuffer(EvioNode node)
Get an evio structure (bank, seg, or tagseg) in ByteBuffer form.
|
java.nio.ByteBuffer |
getStructureBuffer(EvioNode node,
boolean copy)
Get an evio structure (bank, seg, or tagseg) in ByteBuffer form.
|
boolean |
hasDictionary()
Does this evio file have an associated XML dictionary?
|
boolean |
isClosed()
Has
close() been called (without reopening by calling
setBuffer(ByteBuffer) )? |
boolean |
isFile()
Is this reader reading a file? Always false for this class.
|
java.nio.ByteBuffer |
removeEvent(int eventNumber)
This method removes the data of the given event from the buffer.
|
java.nio.ByteBuffer |
removeStructure(EvioNode removeNode)
This method removes the data, represented by the given node, from the buffer.
|
java.util.List<EvioNode> |
searchEvent(int eventNumber,
int tag,
int num)
This method searches the specified event in a file/buffer and
returns a list of objects each of which contain information
about a single evio structure which matches the given tag and num.
|
java.util.List<EvioNode> |
searchEvent(int eventNumber,
java.lang.String dictName,
EvioXMLDictionary dictionary)
This method searches the specified event in a file/buffer and
returns a list of objects each of which contain information
about a single evio structure which matches the given dictionary
entry name.
|
void |
setBuffer(java.nio.ByteBuffer buf)
This method can be used to avoid creating additional EvioCompactReader
objects by reusing this one with another buffer.
|
void |
setBuffer(java.nio.ByteBuffer buf,
EvioNodeSource pool)
This method can be used to avoid creating additional EvioCompactReader
objects by reusing this one with another buffer.
|
void |
toFile(java.io.File file)
Save the internal byte buffer to the given file
(overwrites existing file).
|
void |
toFile(java.lang.String fileName)
Save the internal byte buffer to the given file
(overwrites existing file).
|
public EvioCompactReaderUnsync(java.nio.ByteBuffer byteBuffer) throws EvioException
byteBuffer
- the buffer that contains events.EvioException
- if buffer arg is null;
failure to read first block headerEventWriter
public EvioCompactReaderUnsync(java.nio.ByteBuffer byteBuffer, EvioNodeSource pool) throws EvioException
byteBuffer
- the buffer that contains events.pool
- pool of EvioNode objects.EvioException
- if buffer arg is null;
failure to read first block headerEventWriter
public void setBuffer(java.nio.ByteBuffer buf) throws EvioException
close()
is called before anything else. Any existing pool is
reset in this method.buf
- ByteBuffer to be readEvioException
- if arg is null;
if failure to read first block headerpublic void setBuffer(java.nio.ByteBuffer buf, EvioNodeSource pool) throws EvioException
close()
is called before anything else. The pool is not
reset in this method. Caller may do that prior to calling method.buf
- ByteBuffer to be readpool
- pool of EvioNode objects to use when parsing buf to avoid garbage collection.EvioException
- if arg is null;
if failure to read first block headerpublic boolean isFile()
public boolean isClosed()
close()
been called (without reopening by calling
setBuffer(ByteBuffer)
)?true
if this object closed, else false
.public java.nio.ByteOrder getByteOrder()
public int getEvioVersion()
public java.lang.String getDictionaryXML() throws EvioException
EvioException
- if object closed and dictionary still unreadpublic EvioXMLDictionary getDictionary() throws EvioException
EvioException
- if object closed and dictionary still unreadpublic boolean hasDictionary()
true
if this evio file has an associated XML dictionary,
else false
public java.nio.ByteBuffer getByteBuffer()
public EvioNode getEvent(int eventNumber)
eventNumber
- number of event (place in file/buffer) starting at 1.public EvioNode getScannedEvent(int eventNumber)
eventNumber
- number of event (place in file/buffer) starting at 1.public EvioNode getScannedEvent(int eventNumber, EvioNodeSource nodeSource)
eventNumber
- number of event (place in file/buffer) starting at 1.nodeSource
- source of EvioNode objects to use while parsing evio data.public BlockHeaderV4 getFirstBlockHeader()
public java.util.List<EvioNode> searchEvent(int eventNumber, int tag, int num) throws EvioException
eventNumber
- place of event in buffer (starting with 1)tag
- tag to matchnum
- num to matchEvioException
- if bad arg value(s);
if object closedpublic java.util.List<EvioNode> searchEvent(int eventNumber, java.lang.String dictName, EvioXMLDictionary dictionary) throws EvioException
eventNumber
- place of event in buffer (starting with 1)dictName
- name of dictionary entry to search fordictionary
- dictionary to use; if null, use dictionary with file/bufferEvioException
- if dictName is null;
if dictName is an invalid dictionary entry;
if dictionary is null and none provided in file/buffer being read;
if object closedpublic java.nio.ByteBuffer removeEvent(int eventNumber) throws EvioException
If the constructor of this reader read in data from a file, it will now switch
to using a new, internal buffer which is returned by this method or can be
retrieved by calling getByteBuffer()
. It will not change the
file originally used. A new file can be created by calling either the
toFile(String)
or toFile(File)
methods.
eventNumber
- number of event to remove from bufferEvioException
- if eventNumber < 1;
if event number does not correspond to existing event;
if object closed;
if node was not found in any event;
if internal programming errorpublic java.nio.ByteBuffer removeStructure(EvioNode removeNode) throws EvioException
If the constructor of this reader read in data from a file, it will now switch
to using a new, internal buffer which is returned by this method or can be
retrieved by calling getByteBuffer()
. It will not change the
file originally used. A new file can be created by calling either the
toFile(String)
or toFile(File)
methods.
removeNode
- evio structure to remove from bufferEvioException
- if object closed;
if node was not found in any event;
if internal programming errorpublic java.nio.ByteBuffer addStructure(int eventNumber, java.nio.ByteBuffer addBuffer) throws EvioException
To produce such evio data use BaseStructure.write(ByteBuffer)
,
BaseStructure.write(ByteBuffer)
or
BaseStructure.write(ByteBuffer)
depending on whether
a bank, seg, or tagseg is being added.
A note about files here. If the constructor of this reader read in data
from a file, it will now switch to using a new, internal buffer which
is returned by this method or can be retrieved by calling
getByteBuffer()
. It will not expand the file originally used.
A new file can be created by calling either the toFile(String)
or
toFile(File)
methods.
The given buffer argument must be ready to read with its position and limit defining the limits of the data to copy. This method is due to the bulk, relative puts.
eventNumber
- number of event to which addBuffer is to be addedaddBuffer
- buffer containing evio data to add (not evio file format,
i.e. no block headers)EvioException
- if eventNumber < 1;
if addBuffer is null;
if addBuffer arg is empty or has non-evio format;
if addBuffer is opposite endian to current event buffer;
if added data is not the proper length (i.e. multiple of 4 bytes);
if the event number does not correspond to an existing event;
if there is an internal programming error;
if object closedpublic java.nio.ByteBuffer getData(EvioNode node) throws EvioException
node
- evio structure whose data is to be retrievedEvioException
- if object closedpublic java.nio.ByteBuffer getData(EvioNode node, boolean copy) throws EvioException
This method is due to the bulk, relative gets and puts.
node
- evio structure whose data is to be retrievedcopy
- if true
, then return a copy as opposed to a
view into this reader object's buffer.EvioException
- if object closedpublic java.nio.ByteBuffer getEventBuffer(int eventNumber) throws EvioException
This method is due to the bulk, relative gets and puts.
eventNumber
- number of event of interestEvioException
- if eventNumber < 1;
if the event number does not correspond to an existing event;
if object closedpublic java.nio.ByteBuffer getEventBuffer(int eventNumber, boolean copy) throws EvioException
This method is due to the bulk, relative gets and puts.
eventNumber
- number of event of interestcopy
- if true
, then return a copy as opposed to a
view into this reader object's buffer.EvioException
- if eventNumber < 1;
if the event number does not correspond to an existing event;
if object closedpublic java.nio.ByteBuffer getStructureBuffer(EvioNode node) throws EvioException
This method is due to the bulk, relative gets and puts.
node
- node object representing evio structure of interestEvioException
- if node is null;
if object closedpublic java.nio.ByteBuffer getStructureBuffer(EvioNode node, boolean copy) throws EvioException
This method is due to the bulk, relative gets and puts.
node
- node object representing evio structure of interestcopy
- if true
, then return a copy as opposed to a
view into this reader object's buffer.EvioException
- if node is null;
if object closedpublic void close()
public int getEventCount()
public int getBlockCount()
public void toFile(java.lang.String fileName) throws EvioException, java.io.IOException
fileName
- name of file to writejava.io.IOException
- if error writing to fileEvioException
- if fileName arg is null;
if object closedpublic void toFile(java.io.File file) throws EvioException, java.io.IOException
file
- object of file to writeEvioException
- if file arg is null;
if object closedjava.io.IOException
- if error writing to file