net.fortuna.ical4j.model
public class Calendar extends Object implements Serializable
4.6 Calendar Components The body of the iCalendar object consists of a sequence of calendar properties and one or more calendar components. The calendar properties are attributes that apply to the calendar as a whole. The calendar components are collections of properties that express a particular calendar semantic. For example, the calendar component can specify an event, a to-do, a journal entry, time zone information, or free/busy time information, or an alarm. The body of the iCalendar object is defined by the following notation: icalbody = calprops component calprops = 2*( ; 'prodid' and 'version' are both REQUIRED, ; but MUST NOT occur more than once prodid /version / ; 'calscale' and 'method' are optional, ; but MUST NOT occur more than once calscale / method / x-prop ) component = 1*(eventc / todoc / journalc / freebusyc / / timezonec / iana-comp / x-comp) iana-comp = "BEGIN" ":" iana-token CRLF 1*contentline "END" ":" iana-token CRLF x-comp = "BEGIN" ":" x-name CRLF 1*contentline "END" ":" x-name CRLFExample 1 - Creating a new calendar:
Calendar calendar = new Calendar();
calendar.getProperties().add(new ProdId("-//Ben Fortuna//iCal4j 1.0//EN"));
calendar.getProperties().add(Version.VERSION_2_0);
calendar.getProperties().add(CalScale.GREGORIAN);
// Add events, etc..
Modifier and Type | Field and Description |
---|---|
static String |
BEGIN
Begin token.
|
static String |
END
End token.
|
static String |
VCALENDAR
Calendar token.
|
Constructor and Description |
---|
Calendar()
Default constructor.
|
Calendar(Calendar c)
Creates a deep copy of the specified calendar.
|
Calendar(ComponentList components)
Constructs a new calendar with no properties and the specified components.
|
Calendar(PropertyList p,
ComponentList c)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
boolean |
equals(Object arg0) |
CalScale |
getCalendarScale()
Returns the optional calscale property.
|
Component |
getComponent(String name)
Convenience method for retrieving a named component.
|
ComponentList |
getComponents() |
ComponentList |
getComponents(String name)
Convenience method for retrieving a list of named components.
|
Method |
getMethod()
Returns the optional method property.
|
ProdId |
getProductId()
Returns the mandatory prodid property.
|
PropertyList |
getProperties() |
PropertyList |
getProperties(String name)
Convenience method for retrieving a list of named properties.
|
Property |
getProperty(String name)
Convenience method for retrieving a named property.
|
Version |
getVersion()
Returns the mandatory version property.
|
int |
hashCode() |
String |
toString() |
void |
validate()
Perform validation on the calendar, its properties and its components in its current state.
|
void |
validate(boolean recurse)
Perform validation on the calendar in its current state.
|
public static final String BEGIN
public static final String VCALENDAR
public static final String END
public Calendar()
public Calendar(ComponentList components)
components
- a list of components to add to the calendarpublic Calendar(PropertyList p, ComponentList c)
p
- a list of propertiesc
- a list of componentspublic Calendar(Calendar c) throws ParseException, IOException, URISyntaxException
c
- the calendar to copyIOException
- where an error occurs reading calendar dataParseException
- where calendar parsing failsURISyntaxException
- where an invalid URI string is encounteredpublic final ComponentList getComponents()
public final ComponentList getComponents(String name)
name
- name of components to retrievepublic final Component getComponent(String name)
name
- name of the component to retrievepublic final PropertyList getProperties()
public final PropertyList getProperties(String name)
name
- name of properties to retrievepublic final Property getProperty(String name)
name
- name of the property to retrievepublic final void validate() throws ValidationException
ValidationException
- where the calendar is not in a valid statepublic void validate(boolean recurse) throws ValidationException
recurse
- indicates whether to validate the calendar's properties and componentsValidationException
- where the calendar is not in a valid statepublic final ProdId getProductId()
public final Version getVersion()
public final CalScale getCalendarScale()
public final Method getMethod()
Copyright © 2004-2013 Micronode. All Rights Reserved.