jdk.dio.generic

Interface GenericBufferIODevice

All Superinterfaces:

java.lang.AutoCloseable, BufferAccess<java.nio.ByteBuffer>, java.nio.channels.ByteChannel, java.nio.channels.Channel, java.io.Closeable, Device<GenericDevice>, GenericDevice, java.nio.channels.ReadableByteChannel, java.nio.channels.WritableByteChannel

public interface GenericBufferIODevice
extends GenericDevice, java.nio.channels.ByteChannel, BufferAccess<java.nio.ByteBuffer>

The GenericBufferIODevice interface defines generic methods for accessing and controlling devices using read and write operations.

A platform implementer may allow through this interface access and control of devices for which there exist no other more specific API such as SPIDevice or I2CDevice.

Since:

1.0

Field Summary

Fields inherited from interface jdk.dio.Device

BIG_ENDIAN, LITTLE_ENDIAN, MIXED_ENDIAN

Method Summary

Methods

Modifier and Type	Method and Description
int	read(java.nio.ByteBuffer dst) Reads a sequence of bytes from this device into the given buffer.
int	read(int skip, java.nio.ByteBuffer dst) Reads a sequence of bytes from this device into the given buffer, skipping the first skip bytes read.
int	write(java.nio.ByteBuffer src) Writes a sequence of bytes to this device from the given buffer.

Methods inherited from interface jdk.dio.generic.GenericDevice

getControl, setControl, setEventListener

Methods inherited from interface jdk.dio.Device

close, getByteOrder, getDescriptor, isOpen, tryLock, unlock

Methods inherited from interface jdk.dio.BufferAccess

getInputBuffer, getOutputBuffer, prepareBuffer

Method Detail

read

int read(java.nio.ByteBuffer dst)
         throws java.io.IOException,
                UnavailableDeviceException,
                UnsupportedByteOrderException,
                ClosedDeviceException

Reads a sequence of bytes from this device into the given buffer.

The availability of new input data may be notified through an GenericEvent with ID GenericEvent.INPUT_DATA_AVAILABLE.

Specified by:

read in interface java.nio.channels.ReadableByteChannel

Parameters:

dst - The buffer into which bytes are to be transferred.

Returns:

The number of bytes read into dst, possibly zero, or -1 if the device has reached end-of-stream

Throws:

java.lang.NullPointerException - If dst is null.

UnavailableDeviceException - if this device is not currently available - such as it is locked by another application.

UnsupportedByteOrderException - if the byte ordering of the provided buffer is not supported (see Device Byte Order).

ClosedDeviceException - if the device has been closed.

java.io.IOException - if an I/O error occurred such as the device is not readable.

read

int read(int skip,
       java.nio.ByteBuffer dst)
         throws java.io.IOException,
                UnavailableDeviceException,
                UnsupportedByteOrderException,
                ClosedDeviceException

Reads a sequence of bytes from this device into the given buffer, skipping the first skip bytes read.

Apart from skipping the first skip bytes, this method behaves identically to read(java.nio.ByteBuffer).

Parameters:

skip - the number of read bytes that must be ignored/skipped before filling in the dst buffer.

dst - The buffer into which bytes are to be transferred.

Returns:

The number of bytes read into dst, possibly zero, or -1 if the device has reached end-of-stream

Throws:

java.lang.NullPointerException - If dst is null.

java.lang.IllegalArgumentException - If skip is negative.

UnavailableDeviceException - if this device is not currently available - such as it is locked by another application.

UnsupportedByteOrderException - if the byte ordering of the provided buffer is not supported (see Device Byte Order).

ClosedDeviceException - if the device has been closed.

java.io.IOException - if an I/O error occurred such as the device is not readable.

write

int write(java.nio.ByteBuffer src)
          throws java.io.IOException,
                 UnavailableDeviceException,
                 UnsupportedByteOrderException,
                 ClosedDeviceException

Writes a sequence of bytes to this device from the given buffer.

An empty output buffer condition may be notified through an GenericEvent with ID GenericEvent.OUTPUT_BUFFER_EMPTY.

Specified by:

write in interface java.nio.channels.WritableByteChannel

Parameters:

src - The buffer from which bytes are to be retrieved.

Returns:

The number of bytes written from src, possibly zero.

Throws:

java.lang.NullPointerException - If src is null.

UnavailableDeviceException - if this device is not currently available - such as it is locked by another application.

UnsupportedByteOrderException - if the byte ordering of the provided buffer is not supported (see Device Byte Order).

ClosedDeviceException - if the device has been closed.

java.io.IOException - if an I/O error occurred such as the device is not writable.