Class VResource

  • All Implemented Interfaces:
    Serializable, PropertyContainer

    public class VResource
    extends Component
    $Id$ [May 1 2017] Defines an iCalendar VRESOURCE component.
     Component name:  VRESOURCE
    
     Purpose:  This component provides a typed reference to external
     information about a resource or optionally a plain text typed
     value.  Typically a resource is anything that might be required or
     used by a calendar entity and possibly has a directory entry.
    
     Conformance:  This component can be specified multiple times in a
     "VEVENT", "VTODO", "VJOURNAL", "VFREEBUSY" or "PARTICIPANT"
     calendar component.
    
     Description:  When used in a component this component provides
     information about resources used for the event such as rooms,
     projectors, conferencing capabilities.
    
     The RESOURCE-TYPE value registry provides a place in which
     resource types may be registered.
    
     STRUCTURED-DATA properties if present may refer to representations
     of the resource - such as a vCard.
    
     Format Definition:
    
     This component is defined by the following notation:
    
     resourcec    = "BEGIN" ":" "VRESOURCE" CRLF
                    resprop
                    "END" ":" "VRESOURCE" CRLF
    
     resprop      = ; the elements herein may appear in any order,
                    ; and the order is not significant.
    
                    uid
    
                    (name)
                    (description)
                    (geo)
                    (restype)
    
    sdataprop
    iana-prop
    
     The NAME property is defined in [RFC7986]
    
     
    See Also:
    Serialized Form
    • Constructor Detail

      • VResource

        public VResource()
        Default constructor.
      • VResource

        public VResource​(PropertyList<Property> properties)
        Constructor.
        Parameters:
        properties - a list of properties
    • Method Detail

      • validate

        public final void validate​(boolean recurse)
                            throws ValidationException
        Perform validation on a component.
        Specified by:
        validate in class Component
        Parameters:
        recurse - indicates whether to validate the component's properties
        Throws:
        ValidationException - where the component is not in a valid state
      • getDescription

        public final Description getDescription()
        Returns the optional description property.
        Returns:
        the DESCRIPTION property or null if not specified
      • getGeo

        public final Geo getGeo()
        Returns:
        the optional geo property for a vresource
      • getResourceType

        public ResourceType getResourceType()
        Returns the optional ResourceType property.
        Returns:
        the ResourceType property or null if not specified
      • getNameProp

        public final Name getNameProp()
        Returns:
        the optional name property for a vresource
      • getUid

        public final Uid getUid()
        Returns the UID property of this component if available.
        Returns:
        a Uid instance, or null if no UID property exists
      • getStructuredData

        public final PropertyList<StructuredData> getStructuredData()
        Returns:
        the optional structured data properties