org.opendaylight.controller.cluster.access

Enum ABIVersion

java.lang.Object

java.lang.Enum<ABIVersion>

org.opendaylight.controller.cluster.access.ABIVersion

All Implemented Interfaces:

Serializable, Comparable<ABIVersion>, org.opendaylight.yangtools.concepts.WritableObject

@Beta
public enum ABIVersion
extends Enum<ABIVersion>
implements org.opendaylight.yangtools.concepts.WritableObject

Enumeration of all ABI versions supported by this implementation of the client access API.

Author:

Robert Varga

Enum Constant Summary

Enum Constants

Enum Constant and Description
BORON Initial ABI version, as shipped with Boron Simultaneous release.
TEST_FUTURE_VERSION Version which is newer than any other version.
TEST_PAST_VERSION Version which is older than any other version.

Method Summary

Modifier and Type	Method and Description
static @NonNull ABIVersion	current() Return the codebase-native ABI version.
static @NonNull ABIVersion	inexactReadFrom(@NonNull DataInput in)
static @NonNull ABIVersion	readFrom(@NonNull DataInput in) Read an ABIVersion from a DataInput.
short	shortValue() Return the unsigned short integer identifying this version.
static @NonNull ABIVersion	valueOf(short value) Return the ABIVersion corresponding to an unsigned short integer.
static ABIVersion	valueOf(String name) Returns the enum constant of this type with the specified name.
static ABIVersion[]	values() Returns an array containing the constants of this enum type, in the order they are declared.
void	writeTo(DataOutput out)

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

TEST_PAST_VERSION

public static final ABIVersion TEST_PAST_VERSION

Version which is older than any other version. This version exists purely for testing purposes.

BORON

public static final ABIVersion BORON

Initial ABI version, as shipped with Boron Simultaneous release.

TEST_FUTURE_VERSION

public static final ABIVersion TEST_FUTURE_VERSION

Version which is newer than any other version. This version exists purely for testing purposes.

Method Detail

values

public static ABIVersion[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ABIVersion c : ABIVersion.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ABIVersion valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

shortValue

public short shortValue()

Return the unsigned short integer identifying this version.

Returns:

Unsigned short integer identifying this version

current

public static @NonNull ABIVersion current()

Return the codebase-native ABI version. This version is the default version allocated to messages at runtime. Conversion to previous versions may incur additional overhead (such as object allocation).

Returns:

Current ABIVersion

valueOf

public static @NonNull ABIVersion valueOf(short value)
                                   throws FutureVersionException,
                                          PastVersionException

Return the ABIVersion corresponding to an unsigned short integer. This method is provided for callers which provide their own recovery strategy in case of version incompatibility.

Parameters:

value - Short integer as returned from shortValue()

Returns:

ABIVersion

Throws:

FutureVersionException - if the specified integer identifies a future version

PastVersionException - if the specified integer identifies a past version which is no longer supported

writeTo

public void writeTo(DataOutput out)
             throws IOException

Specified by:

writeTo in interface org.opendaylight.yangtools.concepts.WritableObject

Throws:

IOException

readFrom

public static @NonNull ABIVersion readFrom(@NonNull DataInput in)
                                    throws IOException

Read an ABIVersion from a DataInput. This method is provided for callers which do not have a recovery strategy for dealing with unsupported versions.

Parameters:

in - Input from which to read

Returns:

An ABIVersion

Throws:

IOException - If read fails or an unsupported version is encountered

inexactReadFrom

public static @NonNull ABIVersion inexactReadFrom(@NonNull DataInput in)
                                           throws IOException

Throws:

IOException