ezvcard.property

Class Revision

java.lang.Object

ezvcard.property.VCardProperty

ezvcard.property.SimpleProperty<Temporal>

ezvcard.property.Revision

All Implemented Interfaces:

Comparable<VCardProperty>

public class Revision
extends SimpleProperty<Temporal>

Defines the date that the vCard was last modified by its owner.

Code sample

 VCard vcard = new VCard();
 
 Revision rev = new Revision(Instant.now());
 vcard.setRevision(rev);
 

Property name: REV

Supported versions: 2.1, 3.0, 4.0

Author:

Michael Angstadt

See Also:

RFC 6350 p.45, RFC 2426 p.22, vCard 2.1 p.19

Field Summary

Fields inherited from class ezvcard.property.SimpleProperty

value

Fields inherited from class ezvcard.property.VCardProperty

group, parameters

Constructor Summary

Constructors

Constructor and Description
Revision(Revision original) Copy constructor.
Revision(Temporal timestamp) Creates a revision property.

Method Summary

Modifier and Type	Method and Description
Revision	copy() Creates a copy of this property object.
static Revision	now() Creates a revision property whose value is the current time.

Methods inherited from class ezvcard.property.SimpleProperty

_validate, equals, getValue, hashCode, setValue, toStringValues

Methods inherited from class ezvcard.property.VCardProperty

addParameter, compareTo, getGroup, getParameter, getParameters, getParameters, getSupportedVersions, isSupportedBy, removeParameter, setGroup, setParameter, setParameters, toString, validate

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Revision

public Revision(Temporal timestamp)

Creates a revision property.

Parameters:

timestamp - the timestamp when the vCard was last modified (Instant recommended)

Revision

public Revision(Revision original)

Copy constructor.

Parameters:

original - the property to make a copy of

Method Detail

now

public static Revision now()

Creates a revision property whose value is the current time.

Returns:

the property

copy

public Revision copy()

Description copied from class: VCardProperty

Creates a copy of this property object.

The default implementation of this method uses reflection to look for a copy constructor. Child classes SHOULD override this method to avoid the performance overhead involved in using reflection.

The child class's copy constructor, if present, MUST invoke the VCardProperty.VCardProperty(VCardProperty) super constructor to ensure that the group name and parameters are also copied.

This method MUST be overridden by the child class if the child class does not have a copy constructor. Otherwise, an UnsupportedOperationException will be thrown when an attempt is made to copy the property (such as in the VCard class's copy constructor).

Overrides:

copy in class VCardProperty

Returns:

the copy