biweekly.io.chain

Class ChainingXmlMemoryParser

java.lang.Object

biweekly.io.chain.ChainingXmlParser<ChainingXmlMemoryParser>

biweekly.io.chain.ChainingXmlMemoryParser

public class ChainingXmlMemoryParser
extends ChainingXmlParser<ChainingXmlMemoryParser>

Chainer class for parsing xCals (XML-encoded iCalendar objects) from strings or DOMs.

Author:

Michael Angstadt

See Also:

Biweekly.parseXml(String), Biweekly.parseXml(Document)

Constructor Summary

Constructors

Constructor and Description
ChainingXmlMemoryParser(Document dom)
ChainingXmlMemoryParser(String xml)

Method Summary

Methods

Modifier and Type	Method and Description
List<ICalendar>	all() Reads all iCalendar objects from the stream.
ICalendar	first() Reads the first iCalendar object from the stream.
T	register(ICalComponentScribe<? extends ICalComponent> scribe) Registers a component scribe.
T	register(ICalPropertyScribe<? extends ICalProperty> scribe) Registers a property scribe.
T	warnings(List<List<String>> warnings) Provides a list object that any parser warnings will be put into.

Methods inherited from class java.lang.Object

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

Constructor Detail

ChainingXmlMemoryParser

public ChainingXmlMemoryParser(String xml)

ChainingXmlMemoryParser

public ChainingXmlMemoryParser(Document dom)

Method Detail

first

public ICalendar first()

Reads the first iCalendar object from the stream.

Returns:

the iCalendar object or null if there are none

all

public List<ICalendar> all()

Reads all iCalendar objects from the stream.

Returns:

the parsed iCalendar objects

register

public T register(ICalPropertyScribe<? extends ICalProperty> scribe)

Registers a property scribe.

Parameters:

scribe - the scribe

Returns:

this

register

public T register(ICalComponentScribe<? extends ICalComponent> scribe)

Registers a component scribe.

Parameters:

scribe - the scribe

Returns:

this

warnings

public T warnings(List<List<String>> warnings)

Provides a list object that any parser warnings will be put into.

Parameters:

warnings - the list object that will be populated with the warnings of each parsed iCalendar object. Each element in the list is a list of warnings for one parsed object. Therefore, the size of this list will be equal to the number of parsed iCalendar objects. If an iCalendar object does not have any warnings, then its warning list will be empty.

Returns:

this