org.sellcom.core.io

Class Io

java.lang.Object

org.sellcom.core.io.Io

public class Io
extends Object

I/O operations.

Since:

1.0

Method Summary

Modifier and Type	Method and Description
static void	close(Closeable closeable) Closes the given Closeable, ignoring any possible I/O exception.
static int	copyBytes(InputStream source, OutputStream destination) Copies all bytes from the given source to the given destination.
static void	copyBytes(InputStream source, OutputStream destination, int byteCount) Copies the given number of bytes from the given source to the given destination.
static int	discardBytes(InputStream source) Discards all bytes from the given source.
static void	discardBytes(InputStream source, int byteCount) Discards the given number of bytes from the given source.
static int	getBufferSize() Returns the size of the buffer (in bytes) used in I/O operations.
static byte	readByte(InputStream source) Reads a byte from the given source.
static byte[]	readBytes(InputStream source) Reads all bytes from the given source.
static byte[]	readBytes(InputStream source, int byteCount) Reads the given number of bytes from the given source.
static char	readChar(InputStream source) Reads a char from the given source using the default (big-endian) byte order.
static char	readChar(InputStream source, ByteOrder byteOrder) Reads a char from the given source using the given byte order.
static double	readDouble(InputStream source) Reads a double from the given source using the default (big-endian) byte order.
static double	readDouble(InputStream source, ByteOrder byteOrder) Reads a double from the given source using the given byte order.
static float	readFloat(InputStream source) Reads a float from the given source using the default (big-endian) byte order.
static float	readFloat(InputStream source, ByteOrder byteOrder) Reads a float from the given source using the given byte order.
static int	readInt(InputStream source) Reads an int from the given source using the default (big-endian) byte order.
static int	readInt(InputStream source, ByteOrder byteOrder) Reads an int from the given source using the given byte order.
static long	readLong(InputStream source) Reads a long from the given source using the default (big-endian) byte order.
static long	readLong(InputStream source, ByteOrder byteOrder) Reads a long from the given source using the given byte order.
static short	readShort(InputStream source) Reads a short from the given source using the default (big-endian) byte order.
static short	readShort(InputStream source, ByteOrder byteOrder) Reads a short from the given source using the given byte order.
static String	readString(InputStream source) Reads all bytes from the given source and converts them to a string using UTF-8.
static String	readString(InputStream source, Charset charset) Reads all bytes from the given source and converts them to a string using the given charset.
static String	readString(InputStream source, int byteCount) Reads the given number of bytes from the given source and converts them to a string using UTF-8.
static String	readString(InputStream source, int byteCount, Charset charset) Reads the given number of bytes from the given source and converts them to a string using the given charset.
static int	readUnsignedByte(InputStream source) Reads an unsigned byte from the given source.
static UUID	readUuid(InputStream source) Reads a UUID} from the given source using the default (big-endian) byte order.
static UUID	readUuid(InputStream source, ByteOrder byteOrder) Reads a UUID} from the given source using the given byte order.
static void	setBufferSize(int bufferSize) Sets the size of the buffer (in bytes) used in I/O operations.
static void	writeByte(OutputStream destination, byte value) Writes a byte to the given destination.
static void	writeBytes(OutputStream destination, byte[] bytes) Writes the given bytes to the given destination.
static void	writeChar(OutputStream destination, char value) Writes a char to the given destination using the default (big-endian) byte order.
static void	writeChar(OutputStream destination, char value, ByteOrder byteOrder) Writes a char to the given destination using the given byte order.
static void	writeDouble(OutputStream destination, double value) Writes a double to the given destination using the default (big-endian) byte order.
static void	writeDouble(OutputStream destination, double value, ByteOrder byteOrder) Writes a double to the given destination using the given byte order.
static void	writeFloat(OutputStream destination, float value) Writes a float to the given destination using the default (big-endian) byte order.
static void	writeFloat(OutputStream destination, float value, ByteOrder byteOrder) Writes a float to the given destination using the given byte order.
static void	writeInt(OutputStream destination, int value) Writes an int to the given destination using the default (big-endian) byte order.
static void	writeInt(OutputStream destination, int value, ByteOrder byteOrder) Writes an int to the given destination using the given byte order.
static void	writeLong(OutputStream destination, long value) Writes a long to the given destination using the default (big-endian) byte order.
static void	writeLong(OutputStream destination, long value, ByteOrder byteOrder) Writes a long to the given destination using the given byte order.
static void	writeShort(OutputStream destination, short value) Writes a short to the given destination using the default (big-endian) byte order.
static void	writeShort(OutputStream destination, short value, ByteOrder byteOrder) Writes a short to the given destination using the given byte order.
static void	writeString(OutputStream destination, String string) Writes the given string to the given destination using UTF-8.
static void	writeString(OutputStream destination, String string, Charset charset) Writes the given string to the given destination using the given charset.
static void	writeUnsignedByte(OutputStream destination, int value) Writes an unsigned byte to the given destination.
static void	writeUuid(OutputStream destination, UUID uuid) Writes a UUID to the given destination using the default (big-endian) byte order.
static void	writeUuid(OutputStream destination, UUID uuid, ByteOrder byteOrder) Writes a UUID to the given destination using the given byte order.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

close

public static void close(Closeable closeable)

Closes the given Closeable, ignoring any possible I/O exception.

Since:

1.0

copyBytes

public static int copyBytes(InputStream source,
                            OutputStream destination)
                     throws IOException

Copies all bytes from the given source to the given destination. Returns the number of bytes copied.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

copyBytes

public static void copyBytes(InputStream source,
                             OutputStream destination,
                             int byteCount)
                      throws IOException

Copies the given number of bytes from the given source to the given destination. Copies all bytes if the number of bytes is negative.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

discardBytes

public static int discardBytes(InputStream source)
                        throws IOException

Discards all bytes from the given source. Returns the number of bytes discarded.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

discardBytes

public static void discardBytes(InputStream source,
                                int byteCount)
                         throws IOException

Discards the given number of bytes from the given source. Discards all bytes if the number of bytes is negative.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

getBufferSize

public static int getBufferSize()

Returns the size of the buffer (in bytes) used in I/O operations.

Since:

1.0

readByte

public static byte readByte(InputStream source)
                     throws IOException

Reads a byte from the given source.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readBytes

public static byte[] readBytes(InputStream source)
                        throws IOException

Reads all bytes from the given source.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readBytes

public static byte[] readBytes(InputStream source,
                               int byteCount)
                        throws IOException

Reads the given number of bytes from the given source. Reads all bytes if the number of bytes is negative.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readChar

public static char readChar(InputStream source)
                     throws IOException

Reads a char from the given source using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readChar

public static char readChar(InputStream source,
                            ByteOrder byteOrder)
                     throws IOException

Reads a char from the given source using the given byte order.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

readDouble

public static double readDouble(InputStream source)
                         throws IOException

Reads a double from the given source using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readDouble

public static double readDouble(InputStream source,
                                ByteOrder byteOrder)
                         throws IOException

Reads a double from the given source using the given byte order.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

readFloat

public static float readFloat(InputStream source)
                       throws IOException

Reads a float from the given source using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readFloat

public static float readFloat(InputStream source,
                              ByteOrder byteOrder)
                       throws IOException

Reads a float from the given source using the given byte order.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

readInt

public static int readInt(InputStream source)
                   throws IOException

Reads an int from the given source using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readInt

public static int readInt(InputStream source,
                          ByteOrder byteOrder)
                   throws IOException

Reads an int from the given source using the given byte order.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

readLong

public static long readLong(InputStream source)
                     throws IOException

Reads a long from the given source using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readLong

public static long readLong(InputStream source,
                            ByteOrder byteOrder)
                     throws IOException

Reads a long from the given source using the given byte order.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

readShort

public static short readShort(InputStream source)
                       throws IOException

Reads a short from the given source using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readShort

public static short readShort(InputStream source,
                              ByteOrder byteOrder)
                       throws IOException

Reads a short from the given source using the given byte order.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

readString

public static String readString(InputStream source)
                         throws IOException

Reads all bytes from the given source and converts them to a string using UTF-8.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readString

public static String readString(InputStream source,
                                Charset charset)
                         throws IOException

Reads all bytes from the given source and converts them to a string using the given charset.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if charset is null

IOException - if an I/O error occurs

Since:

1.0

readString

public static String readString(InputStream source,
                                int byteCount)
                         throws IOException

Reads the given number of bytes from the given source and converts them to a string using UTF-8. Reads all bytes if the number of bytes is negative.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readString

public static String readString(InputStream source,
                                int byteCount,
                                Charset charset)
                         throws IOException

Reads the given number of bytes from the given source and converts them to a string using the given charset. Reads all bytes if the number of bytes is negative.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if charset is null

IOException - if an I/O error occurs

Since:

1.0

readUnsignedByte

public static int readUnsignedByte(InputStream source)
                            throws IOException

Reads an unsigned byte from the given source.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readUuid

public static UUID readUuid(InputStream source)
                     throws IOException

Reads a UUID} from the given source using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if source is null

IOException - if an I/O error occurs

Since:

1.0

readUuid

public static UUID readUuid(InputStream source,
                            ByteOrder byteOrder)
                     throws IOException

Reads a UUID} from the given source using the given byte order.

Throws:

IllegalArgumentException - if source is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

setBufferSize

public static void setBufferSize(int bufferSize)

Sets the size of the buffer (in bytes) used in I/O operations.

Throws:

IllegalArgumentException - if bufferSize is not positive

Since:

1.0

writeByte

public static void writeByte(OutputStream destination,
                             byte value)
                      throws IOException

Writes a byte to the given destination.

Throws:

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

writeBytes

public static void writeBytes(OutputStream destination,
                              byte[] bytes)
                       throws IOException

Writes the given bytes to the given destination.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if bytes are null

IOException - if an I/O error occurs

Since:

1.0

writeChar

public static void writeChar(OutputStream destination,
                             char value)
                      throws IOException

Writes a char to the given destination using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

writeChar

public static void writeChar(OutputStream destination,
                             char value,
                             ByteOrder byteOrder)
                      throws IOException

Writes a char to the given destination using the given byte order.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

writeDouble

public static void writeDouble(OutputStream destination,
                               double value)
                        throws IOException

Writes a double to the given destination using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

writeDouble

public static void writeDouble(OutputStream destination,
                               double value,
                               ByteOrder byteOrder)
                        throws IOException

Writes a double to the given destination using the given byte order.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

writeFloat

public static void writeFloat(OutputStream destination,
                              float value)
                       throws IOException

Writes a float to the given destination using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

writeFloat

public static void writeFloat(OutputStream destination,
                              float value,
                              ByteOrder byteOrder)
                       throws IOException

Writes a float to the given destination using the given byte order.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

writeInt

public static void writeInt(OutputStream destination,
                            int value)
                     throws IOException

Writes an int to the given destination using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

writeInt

public static void writeInt(OutputStream destination,
                            int value,
                            ByteOrder byteOrder)
                     throws IOException

Writes an int to the given destination using the given byte order.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

writeLong

public static void writeLong(OutputStream destination,
                             long value)
                      throws IOException

Writes a long to the given destination using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

writeLong

public static void writeLong(OutputStream destination,
                             long value,
                             ByteOrder byteOrder)
                      throws IOException

Writes a long to the given destination using the given byte order.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

writeShort

public static void writeShort(OutputStream destination,
                              short value)
                       throws IOException

Writes a short to the given destination using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

writeShort

public static void writeShort(OutputStream destination,
                              short value,
                              ByteOrder byteOrder)
                       throws IOException

Writes a short to the given destination using the given byte order.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if byteOrder is null

IOException - if an I/O error occurs

Since:

1.0

writeString

public static void writeString(OutputStream destination,
                               String string)
                        throws IOException

Writes the given string to the given destination using UTF-8.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if string is null

IOException - if an I/O error occurs

Since:

1.0

writeString

public static void writeString(OutputStream destination,
                               String string,
                               Charset charset)
                        throws IOException

Writes the given string to the given destination using the given charset.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if string is null

IllegalArgumentException - if charset is null

IOException - if an I/O error occurs

Since:

1.0

writeUnsignedByte

public static void writeUnsignedByte(OutputStream destination,
                                     int value)
                              throws IOException

Writes an unsigned byte to the given destination.

Throws:

IllegalArgumentException - if destination is null

IOException - if an I/O error occurs

Since:

1.0

writeUuid

public static void writeUuid(OutputStream destination,
                             UUID uuid)
                      throws IOException

Writes a UUID to the given destination using the default (big-endian) byte order.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if uuid is null

IOException - if an I/O error occurs

Since:

1.0

writeUuid

public static void writeUuid(OutputStream destination,
                             UUID uuid,
                             ByteOrder byteOrder)
                      throws IOException

Writes a UUID to the given destination using the given byte order.

Throws:

IllegalArgumentException - if destination is null

IllegalArgumentException - if uuid is null

IOException - if an I/O error occurs

Since:

1.0