Package javacardx.framework.nio
A buffer is a container for a fixed amount of data of a specific
primitive type. In addition to its content a buffer has a position,
which is the index of the next element to be read or written, and a
limit, which is the index of the first element that should not be read
or written. The base Buffer
class defines these properties as well as
methods for clearing, flipping, and rewinding, for
marking the current position, and for resetting the position to
the previous mark.
The javacardx.framework.nio
package defines the buffer classes,
which are used throughout the NIO APIs.
Buffers Description
Buffer
Position, limit, and capacity; clear, flip and rewind
ByteBuffer
Get/put, compact, views; allocate, wrap
ByteOrder
Typesafe enumeration for byte orders
A buffer is a container for a fixed amount of data of a specific
primitive type. In addition to its content a buffer has a position,
which is the index of the next element to be read or written, and a
limit, which is the index of the first element that should not be read
or written. The base Buffer
class defines
these properties as well as methods for clearing, flipping, and
rewinding.
This version of the specification defines a buffer class for the byte type only. It defines a family of get and put methods for moving data out of and in to a buffer, methods for slicing a buffer, and static methods for allocating a new buffer as well as for wrapping an existing array into a buffer.
Byte buffers are distinguished in that they can be used as the sources and targets of I/O operations. They also support several features not found in the other buffer classes:
-
A byte buffer can be allocated as a direct buffer, in which case the Java virtual machine will make a best effort to perform native I/O operations directly upon it.
-
A byte buffer provides access to its content as either a heterogeneous or homogeneous sequence of binary data of any non-boolean primitive type, in platform byte order.
Unless otherwise noted, passing a null
argument to a constructor or
method in any class or interface in this package will cause a
NullPointerException
to be thrown.
-
Class Summary Class Description Buffer A container for data of a specific primitive type.ByteBuffer A byte buffer.ByteOrder A typesafe enumeration for byte orders. -
Exception Summary Exception Description BufferOverflowException Unchecked exception thrown when a relative put operation reaches the target buffer's limit.BufferUnderflowException Unchecked exception thrown when a relative get operation reaches the source buffer's limit.ReadOnlyBufferException Unchecked exception thrown when a content-mutation method such asput
orcompact
is invoked upon a read-only buffer.