org.gatein.common.io

Class IOTools

java.lang.Object

org.gatein.common.io.IOTools

public class IOTools
extends Object

IO tools.

Version:

$Revision: 1.1 $

Author:

Julien Viet

Field Summary

Fields

Modifier and Type	Field and Description
static Logger	log The logger.

Constructor Summary

Constructors

Constructor and Description
IOTools()

Method Summary

Methods

Modifier and Type	Method and Description
static <S extends Serializable> S	clone(S serializable) Clone an object implementing the Serializable interface.
static <S extends Serializable> S	clone(S serializable, ClassLoader classLoader) Clone an object implementing the Serializable interface.
static void	copy(InputStream in, OutputStream out)
static void	copy(InputStream in, OutputStream out, int bufferSize) Pipe an incoming stream in an outcoming stream until no bytes is available from the input stream.
static void	copy(Reader reader, Writer writer) Pipe an input stream in an output stream.
static void	copy(Reader reader, Writer writer, int bufferSize) Pipe an incoming stream in an outcoming stream.
static byte[]	getBytes(InputStream in)
static byte[]	getBytes(InputStream in, int bufferSize) Get the bytes from the provided input stream.
static BufferedInputStream	safeBufferedWrapper(InputStream in) Check that the provided input stream is buffered.
static BufferedOutputStream	safeBufferedWrapper(OutputStream out) Check that the provided output stream is buffered.
static void	safeClose(Closeable out) Attempt to close an Closeable object.
static void	safeClose(Object closable) Attempt to close an object.
static byte[]	safeGetBytes(InputStream is)
static byte[]	serialize(Serializable serializable)
static <T> byte[]	serialize(Serialization<T> serialization, SerializationFilter filter, T t)
static <T> byte[]	serialize(Serialization<T> serialization, T t)
static Serializable	unserialize(byte[] bytes) Unserialize the bytes into an object.
static Serializable	unserialize(byte[] bytes, ClassLoader classLoader) Unserialize the bytes into an object.
static <T> T	unserialize(Serialization<T> serialization, byte[] bytes)
static <T> T	unserialize(Serialization<T> serialization, SerializationFilter filter, byte[] bytes)

Methods inherited from class java.lang.Object

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

Field Detail

log

public static final Logger log

The logger.

Constructor Detail

IOTools

public IOTools()

Method Detail

safeClose

public static void safeClose(Object closable)

Attempt to close an object. Null argument value is authorized and no operation will be performed in that use case.

It will try to obtain a close() method by reflection and it will be invoked only if the method is public and not static. If the method is called, any Error or RuntimeException will be rethrown, any other kind of throwable will not be rethrown in any form.

Parameters:

closable - the object to close

safeClose

public static void safeClose(Closeable out)

Attempt to close an Closeable object. Null argument value is authorized and no operation will be performed in that use case. IOException thrown are logged using the error level but not propagated.

Parameters:

out - the stream to close

getBytes

public static byte[] getBytes(InputStream in)
                       throws IOException,
                              IllegalArgumentException

Parameters:

in - the input stream

Returns:

the bytes read from the stream

Throws:

IOException

IllegalArgumentException - if the input stream is null

See Also:

getBytes(java.io.InputStream, int)

getBytes

public static byte[] getBytes(InputStream in,
              int bufferSize)
                       throws IOException,
                              IllegalArgumentException

Get the bytes from the provided input stream. No attempt will be made to close the stream.

Parameters:

in - the input stream

bufferSize - the buffer size used to copy the bytes

Returns:

the bytes read from the stream

Throws:

IOException

IllegalArgumentException - if the input stream is null or the buffer size < 1

safeGetBytes

public static byte[] safeGetBytes(InputStream is)

copy

public static void copy(InputStream in,
        OutputStream out)
                 throws IOException

Parameters:

in - the incoming stream

out - the outcoming stream

Throws:

IllegalArgumentException - if an argument is null

IOException

See Also:

copy(java.io.InputStream, java.io.OutputStream, int)

copy

public static void copy(InputStream in,
        OutputStream out,
        int bufferSize)
                 throws IOException

Pipe an incoming stream in an outcoming stream until no bytes is available from the input stream. No attempts will be made to close the streams.

Parameters:

in - the incoming stream

out - the outcoming stream

bufferSize - the buffer size

Throws:

IllegalArgumentException - if bufferSize < 1 or an argument is null

IOException

copy

public static void copy(Reader reader,
        Writer writer)
                 throws IOException

Pipe an input stream in an output stream.

Parameters:

reader - the incoming reader

writer - the outcoming writer

Throws:

IllegalArgumentException - if an argument is null

IOException

copy

public static void copy(Reader reader,
        Writer writer,
        int bufferSize)
                 throws IOException

Pipe an incoming stream in an outcoming stream.

Parameters:

reader - the incoming reader

writer - the outcoming writer

bufferSize - the buffer size

Throws:

IllegalArgumentException - if bufferSize < 1 or an argument is null

IOException

clone

public static <S extends Serializable> S clone(S serializable)
                                    throws IllegalArgumentException,
                                           IOException

Clone an object implementing the Serializable interface.

Parameters:

serializable - the serializable object to clone

Returns:

a clone

Throws:

IllegalArgumentException - if the serializable object is null

IOException - any IOException

clone

public static <S extends Serializable> S clone(S serializable,
                               ClassLoader classLoader)
                                    throws IllegalArgumentException,
                                           IOException,
                                           ClassNotFoundException

Clone an object implementing the Serializable interface. The specified classloader will be used to perform the unserialization. If no classloader is specified and the object is not null then the classloader used is the one returned by serializable.getClass().getClassLoader().

Parameters:

serializable - the serializable object to clone

Returns:

a clone

Throws:

IllegalArgumentException - if the serializable object is null

IOException - any IOException

ClassNotFoundException

serialize

public static byte[] serialize(Serializable serializable)
                        throws IllegalArgumentException,
                               IOException

Throws:

IllegalArgumentException

IOException

unserialize

public static Serializable unserialize(byte[] bytes)
                                throws IllegalArgumentException,
                                       IOException,
                                       ClassNotFoundException

Unserialize the bytes into an object. The thread context classloader is used to perform unserialization.

Parameters:

bytes - the bytes to unserialize

Returns:

the unserialized object

Throws:

IllegalArgumentException - if the byte array is null

IOException - any IOException

ClassNotFoundException - any ClassNotFoundException

unserialize

public static Serializable unserialize(byte[] bytes,
                       ClassLoader classLoader)
                                throws IllegalArgumentException,
                                       IOException,
                                       ClassNotFoundException

Unserialize the bytes into an object. If the provided classloader is not null, this classloader is used to perform the unserialization otherwise the thread current context classloader is used.

Parameters:

bytes - the bytes to unserialize

classLoader - the classloader

Returns:

the unserialized object

Throws:

IllegalArgumentException - if the byte array is null

IOException - any IOException

ClassNotFoundException - any ClassNotFoundException

serialize

public static <T> byte[] serialize(Serialization<T> serialization,
                   T t)

serialize

public static <T> byte[] serialize(Serialization<T> serialization,
                   SerializationFilter filter,
                   T t)

unserialize

public static <T> T unserialize(Serialization<T> serialization,
                byte[] bytes)

unserialize

public static <T> T unserialize(Serialization<T> serialization,
                SerializationFilter filter,
                byte[] bytes)

safeBufferedWrapper

public static BufferedInputStream safeBufferedWrapper(InputStream in)

Check that the provided input stream is buffered. If the argument is already an instance of BufferedInputStream no operation will be performed, otherwise a instance of BufferedInputStream will be created and returned.

If the provided argument is null, the null value is returned.

Parameters:

in - the stream

Returns:

a buffered wrapper

safeBufferedWrapper

public static BufferedOutputStream safeBufferedWrapper(OutputStream out)

Check that the provided output stream is buffered. If the argument is already an instance of BufferedOutputStream no operation will be performed, otherwise a instance of BufferedOutputStream will be created and returned.

If the provided argument is null, the null value is returned.

Parameters:

out - the stream

Returns:

a buffered wrapper