View Javadoc
1   /*
2    * DavMail POP/IMAP/SMTP/CalDav/LDAP Exchange Gateway
3    * Copyright (C) 2010  Mickael Guessant
4    *
5    * This program is free software; you can redistribute it and/or
6    * modify it under the terms of the GNU General Public License
7    * as published by the Free Software Foundation; either version 2
8    * of the License, or (at your option) any later version.
9    *
10   * This program is distributed in the hope that it will be useful,
11   * but WITHOUT ANY WARRANTY; without even the implied warranty of
12   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13   * GNU General Public License for more details.
14   *
15   * You should have received a copy of the GNU General Public License
16   * along with this program; if not, write to the Free Software
17   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
18   */
19  package davmail.exchange;
20  
21  import davmail.Settings;
22  import davmail.util.StringUtil;
23  import org.apache.log4j.Logger;
24  
25  import java.io.*;
26  import java.nio.charset.StandardCharsets;
27  import java.text.ParseException;
28  import java.text.SimpleDateFormat;
29  import java.util.*;
30  
31  /**
32   * VCalendar object.
33   */
34  public class VCalendar extends VObject {
35      protected static final Logger LOGGER = Logger.getLogger(VCalendar.class);
36      protected VObject firstVevent;
37      protected VObject vTimezone;
38      protected String email;
39  
40      /**
41       * Create VCalendar object from reader;
42       *
43       * @param reader    stream reader
44       * @param email     current user email
45       * @param vTimezone user OWA timezone
46       * @throws IOException on error
47       */
48      public VCalendar(BufferedReader reader, String email, VObject vTimezone) throws IOException {
49          super(reader);
50          if (!"VCALENDAR".equals(type)) {
51              throw new IOException("Invalid type: " + type);
52          }
53          this.email = email;
54          // set OWA timezone information
55          if (this.vTimezone == null && vTimezone != null) {
56              setTimezone(vTimezone);
57          }
58      }
59  
60      /**
61       * Create VCalendar object from string;
62       *
63       * @param vCalendarBody item body
64       * @param email         current user email
65       * @param vTimezone     user OWA timezone
66       * @throws IOException on error
67       */
68      public VCalendar(String vCalendarBody, String email, VObject vTimezone) throws IOException {
69          this(new ICSBufferedReader(new StringReader(vCalendarBody)), email, vTimezone);
70      }
71  
72      /**
73       * Create VCalendar object from string;
74       *
75       * @param vCalendarContent item content
76       * @param email            current user email
77       * @param vTimezone        user OWA timezone
78       * @throws IOException on error
79       */
80      public VCalendar(byte[] vCalendarContent, String email, VObject vTimezone) throws IOException {
81          this(new ICSBufferedReader(new InputStreamReader(new ByteArrayInputStream(vCalendarContent), StandardCharsets.UTF_8)), email, vTimezone);
82      }
83  
84      /**
85       * Empty constructor
86       */
87      public VCalendar() {
88          type = "VCALENDAR";
89      }
90  
91      /**
92       * Set timezone on vObject
93       *
94       * @param vTimezone timezone object
95       */
96      public void setTimezone(VObject vTimezone) {
97          if (vObjects == null) {
98              addVObject(vTimezone);
99          } else {
100             vObjects.add(0, vTimezone);
101         }
102         this.vTimezone = vTimezone;
103     }
104 
105     @Override
106     public void addVObject(VObject vObject) {
107         if (firstVevent == null && ("VEVENT".equals(vObject.type) || "VTODO".equals(vObject.type))) {
108             firstVevent = vObject;
109         }
110         if ("VTIMEZONE".equals(vObject.type)) {
111             if (vTimezone == null) {
112                 vTimezone = vObject;
113             } else if (vTimezone.getPropertyValue("TZID").equals(vObject.getPropertyValue("TZID"))){
114                 // drop duplicate TZID definition (Korganizer bug)
115                 vObject = null;
116             }
117         }
118         if (vObject != null) {
119             super.addVObject(vObject);
120         }
121     }
122 
123     protected boolean isAllDay(VObject vObject) {
124         VProperty dtstart = vObject.getProperty("DTSTART");
125         return dtstart != null && dtstart.hasParam("VALUE", "DATE");
126     }
127 
128     protected boolean isCdoAllDay(VObject vObject) {
129         return "TRUE".equals(vObject.getPropertyValue("X-MICROSOFT-CDO-ALLDAYEVENT"));
130     }
131 
132     /**
133      * Check if vCalendar is CDO allday.
134      *
135      * @return true if vCalendar has X-MICROSOFT-CDO-ALLDAYEVENT property set to TRUE
136      */
137     public boolean isCdoAllDay() {
138         return firstVevent != null && isCdoAllDay(firstVevent);
139     }
140 
141     /**
142      * Get email from property value.
143      *
144      * @param property property
145      * @return email value
146      */
147     public String getEmailValue(VProperty property) {
148         if (property == null) {
149             return null;
150         }
151         String propertyValue = property.getValue();
152         if (propertyValue != null && (propertyValue.startsWith("MAILTO:") || propertyValue.startsWith("mailto:"))) {
153             return propertyValue.substring(7);
154         } else {
155             return propertyValue;
156         }
157     }
158 
159     protected String getMethod() {
160         return getPropertyValue("METHOD");
161     }
162 
163     protected void fixVCalendar(boolean fromServer) {
164         // set iCal 4 global X-CALENDARSERVER-ACCESS from CLASS
165         if (fromServer) {
166             setPropertyValue("X-CALENDARSERVER-ACCESS", getCalendarServerAccess());
167         }
168 
169         if (fromServer && "PUBLISH".equals(getPropertyValue("METHOD"))) {
170             removeProperty("METHOD");
171         }
172 
173         // iCal 4 global X-CALENDARSERVER-ACCESS
174         String calendarServerAccess = getPropertyValue("X-CALENDARSERVER-ACCESS");
175         String now = ExchangeSession.getZuluDateFormat().format(new Date());
176 
177         // fix method from iPhone
178         if (!fromServer && getPropertyValue("METHOD") == null) {
179             setPropertyValue("METHOD", "PUBLISH");
180         }
181 
182         // rename TZID for maximum iCal/iPhone compatibility
183         String tzid = null;
184         if (fromServer) {
185             // get current tzid
186             VObject vObject = vTimezone;
187             if (vObject != null) {
188                 String currentTzid = vObject.getPropertyValue("TZID");
189                 // fix TZID with \n (Exchange 2010 bug)
190                 if (currentTzid != null && currentTzid.endsWith("\n")) {
191                     currentTzid = currentTzid.substring(0, currentTzid.length() - 1);
192                     vObject.setPropertyValue("TZID", currentTzid);
193                 }
194                 if (currentTzid != null && currentTzid.indexOf(' ') >= 0) {
195                     try {
196                         tzid = ResourceBundle.getBundle("timezones").getString(currentTzid);
197                         vObject.setPropertyValue("TZID", tzid);
198                     } catch (MissingResourceException e) {
199                         LOGGER.debug("Timezone " + currentTzid + " not found in rename table");
200                     }
201                 }
202             }
203         }
204 
205         if (!fromServer) {
206             fixTimezoneToServer();
207         }
208 
209         // iterate over vObjects
210         for (VObject vObject : vObjects) {
211             if ("VEVENT".equals(vObject.type)) {
212                 if (calendarServerAccess != null) {
213                     vObject.setPropertyValue("CLASS", getEventClass(calendarServerAccess));
214                     // iCal 3, get X-CALENDARSERVER-ACCESS from local VEVENT
215                 } else if (vObject.getPropertyValue("X-CALENDARSERVER-ACCESS") != null) {
216                     vObject.setPropertyValue("CLASS", getEventClass(vObject.getPropertyValue("X-CALENDARSERVER-ACCESS")));
217                 }
218                 if (fromServer) {
219                     // remove organizer line for event without attendees for iPhone
220                     if (vObject.getProperty("ATTENDEE") == null) {
221                         vObject.setPropertyValue("ORGANIZER", null);
222                     }
223                     // detect allday and update date properties
224                     if (isCdoAllDay(vObject)) {
225                         setClientAllday(vObject.getProperty("DTSTART"));
226                         setClientAllday(vObject.getProperty("DTEND"));
227                         setClientAllday(vObject.getProperty("RECURRENCE-ID"));
228                     }
229                     String cdoBusyStatus = vObject.getPropertyValue("X-MICROSOFT-CDO-BUSYSTATUS");
230                     if (cdoBusyStatus != null) {
231                         // we set status only if it's tentative
232                         if ("TENTATIVE".equals(cdoBusyStatus)) {
233                             vObject.setPropertyValue("STATUS", "TENTATIVE");
234                         }
235                         // in all cases, we set the transparency (also called "show time as" in UI)
236                         vObject.setPropertyValue("TRANSP",
237                                 !"FREE".equals(cdoBusyStatus) ? "OPAQUE" : "TRANSPARENT");
238                     }
239 
240                     // Apple iCal doesn't understand this key, and it's entourage
241                     // specific (i.e. not needed by any caldav client): strip it out
242                     vObject.removeProperty("X-ENTOURAGE_UUID");
243 
244                     splitExDate(vObject);
245 
246                     // remove empty properties
247                     if ("".equals(vObject.getPropertyValue("LOCATION"))) {
248                         vObject.removeProperty("LOCATION");
249                     }
250                     if ("".equals(vObject.getPropertyValue("DESCRIPTION"))) {
251                         vObject.removeProperty("DESCRIPTION");
252                     }
253                     if ("".equals(vObject.getPropertyValue("CLASS"))) {
254                         vObject.removeProperty("CLASS");
255                     }
256                     // rename TZID
257                     if (tzid != null) {
258                         VProperty dtStart = vObject.getProperty("DTSTART");
259                         if (dtStart != null && dtStart.getParam("TZID") != null) {
260                             dtStart.setParam("TZID", tzid);
261                         }
262                         VProperty dtEnd = vObject.getProperty("DTEND");
263                         if (dtEnd != null && dtEnd.getParam("TZID") != null) {
264                             dtEnd.setParam("TZID", tzid);
265                         }
266                         VProperty recurrenceId = vObject.getProperty("RECURRENCE-ID");
267                         if (recurrenceId != null && recurrenceId.getParam("TZID") != null) {
268                             recurrenceId.setParam("TZID", tzid);
269                         }
270                         VProperty exDate = vObject.getProperty("EXDATE");
271                         if (exDate != null && exDate.getParam("TZID") != null) {
272                             exDate.setParam("TZID", tzid);
273                         }
274                     }
275                     // remove unsupported attachment reference
276                     if (vObject.getProperty("ATTACH") != null) {
277                         List<String> toRemoveValues = null;
278                         List<String> values = vObject.getProperty("ATTACH").getValues();
279                         for (String value : values) {
280                             if (value.contains("CID:")) {
281                                 if (toRemoveValues == null) {
282                                     toRemoveValues = new ArrayList<>();
283                                 }
284                                 toRemoveValues.add(value);
285                             }
286                         }
287                         if (toRemoveValues != null) {
288                             values.removeAll(toRemoveValues);
289                             if (values.size() == 0) {
290                                 vObject.removeProperty("ATTACH");
291                             }
292                         }
293                     }
294                 } else {
295                     // add organizer line to all events created in Exchange for active sync
296                     String organizer = getEmailValue(vObject.getProperty("ORGANIZER"));
297                     if (organizer == null) {
298                         vObject.setPropertyValue("ORGANIZER", "MAILTO:" + email);
299                     } else if (!email.equalsIgnoreCase(organizer) && vObject.getProperty("X-MICROSOFT-CDO-REPLYTIME") == null) {
300                         vObject.setPropertyValue("X-MICROSOFT-CDO-REPLYTIME", now);
301                     }
302                     // set OWA allday flag
303                     vObject.setPropertyValue("X-MICROSOFT-CDO-ALLDAYEVENT", isAllDay(vObject) ? "TRUE" : "FALSE");
304                     if (vObject.getPropertyValue("TRANSP") != null) {
305                         vObject.setPropertyValue("X-MICROSOFT-CDO-BUSYSTATUS",
306                                 !"TRANSPARENT".equals(vObject.getPropertyValue("TRANSP")) ? "BUSY" : "FREE");
307                     }
308 
309                     if (isAllDay(vObject)) {
310                         // convert date values to outlook compatible values
311                         setServerAllday(vObject.getProperty("DTSTART"));
312                         setServerAllday(vObject.getProperty("DTEND"));
313                     } else {
314                         fixTzid(vObject.getProperty("DTSTART"));
315                         fixTzid(vObject.getProperty("DTEND"));
316                     }
317                 }
318 
319                 fixAttendees(vObject, fromServer);
320 
321                 fixAlarm(vObject, fromServer);
322             }
323         }
324 
325     }
326 
327     private void fixTimezoneToServer() {
328         if (vTimezone != null && vTimezone.vObjects != null && vTimezone.vObjects.size() > 2) {
329             VObject standard = null;
330             VObject daylight = null;
331             for (VObject vObject : vTimezone.vObjects) {
332                 if ("STANDARD".equals(vObject.type)) {
333                     if (standard == null ||
334                             (vObject.getPropertyValue("DTSTART").compareTo(standard.getPropertyValue("DTSTART")) > 0)) {
335                         standard = vObject;
336                     }
337                 }
338                 if ("DAYLIGHT".equals(vObject.type)) {
339                     if (daylight == null ||
340                             (vObject.getPropertyValue("DTSTART").compareTo(daylight.getPropertyValue("DTSTART")) > 0)) {
341                         daylight = vObject;
342                     }
343                 }
344             }
345             vTimezone.vObjects.clear();
346             vTimezone.vObjects.add(standard);
347             vTimezone.vObjects.add(daylight);
348         }
349         // fix 3569922: quick workaround for broken Israeli Timezone issue
350         if (vTimezone != null && vTimezone.vObjects != null) {
351             for (VObject vObject : vTimezone.vObjects) {
352                 VProperty rrule = vObject.getProperty("RRULE");
353                 if (rrule != null && rrule.getValues().size() == 3 && "BYDAY=-2SU".equals(rrule.getValues().get(1))) {
354                     rrule.getValues().set(1, "BYDAY=4SU");
355                 }
356                 // Fix 555 another broken Israeli timezone
357                 if (rrule != null && rrule.getValues().size() == 4 && "BYDAY=FR".equals(rrule.getValues().get(1))
358                         && "BYMONTHDAY=23,24,25,26,27,28,29".equals(rrule.getValues().get(2))) {
359                     rrule.getValues().set(1, "BYDAY=-1FR");
360                     rrule.getValues().remove(2);
361                 }
362             }
363         }
364         
365         // validate RRULE - COUNT and UNTIL may not occur at once
366         if (vTimezone != null && vTimezone.vObjects != null) {
367             for (VObject vObject : vTimezone.vObjects) {
368                 VProperty rrule = vObject.getProperty("RRULE");
369                 if (rrule != null) {
370                     Map<String, String> rruleValueMap = rrule.getValuesAsMap();
371                     if (rruleValueMap.containsKey("UNTIL") && rruleValueMap.containsKey("COUNT")) {
372                         rrule.removeValue("UNTIL="+rruleValueMap.get("UNTIL"));
373                     }
374                 }
375             }
376         }
377         // end validate RRULE
378         
379         // convert TZID to Exchange time zone id
380         ResourceBundle tzBundle = ResourceBundle.getBundle("exchtimezones");
381         ResourceBundle tzidsBundle = ResourceBundle.getBundle("stdtimezones");
382         for (VObject vObject : vObjects) {
383             if (vObject.isVTimezone()) {
384                 String tzid = vObject.getPropertyValue("TZID");
385                 // check if tzid is avalid Exchange timezone id
386                 if (!tzidsBundle.containsKey(tzid)) {
387                     String exchangeTzid = null;
388                     // try to convert standard timezone id to Exchange timezone id
389                     if (tzBundle.containsKey(tzid)) {
390                         exchangeTzid = tzBundle.getString(tzid);
391                     } else {
392                         // failover, map to a close timezone
393                         for (VObject tzDefinition : vObject.vObjects) {
394                             if ("STANDARD".equals(tzDefinition.type)) {
395                                 exchangeTzid = getTzidFromOffset(tzDefinition.getPropertyValue("TZOFFSETTO"));
396                             }
397                         }
398                     }
399                     if (exchangeTzid != null) {
400                         vObject.setPropertyValue("TZID", exchangeTzid);
401                         // also replace TZID in properties
402                         updateTzid(tzid, exchangeTzid);
403                     }
404                 }
405             }
406         }
407     }
408 
409     protected void updateTzid(String tzid, String newTzid) {
410         for (VObject vObject : vObjects) {
411             if (vObject.isVEvent()) {
412                 for (VProperty vProperty : vObject.properties) {
413                     if (tzid.equalsIgnoreCase(vProperty.getParamValue("TZID"))) {
414                         vProperty.setParam("TZID", newTzid);
415                     }
416                 }
417             }
418         }
419     }
420 
421     private void fixTzid(VProperty property) {
422         if (property != null && !property.hasParam("TZID")) {
423             property.addParam("TZID", vTimezone.getPropertyValue("TZID"));
424         }
425     }
426 
427     protected void splitExDate(VObject vObject) {
428         List<VProperty> exDateProperties = vObject.getProperties("EXDATE");
429         if (exDateProperties != null) {
430             for (VProperty property : exDateProperties) {
431                 String value = property.getValue();
432                 if (value.indexOf(',') >= 0) {
433                     // split property
434                     vObject.removeProperty(property);
435                     for (String singleValue : value.split(",")) {
436                         VProperty singleProperty = new VProperty("EXDATE", singleValue);
437                         singleProperty.setParams(property.getParams());
438                         vObject.addProperty(singleProperty);
439                     }
440                 }
441             }
442         }
443     }
444 
445     protected void setServerAllday(VProperty property) {
446         if (vTimezone != null) {
447             // set TZID param
448             if (!property.hasParam("TZID")) {
449                 property.addParam("TZID", vTimezone.getPropertyValue("TZID"));
450             }
451             // remove VALUE
452             property.removeParam("VALUE");
453             String value = property.getValue();
454             if (value.length() != 8) {
455                 LOGGER.warn("Invalid date value in allday event: " + value);
456             }
457             property.setValue(property.getValue() + "T000000");
458         }
459     }
460 
461     protected void setClientAllday(VProperty property) {
462         if (property != null) {
463             // set VALUE=DATE param
464             if (!property.hasParam("VALUE")) {
465                 property.addParam("VALUE", "DATE");
466             }
467             // remove TZID
468             property.removeParam("TZID");
469             String value = property.getValue();
470             if (value.length() != 8) {
471                 // try to convert datetime value to date value
472                 try {
473                     Calendar calendar = Calendar.getInstance();
474                     SimpleDateFormat dateParser = new SimpleDateFormat("yyyyMMdd'T'HHmmss");
475                     calendar.setTime(dateParser.parse(value));
476                     calendar.add(Calendar.HOUR_OF_DAY, 12);
477                     SimpleDateFormat dateFormatter = new SimpleDateFormat("yyyyMMdd");
478                     value = dateFormatter.format(calendar.getTime());
479                 } catch (ParseException e) {
480                     LOGGER.warn("Invalid date value in allday event: " + value);
481                 }
482             }
483             property.setValue(value);
484         }
485     }
486 
487     protected void fixAlarm(VObject vObject, boolean fromServer) {
488         if (vObject.vObjects != null) {
489             if (Settings.getBooleanProperty("davmail.caldavDisableReminders", false)) {
490                 ArrayList<VObject> vAlarms = null;
491                 for (VObject vAlarm : vObject.vObjects) {
492                     if ("VALARM".equals(vAlarm.type)) {
493                         if (vAlarms == null) {
494                             vAlarms = new ArrayList<>();
495                         }
496                         vAlarms.add(vAlarm);
497                     }
498                 }
499                 // remove all vAlarms
500                 if (vAlarms != null) {
501                     for (VObject vAlarm : vAlarms) {
502                         vObject.vObjects.remove(vAlarm);
503                     }
504                 }
505 
506             } else {
507                 for (VObject vAlarm : vObject.vObjects) {
508                     if ("VALARM".equals(vAlarm.type)) {
509                         String action = vAlarm.getPropertyValue("ACTION");
510                         if (fromServer && "DISPLAY".equals(action)
511                                 // convert DISPLAY to AUDIO only if user defined an alarm sound
512                                 && Settings.getProperty("davmail.caldavAlarmSound") != null) {
513                             // Convert alarm to audio for iCal
514                             vAlarm.setPropertyValue("ACTION", "AUDIO");
515 
516                             if (vAlarm.getPropertyValue("ATTACH") == null) {
517                                 // Add defined sound into the audio alarm
518                                 VProperty vProperty = new VProperty("ATTACH", Settings.getProperty("davmail.caldavAlarmSound"));
519                                 vProperty.addParam("VALUE", "URI");
520                                 vAlarm.addProperty(vProperty);
521                             }
522 
523                         } else if (!fromServer && "AUDIO".equals(action)) {
524                             // Use the alarm action that exchange (and blackberry) understand
525                             // (exchange and blackberry don't understand audio actions)
526                             vAlarm.setPropertyValue("ACTION", "DISPLAY");
527                         }
528                     }
529                 }
530             }
531         }
532     }
533 
534     /**
535      * Replace iCal4 (Snow Leopard) principal paths with mailto expression
536      *
537      * @param value attendee value or ics line
538      * @return fixed value
539      */
540     protected String replaceIcal4Principal(String value) {
541         if (value.contains("/principals/__uuids__/")) {
542             return value.replaceAll("/principals/__uuids__/([^/]*)__AT__([^/]*)/", "mailto:$1@$2");
543         } else {
544             return value;
545         }
546     }
547 
548     private void fixAttendees(VObject vObject, boolean fromServer) {
549         if (vObject.properties != null) {
550             for (VProperty property : vObject.properties) {
551                 if ("ATTENDEE".equalsIgnoreCase(property.getKey())) {
552                     if (fromServer) {
553                         // If this is coming from the server, strip out RSVP for this
554                         // user as an attendee where the partstat is something other
555                         // than PARTSTAT=NEEDS-ACTION since the RSVP confuses iCal4 into
556                         // thinking the attendee has not replied
557                         if (isCurrentUser(property) && property.hasParam("RSVP", "TRUE")) {
558                             if (!"NEEDS-ACTION".equals(property.getParamValue("PARTSTAT"))) {
559                                 property.removeParam("RSVP");
560                             }
561                         }
562                     } else {
563                         property.setValue(replaceIcal4Principal(property.getValue()));
564                     }
565                 }
566 
567             }
568         }
569 
570     }
571 
572     private boolean isCurrentUser(VProperty property) {
573         return property.getValue().equalsIgnoreCase("mailto:" + email);
574     }
575 
576     /**
577      * Return VTimezone object
578      *
579      * @return VTimezone
580      */
581     public VObject getVTimezone() {
582         return vTimezone;
583     }
584 
585     /**
586      * Convert X-CALENDARSERVER-ACCESS to CLASS.
587      * see http://svn.calendarserver.org/repository/calendarserver/CalendarServer/trunk/doc/Extensions/caldav-privateevents.txt
588      *
589      * @param calendarServerAccess X-CALENDARSERVER-ACCESS value
590      * @return CLASS value
591      */
592     protected String getEventClass(String calendarServerAccess) {
593         if ("PRIVATE".equalsIgnoreCase(calendarServerAccess)) {
594             return "CONFIDENTIAL";
595         } else if ("CONFIDENTIAL".equalsIgnoreCase(calendarServerAccess) || "RESTRICTED".equalsIgnoreCase(calendarServerAccess)) {
596             return "PRIVATE";
597         } else {
598             return null;
599         }
600     }
601 
602     /**
603      * Convert CLASS to X-CALENDARSERVER-ACCESS.
604      * see http://svn.calendarserver.org/repository/calendarserver/CalendarServer/trunk/doc/Extensions/caldav-privateevents.txt     *
605      *
606      * @return X-CALENDARSERVER-ACCESS value
607      */
608     protected String getCalendarServerAccess() {
609         String eventClass = getFirstVeventPropertyValue("CLASS");
610         if ("PRIVATE".equalsIgnoreCase(eventClass)) {
611             return "CONFIDENTIAL";
612         } else if ("CONFIDENTIAL".equalsIgnoreCase(eventClass)) {
613             return "PRIVATE";
614         } else {
615             return null;
616         }
617     }
618 
619     /**
620      * Get property value from first VEVENT in VCALENDAR.
621      *
622      * @param name property name
623      * @return property value
624      */
625     public String getFirstVeventPropertyValue(String name) {
626         if (firstVevent == null) {
627             return null;
628         } else {
629             return firstVevent.getPropertyValue(name);
630         }
631     }
632 
633     protected VProperty getFirstVeventProperty(String name) {
634         if (firstVevent == null) {
635             return null;
636         } else {
637             return firstVevent.getProperty(name);
638         }
639     }
640 
641 
642     /**
643      * Get properties by name from first VEVENT.
644      *
645      * @param name property name
646      * @return properties
647      */
648     public List<VProperty> getFirstVeventProperties(String name) {
649         if (firstVevent == null) {
650             return null;
651         } else {
652             return firstVevent.getProperties(name);
653         }
654     }
655 
656     /**
657      * Remove VAlarm from VCalendar.
658      */
659     public void removeVAlarm() {
660         if (vObjects != null) {
661             for (VObject vObject : vObjects) {
662                 if ("VEVENT".equals(vObject.type)) {
663                     // As VALARM is the only possible inner object, just drop all objects
664                     if (vObject.vObjects != null) {
665                         vObject.vObjects = null;
666                     }
667                 }
668             }
669         }
670     }
671 
672     /**
673      * Check if VCalendar has a VALARM item.
674      *
675      * @return true if VCalendar has a VALARM
676      */
677     public boolean hasVAlarm() {
678         if (vObjects != null) {
679             for (VObject vObject : vObjects) {
680                 if ("VEVENT".equals(vObject.type)) {
681                     if (vObject.vObjects != null && !vObject.vObjects.isEmpty()) {
682                         return vObject.vObjects.get(0).isVAlarm();
683                     }
684                 }
685             }
686         }
687         return false;
688     }
689 
690     public String getReminderMinutesBeforeStart() {
691         String result = "0";
692         if (vObjects != null) {
693             for (VObject vObject : vObjects) {
694                 if (vObject.vObjects != null && !vObject.vObjects.isEmpty() &&
695                         vObject.vObjects.get(0).isVAlarm()) {
696                     String trigger = vObject.vObjects.get(0).getPropertyValue("TRIGGER");
697                     if (trigger != null) {
698                         if (trigger.startsWith("-PT") && trigger.endsWith("M")) {
699                             result = trigger.substring(3, trigger.length() - 1);
700                         } else if (trigger.startsWith("-PT") && trigger.endsWith("H")) {
701                             result = trigger.substring(3, trigger.length() - 1);
702                             // convert to minutes
703                             result = String.valueOf(Integer.parseInt(result) * 60);
704                         } else if (trigger.startsWith("-P") && trigger.endsWith("D")) {
705                             result = trigger.substring(2, trigger.length() - 1);
706                             // convert to minutes
707                             result = String.valueOf(Integer.parseInt(result) * 60 * 24);
708                         } else if (trigger.startsWith("-P") && trigger.endsWith("W")) {
709                             result = trigger.substring(2, trigger.length() - 1);
710                             // convert to minutes
711                             result = String.valueOf(Integer.parseInt(result) * 60 * 24 * 7);
712                         }
713                     }
714                 }
715             }
716         }
717         return result;
718     }
719 
720 
721     /**
722      * Check if this VCalendar is a meeting.
723      *
724      * @return true if this VCalendar has attendees
725      */
726     public boolean isMeeting() {
727         return getFirstVeventProperty("ATTENDEE") != null;
728     }
729 
730     /**
731      * Check if current user is meeting organizer.
732      *
733      * @return true it user email matched organizer email
734      */
735     public boolean isMeetingOrganizer() {
736         return email.equalsIgnoreCase(getEmailValue(getFirstVeventProperty("ORGANIZER")));
737     }
738 
739     /**
740      * Set property value on first VEVENT.
741      *
742      * @param propertyName  property name
743      * @param propertyValue property value
744      */
745     public void setFirstVeventPropertyValue(String propertyName, String propertyValue) {
746         firstVevent.setPropertyValue(propertyName, propertyValue);
747     }
748 
749     /**
750      * Add property on first VEVENT.
751      *
752      * @param vProperty property object
753      */
754     public void addFirstVeventProperty(VProperty vProperty) {
755         firstVevent.addProperty(vProperty);
756     }
757 
758     /**
759      * Check if this item is a VTODO item
760      *
761      * @return true with VTODO items
762      */
763     public boolean isTodo() {
764         return firstVevent != null && "VTODO".equals(firstVevent.type);
765     }
766 
767     /**
768      * VCalendar recipients for notifications
769      */
770     public static class Recipients {
771         /**
772          * attendee list
773          */
774         public String attendees;
775 
776         /**
777          * optional attendee list
778          */
779         public String optionalAttendees;
780 
781         /**
782          * vCalendar organizer
783          */
784         public String organizer;
785     }
786 
787     /**
788      * Build recipients value for VCalendar.
789      *
790      * @param isNotification if true, filter recipients that should receive meeting notifications
791      * @return notification/event recipients
792      */
793     public Recipients getRecipients(boolean isNotification) {
794 
795         HashSet<String> attendees = new HashSet<>();
796         HashSet<String> optionalAttendees = new HashSet<>();
797 
798         // get recipients from first VEVENT
799         List<VProperty> attendeeProperties = getFirstVeventProperties("ATTENDEE");
800         if (attendeeProperties != null) {
801             for (VProperty property : attendeeProperties) {
802                 // exclude current user and invalid values from recipients
803                 // also exclude no action attendees
804                 String attendeeEmail = getEmailValue(property);
805                 if (!email.equalsIgnoreCase(attendeeEmail) && attendeeEmail != null && attendeeEmail.indexOf('@') >= 0
806                         // return all attendees for user calendar folder, filter for notifications
807                         && (!isNotification
808                         // notify attendee if reply explicitly requested
809                         || (property.hasParam("RSVP", "TRUE"))
810                         || (
811                         // workaround for iCal bug: do not notify if reply explicitly not requested
812                         !(property.hasParam("RSVP", "FALSE")) &&
813                                 ((property.hasParam("PARTSTAT", "NEEDS-ACTION")
814                                         // need to include other PARTSTATs participants for CANCEL notifications
815                                         || property.hasParam("PARTSTAT", "ACCEPTED")
816                                         || property.hasParam("PARTSTAT", "DECLINED")
817                                         || property.hasParam("PARTSTAT", "TENTATIVE")))
818                 ))) {
819                     if (property.hasParam("ROLE", "OPT-PARTICIPANT")) {
820                         optionalAttendees.add(attendeeEmail);
821                     } else {
822                         attendees.add(attendeeEmail);
823                     }
824                 }
825             }
826         }
827         Recipients recipients = new Recipients();
828         recipients.organizer = getEmailValue(getFirstVeventProperty("ORGANIZER"));
829         recipients.attendees = StringUtil.join(attendees, ", ");
830         recipients.optionalAttendees = StringUtil.join(optionalAttendees, ", ");
831         return recipients;
832     }
833 
834     public String getAttendeeStatus() {
835         String status = null;
836         List<VProperty> attendeeProperties = getFirstVeventProperties("ATTENDEE");
837         if (attendeeProperties != null) {
838             for (VProperty property : attendeeProperties) {
839                 String attendeeEmail = getEmailValue(property);
840                 if (email.equalsIgnoreCase(attendeeEmail) && property.hasParam("PARTSTAT")) {
841                     // found current user attendee line
842                     status = property.getParamValue("PARTSTAT");
843                     break;
844                 }
845             }
846         }
847         return status;
848     }
849 
850     /**
851      * Get first VEvent
852      *
853      * @return first VEvent
854      */
855     public VObject getFirstVevent() {
856         return firstVevent;
857     }
858 
859     /**
860      * Get recurring VCalendar occurence exceptions.
861      *
862      * @return event occurences
863      */
864     public List<VObject> getModifiedOccurrences() {
865         boolean first = true;
866         ArrayList<VObject> results = new ArrayList<>();
867         for (VObject vObject : vObjects) {
868             if ("VEVENT".equals(vObject.type)) {
869                 if (first) {
870                     first = false;
871                 } else {
872                     results.add(vObject);
873                 }
874             }
875         }
876         return results;
877     }
878 
879     public TimeZone getStandardTimezoneId(String tzid) {
880         String convertedTzid;
881         // convert Exchange TZID to standard timezone
882         try {
883             convertedTzid = ResourceBundle.getBundle("timezones").getString(tzid);
884         } catch (MissingResourceException e) {
885             convertedTzid = tzid;
886             // failover: detect timezone from offset
887             VObject vTimezone = getVTimezone();
888             for (VObject tzDefinition : vTimezone.vObjects) {
889                 if ("STANDARD".equals(tzDefinition.type)) {
890                     convertedTzid = getTzidFromOffset(tzDefinition.getPropertyValue("TZOFFSETTO"));
891                 }
892             }
893             convertedTzid = ResourceBundle.getBundle("timezones").getString(convertedTzid);
894         }
895         return TimeZone.getTimeZone(convertedTzid);
896 
897     }
898 
899     private String getTzidFromOffset(String tzOffset) {
900         if (tzOffset == null) {
901             return null;
902         } else if (tzOffset.length() == 7) {
903             tzOffset = tzOffset.substring(0, 5);
904         }
905         return ResourceBundle.getBundle("tzoffsettimezones").getString(tzOffset);
906     }
907 
908     public String convertCalendarDateToExchangeZulu(String vcalendarDateValue, String tzid) throws IOException {
909         String zuluDateValue = null;
910         TimeZone timeZone;
911         if (tzid == null) {
912             timeZone = ExchangeSession.GMT_TIMEZONE;
913         } else {
914             timeZone = getStandardTimezoneId(tzid);
915         }
916         if (vcalendarDateValue != null) {
917             try {
918                 SimpleDateFormat dateParser;
919                 if (vcalendarDateValue.length() == 8) {
920                     dateParser = new SimpleDateFormat("yyyyMMdd", Locale.ENGLISH);
921                 } else {
922                     dateParser = new SimpleDateFormat("yyyyMMdd'T'HHmmss", Locale.ENGLISH);
923                 }
924                 dateParser.setTimeZone(timeZone);
925                 SimpleDateFormat dateFormatter = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'", Locale.ENGLISH);
926                 dateFormatter.setTimeZone(ExchangeSession.GMT_TIMEZONE);
927                 zuluDateValue = dateFormatter.format(dateParser.parse(vcalendarDateValue));
928             } catch (ParseException e) {
929                 throw new IOException("Invalid date " + vcalendarDateValue + " with tzid " + tzid);
930             }
931         }
932         return zuluDateValue;
933     }
934 }