eve.io

Interface FastStream

public interface FastStream

Method Summary

Modifier and Type	Method and Description
int	quickRead(byte[] data, int offset, int length, boolean readAll) This attempts to read using a fast native or direct method.
void	quickWrite(byte[] data, int offset, int length) This attempts to write using a fast native or direct access method.

Method Detail

quickRead

int quickRead(byte[] data,
              int offset,
              int length,
              boolean readAll)
       throws IOException

This attempts to read using a fast native or direct method. Failing that a normal read is done. If a native method is used the method will block the entire VM until the data is read, so you should use this with care.

Parameters:

data - The destination for the data.

offset - The index in the destination for the data.

length - The number of bytes to read.

readAll - if this is true then the method will not return until a full length number of bytes have been read. If the stream ends before this then an IOException is thrown.

Returns:

the number of bytes read or -1 if the stream ended with no bytes read.

Throws:

IOException

quickWrite

void quickWrite(byte[] data,
                int offset,
                int length)
         throws IOException

This attempts to write using a fast native or direct access method. Failing that a normal write is done. If the native method is used the method will block the entire VM until the data is written, so you should use this with care.

Parameters:

data - The source of the data bytes.

offset - The index in the source of the data.

length - The number of bytes to write.

Throws:

IOException