java.nio
Class ShortToByteBufferAdapter

java.lang.Object
  java.nio.Buffer
      java.nio.ShortBuffer
          java.nio.ShortToByteBufferAdapter

All Implemented Interfaces:

Comparable<ShortBuffer>, org.apache.harmony.nio.internal.DirectBuffer

final class ShortToByteBufferAdapter
extends ShortBuffer
implements org.apache.harmony.nio.internal.DirectBuffer

This class wraps a byte buffer to be a short buffer.

Implementation notice:

• After a byte buffer instance is wrapped, it becomes privately owned by the adapter. It must NOT be accessed outside the adapter any more.
• The byte buffer's position and limit are NOT linked with the adapter. The adapter extends Buffer, thus has its own position and limit.

Field Summary

Fields inherited from class java.nio.Buffer

_elementSizeShift, capacity, limit, mark, position, UNSET_MARK

Constructor Summary

ShortToByteBufferAdapter(ByteBuffer byteBuffer)

Method Summary

void	addressValidityCheck()
ShortBuffer	asReadOnlyBuffer() Returns a readonly buffer that shares content with this buffer.
ShortBuffer	compact() Compacts this short buffer.
ShortBuffer	duplicate() Returns a duplicated buffer that shares content with this buffer.
void	free()
short	get() Returns the short at the current position and increase the position by 1.
short	get(int index) Returns a short at the specified index, and the position is not changed.
org.apache.harmony.luni.platform.PlatformAddress	getBaseAddress()
int	getByteCapacity()
org.apache.harmony.luni.platform.PlatformAddress	getEffectiveAddress()
boolean	isAddressValid()
boolean	isDirect() Returns true if this buffer is direct.
boolean	isReadOnly() Returns whether this buffer is readonly or not.
ByteOrder	order() Returns the byte order used by this buffer when converting shorts from/to bytes.
protected short[]	protectedArray() Child class implements this method to realize array().
protected int	protectedArrayOffset() Child class implements this method to realize arrayOffset().
protected boolean	protectedHasArray() Child class implements this method to realize hasArray().
ShortBuffer	put(int index, short c) Write a short to the specified index of this buffer and the position is not changed.
ShortBuffer	put(short c) Writes the given short to the current position and increase the position by 1.
ShortBuffer	put(short[] s, int off, int len) Writes shorts in the given short array, starting from the specified offset, to the current position and increase the position by the number of shorts written.
ShortBuffer	slice() Returns a sliced buffer that shares content with this buffer.
(package private) static ShortBuffer	wrap(ByteBuffer byteBuffer)

Methods inherited from class java.nio.ShortBuffer

_array, _arrayOffset, allocate, array, arrayOffset, compareTo, equals, get, get, hasArray, hashCode, put, put, toString, wrap, wrap

Methods inherited from class java.nio.Buffer

capacity, clear, flip, hasRemaining, limit, limit, mark, position, position, remaining, reset, rewind

Methods inherited from class java.lang.Object

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

Constructor Detail

ShortToByteBufferAdapter

ShortToByteBufferAdapter(ByteBuffer byteBuffer)

Method Detail

wrap

static ShortBuffer wrap(ByteBuffer byteBuffer)

getByteCapacity

public int getByteCapacity()

Specified by:

getByteCapacity in interface org.apache.harmony.nio.internal.DirectBuffer

getEffectiveAddress

public org.apache.harmony.luni.platform.PlatformAddress getEffectiveAddress()

Specified by:

getEffectiveAddress in interface org.apache.harmony.nio.internal.DirectBuffer

getBaseAddress

public org.apache.harmony.luni.platform.PlatformAddress getBaseAddress()

Specified by:

getBaseAddress in interface org.apache.harmony.nio.internal.DirectBuffer

isAddressValid

public boolean isAddressValid()

Specified by:

isAddressValid in interface org.apache.harmony.nio.internal.DirectBuffer

addressValidityCheck

public void addressValidityCheck()

Specified by:

addressValidityCheck in interface org.apache.harmony.nio.internal.DirectBuffer

free

public void free()

Specified by:

free in interface org.apache.harmony.nio.internal.DirectBuffer

asReadOnlyBuffer

public ShortBuffer asReadOnlyBuffer()

Description copied from class: ShortBuffer

Returns a readonly buffer that shares content with this buffer.

The returned buffer is guaranteed to be a new instance, even this buffer is readonly itself. The new buffer's position, limit, capacity and mark are the same as this buffer.

The new buffer shares content with this buffer, which means this buffer's change of content will be visible to the new buffer. The two buffer's position, limit and mark are independent.

Specified by:

asReadOnlyBuffer in class ShortBuffer

Returns:

A readonly version of this buffer.

compact

public ShortBuffer compact()

Description copied from class: ShortBuffer

Compacts this short buffer.

The remaining shorts will be moved to the head of the buffer, staring from position zero. Then the position is set to remaining(); the limit is set to capacity; the mark is cleared.

Specified by:

compact in class ShortBuffer

Returns:

This buffer

duplicate

public ShortBuffer duplicate()

Description copied from class: ShortBuffer

Returns a duplicated buffer that shares content with this buffer.

The duplicated buffer's position, limit, capacity and mark are the same as this buffer. The duplicated buffer's readonly property and byte order are same as this buffer too.

The new buffer shares content with this buffer, which means either buffer's change of content will be visible to the other. The two buffer's position, limit and mark are independent.

Specified by:

duplicate in class ShortBuffer

Returns:

A duplicated buffer that shares content with this buffer.

get

public short get()

Description copied from class: ShortBuffer

Returns the short at the current position and increase the position by 1.

Specified by:

get in class ShortBuffer

Returns:

The short at the current position.

get

public short get(int index)

Description copied from class: ShortBuffer

Returns a short at the specified index, and the position is not changed.

Specified by:

get in class ShortBuffer

Parameters:

index - The index, must be no less than zero and less than limit

Returns:

A short at the specified index.

isDirect

public boolean isDirect()

Description copied from class: ShortBuffer

Returns true if this buffer is direct.

A direct buffer will try its best to take advantage of native memory APIs and it may not stay in java heap, thus not affected by GC.

A short buffer is direct, if it is based on a byte buffer and the byte buffer is direct.

Specified by:

isDirect in class ShortBuffer

Returns:

True if this buffer is direct.

isReadOnly

public boolean isReadOnly()

Description copied from class: Buffer

Returns whether this buffer is readonly or not.

Specified by:

isReadOnly in class Buffer

Returns:

Whether this buffer is readonly or not.

order

public ByteOrder order()

Description copied from class: ShortBuffer

Returns the byte order used by this buffer when converting shorts from/to bytes.

If this buffer is not based on a byte buffer, then always return the platform's native byte order.

Specified by:

order in class ShortBuffer

Returns:

The byte order used by this buffer when converting shorts from/to bytes.

protectedArray

protected short[] protectedArray()

Description copied from class: ShortBuffer

Child class implements this method to realize array().

Specified by:

protectedArray in class ShortBuffer

Returns:

see array()

protectedArrayOffset

protected int protectedArrayOffset()

Description copied from class: ShortBuffer

Child class implements this method to realize arrayOffset().

Specified by:

protectedArrayOffset in class ShortBuffer

Returns:

see arrayOffset()

protectedHasArray

protected boolean protectedHasArray()

Description copied from class: ShortBuffer

Child class implements this method to realize hasArray().

Specified by:

protectedHasArray in class ShortBuffer

Returns:

see hasArray()

put

public ShortBuffer put(short c)

Description copied from class: ShortBuffer

Writes the given short to the current position and increase the position by 1.

Specified by:

put in class ShortBuffer

Parameters:

c - The short to write

Returns:

This buffer

put

public ShortBuffer put(int index,
                       short c)

Description copied from class: ShortBuffer

Write a short to the specified index of this buffer and the position is not changed.

Specified by:

put in class ShortBuffer

Parameters:

index - The index, must be no less than zero and less than the limit

c - The short to write

Returns:

This buffer

put

public ShortBuffer put(short[] s,
                       int off,
                       int len)

Description copied from class: ShortBuffer

Writes shorts in the given short array, starting from the specified offset, to the current position and increase the position by the number of shorts written.

Overrides:

put in class ShortBuffer

Parameters:

s - The source short array

off - The offset of short array, must be no less than zero and no greater than src.length

len - The number of shorts to write, must be no less than zero and no greater than src.length - off

Returns:

This buffer

slice

public ShortBuffer slice()

Description copied from class: ShortBuffer

Returns a sliced buffer that shares content with this buffer.

The sliced buffer's capacity will be this buffer's remaining(), and its zero position will correspond to this buffer's current position. The new buffer's position will be 0, limit will be its capacity, and its mark is unset. The new buffer's readonly property and byte order are same as this buffer.

The new buffer shares content with this buffer, which means either buffer's change of content will be visible to the other. The two buffer's position, limit and mark are independent.

Specified by:

slice in class ShortBuffer

Returns:

A sliced buffer that shares content with this buffer.