View Javadoc

1   /*
2    * $Id: Attendee.java [Apr 6, 2004]
3    *
4    * Copyright (c) 2004, Ben Fortuna
5    * All rights reserved.
6    *
7    * Redistribution and use in source and binary forms, with or without
8    * modification, are permitted provided that the following conditions
9    * are met:
10   *
11   * 	o Redistributions of source code must retain the above copyright
12   * notice, this list of conditions and the following disclaimer.
13   *
14   * 	o Redistributions in binary form must reproduce the above copyright
15   * notice, this list of conditions and the following disclaimer in the
16   * documentation and/or other materials provided with the distribution.
17   *
18   * 	o Neither the name of Ben Fortuna nor the names of any other contributors
19   * may be used to endorse or promote products derived from this software
20   * without specific prior written permission.
21   *
22   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23   * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24   * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
25   * A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR
26   * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
27   * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
28   * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
29   * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
30   * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
31   * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
32   * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33   */
34  package net.fortuna.ical4j.model.property;
35  
36  import java.net.URI;
37  import java.net.URISyntaxException;
38  
39  import net.fortuna.ical4j.model.Parameter;
40  import net.fortuna.ical4j.model.ParameterList;
41  import net.fortuna.ical4j.model.Property;
42  import net.fortuna.ical4j.model.ValidationException;
43  import net.fortuna.ical4j.util.ParameterValidator;
44  
45  /***
46   * Defines an ATTENDEE iCalendar component property.
47   *
48   * @author benf
49   */
50  public class Attendee extends Property {
51  
52      private URI calAddress;
53  
54      /***
55       * @param aList
56       *            a list of parameters for this component
57       * @param aValue
58       *            a value string for this component
59       * @throws URISyntaxException
60       *             where the specified value string is not a valid uri
61       */
62      public Attendee(final ParameterList aList, final String aValue)
63              throws URISyntaxException {
64          this(aList, new URI(aValue));
65      }
66  
67      /***
68       * @param aList
69       *            a list of parameters for this component
70       * @param aUri
71       *            a URI
72       */
73      public Attendee(final ParameterList aList, final URI aUri) {
74          super(ATTENDEE, aList);
75  
76          calAddress = aUri;
77      }
78  
79      /***
80       * @see net.fortuna.ical4j.model.Property#validate()
81       */
82      public final void validate() throws ValidationException {
83  
84          /*
85           * ; the following are optional, ; but MUST NOT occur more than once
86           *
87           * (";" cutypeparam) / (";"memberparam) / (";" roleparam) / (";"
88           * partstatparam) / (";" rsvpparam) / (";" deltoparam) / (";"
89           * delfromparam) / (";" sentbyparam) / (";"cnparam) / (";" dirparam) /
90           * (";" languageparam) /
91           */
92          ParameterValidator.getInstance().validateOneOrLess(Parameter.CUTYPE,
93                  getParameters());
94          ParameterValidator.getInstance().validateOneOrLess(Parameter.MEMBER,
95                  getParameters());
96          ParameterValidator.getInstance().validateOneOrLess(Parameter.ROLE,
97                  getParameters());
98          ParameterValidator.getInstance().validateOneOrLess(Parameter.PARTSTAT,
99                  getParameters());
100         ParameterValidator.getInstance().validateOneOrLess(Parameter.RSVP,
101                 getParameters());
102         ParameterValidator.getInstance().validateOneOrLess(
103                 Parameter.DELEGATED_TO, getParameters());
104         ParameterValidator.getInstance().validateOneOrLess(
105                 Parameter.DELEGATED_FROM, getParameters());
106         ParameterValidator.getInstance().validateOneOrLess(Parameter.SENT_BY,
107                 getParameters());
108         ParameterValidator.getInstance().validateOneOrLess(Parameter.CN,
109                 getParameters());
110         ParameterValidator.getInstance().validateOneOrLess(Parameter.DIR,
111                 getParameters());
112         ParameterValidator.getInstance().validateOneOrLess(Parameter.LANGUAGE,
113                 getParameters());
114 
115         /*
116          * ; the following is optional, ; and MAY occur more than once
117          *
118          * (";" xparam)
119          */
120     }
121 
122     /***
123      * @return Returns the calAddress.
124      */
125     public final URI getCalAddress() {
126         return calAddress;
127     }
128 
129     /*
130      * (non-Javadoc)
131      *
132      * @see net.fortuna.ical4j.model.Property#getValue()
133      */
134     public String getValue() {
135         return getCalAddress().toString();
136     }
137 }