net.fortuna.ical4j.data

Class CalendarBuilder

java.lang.Object

net.fortuna.ical4j.data.CalendarBuilder

All Implemented Interfaces:

java.util.function.Consumer<Calendar>

public class CalendarBuilder
extends java.lang.Object
implements java.util.function.Consumer<Calendar>

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

Constructor Summary

Constructors

Constructor and Description
CalendarBuilder() Default constructor.
CalendarBuilder(CalendarParser parser) Constructs a new calendar builder using the specified calendar parser.
CalendarBuilder(CalendarParser parser, PropertyFactoryRegistry propertyFactoryRegistry, ParameterFactoryRegistry parameterFactoryRegistry, TimeZoneRegistry tzRegistry) Deprecated.
CalendarBuilder(CalendarParser parser, java.util.function.Supplier<java.util.List<ParameterFactory<?>>> parameterFactorySupplier, java.util.function.Supplier<java.util.List<PropertyFactory<?>>> propertyFactorySupplier, java.util.function.Supplier<java.util.List<ComponentFactory<?>>> componentFactorySupplier, TimeZoneRegistry tzRegistry)
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 and Description
void	accept(Calendar calendar)
Calendar	build(java.io.InputStream in) Builds an iCalendar model from the specified input stream.
Calendar	build(java.io.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.
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

Methods inherited from interface java.util.function.Consumer

andThen

Constructor Detail

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

public CalendarBuilder(CalendarParser parser,
                       java.util.function.Supplier<java.util.List<ParameterFactory<?>>> parameterFactorySupplier,
                       java.util.function.Supplier<java.util.List<PropertyFactory<?>>> propertyFactorySupplier,
                       java.util.function.Supplier<java.util.List<ComponentFactory<?>>> componentFactorySupplier,
                       TimeZoneRegistry tzRegistry)

Parameters:

parser - a custom calendar parser

tzRegistry - a custom timezone registry

Method Detail

accept

public void accept(Calendar calendar)

Specified by:

accept in interface java.util.function.Consumer<Calendar>

build

public Calendar build(java.io.InputStream in)
               throws java.io.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:

java.io.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(java.io.Reader in)
               throws java.io.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:

java.io.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 java.io.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:

java.io.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