biweekly

Class Biweekly.ParserChainTextReader

java.lang.Object

biweekly.Biweekly.ParserChainTextReader

Enclosing class:

Biweekly

public static class Biweekly.ParserChainTextReader
extends Object

Chainer class for parsing plain text iCalendar data streams.

See Also:

Biweekly.parse(InputStream), Biweekly.parse(File), Biweekly.parse(Reader)

Method Summary

Methods

Modifier and Type	Method and Description
List<ICalendar>	all() Reads all iCalendar objects from the data stream.
Biweekly.ParserChainTextReader	caretDecoding(boolean enable) Sets whether the reader will decode parameter values that use circumflex accent encoding (enabled by default).
ICalendar	first() Reads the first iCalendar object from the data stream.
Biweekly.ParserChainTextReader	register(ICalComponentScribe<? extends ICalComponent> scribe) Registers a component scribe.
Biweekly.ParserChainTextReader	register(ICalPropertyScribe<? extends ICalProperty> scribe) Registers a property scribe.
Biweekly.ParserChainTextReader	warnings(List<List<String>> warnings) Provides a list for putting the parser warnings into.

Methods inherited from class java.lang.Object

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

Method Detail

register

public Biweekly.ParserChainTextReader register(ICalPropertyScribe<? extends ICalProperty> scribe)

Registers a property scribe.

Parameters:

scribe - the scribe

Returns:

this

register

public Biweekly.ParserChainTextReader register(ICalComponentScribe<? extends ICalComponent> scribe)

Registers a component scribe.

Parameters:

scribe - the scribe

Returns:

this

warnings

public Biweekly.ParserChainTextReader warnings(List<List<String>> warnings)

Provides a list for putting the parser warnings into.

Parameters:

warnings - the list object to populate (it is a "list of lists"--each parsed ICalendar object has its own warnings list)

Returns:

this

caretDecoding

public Biweekly.ParserChainTextReader caretDecoding(boolean enable)

Sets whether the reader will decode parameter values that use circumflex accent encoding (enabled by default). This escaping mechanism allows newlines and double quotes to be included in parameter values.

Parameters:

enable - true to use circumflex accent decoding, false not to

Returns:

this

See Also:

ICalRawReader.setCaretDecodingEnabled(boolean)

first

public ICalendar first()
                throws IOException

Reads the first iCalendar object from the data stream.

Returns:

the first iCalendar object or null if there are none

Throws:

IOException - if there a problem reading from the data stream

all

public List<ICalendar> all()
                    throws IOException

Reads all iCalendar objects from the data stream.

Returns:

the parsed iCalendar objects

Throws:

IOException - if there's a problem reading from the data stream