Module ical4j.core

Package net.fortuna.ical4j.data

Class CalendarBuilder

java.lang.Object

net.fortuna.ical4j.data.CalendarBuilder

public class CalendarBuilder
extends Object

Parses and builds an iCalendar model from an input stream. Note that this class is not thread-safe.

Constructor Summary

Constructors

Constructor	Description
CalendarBuilder()	Default constructor.
CalendarBuilder(CalendarParser parser)	Constructs a new calendar builder using the specified calendar parser.
CalendarBuilder(CalendarParser parser, Supplier<List<ParameterFactory<?>>> parameterFactorySupplier, Supplier<List<PropertyFactory<?>>> propertyFactorySupplier, Supplier<List<ComponentFactory<?>>> componentFactorySupplier, TimeZoneRegistry tzRegistry)	Deprecated. use CalendarBuilder(CalendarParser,ContentHandlerContext, TimeZoneRegistry)
CalendarBuilder(CalendarParser parser, ContentHandlerContext contentHandlerContext, TimeZoneRegistry tzRegistry)
CalendarBuilder(CalendarParser parser, PropertyFactoryRegistry propertyFactoryRegistry, ParameterFactoryRegistry parameterFactoryRegistry, TimeZoneRegistry tzRegistry)	Deprecated.
CalendarBuilder(CalendarParser parser, TimeZoneRegistry tzRegistry)	Constructs a new instance using the specified parser and registry.
CalendarBuilder(TimeZoneRegistry tzRegistry)	Constructs a new calendar builder using the specified timezone registry.

Method Summary

Modifier and Type	Method	Description
Calendar	build(InputStream in)	Builds an iCalendar model from the specified input stream.
Calendar	build(Reader in)	Builds an iCalendar model from the specified reader.
Calendar	build(UnfoldingReader uin)	Build an iCalendar model by parsing data from the specified reader.
final TimeZoneRegistry	getRegistry()	Returns the timezone registry used in the construction of calendars.

Methods inherited from class java.lang.Object

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

Constructor Details

CalendarBuilder

public CalendarBuilder()

Default constructor.

CalendarBuilder

public CalendarBuilder(CalendarParser parser)

Constructs a new calendar builder using the specified calendar parser.

Parameters:

parser - a calendar parser used to parse calendar files

CalendarBuilder

public CalendarBuilder(TimeZoneRegistry tzRegistry)

Constructs a new calendar builder using the specified timezone registry.

Parameters:

tzRegistry - a timezone registry to populate with discovered timezones

CalendarBuilder

public CalendarBuilder(CalendarParser parser,
 TimeZoneRegistry tzRegistry)

Constructs a new instance using the specified parser and registry.

Parameters:

parser - a calendar parser used to construct the calendar

tzRegistry - a timezone registry used to retrieve TimeZones and register additional timezone information found in the calendar

CalendarBuilder

@Deprecated
public CalendarBuilder(CalendarParser parser,
 PropertyFactoryRegistry propertyFactoryRegistry,
 ParameterFactoryRegistry parameterFactoryRegistry,
 TimeZoneRegistry tzRegistry)

Deprecated.

Parameters:

parser - a custom calendar parser

tzRegistry - a custom timezone registry

CalendarBuilder

@Deprecated
public CalendarBuilder(CalendarParser parser,
 Supplier<List<ParameterFactory<?>>> parameterFactorySupplier,
 Supplier<List<PropertyFactory<?>>> propertyFactorySupplier,
 Supplier<List<ComponentFactory<?>>> componentFactorySupplier,
 TimeZoneRegistry tzRegistry)

Deprecated.

use CalendarBuilder(CalendarParser,ContentHandlerContext, TimeZoneRegistry)

Parameters:

parser - a custom calendar parser

tzRegistry - a custom timezone registry

CalendarBuilder

public CalendarBuilder(CalendarParser parser,
 ContentHandlerContext contentHandlerContext,
 TimeZoneRegistry tzRegistry)

Parameters:

parser - a custom calendar parser

tzRegistry - a custom timezone registry

Method Details

build

public Calendar build(InputStream in)
               throws IOException,
ParserException

Builds an iCalendar model from the specified input stream.

Parameters:

in - an input stream to read calendar data from

Returns:

a calendar parsed from the specified input stream

Throws:

IOException - where an error occurs reading data from the specified stream

ParserException - where an error occurs parsing data from the stream

build

public Calendar build(Reader in)
               throws IOException,
ParserException

Builds an iCalendar model from the specified reader. An UnfoldingReader is applied to the specified reader to ensure the data stream is correctly unfolded where appropriate.

Parameters:

in - a reader to read calendar data from

Returns:

a calendar parsed from the specified reader

Throws:

IOException - where an error occurs reading data from the specified reader

ParserException - where an error occurs parsing data from the reader

build

public Calendar build(UnfoldingReader uin)
               throws IOException,
ParserException

Build an iCalendar model by parsing data from the specified reader.

Parameters:

uin - an unfolding reader to read data from

Returns:

a calendar parsed from the specified reader

Throws:

IOException - where an error occurs reading data from the specified reader

ParserException - where an error occurs parsing data from the reader

getRegistry

public final TimeZoneRegistry getRegistry()

Returns the timezone registry used in the construction of calendars.

Returns:

a timezone registry