src/net/fortuna/ical4j/model/property/LastModified.java

changeset 0
fb9019fb1bf7
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/src/net/fortuna/ical4j/model/property/LastModified.java	Tue Feb 10 18:12:00 2015 +0100
     1.3 @@ -0,0 +1,129 @@
     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 java.text.ParseException;
    1.38 +
    1.39 +import net.fortuna.ical4j.model.DateTime;
    1.40 +import net.fortuna.ical4j.model.ParameterList;
    1.41 +import net.fortuna.ical4j.model.PropertyFactoryImpl;
    1.42 +
    1.43 +/**
    1.44 + * $Id$
    1.45 + * 
    1.46 + * Created: [Apr 6, 2004]
    1.47 + *
    1.48 + * Defines a LAST-MODIFIED iCalendar component property.
    1.49 + * 
    1.50 + * <pre>
    1.51 + *     4.8.7.3 Last Modified
    1.52 + *     
    1.53 + *        Property Name: LAST-MODIFIED
    1.54 + *     
    1.55 + *        Purpose: The property specifies the date and time that the
    1.56 + *        information associated with the calendar component was last revised
    1.57 + *        in the calendar store.
    1.58 + *     
    1.59 + *             Note: This is analogous to the modification date and time for a
    1.60 + *             file in the file system.
    1.61 + *     
    1.62 + *        Value Type: DATE-TIME
    1.63 + *     
    1.64 + *        Property Parameters: Non-standard property parameters can be
    1.65 + *        specified on this property.
    1.66 + *     
    1.67 + *        Conformance: This property can be specified in the &quot;EVENT&quot;, &quot;VTODO&quot;,
    1.68 + *        &quot;VJOURNAL&quot; or &quot;VTIMEZONE&quot; calendar components.
    1.69 + *     
    1.70 + *        Description: The property value MUST be specified in the UTC time
    1.71 + *        format.
    1.72 + *     
    1.73 + *        Format Definition: The property is defined by the following notation:
    1.74 + *     
    1.75 + *          last-mod   = &quot;LAST-MODIFIED&quot; lstparam &quot;:&quot; date-time CRLF
    1.76 + *     
    1.77 + *          lstparam   = *(&quot;;&quot; xparam)
    1.78 + * </pre>
    1.79 + * 
    1.80 + * @author benf
    1.81 + */
    1.82 +public class LastModified extends UtcProperty {
    1.83 +
    1.84 +    private static final long serialVersionUID = 5288572652052836062L;
    1.85 +
    1.86 +    /**
    1.87 +     * Default constructor.
    1.88 +     */
    1.89 +    public LastModified() {
    1.90 +        super(LAST_MODIFIED, PropertyFactoryImpl.getInstance());
    1.91 +    }
    1.92 +
    1.93 +    /**
    1.94 +     * @param aValue a date-time value
    1.95 +     * @throws ParseException where the specified string is not a valid date-time
    1.96 +     */
    1.97 +    public LastModified(final String aValue) throws ParseException {
    1.98 +    	this(new ParameterList(), aValue);
    1.99 +    }
   1.100 +    
   1.101 +    /**
   1.102 +     * @param aList a list of parameters for this component
   1.103 +     * @param aValue a value string for this component
   1.104 +     * @throws ParseException where the specified value string is not a valid date-time/date representation
   1.105 +     */
   1.106 +    public LastModified(final ParameterList aList, final String aValue)
   1.107 +            throws ParseException {
   1.108 +        super(LAST_MODIFIED, aList, PropertyFactoryImpl.getInstance());
   1.109 +        setValue(aValue);
   1.110 +    }
   1.111 +
   1.112 +    /**
   1.113 +     * @param aDate a date representation of a date-time value
   1.114 +     */
   1.115 +    public LastModified(final DateTime aDate) {
   1.116 +        super(LAST_MODIFIED, PropertyFactoryImpl.getInstance());
   1.117 +        // time must be in UTC..
   1.118 +        aDate.setUtc(true);
   1.119 +        setDate(aDate);
   1.120 +    }
   1.121 +
   1.122 +    /**
   1.123 +     * @param aList a list of parameters for this component
   1.124 +     * @param aDate a date representation of a date-time value
   1.125 +     */
   1.126 +    public LastModified(final ParameterList aList, final DateTime aDate) {
   1.127 +        super(LAST_MODIFIED, aList, PropertyFactoryImpl.getInstance());
   1.128 +        // time must be in UTC..
   1.129 +        aDate.setUtc(true);
   1.130 +        setDate(aDate);
   1.131 +    }
   1.132 +}

mercurial