1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/src/net/fortuna/ical4j/model/property/Method.java Tue Feb 10 18:12:00 2015 +0100 1.3 @@ -0,0 +1,162 @@ 1.4 +/** 1.5 + * Copyright (c) 2012, Ben Fortuna 1.6 + * All rights reserved. 1.7 + * 1.8 + * Redistribution and use in source and binary forms, with or without 1.9 + * modification, are permitted provided that the following conditions 1.10 + * are met: 1.11 + * 1.12 + * o Redistributions of source code must retain the above copyright 1.13 + * notice, this list of conditions and the following disclaimer. 1.14 + * 1.15 + * o Redistributions in binary form must reproduce the above copyright 1.16 + * notice, this list of conditions and the following disclaimer in the 1.17 + * documentation and/or other materials provided with the distribution. 1.18 + * 1.19 + * o Neither the name of Ben Fortuna nor the names of any other contributors 1.20 + * may be used to endorse or promote products derived from this software 1.21 + * without specific prior written permission. 1.22 + * 1.23 + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 1.24 + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 1.25 + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 1.26 + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 1.27 + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 1.28 + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 1.29 + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 1.30 + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 1.31 + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 1.32 + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 1.33 + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 1.34 + */ 1.35 +package net.fortuna.ical4j.model.property; 1.36 + 1.37 +import net.fortuna.ical4j.model.ParameterList; 1.38 +import net.fortuna.ical4j.model.Property; 1.39 +import net.fortuna.ical4j.model.PropertyFactoryImpl; 1.40 +import net.fortuna.ical4j.model.ValidationException; 1.41 + 1.42 +/** 1.43 + * $Id$ 1.44 + * 1.45 + * Created: [Apr 6, 2004] 1.46 + * 1.47 + * Defines a METHOD iCalendar property. 1.48 + * @author benf 1.49 + */ 1.50 +public class Method extends Property { 1.51 + 1.52 + private static final long serialVersionUID = 7220956532685378719L; 1.53 + 1.54 + /** 1.55 + * Used to publish a calendar entry to one or more Calendar Users. There is no interactivity between the publisher 1.56 + * and any other calendar user. An example might include a baseball team publishing its schedule to the public. [RFC 1.57 + * 2446] 1.58 + */ 1.59 + public static final Method PUBLISH = new ImmutableMethod("PUBLISH"); 1.60 + 1.61 + /** 1.62 + * Used to schedule a calendar entry with other Calendar Users. Requests are interactive in that they require the 1.63 + * receiver to respond using the Reply methods. Meeting Requests, Busy Time requests and the assignment of VTODOs to 1.64 + * other Calendar Users are all examples. Requests are also used by the "Organizer" to update the status of a 1.65 + * calendar entry. [RFC 2446] 1.66 + */ 1.67 + public static final Method REQUEST = new ImmutableMethod("REQUEST"); 1.68 + 1.69 + /** 1.70 + * A Reply is used in response to a Request to convey "Attendee" status to the "Organizer". Replies are commonly 1.71 + * used to respond to meeting and task requests. [RFC2446] 1.72 + */ 1.73 + public static final Method REPLY = new ImmutableMethod("REPLY"); 1.74 + 1.75 + /** 1.76 + * Add one or more instances to an existing VEVENT, VTODO, or VJOURNAL. [RFC 2446] 1.77 + */ 1.78 + public static final Method ADD = new ImmutableMethod("ADD"); 1.79 + 1.80 + /** 1.81 + * Cancel one or more instances of an existing VEVENT, VTODO, or VJOURNAL. [RFC 2446] 1.82 + */ 1.83 + public static final Method CANCEL = new ImmutableMethod("CANCEL"); 1.84 + 1.85 + /** 1.86 + * The Refresh method is used by an "Attendee" to request the latest version of a calendar entry. [RFC 2446] 1.87 + */ 1.88 + public static final Method REFRESH = new ImmutableMethod("REFRESH"); 1.89 + 1.90 + /** 1.91 + * The Counter method is used by an "Attendee" to negotiate a change in the calendar entry. Examples include the 1.92 + * request to change a proposed Event time or change the due date for a VTODO. [RFC 2446] 1.93 + */ 1.94 + public static final Method COUNTER = new ImmutableMethod("COUNTER"); 1.95 + 1.96 + /** 1.97 + * Used by the "Organizer" to decline the proposed counter-proprosal. [RFC 2446] 1.98 + */ 1.99 + public static final Method DECLINE_COUNTER = new ImmutableMethod( 1.100 + "DECLINE-COUNTER"); 1.101 + 1.102 + /** 1.103 + * @author Ben Fortuna An immutable instance of Method. 1.104 + */ 1.105 + private static final class ImmutableMethod extends Method { 1.106 + 1.107 + private static final long serialVersionUID = 5332607957381969713L; 1.108 + 1.109 + private ImmutableMethod(final String value) { 1.110 + super(new ParameterList(true), value); 1.111 + } 1.112 + 1.113 + public void setValue(final String aValue) { 1.114 + throw new UnsupportedOperationException( 1.115 + "Cannot modify constant instances"); 1.116 + } 1.117 + } 1.118 + 1.119 + private String value; 1.120 + 1.121 + /** 1.122 + * Default constructor. 1.123 + */ 1.124 + public Method() { 1.125 + super(METHOD, PropertyFactoryImpl.getInstance()); 1.126 + } 1.127 + 1.128 + /** 1.129 + * @param aValue a value string for this component 1.130 + */ 1.131 + public Method(final String aValue) { 1.132 + super(METHOD, PropertyFactoryImpl.getInstance()); 1.133 + this.value = aValue; 1.134 + } 1.135 + 1.136 + /** 1.137 + * @param aList a list of parameters for this component 1.138 + * @param aValue a value string for this component 1.139 + */ 1.140 + public Method(final ParameterList aList, final String aValue) { 1.141 + super(METHOD, aList, PropertyFactoryImpl.getInstance()); 1.142 + this.value = aValue; 1.143 + } 1.144 + 1.145 + /** 1.146 + * {@inheritDoc} 1.147 + */ 1.148 + public void setValue(final String aValue) { 1.149 + this.value = aValue; 1.150 + } 1.151 + 1.152 + /** 1.153 + * {@inheritDoc} 1.154 + */ 1.155 + public final String getValue() { 1.156 + return value; 1.157 + } 1.158 + 1.159 + /** 1.160 + * {@inheritDoc} 1.161 + */ 1.162 + public final void validate() throws ValidationException { 1.163 + // TODO: Auto-generated method stub 1.164 + } 1.165 +}