Module ical4j.core

Class TzUrl

All Implemented Interfaces:
Serializable, Comparable<Property>, FluentProperty, Prototype<Property>

public class TzUrl extends Property
$Id$

Created: [Apr 6, 2004]

Defines a TZURL iCalendar component property.

     4.8.3.5 Time Zone URL

        Property Name: TZURL

        Purpose: The TZURL provides a means for a VTIMEZONE component to
        point to a network location that can be used to retrieve an up-to-
        date version of itself.

        Value Type: URI

        Property Parameters: Non-standard property parameters can be
        specified on this property.

        Conformance: This property can be specified in a "VTIMEZONE" calendar
        component.

        Description: The TZURL provides a means for a VTIMEZONE component to
        point to a network location that can be used to retrieve an up-to-
        date version of itself. This provides a hook to handle changes
        government bodies impose upon time zone definitions. Retrieval of
        this resource results in an iCalendar object containing a single
        VTIMEZONE component and a METHOD property set to PUBLISH.

        Format Definition: The property is defined by the following notation:

          tzurl      = "TZURL" tzurlparam ":" uri CRLF

          tzurlparam = *(";" xparam)

        Example: The following is an example of this property:

          TZURL:http://timezones.r.us.net/tz/US-California-Los_Angeles
 
See Also:
  • Constructor Details

    • TzUrl

      public TzUrl()
      Default constructor.
    • TzUrl

      public TzUrl(ParameterList aList, String aValue)
      Parameters:
      aList - a list of parameters for this component
      aValue - a value string for this component
    • TzUrl

      public TzUrl(URI aUri)
      Parameters:
      aUri - a URI
    • TzUrl

      public TzUrl(ParameterList aList, URI aUri)
      Parameters:
      aList - a list of parameters for this component
      aUri - a URI
  • Method Details

    • getUri

      public final URI getUri()
      Returns:
      Returns the uri.
    • setValue

      public final void setValue(String aValue)
      Sets the current value of the property.
      Specified by:
      setValue in class Property
      Parameters:
      aValue - a string representation of the property value
    • getValue

      public final String getValue()
      Specified by:
      getValue in class Content
      Returns:
      the content value
    • setUri

      public final void setUri(URI uri)
      Parameters:
      uri - The uri to set.
    • validate

      public ValidationResult validate() throws ValidationException
      Description copied from class: Property
      Perform validation on a property.
      Specified by:
      validate in class Property
      Throws:
      ValidationException - where the property is not in a valid state
    • newFactory

      protected PropertyFactory<TzUrl> newFactory()
      Description copied from class: Property
      Returns a new property factory used to create deep copies.
      Specified by:
      newFactory in class Property
      Returns:
      a property factory instance