All Implemented Interfaces:
PropAttachment<T>, VProperty<T>, VChild, VElement, VParent

public class Attachment<T> extends VPropertyBase<T,Attachment<T>> implements PropAttachment<T>

Property Name: ATTACH

Purpose: This property provides the capability to associate a document object with a calendar component.

Value Type: The default value type for this property is URI. The value type can also be set to BINARY to indicate inline binary encoded content information.

Property Parameters: IANA, non-standard, inline encoding, and value data type property parameters can be specified on this property. The format type parameter can be specified on this property and is RECOMMENDED for inline binary encoded content information.

Conformance: This property can be specified multiple times in a VEVENT, VTODO, VJOURNAL, or VALARM calendar component with the exception of AUDIO alarm that only allows this property to occur once.

Description: This property is used in VEVENT, VTODO, and VJOURNAL calendar components to associate a resource (e.g., document) with the calendar component. This property is used in VALARM calendar components to specify an audio sound resource or an email message attachment. This property can be specified as a URI pointing to a resource or as inline binary encoded content.

When this property is specified as inline binary encoded content, calendar applications MAY attempt to guess the media type of the resource via inspection of its content if and only if the media type of the resource is not given by the FMTTYPE parameter. If the media type remains unknown, calendar applications SHOULD treat it as type "application/octet-stream".

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

  • attach
  • attachparam
    • The following is OPTIONAL for a URI value, RECOMMENDED for a BINARY value, and MUST NOT occur more than once.
    • The following are OPTIONAL, and MAY occur more than once.
      • ";" OtherParameter

Example: The following is an example of this property:

  • ATTACH:CID:jsmith.part3.960817T083000.xyzMail@example.com
  • ATTACH;FMTTYPE=application/postscript:ftp://example.com/pub/
    reports/r-960812.ps

3.8.1.1. Attachment RFC 5545 iCalendar September 2009
  • Field Details

  • Constructor Details

    • Attachment

      public Attachment(Class<T> clazz, String contentLine)
      Create a Binary Attachment by setting property value to String input parameter
    • Attachment

      public Attachment(Attachment<T> source)
      Create deep copy of source Attachment
    • Attachment

      public Attachment(T value)
      Create new Attendee with property value set to input parameter
      Note: This constructor has no type checking. Use Attachment(Class, String) constructor for type checking
    • Attachment

      public Attachment()
      Create default Attachment with no value set
  • Method Details