Class VJournalUserAgent

    • Method Detail

      • publish

        public Calendar publish​(VJournal... component)
         3.5.1.  PUBLISH
        
             The "PUBLISH" method in a "VJOURNAL" calendar component has no
             associated response.  It is simply a posting of an iCalendar object
             that may be added to a calendar.  It MUST have an "Organizer".  It
             MUST NOT have "Attendees".  The expected usage is for encapsulating
             an arbitrary journal entry as an iCalendar object.  The "Organizer"
             MAY subsequently update (with another "PUBLISH" method) or cancel
             (with a "CANCEL" method) a previously published journal entry.
         
        Parameters:
        component - one or more component objects
        Returns:
        a calendar object validated to conform to iTIP method PUBLISH
      • request

        public Calendar request​(VJournal... component)
        Not applicable for this agent implementation.
        Parameters:
        component - one or more component objects
        Returns:
        a calendar object validated to conform to iTIP method REQUEST
        Throws:
        UnsupportedOperationException
      • delegate

        public Calendar delegate​(Calendar request)
        Not applicable for this agent implementation.
        Parameters:
        request - a calendar implement the iTIP REQUEST method
        Returns:
        a calendar delegating the request via an iTIP REQUEST method
        Throws:
        UnsupportedOperationException
      • reply

        public Calendar reply​(Calendar request)
        Not applicable for this agent implementation.
        Parameters:
        request - a calendar request
        Returns:
        a calendar object validated to conform to iTIP method REPLY
        Throws:
        UnsupportedOperationException
      • add

        public Calendar add​(VJournal component)
         3.5.2.  ADD
        
             The "ADD" method allows the "Organizer" to add one or more new
             instances to an existing "VJOURNAL" using a single iTIP message
             without having to send the entire "VJOURNAL" with all the existing
             instance data, as it would have to do if the "REQUEST" method were
             used.
        
             The "UID" must be that of the existing journal entry.  If the "UID"
             property value in the "ADD" is not found on the recipient's calendar,
             then the recipient MAY treat the "ADD" as a "PUBLISH".
        
             When handling an "ADD" message, the "Attendee" treats each component
             in the "ADD" message as if it were referenced via an "RDATE" in the
             main component.  There is no response to the "Organizer".
         
        Parameters:
        component - a calendar component to add
        Returns:
        a calendar object validated to conform to iTIP method ADD
      • cancel

        public Calendar cancel​(VJournal... component)
         3.5.3.  CANCEL
        
             The "CANCEL" method in a "VJOURNAL" calendar component is used to
             send a cancellation notice of an existing journal entry.  The message
             is sent by the "Organizer" of a journal entry.  For a recurring
             journal entry, either the whole journal entry or instances of a
             journal entry may be cancelled.  To cancel the complete range of a
             recurring journal entry, the "UID" property value for the journal
             entry MUST be specified and a "RECURRENCE-ID" property MUST NOT be
             specified in the "CANCEL" method.  In order to cancel an individual
             instance of the journal entry, the "RECURRENCE-ID" property value for
             the journal entry MUST be specified in the "CANCEL" method.
        
             There are two options for canceling a sequence of instances of a
             recurring "VJOURNAL" calendar component:
        
             a.  The "RECURRENCE-ID" property for an instance in the sequence MUST
             be specified with the "RANGE" property parameter value of
             "THISANDFUTURE" to indicate cancellation of the specified
             "VJOURNAL" calendar component and all instances after.
        
             b.  Individual recurrence instances may be cancelled by specifying
             multiple "VJOURNAL" components each with a "RECURRENCE-ID"
             property corresponding to one of the instances to be cancelled.
        
             When a "VJOURNAL" is cancelled, the "SEQUENCE" property value MUST be
             incremented as described in Section 2.1.4.
         
        Parameters:
        component - one or more component objects
        Returns:
        a calendar object validated to conform to iTIP method CANCEL
      • refresh

        public Calendar refresh​(VJournal component)
        Not applicable for this agent implementation.
        Parameters:
        component - a calendar component to refresh
        Returns:
        a calendar object validated to conform to iTIP method REFRESH
        Throws:
        UnsupportedOperationException
      • counter

        public Calendar counter​(Calendar request)
        Not applicable for this agent implementation.
        Parameters:
        request - a calendar request to counter
        Returns:
        a calendar object validated to conform to iTIP method COUNTER
        Throws:
        UnsupportedOperationException
      • declineCounter

        public Calendar declineCounter​(Calendar counter)
        Not applicable for this agent implementation.
        Parameters:
        counter - a counter to a request
        Returns:
        a calendar object validated to conform to iTIP method DECLINECOUNTER
        Throws:
        UnsupportedOperationException