Caldavsync Sources / file diff

     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/src/net/fortuna/ical4j/model/TimeZoneRegistry.java	Tue Feb 10 18:12:00 2015 +0100
     1.3 @@ -0,0 +1,77 @@
     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;
    1.36 +
    1.37 +/**
    1.38 + * $Id$
    1.39 + *
    1.40 + * Created on 18/09/2005
    1.41 + *
    1.42 + * Implementors provide a list of timezone definitions applicable for use
    1.43 + * with iCalendar objects.
    1.44 + * @author Ben Fortuna
    1.45 + */
    1.46 +public interface TimeZoneRegistry {
    1.47 +
    1.48 +    /**
    1.49 +     * Registers a new timezone for use with iCalendar objects. If a timezone
    1.50 +     * with the same identifier is already registered this timezone will take
    1.51 +     * precedence.
    1.52 +     * @param timezone a timezone to be registered for use with iCalendar
    1.53 +     * objects
    1.54 +     */
    1.55 +    void register(final TimeZone timezone);
    1.56 +    
    1.57 +    /**
    1.58 +     * Registers a new timezone for use with iCalendar objects. If a timezone
    1.59 +     * with the same identifier is already registered this timezone will take
    1.60 +     * precedence.
    1.61 +     * @param timezone a timezone to be registered for use with iCalendar
    1.62 +     * objects
    1.63 +     * @param update attempt to update the definition from any specified TZURL
    1.64 +     * property if true
    1.65 +     */
    1.66 +    void register(final TimeZone timezone, boolean update);
    1.67 +    
    1.68 +    /**
    1.69 +     * Clears all registered timezones.
    1.70 +     */
    1.71 +    void clear();
    1.72 +    
    1.73 +    /**
    1.74 +     * Returns a timezone with the specified identifier.
    1.75 +     * @param id a timezone identifier
    1.76 +     * @return a timezone matching the specified identifier. If no timezone
    1.77 +     * is registered with the specified identifier null is returned.
    1.78 +     */
    1.79 +    TimeZone getTimeZone(final String id);
    1.80 +}