Package org.hildan.hashcode.utils.parser

Class HCParser<T>

java.lang.Object

org.hildan.hashcode.utils.parser.HCParser<T>

Type Parameters:

T - the type of objects this parser yields

public class HCParser<T>
extends java.lang.Object

HCParser parses textual input using a root ChildReader. This is useful to convert Hash Code's input file into an object representation of the problem.

Constructor Summary

Constructors

Constructor	Description
HCParser(@NotNull ObjectReader<T> rootReader)	Creates a new HCParser with the default configuration.
HCParser(@NotNull ObjectReader<T> rootReader, java.lang.String separator)	Creates a new HCParser using the given separator.
HCParser(@NotNull ObjectReader<T> rootReader, Config config)	Creates a new HCParser with the given configuration.

Method Summary

Modifier and Type	Method	Description
T	parse(java.io.Reader inputReader)	Creates an instance of T by reading the input from the given Reader.
T	parse(java.lang.String content)	Parses the given input to create an instance of T.
T	parse(Context context)	Creates an instance of T by reading the input from the given Context.
T	parseFile(java.lang.String filename)	Parses the given file to create an instance of T.

Methods inherited from class java.lang.Object

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

Constructor Detail

HCParser

public HCParser(@NotNull
                @NotNull ObjectReader<T> rootReader)

Creates a new HCParser with the default configuration.

Parameters:

rootReader - the reader to use to read the input into an object

HCParser

public HCParser(@NotNull
                @NotNull ObjectReader<T> rootReader,
                java.lang.String separator)

Creates a new HCParser using the given separator.

Parameters:

rootReader - the reader to use to read the input into an object

separator - the separator between elements within an input line

HCParser

public HCParser(@NotNull
                @NotNull ObjectReader<T> rootReader,
                Config config)

Creates a new HCParser with the given configuration.

Parameters:

rootReader - the reader to use to read the input into an object

config - the configuration defining this parser's behaviour

Method Detail

parseFile

public T parseFile(java.lang.String filename)
            throws java.io.FileNotFoundException

Parses the given file to create an instance of T.

Parameters:

filename - the path to the file to parse

Returns:

the created object representing the input problem

Throws:

java.io.FileNotFoundException - if the given file does not exist

parse

public T parse(java.lang.String content)

Parses the given input to create an instance of T.

Parameters:

content - the input to parse

Returns:

the created object representing the input problem

parse

public T parse(java.io.Reader inputReader)

Creates an instance of T by reading the input from the given Reader.

Parameters:

inputReader - the Reader to use to consume the input

Returns:

the created object representing the input problem

parse

public T parse(Context context)

Creates an instance of T by reading the input from the given Context.

Parameters:

context - the Context from which to read the input to parse

Returns:

the created object representing the input problem