Package com.aspectran.core.util.apon

Class AponReader

java.lang.Object

com.aspectran.core.util.apon.AponFormat

com.aspectran.core.util.apon.AponReader

public class AponReader
extends AponFormat

Converts a string in APON format to a Parameters object.

Field Summary

Fields inherited from class com.aspectran.core.util.apon.AponFormat

COMMENT_LINE_START, CURLY_BRACKET_CLOSE, CURLY_BRACKET_OPEN, DOUBLE_QUOTE_CHAR, ESCAPE_CHAR, FALSE, INDENT_STRING, NAME_VALUE_SEPARATOR, NEW_LINE_CHAR, NO_CONTROL_CHAR, NULL, ROUND_BRACKET_CLOSE, ROUND_BRACKET_OPEN, SINGLE_QUOTE_CHAR, SPACE, SPACE_CHAR, SQUARE_BRACKET_CLOSE, SQUARE_BRACKET_OPEN, TEXT_LINE_START, TRUE

Constructor Summary

Constructors

Constructor	Description
AponReader(java.io.Reader reader)	Instantiates a new AponReader.
AponReader(java.lang.String text)	Instantiates a new AponReader.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the reader.
static Parameters	parse(java.io.File file)	Converts to a Parameters object from a file.
static Parameters	parse(java.io.File file, java.lang.String encoding)	Converts to a Parameters object from a file.
static <T extends Parameters> T	parse(java.io.File file, java.lang.String encoding, T parameters)	Converts into a given Parameters object from a file.
static <T extends Parameters> T	parse(java.io.File file, T parameters)	Converts into a given Parameters object from a file.
static Parameters	parse(java.io.Reader reader)	Converts to a Parameters object from a character-input stream.
static <T extends Parameters> T	parse(java.io.Reader reader, T parameters)	Converts into a given Parameters object from a character-input stream.
static Parameters	parse(java.lang.String text)	Converts an APON formatted string into a Parameters object.
static <T extends Parameters> T	parse(java.lang.String text, T parameters)	Converts an APON formatted string into a given Parameters object.
Parameters	read()	Reads an APON document into a VariableParameters object.
<T extends Parameters> T	read(T parameters)	Reads an APON formatted document into the specified Parameters object.

Methods inherited from class com.aspectran.core.util.apon.AponFormat

escape, unescape

Methods inherited from class java.lang.Object

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

Constructor Detail

AponReader

public AponReader(java.lang.String text)

Instantiates a new AponReader.

Parameters:

text - the APON formatted string

AponReader

public AponReader(java.io.Reader reader)

Instantiates a new AponReader.

Parameters:

reader - the character stream whose contents can be parsed as APON

Method Detail

read

public Parameters read()
                throws AponParseException

Reads an APON document into a VariableParameters object.

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

read

public <T extends Parameters> T read(T parameters)

Reads an APON formatted document into the specified Parameters object.

Type Parameters:

T - the generic type

Parameters:

parameters - the Parameters object

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

close

public void close()
           throws java.io.IOException

Closes the reader.

Throws:

java.io.IOException - if an I/O error occurs

parse

public static Parameters parse(java.lang.String text)
                        throws AponParseException

Converts an APON formatted string into a Parameters object.

Parameters:

text - the APON formatted string

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

parse

public static <T extends Parameters> T parse(java.lang.String text,
                                             T parameters)
                                      throws AponParseException

Converts an APON formatted string into a given Parameters object.

Type Parameters:

T - the generic type

Parameters:

text - the APON formatted string

parameters - the Parameters object

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

parse

public static Parameters parse(java.io.File file)
                        throws AponParseException

Converts to a Parameters object from a file.

Parameters:

file - the file to parse

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

parse

public static Parameters parse(java.io.File file,
                               java.lang.String encoding)
                        throws AponParseException

Converts to a Parameters object from a file.

Parameters:

file - the file to parse

encoding - the character encoding

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

parse

public static <T extends Parameters> T parse(java.io.File file,
                                             T parameters)
                                      throws AponParseException

Converts into a given Parameters object from a file.

Type Parameters:

T - the generic type

Parameters:

file - the file to parse

parameters - the Parameters object

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

parse

public static <T extends Parameters> T parse(java.io.File file,
                                             java.lang.String encoding,
                                             T parameters)
                                      throws AponParseException

Converts into a given Parameters object from a file.

Type Parameters:

T - the generic type

Parameters:

file - the file to parse

encoding - the character encoding

parameters - the Parameters object

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

parse

public static Parameters parse(java.io.Reader reader)
                        throws AponParseException

Converts to a Parameters object from a character-input stream.

Parameters:

reader - the character-input stream

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails

parse

public static <T extends Parameters> T parse(java.io.Reader reader,
                                             T parameters)
                                      throws AponParseException

Converts into a given Parameters object from a character-input stream.

Type Parameters:

T - the generic type

Parameters:

reader - the character-input stream

parameters - the Parameters object

Returns:

the Parameters object

Throws:

AponParseException - if reading APON format document fails