Package net.fortuna.ical4j.model.property

Class Url

  • All Implemented Interfaces:
    Serializable, Comparable<Property>, FluentProperty
    public class Url
extends Property
    $Id$

    Created: [Apr 6, 2004]

    Defines a URL iCalendar component property. 

         4.8.4.6 Uniform Resource Locator

        Property Name: URL

        Purpose: This property defines a Uniform Resource Locator (URL)
        associated with the iCalendar object.

        Value Type: URI

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

        Conformance: This property can be specified once in the "VEVENT",
        "VTODO", "VJOURNAL" or "VFREEBUSY" calendar components.

        Description: This property may be used in a calendar component to
        convey a location where a more dynamic rendition of the calendar
        information associated with the calendar component can be found. This
        memo does not attempt to standardize the form of the URI, nor the
        format of the resource pointed to by the property value. If the URL
        property and Content-Location MIME header are both specified, they
        MUST point to the same resource.

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

          url        = "URL" urlparam ":" uri CRLF

          urlparam   = *(";" xparam)

        Example: The following is an example of this property:

          URL:http://abc.com/pub/calendars/jsmith/mytime.ics
    See Also:
    Serialized Form

    • Constructor Detail

      • Url

        public Url()
        Default constructor.

      • Url

        public Url​(ParameterList aList,
           String aValue)
        Parameters:
        aList - a list of parameters for this component
        aValue - a value string for this component
        Throws:
        URISyntaxException - where the specified value string is not a valid uri

      • Url

        public Url​(URI aUri)
        Parameters:
        aUri - a URI

      • Url

        public Url​(ParameterList aList,
           URI aUri)
        Parameters:
        aList - a list of parameters for this component
        aUri - a URI

    • Method Detail

      • 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.

      • newFactory

        protected PropertyFactory<Url> 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