| Java Source Code / Java Documentation » JDK Core » io nio » java.nio |
| java.nio | ||||||||||||||||||||||||
|
Defines buffers, which are containers for data, and provides an overview of the
other NIO packages.
The central abstractions of the NIO APIs are:
The java.nio package defines the buffer classes, which are used
throughout the NIO APIs. The charset API is defined in the {@link
java.nio.charset} package, and the channel and selector APIs are defined in the
{@link java.nio.channels} package. Each of these subpackages has its own
service-provider (SPI) subpackage, the contents of which can be used to extend
the platform's default implementations or to construct alternative
implementations.
Buffers Description 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 {@link java.nio.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.
There is a buffer class for each non-boolean primitive type. Each class
defines a family of get and put methods for moving data out of
and in to a buffer, methods for compacting, duplicating, and
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 can be created by {@link
java.nio.channels.FileChannel#map mapping 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 either big-endian or little-endian 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 {@link
java.lang.NullPointerException NullPointerException} to be thrown.
@since 1.4
@version 1.18, 07/05/05
@author Mark Reinhold
@author JSR-51 Expert Group
| ||||||||||||||||||||||||
| Java Source File Name | Type | Comment | ||||||||||||||||||||||
| Bits.java | Class | Access to bits, native and otherwise. | ||||||||||||||||||||||
| Buffer.java | Class | A container for data of a specific primitive type.
A buffer is a linear, finite sequence of elements of a specific primitive type. | ||||||||||||||||||||||
| ByteBufferAs-X-Buffer.java | Class | |||||||||||||||||||||||
| ByteOrder.java | Class | A typesafe enumeration for byte orders. | ||||||||||||||||||||||
| Direct-X-Buffer-bin.java | Class | |||||||||||||||||||||||
| Direct-X-Buffer.java | Class | |||||||||||||||||||||||
| Heap-X-Buffer.java | Class | #if[rw] A read/write Heap$Type$Buffer. #else[rw] A read-only Heap$Type$Buffer. | ||||||||||||||||||||||
| MappedByteBuffer.java | Class | A direct byte buffer whose content is a memory-mapped region of a file.
Mapped byte buffers are created via the java.nio.channels.FileChannel.map FileChannel.map method. | ||||||||||||||||||||||
| StringCharBuffer.java | Class | |||||||||||||||||||||||
| X-Buffer-bin.java | Class | |||||||||||||||||||||||
| X-Buffer.java | Class | $A$ $fulltype$ buffer.
This class defines {#if[byte]?six:four} categories of operations upon $fulltype$ buffers:
| ||||||||||||||||||||||