java.lang.Object
- org.jboss.jandex.EquivalenceKey

Direct Known Subclasses:

EquivalenceKey.DeclarationEquivalenceKey, EquivalenceKey.TypeEquivalenceKey
```
public abstract class EquivalenceKey
extends java.lang.Object
```
Establishes a notion of equivalence of Jandex objects. Two Jandex objects are equivalent if and only if they denote the same Java declaration or type, without taking into account any annotations. The prime use case is to assist with building annotation overlays on top of Jandex, where it is common to have multiple Jandex objects with different annotations, but otherwise equivalent.
In contrast, the common Jandex classes such as ClassInfo, MethodInfo or FieldInfo either don't provide equality at all (and hence can only be compared by identity) or provide strict equality, which includes presence or absence of annotations and comparison of their members, as well as other details.
An instance of this class, also called an equivalence key, provides 3 fundamental operations, corresponding to the 3 common methods all Java classes have:
- equals(): when two Jandex objects are equivalent, their equivalence keys are equal
- hashCode(): consistent with equals() described above
- toString(): human-readable representation of the equivalence key; format of the value is not guaranteed and may change without notice
In addition, equivalence keys are structured in an inheritance hierarchy that corresponds to the inheritance hierarchy of Jandex objects. Therefore, the kind of the "source" Jandex object may be found by inspecting the class of the equivalence key:
- EquivalenceKey
  - DeclarationEquivalenceKey
    - ClassEquivalenceKey
    - FieldEquivalenceKey
    - MethodEquivalenceKey
    - MethodParameterEquivalenceKey
    - RecordComponentEquivalenceKey
  - TypeEquivalenceKey
    - ArrayTypeEquivalenceKey
    - ClassTypeEquivalenceKey
    - ParameterizedTypeEquivalenceKey
    - PrimitiveTypeEquivalenceKey
    - TypeVariableEquivalenceKey
    - TypeVariableReferenceEquivalenceKey
    - UnresolvedTypeVariableEquivalenceKey
    - VoidTypeEquivalenceKey
    - WildcardTypeEquivalenceKey

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`static class`	`EquivalenceKey.ArrayTypeEquivalenceKey`
`static class`	`EquivalenceKey.ClassEquivalenceKey`
`static class`	`EquivalenceKey.ClassTypeEquivalenceKey`
`static class`	`EquivalenceKey.DeclarationEquivalenceKey`
`static class`	`EquivalenceKey.FieldEquivalenceKey`
`static class`	`EquivalenceKey.MethodEquivalenceKey`
`static class`	`EquivalenceKey.MethodParameterEquivalenceKey`
`static class`	`EquivalenceKey.ParameterizedTypeEquivalenceKey`
`static class`	`EquivalenceKey.PrimitiveTypeEquivalenceKey`
`static class`	`EquivalenceKey.RecordComponentEquivalenceKey`
`static class`	`EquivalenceKey.TypeEquivalenceKey`
`static class`	`EquivalenceKey.TypeVariableEquivalenceKey`
`static class`	`EquivalenceKey.TypeVariableReferenceEquivalenceKey`
`static class`	`EquivalenceKey.UnresolvedTypeVariableEquivalenceKey`
`static class`	`EquivalenceKey.VoidTypeEquivalenceKey`
`static class`	`EquivalenceKey.WildcardTypeEquivalenceKey`

Constructor Summary

Constructors
Modifier Constructor Description

private EquivalenceKey()

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`static EquivalenceKey`	`of(AnnotationTarget annotationTarget)`	Returns an equivalence key for given annotation target.
`static EquivalenceKey.ClassEquivalenceKey`	`of(ClassInfo clazz)`	Returns an equivalence key for given class.
`static EquivalenceKey.DeclarationEquivalenceKey`	`of(Declaration declaration)`	Returns an equivalence key for given declaration.
`static EquivalenceKey.FieldEquivalenceKey`	`of(FieldInfo field)`	Returns an equivalence key for given field.
`static EquivalenceKey.MethodEquivalenceKey`	`of(MethodInfo method)`	Returns an equivalence key for given method.
`static EquivalenceKey.MethodParameterEquivalenceKey`	`of(MethodParameterInfo parameter)`	Returns an equivalence key for given method parameter.
`static EquivalenceKey.RecordComponentEquivalenceKey`	`of(RecordComponentInfo recordComponent)`	Returns an equivalence key for given record component.
`static EquivalenceKey.TypeEquivalenceKey`	`of(Type type)`	Returns an equivalence key for given type.
`private static EquivalenceKey.TypeEquivalenceKey[]`	`of(Type[] types)`
`static EquivalenceKey.TypeEquivalenceKey`	`of(TypeTarget typeTarget)`	Returns an equivalence key for given type annotation target.
`private static boolean`	`startsWithJava(DotName name)`
`private static java.lang.String`	`toStringWhereClause(java.util.Set<EquivalenceKey.TypeVariableEquivalenceKey> typeVariables)`
`(package private) java.lang.String`	`toStringWithWhere(java.util.Set<EquivalenceKey.TypeVariableEquivalenceKey> typeVariables)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - EquivalenceKey
```
private EquivalenceKey()
```
- Method Detail
  - of
```
public static EquivalenceKey of(AnnotationTarget annotationTarget)
```
    Returns an equivalence key for given annotation target.
    
    Parameters:
    
    annotationTarget - the annotation target, may be null
    
    Returns:
    
    equivalence key for given annotation target, only null if annotationTarget == null
  - of
```
public static EquivalenceKey.DeclarationEquivalenceKey of(Declaration declaration)
```
    Returns an equivalence key for given declaration.
    
    Parameters:
    
    declaration - the declaration, may be null
    
    Returns:
    
    equivalence key for given declaration, only null if declaration == null
    
    Since:
    
    3.1.0
  - of
```
public static EquivalenceKey.ClassEquivalenceKey of(ClassInfo clazz)
```
    Returns an equivalence key for given class.
    
    Parameters:
    
    clazz - the class, may be null
    
    Returns:
    
    equivalence key for given class, only null if clazz == null
  - of
```
public static EquivalenceKey.MethodEquivalenceKey of(MethodInfo method)
```
    Returns an equivalence key for given method.
    
    Parameters:
    
    method - the method, may be null
    
    Returns:
    
    equivalence key for given method, only null if method == null
  - of
```
public static EquivalenceKey.MethodParameterEquivalenceKey of(MethodParameterInfo parameter)
```
    Returns an equivalence key for given method parameter.
    
    Parameters:
    
    parameter - the method parameter, may be null
    
    Returns:
    
    equivalence key for given method parameter, only null if parameter == null
  - of
```
public static EquivalenceKey.FieldEquivalenceKey of(FieldInfo field)
```
    Returns an equivalence key for given field.
    
    Parameters:
    
    field - the field, may be null
    
    Returns:
    
    equivalence key for given field, only null if field == null
  - of
```
public static EquivalenceKey.RecordComponentEquivalenceKey of(RecordComponentInfo recordComponent)
```
    Returns an equivalence key for given record component.
    
    Parameters:
    
    recordComponent - the record component, may be null
    
    Returns:
    
    equivalence key for given record component, only null if recordComponent == null
  - of
```
public static EquivalenceKey.TypeEquivalenceKey of(TypeTarget typeTarget)
```
    Returns an equivalence key for given type annotation target. It is the equivalence key of the annotated type.
    
    Parameters:
    
    typeTarget - the type target, may be null
    
    Returns:
    
    equivalence key for given type target, only null if typeTarget == null
  - of
```
public static EquivalenceKey.TypeEquivalenceKey of(Type type)
```
    Returns an equivalence key for given type.
    
    Parameters:
    
    type - the type, may be null
    
    Returns:
    
    equivalence key for given type, only null if type == null
  - of
```
private static EquivalenceKey.TypeEquivalenceKey[] of(Type[] types)
```
  - toStringWithWhere
```
java.lang.String toStringWithWhere(java.util.Set<EquivalenceKey.TypeVariableEquivalenceKey> typeVariables)
```
  - toStringWhereClause
```
private static java.lang.String toStringWhereClause(java.util.Set<EquivalenceKey.TypeVariableEquivalenceKey> typeVariables)
```
  - startsWithJava
```
private static boolean startsWithJava(DotName name)
```

Class EquivalenceKey

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

EquivalenceKey

Method Detail

of

of

of

of

of

of

of

of

of

of

toStringWithWhere

toStringWhereClause

startsWithJava