java.nio
Class DirectByteBufferR

java.lang.Object
  java.nio.Buffer
      java.nio.ByteBuffer
          java.nio.MappedByteBuffer
              java.nio.DirectByteBuffer
                  java.nio.DirectByteBufferR

All Implemented Interfaces:

Comparable, sun.nio.ch.DirectBuffer

class DirectByteBufferR

extends DirectByteBuffer

implements sun.nio.ch.DirectBuffer

Field Summary

protected static boolean	unaligned
protected static sun.misc.Unsafe	unsafe
protected Object	viewedBuffer

Fields inherited from class java.nio.MappedByteBuffer

isAMappedBuffer

Fields inherited from class java.nio.ByteBuffer

bigEndian, hb, isReadOnly, nativeByteOrder, offset

Fields inherited from class java.nio.Buffer

address

Constructor Summary

(package private)	DirectByteBufferR(sun.nio.ch.DirectBuffer db, int mark, int pos, int lim, int cap, int off)
(package private)	DirectByteBufferR(int cap)
protected	DirectByteBufferR(int cap, long addr, Runnable unmapper)

Method Summary

(package private) byte	_get(int i)
(package private) void	_put(int i, byte b)
long	address()
CharBuffer	asCharBuffer() Creates a view of this byte buffer as a char buffer.
DoubleBuffer	asDoubleBuffer() Creates a view of this byte buffer as a double buffer.
FloatBuffer	asFloatBuffer() Creates a view of this byte buffer as a float buffer.
IntBuffer	asIntBuffer() Creates a view of this byte buffer as an int buffer.
LongBuffer	asLongBuffer() Creates a view of this byte buffer as a long buffer.
ByteBuffer	asReadOnlyBuffer() Creates a new, read-only byte buffer that shares this buffer's content.
ShortBuffer	asShortBuffer() Creates a view of this byte buffer as a short buffer.
sun.misc.Cleaner	cleaner()
ByteBuffer	compact() Compacts this buffer (optional operation).
ByteBuffer	duplicate() Creates a new byte buffer that shares this buffer's content.
byte	get() Relative get method.
ByteBuffer	get(byte[] dst, int offset, int length) Relative bulk get method.
byte	get(int i) Absolute get method.
char	getChar() Relative get method for reading a char value.
char	getChar(int i) Absolute get method for reading a char value.
double	getDouble() Relative get method for reading a double value.
double	getDouble(int i) Absolute get method for reading a double value.
float	getFloat() Relative get method for reading a float value.
float	getFloat(int i) Absolute get method for reading a float value.
int	getInt() Relative get method for reading an int value.
int	getInt(int i) Absolute get method for reading an int value.
long	getLong() Relative get method for reading a long value.
long	getLong(int i) Absolute get method for reading a long value.
short	getShort() Relative get method for reading a short value.
short	getShort(int i) Absolute get method for reading a short value.
boolean	isDirect() Tells whether or not this byte buffer is direct.
boolean	isReadOnly() Tells whether or not this buffer is read-only.
ByteBuffer	put(byte x) Relative put method (optional operation).
ByteBuffer	put(byte[] src, int offset, int length) Relative bulk put method (optional operation).
ByteBuffer	put(ByteBuffer src) Relative bulk put method (optional operation).
ByteBuffer	put(int i, byte x) Absolute put method (optional operation).
ByteBuffer	putChar(char x) Relative put method for writing a char value (optional operation).
ByteBuffer	putChar(int i, char x) Absolute put method for writing a char value (optional operation).
private ByteBuffer	putChar(long a, char x)
ByteBuffer	putDouble(double x) Relative put method for writing a double value (optional operation).
ByteBuffer	putDouble(int i, double x) Absolute put method for writing a double value (optional operation).
private ByteBuffer	putDouble(long a, double x)
ByteBuffer	putFloat(float x) Relative put method for writing a float value (optional operation).
ByteBuffer	putFloat(int i, float x) Absolute put method for writing a float value (optional operation).
private ByteBuffer	putFloat(long a, float x)
ByteBuffer	putInt(int x) Relative put method for writing an int value (optional operation).
ByteBuffer	putInt(int i, int x) Absolute put method for writing an int value (optional operation).
private ByteBuffer	putInt(long a, int x)
ByteBuffer	putLong(int i, long x) Absolute put method for writing a long value (optional operation).
ByteBuffer	putLong(long x) Relative put method for writing a long value (optional operation).
private ByteBuffer	putLong(long a, long x)
ByteBuffer	putShort(int i, short x) Absolute put method for writing a short value (optional operation).
private ByteBuffer	putShort(long a, short x)
ByteBuffer	putShort(short x) Relative put method for writing a short value (optional operation).
ByteBuffer	slice() Creates a new byte buffer whose content is a shared subsequence of this buffer's content.
Object	viewedBuffer()

Methods inherited from class java.nio.MappedByteBuffer

force, isLoaded, load

Methods inherited from class java.nio.ByteBuffer

allocate, allocateDirect, array, arrayOffset, compareTo, equals, get, hasArray, hashCode, order, order, put, toString, wrap, wrap

Methods inherited from class java.nio.Buffer

capacity, checkBounds, checkIndex, checkIndex, clear, flip, hasRemaining, limit, limit, mark, markValue, nextGetIndex, nextGetIndex, nextPutIndex, nextPutIndex, position, position, remaining, reset, rewind

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface sun.nio.ch.DirectBuffer

address, cleaner, viewedBuffer

Field Detail

unsafe

protected static final sun.misc.Unsafe unsafe

unaligned

protected static final boolean unaligned

viewedBuffer

protected Object viewedBuffer

Constructor Detail

DirectByteBufferR

DirectByteBufferR(int cap)

DirectByteBufferR

protected DirectByteBufferR(int cap,
                            long addr,
                            Runnable unmapper)

DirectByteBufferR

DirectByteBufferR(sun.nio.ch.DirectBuffer db,
                  int mark,
                  int pos,
                  int lim,
                  int cap,
                  int off)

Method Detail

slice

public ByteBuffer slice()

Description copied from class: ByteBuffer

Creates a new byte buffer whose content is a shared subsequence of this buffer's content.

The content of the new buffer will start at this buffer's current position. Changes to this buffer's content will be visible in the new buffer, and vice versa; the two buffers' position, limit, and mark values will be independent.

The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer, and its mark will be undefined. The new buffer will be direct if, and only if, this buffer is direct, and it will be read-only if, and only if, this buffer is read-only.

Overrides:

slice in class DirectByteBuffer

duplicate

public ByteBuffer duplicate()

Description copied from class: ByteBuffer

Creates a new byte buffer that shares this buffer's content.

The content of the new buffer will be that of this buffer. Changes to this buffer's content will be visible in the new buffer, and vice versa; the two buffers' position, limit, and mark values will be independent.

The new buffer's capacity, limit, position, and mark values will be identical to those of this buffer. The new buffer will be direct if, and only if, this buffer is direct, and it will be read-only if, and only if, this buffer is read-only.

Overrides:

duplicate in class DirectByteBuffer

asReadOnlyBuffer

public ByteBuffer asReadOnlyBuffer()

Description copied from class: ByteBuffer

Creates a new, read-only byte buffer that shares this buffer's content.

The content of the new buffer will be that of this buffer. Changes to this buffer's content will be visible in the new buffer; the new buffer itself, however, will be read-only and will not allow the shared content to be modified. The two buffers' position, limit, and mark values will be independent.

The new buffer's capacity, limit, position, and mark values will be identical to those of this buffer.

If this buffer is itself read-only then this method behaves in exactly the same way as the duplicate method.

Overrides:

asReadOnlyBuffer in class DirectByteBuffer

put

public ByteBuffer put(byte x)

Description copied from class: ByteBuffer

Relative put method (optional operation).

Writes the given byte into this buffer at the current position, and then increments the position.

Overrides:

put in class DirectByteBuffer

put

public ByteBuffer put(int i,
                      byte x)

Description copied from class: ByteBuffer

Absolute put method (optional operation).

Writes the given byte into this buffer at the given index.

Overrides:

put in class DirectByteBuffer

put

public ByteBuffer put(ByteBuffer src)

Description copied from class: ByteBuffer

Relative bulk put method (optional operation).

This method transfers the bytes remaining in the given source buffer into this buffer. If there are more bytes remaining in the source buffer than in this buffer, that is, if src.remaining() > remaining(), then no bytes are transferred and a BufferOverflowException is thrown.

Otherwise, this method copies n = src.remaining() bytes from the given buffer into this buffer, starting at each buffer's current position. The positions of both buffers are then incremented by n.

In other words, an invocation of this method of the form dst.put(src) has exactly the same effect as the loop

     while (src.hasRemaining())
         dst.put(src.get()); 

except that it first checks that there is sufficient space in this buffer and it is potentially much more efficient.

Overrides:

put in class DirectByteBuffer

put

public ByteBuffer put(byte[] src,
                      int offset,
                      int length)

Description copied from class: ByteBuffer

Relative bulk put method (optional operation).

This method transfers bytes into this buffer from the given source array. If there are more bytes to be copied from the array than remain in this buffer, that is, if length > remaining(), then no bytes are transferred and a BufferOverflowException is thrown.

Otherwise, this method copies length bytes from the given array into this buffer, starting at the given offset in the array and at the current position of this buffer. The position of this buffer is then incremented by length.

In other words, an invocation of this method of the form dst.put(src, off, len) has exactly the same effect as the loop

     for (int i = off; i < off + len; i++)
         dst.put(a[i]); 

except that it first checks that there is sufficient space in this buffer and it is potentially much more efficient.

Overrides:

put in class DirectByteBuffer

compact

public ByteBuffer compact()

Description copied from class: ByteBuffer

Compacts this buffer (optional operation).

The bytes between the buffer's current position and its limit, if any, are copied to the beginning of the buffer. That is, the byte at index p = position() is copied to index zero, the byte at index p + 1 is copied to index one, and so forth until the byte at index limit() - 1 is copied to index n = limit() - 1 - p. The buffer's position is then set to n+1 and its limit is set to its capacity. The mark, if defined, is discarded.

The buffer's position is set to the number of bytes copied, rather than to zero, so that an invocation of this method can be followed immediately by an invocation of another relative put method.

Invoke this method after writing data from a buffer in case the write was incomplete. The following loop, for example, copies bytes from one channel to another via the buffer buf:

 buf.clear();          // Prepare buffer for use
 for (;;) {
     if (in.read(buf) < 0 && !buf.hasRemaining())
         break;        // No more bytes to transfer
     buf.flip();
     out.write(buf);
     buf.compact();    // In case of partial write
 }

Overrides:

compact in class DirectByteBuffer

isDirect

public boolean isDirect()

Description copied from class: ByteBuffer

Tells whether or not this byte buffer is direct.

Overrides:

isDirect in class DirectByteBuffer

isReadOnly

public boolean isReadOnly()

Description copied from class: Buffer

Tells whether or not this buffer is read-only.

Overrides:

isReadOnly in class DirectByteBuffer

_get

byte _get(int i)

Overrides:

_get in class DirectByteBuffer

_put

void _put(int i,
          byte b)

Overrides:

_put in class DirectByteBuffer

putChar

private ByteBuffer putChar(long a,
                           char x)

putChar

public ByteBuffer putChar(char x)

Description copied from class: ByteBuffer

Relative put method for writing a char value (optional operation).

Writes two bytes containing the given char value, in the current byte order, into this buffer at the current position, and then increments the position by two.

Overrides:

putChar in class DirectByteBuffer

putChar

public ByteBuffer putChar(int i,
                          char x)

Description copied from class: ByteBuffer

Absolute put method for writing a char value (optional operation).

Writes two bytes containing the given char value, in the current byte order, into this buffer at the given index.

Overrides:

putChar in class DirectByteBuffer

asCharBuffer

public CharBuffer asCharBuffer()

Description copied from class: ByteBuffer

Creates a view of this byte buffer as a char buffer.

The content of the new buffer will start at this buffer's current position. Changes to this buffer's content will be visible in the new buffer, and vice versa; the two buffers' position, limit, and mark values will be independent.

The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer divided by two, and its mark will be undefined. The new buffer will be direct if, and only if, this buffer is direct, and it will be read-only if, and only if, this buffer is read-only.

Overrides:

asCharBuffer in class DirectByteBuffer

putShort

private ByteBuffer putShort(long a,
                            short x)

putShort

public ByteBuffer putShort(short x)

Description copied from class: ByteBuffer

Relative put method for writing a short value (optional operation).

Writes two bytes containing the given short value, in the current byte order, into this buffer at the current position, and then increments the position by two.

Overrides:

putShort in class DirectByteBuffer

putShort

public ByteBuffer putShort(int i,
                           short x)

Description copied from class: ByteBuffer

Absolute put method for writing a short value (optional operation).

Writes two bytes containing the given short value, in the current byte order, into this buffer at the given index.

Overrides:

putShort in class DirectByteBuffer

asShortBuffer

public ShortBuffer asShortBuffer()

Description copied from class: ByteBuffer

Creates a view of this byte buffer as a short buffer.

The content of the new buffer will start at this buffer's current position. Changes to this buffer's content will be visible in the new buffer, and vice versa; the two buffers' position, limit, and mark values will be independent.

The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer divided by two, and its mark will be undefined. The new buffer will be direct if, and only if, this buffer is direct, and it will be read-only if, and only if, this buffer is read-only.

Overrides:

asShortBuffer in class DirectByteBuffer

putInt

private ByteBuffer putInt(long a,
                          int x)

putInt

public ByteBuffer putInt(int x)

Description copied from class: ByteBuffer

Relative put method for writing an int value (optional operation).

Writes four bytes containing the given int value, in the current byte order, into this buffer at the current position, and then increments the position by four.

Overrides:

putInt in class DirectByteBuffer

putInt

public ByteBuffer putInt(int i,
                         int x)

Description copied from class: ByteBuffer

Absolute put method for writing an int value (optional operation).

Writes four bytes containing the given int value, in the current byte order, into this buffer at the given index.

Overrides:

putInt in class DirectByteBuffer

asIntBuffer

public IntBuffer asIntBuffer()

Description copied from class: ByteBuffer

Creates a view of this byte buffer as an int buffer.

The content of the new buffer will start at this buffer's current position. Changes to this buffer's content will be visible in the new buffer, and vice versa; the two buffers' position, limit, and mark values will be independent.

The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer divided by four, and its mark will be undefined. The new buffer will be direct if, and only if, this buffer is direct, and it will be read-only if, and only if, this buffer is read-only.

Overrides:

asIntBuffer in class DirectByteBuffer

putLong

private ByteBuffer putLong(long a,
                           long x)

putLong

public ByteBuffer putLong(long x)

Description copied from class: ByteBuffer

Relative put method for writing a long value (optional operation).

Writes eight bytes containing the given long value, in the current byte order, into this buffer at the current position, and then increments the position by eight.

Overrides:

putLong in class DirectByteBuffer

putLong

public ByteBuffer putLong(int i,
                          long x)

Description copied from class: ByteBuffer

Absolute put method for writing a long value (optional operation).

Writes eight bytes containing the given long value, in the current byte order, into this buffer at the given index.

Overrides:

putLong in class DirectByteBuffer

asLongBuffer

public LongBuffer asLongBuffer()

Description copied from class: ByteBuffer

Creates a view of this byte buffer as a long buffer.

The content of the new buffer will start at this buffer's current position. Changes to this buffer's content will be visible in the new buffer, and vice versa; the two buffers' position, limit, and mark values will be independent.

The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer divided by eight, and its mark will be undefined. The new buffer will be direct if, and only if, this buffer is direct, and it will be read-only if, and only if, this buffer is read-only.

Overrides:

asLongBuffer in class DirectByteBuffer

putFloat

private ByteBuffer putFloat(long a,
                            float x)

putFloat

public ByteBuffer putFloat(float x)

Description copied from class: ByteBuffer

Relative put method for writing a float value (optional operation).

Writes four bytes containing the given float value, in the current byte order, into this buffer at the current position, and then increments the position by four.

Overrides:

putFloat in class DirectByteBuffer

putFloat

public ByteBuffer putFloat(int i,
                           float x)

Description copied from class: ByteBuffer

Absolute put method for writing a float value (optional operation).

Writes four bytes containing the given float value, in the current byte order, into this buffer at the given index.

Overrides:

putFloat in class DirectByteBuffer

asFloatBuffer

public FloatBuffer asFloatBuffer()

Description copied from class: ByteBuffer

Creates a view of this byte buffer as a float buffer.

The content of the new buffer will start at this buffer's current position. Changes to this buffer's content will be visible in the new buffer, and vice versa; the two buffers' position, limit, and mark values will be independent.

The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer divided by four, and its mark will be undefined. The new buffer will be direct if, and only if, this buffer is direct, and it will be read-only if, and only if, this buffer is read-only.

Overrides:

asFloatBuffer in class DirectByteBuffer

putDouble

private ByteBuffer putDouble(long a,
                             double x)

putDouble

public ByteBuffer putDouble(double x)

Description copied from class: ByteBuffer

Relative put method for writing a double value (optional operation).

Writes eight bytes containing the given double value, in the current byte order, into this buffer at the current position, and then increments the position by eight.

Overrides:

putDouble in class DirectByteBuffer

putDouble

public ByteBuffer putDouble(int i,
                            double x)

Description copied from class: ByteBuffer

Absolute put method for writing a double value (optional operation).

Writes eight bytes containing the given double value, in the current byte order, into this buffer at the given index.

Overrides:

putDouble in class DirectByteBuffer

asDoubleBuffer

public DoubleBuffer asDoubleBuffer()

Description copied from class: ByteBuffer

Creates a view of this byte buffer as a double buffer.

The content of the new buffer will start at this buffer's current position. Changes to this buffer's content will be visible in the new buffer, and vice versa; the two buffers' position, limit, and mark values will be independent.

The new buffer's position will be zero, its capacity and its limit will be the number of bytes remaining in this buffer divided by eight, and its mark will be undefined. The new buffer will be direct if, and only if, this buffer is direct, and it will be read-only if, and only if, this buffer is read-only.

Overrides:

asDoubleBuffer in class DirectByteBuffer

viewedBuffer

public Object viewedBuffer()

Specified by:

viewedBuffer in interface sun.nio.ch.DirectBuffer

cleaner

public sun.misc.Cleaner cleaner()

Specified by:

cleaner in interface sun.nio.ch.DirectBuffer

address

public long address()

Specified by:

address in interface sun.nio.ch.DirectBuffer

get

public byte get()

Description copied from class: ByteBuffer

Relative get method. Reads the byte at this buffer's current position, and then increments the position.

Specified by:

get in class ByteBuffer

Returns:

The byte at the buffer's current position

get

public byte get(int i)

Description copied from class: ByteBuffer

Absolute get method. Reads the byte at the given index.

Specified by:

get in class ByteBuffer

Parameters:

i - The index from which the byte will be read

Returns:

The byte at the given index

get

public ByteBuffer get(byte[] dst,
                      int offset,
                      int length)

Description copied from class: ByteBuffer

Relative bulk get method.

This method transfers bytes from this buffer into the given destination array. If there are fewer bytes remaining in the buffer than are required to satisfy the request, that is, if length > remaining(), then no bytes are transferred and a BufferUnderflowException is thrown.

Otherwise, this method copies length bytes from this buffer into the given array, starting at the current position of this buffer and at the given offset in the array. The position of this buffer is then incremented by length.

In other words, an invocation of this method of the form src.get(dst, off, len) has exactly the same effect as the loop

     for (int i = off; i < off + len; i++)
         dst[i] = src.get(); 

except that it first checks that there are sufficient bytes in this buffer and it is potentially much more efficient.

Overrides:

get in class ByteBuffer

Parameters:

dst - The array into which bytes are to be written

offset - The offset within the array of the first byte to be written; must be non-negative and no larger than dst.length

length - The maximum number of bytes to be written to the given array; must be non-negative and no larger than dst.length - offset

Returns:

This buffer

getChar

public char getChar()

Description copied from class: ByteBuffer

Relative get method for reading a char value.

Reads the next two bytes at this buffer's current position, composing them into a char value according to the current byte order, and then increments the position by two.

Specified by:

getChar in class ByteBuffer

Returns:

The char value at the buffer's current position

getChar

public char getChar(int i)

Description copied from class: ByteBuffer

Absolute get method for reading a char value.

Reads two bytes at the given index, composing them into a char value according to the current byte order.

Specified by:

getChar in class ByteBuffer

Parameters:

i - The index from which the bytes will be read

Returns:

The char value at the given index

getShort

public short getShort()

Description copied from class: ByteBuffer

Relative get method for reading a short value.

Reads the next two bytes at this buffer's current position, composing them into a short value according to the current byte order, and then increments the position by two.

Specified by:

getShort in class ByteBuffer

Returns:

The short value at the buffer's current position

getShort

public short getShort(int i)

Description copied from class: ByteBuffer

Absolute get method for reading a short value.

Reads two bytes at the given index, composing them into a short value according to the current byte order.

Specified by:

getShort in class ByteBuffer

Parameters:

i - The index from which the bytes will be read

Returns:

The short value at the given index

getInt

public int getInt()

Description copied from class: ByteBuffer

Relative get method for reading an int value.

Reads the next four bytes at this buffer's current position, composing them into an int value according to the current byte order, and then increments the position by four.

Specified by:

getInt in class ByteBuffer

Returns:

The int value at the buffer's current position

getInt

public int getInt(int i)

Description copied from class: ByteBuffer

Absolute get method for reading an int value.

Reads four bytes at the given index, composing them into a int value according to the current byte order.

Specified by:

getInt in class ByteBuffer

Parameters:

i - The index from which the bytes will be read

Returns:

The int value at the given index

getLong

public long getLong()

Description copied from class: ByteBuffer

Relative get method for reading a long value.

Reads the next eight bytes at this buffer's current position, composing them into a long value according to the current byte order, and then increments the position by eight.

Specified by:

getLong in class ByteBuffer

Returns:

The long value at the buffer's current position

getLong

public long getLong(int i)

Description copied from class: ByteBuffer

Absolute get method for reading a long value.

Reads eight bytes at the given index, composing them into a long value according to the current byte order.

Specified by:

getLong in class ByteBuffer

Parameters:

i - The index from which the bytes will be read

Returns:

The long value at the given index

getFloat

public float getFloat()

Description copied from class: ByteBuffer

Relative get method for reading a float value.

Reads the next four bytes at this buffer's current position, composing them into a float value according to the current byte order, and then increments the position by four.

Specified by:

getFloat in class ByteBuffer

Returns:

The float value at the buffer's current position

getFloat

public float getFloat(int i)

Description copied from class: ByteBuffer

Absolute get method for reading a float value.

Reads four bytes at the given index, composing them into a float value according to the current byte order.

Specified by:

getFloat in class ByteBuffer

Parameters:

i - The index from which the bytes will be read

Returns:

The float value at the given index

getDouble

public double getDouble()

Description copied from class: ByteBuffer

Relative get method for reading a double value.

Reads the next eight bytes at this buffer's current position, composing them into a double value according to the current byte order, and then increments the position by eight.

Specified by:

getDouble in class ByteBuffer

Returns:

The double value at the buffer's current position

getDouble

public double getDouble(int i)

Description copied from class: ByteBuffer

Absolute get method for reading a double value.

Reads eight bytes at the given index, composing them into a double value according to the current byte order.

Specified by:

getDouble in class ByteBuffer

Parameters:

i - The index from which the bytes will be read

Returns:

The double value at the given index