org.jenetics.util

Class IO

java.lang.Object

org.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.xml"); IO.jaxb.write(result.getPopulation(), file); // Reading the population from disk. Population<DoubleGene, Double> population = (Population<DoubleGene, Double>)IO.jaxb.read(file); EvolutionStream<DoubleGene, Double> stream = Engine .build(ff, gtf) .stream(population, 1);

Since:

1.0

Version:

2.0 — $Date: 2014-12-28 $

Author:

Franz Wilhelmstötter

Field Summary

Fields

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

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IO()

Method Summary

Modifier and Type	Method and Description
<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, Path path) Reads an object from the given file.
<T> T	read(Class<T> type, String path) Reads an object from the given file.
Object	read(File file) Reads an object from the given file.
Object	read(InputStream in) Reads an object from the given input stream.
Object	read(Path path) Reads an object from the given file.
Object	read(String path) Reads an object from the given file.
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, Path path) Write the (serializable) object to the given path.
void	write(Object object, String 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

jaxb

public static final IO jaxb

JAXB for XML serialization.

object

public static final IO object

IO implementation for "native" Java serialization.

Constructor Detail

IO

protected IO()

Method Detail

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.

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.