Package io.jenetics.util

Class IO

java.lang.Object

io.jenetics.util.IO

public abstract class IO
extends Object

Class for object serialization. The following example shows how to write and reload a given population.

// Creating result population. EvolutionResult<DoubleGene, Double> result = stream .collect(toBestEvolutionResult()); // Writing the population to disk. final File file = new File("population.bin"); IO.object.write(result.getPopulation(), file); // Reading the population from disk. ISeq<Phenotype<G, C>> population = (ISeq<Phenotype<G, C>>)IO.object.read(file); EvolutionStream<DoubleGene, Double> stream = Engine .build(ff, gtf) .stream(population, 1);

Since:

1.0

Version:

4.0

Field Summary

Fields

Modifier and Type	Field	Description
static IO	object	IO implementation for "native" Java serialization.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	IO()

Method Summary

Modifier and Type	Method	Description
Object	fromByteArray(byte[] bytes)	Creates a, previously serialized, object from the given byte[] array.
Object	read(File file)	Reads an object from the given file.
Object	read(InputStream in)	Reads an object from the given input stream.
<T> T	read(Class<T> type, File file)	Reads an object from the given file.
abstract <T> T	read(Class<T> type, InputStream in)	Reads an object from the given input stream.
<T> T	read(Class<T> type, String path)	Reads an object from the given file.
<T> T	read(Class<T> type, Path path)	Reads an object from the given file.
Object	read(String path)	Reads an object from the given file.
Object	read(Path path)	Reads an object from the given file.
byte[]	toByteArray(Object object)	Serializes the given object to a byte[] array.
void	write(Object object, File file)	Write the (serializable) object to the given file.
abstract void	write(Object object, OutputStream out)	Write the (serializable) object to the given output stream.
void	write(Object object, String path)	Write the (serializable) object to the given path.
void	write(Object object, Path path)	Write the (serializable) object to the given path.

Methods inherited from class java.lang.Object

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

Field Detail

object

public static final IO object

IO implementation for "native" Java serialization.

Constructor Detail

IO

protected IO()

Method Detail

toByteArray

public byte[] toByteArray(Object object)
                   throws IOException

Serializes the given object to a byte[] array.

Parameters:

object - the object to serialize.

Returns:

the serialized object as byte[] array

Throws:

NullPointerException - if one of the object is null.

IOException - if the object could not be serialized.

Since:

4.1

write

public void write(Object object,
                  String path)
           throws IOException

Write the (serializable) object to the given path.

Parameters:

object - the object to serialize.

path - the path to write the object to.

Throws:

NullPointerException - if one of the arguments is null.

IOException - if the object could not be serialized.

write

public void write(Object object,
                  Path path)
           throws IOException

Write the (serializable) object to the given path.

Parameters:

object - the object to serialize.

path - the path to write the object to.

Throws:

NullPointerException - if one of the arguments is null.

IOException - if the object could not be serialized.

write

public void write(Object object,
                  File file)
           throws IOException

Write the (serializable) object to the given file.

Parameters:

object - the object to serialize.

file - the file to write the object to.

Throws:

NullPointerException - if one of the arguments is null.

IOException - if the object could not be serialized.

write

public abstract void write(Object object,
                           OutputStream out)
                    throws IOException

Write the (serializable) object to the given output stream.

Parameters:

object - the object to serialize.

out - the output stream to write the object to.

Throws:

NullPointerException - if one of the arguments is null.

IOException - if the object could not be serialized.

fromByteArray

public Object fromByteArray(byte[] bytes)
                     throws IOException

Creates a, previously serialized, object from the given byte[] array.

Parameters:

bytes - the serialized object.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input bytes is null.

IOException - if the object could not be de-serialized.

Since:

4.1

read

public <T> T read(Class<T> type,
                  String path)
           throws IOException

Reads an object from the given file.

Type Parameters:

T - the type of the read object

Parameters:

path - the path to read from.

type - the type of the read object.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input stream in is null.

IOException - if the object could not be read.

read

public Object read(String path)
            throws IOException

Reads an object from the given file.

Parameters:

path - the path to read from.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input stream in is null.

IOException - if the object could not be read.

read

public <T> T read(Class<T> type,
                  Path path)
           throws IOException

Reads an object from the given file.

Type Parameters:

T - the type of the read object

Parameters:

path - the path to read from.

type - the type of the read object.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input stream in is null.

IOException - if the object could not be read.

read

public Object read(Path path)
            throws IOException

Reads an object from the given file.

Parameters:

path - the path to read from.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input stream in is null.

IOException - if the object could not be read.

read

public <T> T read(Class<T> type,
                  File file)
           throws IOException

Reads an object from the given file.

Type Parameters:

T - the type of the read object

Parameters:

file - the file to read from.

type - the type of the read object.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input stream in is null.

IOException - if the object could not be read.

read

public Object read(File file)
            throws IOException

Reads an object from the given file.

Parameters:

file - the file to read from.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input stream in is null.

IOException - if the object could not be read.

read

public abstract <T> T read(Class<T> type,
                           InputStream in)
                    throws IOException

Reads an object from the given input stream.

Type Parameters:

T - the type of the read object

Parameters:

in - the input stream to read from.

type - the type of the read object.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input stream in is null.

IOException - if the object could not be read.

read

public Object read(InputStream in)
            throws IOException

Reads an object from the given input stream.

Parameters:

in - the input stream to read from.

Returns:

the de-serialized object.

Throws:

NullPointerException - if the input stream in is null.

IOException - if the object could not be read.