Serializable
public class Organizer extends Property
Created: [Apr 6, 2004]
Defines an ORGANIZER iCalendar component property.
4.8.4.3 Organizer Property Name: ORGANIZER Purpose: The property defines the organizer for a calendar component. Value Type: CAL-ADDRESS Property Parameters: Non-standard, language, common name, directory entry reference, sent by property parameters can be specified on this property. Conformance: This property MUST be specified in an iCalendar object that specifies a group scheduled calendar entity. This property MUST be specified in an iCalendar object that specifies the publication of a calendar user's busy time. This property MUST NOT be specified in an iCalendar object that specifies only a time zone definition or that defines calendar entities that are not group scheduled entities, but are entities only on a single user's calendar. Description: The property is specified within the "VEVENT", "VTODO", "VJOURNAL calendar components to specify the organizer of a group scheduled calendar entity. The property is specified within the "VFREEBUSY" calendar component to specify the calendar user requesting the free or busy time. When publishing a "VFREEBUSY" calendar component, the property is used to specify the calendar that the published busy time came from. The property has the property parameters CN, for specifying the common or display name associated with the "Organizer", DIR, for specifying a pointer to the directory information associated with the "Organizer", SENT-BY, for specifying another calendar user that is acting on behalf of the "Organizer". The non-standard parameters may also be specified on this property. If the LANGUAGE property parameter is specified, the identified language applies to the CN parameter value. Format Definition: The property is defined by the following notation: organizer = "ORGANIZER" orgparam ":" cal-address CRLF orgparam = *( ; the following are optional, ; but MUST NOT occur more than once (";" cnparam) / (";" dirparam) / (";" sentbyparam) / (";" languageparam) / ; the following is optional, ; and MAY occur more than once (";" xparam) ) Example: The following is an example of this property: ORGANIZER;CN=John Smith:MAILTO:jsmith@host1.com The following is an example of this property with a pointer to the directory information associated with the organizer: ORGANIZER;CN=JohnSmith;DIR="ldap://host.com:6666/o=3DDC%20Associ ates,c=3DUS??(cn=3DJohn%20Smith)":MAILTO:jsmith@host1.com The following is an example of this property used by another calendar user who is acting on behalf of the organizer, with responses intended to be sent back to the organizer, not the other calendar user: ORGANIZER;SENT-BY="MAILTO:jane_doe@host.com": MAILTO:jsmith@host1.com
Modifier and Type | Class | Description |
---|---|---|
static class |
Organizer.Factory |
ACKNOWLEDGED, ACTION, ATTACH, ATTENDEE, BUSYTYPE, CALSCALE, CATEGORIES, CLASS, COMMENT, COMPLETED, CONTACT, COUNTRY, CREATED, DESCRIPTION, DTEND, DTSTAMP, DTSTART, DUE, DURATION, EXDATE, EXPERIMENTAL_PREFIX, EXRULE, EXTENDED_ADDRESS, FREEBUSY, GEO, LAST_MODIFIED, LOCALITY, LOCATION, LOCATION_TYPE, METHOD, NAME, ORGANIZER, PERCENT_COMPLETE, POSTALCODE, PRIORITY, PRODID, RDATE, RECURRENCE_ID, REGION, RELATED_TO, REPEAT, REQUEST_STATUS, RESOURCES, RRULE, SEQUENCE, STATUS, STREET_ADDRESS, SUMMARY, TEL, TRANSP, TRIGGER, TZID, TZNAME, TZOFFSETFROM, TZOFFSETTO, TZURL, UID, URL, VERSION
Constructor | Description |
---|---|
Organizer() |
Default constructor.
|
Organizer(String value) |
Constructs a new instance with the specified value.
|
Organizer(URI aUri) |
|
Organizer(ParameterList aList,
String aValue) |
|
Organizer(ParameterList aList,
URI aUri) |
Modifier and Type | Method | Description |
---|---|---|
URI |
getCalAddress() |
|
String |
getValue() |
|
protected PropertyFactory<Organizer> |
newFactory() |
Returns a new property factory used to create deep copies.
|
void |
setCalAddress(URI calAddress) |
|
void |
setValue(String aValue) |
Sets the current value of the property.
|
void |
validate() |
Perform validation on a property.
|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
add, copy, equals, getName, getParameter, getParameters, getParameters, hashCode, remove, removeAll, replace, setParameters, toString
public Organizer()
public Organizer(String value) throws URISyntaxException
value
- an organizer URIURISyntaxException
- where the specified value is not a valid URIpublic Organizer(ParameterList aList, String aValue) throws URISyntaxException
aList
- a list of parameters for this componentaValue
- a value string for this componentURISyntaxException
- where the specified value string is not a valid uripublic Organizer(URI aUri)
aUri
- a URI representation of a calendar addresspublic Organizer(ParameterList aList, URI aUri)
aList
- a list of parameters for this componentaUri
- a URI representation of a calendar addresspublic final void validate() throws ValidationException
validate
in class Property
ValidationException
- where the property is not in a valid statepublic final URI getCalAddress()
public final void setValue(String aValue) throws URISyntaxException
setValue
in class Property
aValue
- a string representation of the property valueURISyntaxException
- possibly thrown by setting the value of certain propertiespublic final String getValue()
public final void setCalAddress(URI calAddress)
calAddress
- The calAddress to set.protected PropertyFactory<Organizer> newFactory()
Property
newFactory
in class Property