org.opendaylight.yangtools.yang.common

Class Revision

java.lang.Object

org.opendaylight.yangtools.yang.common.Revision

All Implemented Interfaces:

Serializable, Comparable<Revision>

public final class Revision
extends Object
implements Comparable<Revision>, Serializable

Dedicated object identifying a YANG module revision.

API design note

This class defines the contents of a revision statement, but modules do not require to have a revision (e.g. they have not started to keep track of revisions).

APIs which involve this class should always transfer instances via Optional<Revision>, which is the primary bridge data type. Implementations can use nullable fields with explicit conversions to/from Optional. Both patterns can take advantage of compare(Optional, Optional) and compare(Revision, Revision) respectively.

Author:

Robert Varga

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Revision	MAX_VALUE Revision which compares as greater than any other valid revision.
static Pattern	STRING_FORMAT_PATTERN String format pattern, which can be used to match parts of a string into components.

Method Summary

Modifier and Type	Method and Description
static int	compare(@NonNull Optional<Revision> first, @NonNull Optional<Revision> second) Compare two Optionals wrapping Revisions.
static int	compare(@Nullable Revision first, @Nullable Revision second) Compare two explicitly nullable Revisions.
int	compareTo(Revision o)
boolean	equals(Object obj)
int	hashCode()
static @NonNull Revision	of(@NonNull String str) Parse a revision string.
static @NonNull Optional<Revision>	ofNullable(@Nullable String str) Parse a (potentially null) revision string.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

STRING_FORMAT_PATTERN

public static final Pattern STRING_FORMAT_PATTERN

String format pattern, which can be used to match parts of a string into components.

MAX_VALUE

public static final Revision MAX_VALUE

Revision which compares as greater than any other valid revision.

Method Detail

of

public static @NonNull Revision of(@NonNull String str)

Parse a revision string.

Parameters:

str - String to be parsed

Returns:

A Revision instance.

Throws:

DateTimeParseException - if the string format does not conform specification.

NullPointerException - if the string is null

ofNullable

public static @NonNull Optional<Revision> ofNullable(@Nullable String str)

Parse a (potentially null) revision string. Null strings result result in Optional.empty().

Parameters:

str - String to be parsed

Returns:

An optional Revision instance.

Throws:

DateTimeParseException - if the string format does not conform specification.

compare

public static int compare(@NonNull Optional<Revision> first,
                          @NonNull Optional<Revision> second)

Compare two Optionals wrapping Revisions. Arguments and return value are consistent with Comparator.compare(Object, Object) interface contract. Missing revisions compare as lower than any other revision.

Parameters:

first - First optional revision

second - Second optional revision

Returns:

Positive, zero, or negative integer.

compare

public static int compare(@Nullable Revision first,
                          @Nullable Revision second)

Compare two explicitly nullable Revisions. Unlike compareTo(Revision), this handles both arguments being null such that total ordering is defined.

Parameters:

first - First revision

second - Second revision

Returns:

Positive, zero, or negative integer.

compareTo

public int compareTo(Revision o)

Specified by:

compareTo in interface Comparable<Revision>

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object