net.openhft.chronicle.core.annotation

Annotation Type TargetMajorVersion

@Retention(value=RUNTIME)
 @Target(value=TYPE)
public @interface TargetMajorVersion

@TargetMajorVersion specifies which Java major version a type targets. It is useful for library maintainers managing backwards compatibility.

Retention and effect: Retained at runtime but has no behaviour unless tooling inspects it.

  @TargetMajorVersion(11)
 class ModernOnly { }
 

Major version 0 means any version. Common values are 8, 11, 17 and 21.

 Class<?> impl = ImplementationPicker.pick(TargetInterface.class);
 

When multiple classes match, includeOlder and includeNewer determine precedence.

See Also:

Java9, ChronicleFeature

Field Summary

Fields

Modifier and Type	Fields and Description
static int	ANY_VERSION Constant to represent compatibility with any version.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	includeNewer If set to true, indicates that the annotated type should be compatible with versions newer than the specified major version.
boolean	includeOlder If set to true, indicates that the annotated type should be compatible with versions older than the specified major version.
int	majorVersion Specifies the major version number that the annotated type targets.

Field Detail

ANY_VERSION

public static final int ANY_VERSION

Constant to represent compatibility with any version.

Element Detail

majorVersion

public abstract int majorVersion

Specifies the major version number that the annotated type targets.

Returns:

the target major version number

Default:

0

includeOlder

public abstract boolean includeOlder

If set to true, indicates that the annotated type should be compatible with versions older than the specified major version.

Returns:

true if compatibility with older versions is intended

Default:

false

includeNewer

public abstract boolean includeNewer

If set to true, indicates that the annotated type should be compatible with versions newer than the specified major version.

Returns:

true if compatibility with newer versions is intended

Default:

false