net.fortuna.ical4j.util
Class Calendars

java.lang.Object
  net.fortuna.ical4j.util.Calendars

public final class Calendars
extends java.lang.Object

Utility method for working with Calendars.

Author:

Ben Fortuna

Method Summary

static Calendar	load(java.lang.String filename) Loads a calendar from the specified file.
static Calendar	merge(Calendar c1, Calendar c2) Merge all properties and components from two specified calendars into one instance.
static Calendar	wrap(Component component) Wraps a component in a calendar.

Methods inherited from class java.lang.Object

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

Method Detail

load

public static Calendar load(java.lang.String filename)
                     throws java.io.IOException,
                            ParserException

Loads a calendar from the specified file.

Parameters:

filename - the name of the file from which to load calendar data

Returns:

returns a new calendar instance initialised from the specified file

Throws:

java.io.IOException - occurs when there is an error reading the specified file

ParserException - occurs when the data in the specified file is invalid

merge

public static Calendar merge(Calendar c1,
                             Calendar c2)

Merge all properties and components from two specified calendars into one instance. Note that the merge process is not very sophisticated, and may result in invalid calendar data (e.g. multiple properties of a type that should only be specified once).

Parameters:

c1 - the first calendar to merge

c2 - the second calendar to merge

Returns:

a Calendar instance containing all properties and components from both of the specified calendars

wrap

public static Calendar wrap(Component component)

Wraps a component in a calendar.

Parameters:

component - the component to wrap with a calendar

Returns:

a calendar containing the specified component