org.eclipse.golo.runtime.augmentation

Class AugmentationMethod

java.lang.Object

org.eclipse.golo.runtime.augmentation.AugmentationMethod

All Implemented Interfaces:

java.lang.Comparable<AugmentationMethod>

public final class AugmentationMethod
extends java.lang.Object
implements java.lang.Comparable<AugmentationMethod>

Encapsulate runtime information about augmentation method resolution.

Method Summary

Modifier and Type	Method and Description
int	compareTo(AugmentationMethod other) Compare applications for priority.
boolean	equals(java.lang.Object o)
int	hashCode()
java.lang.reflect.Method	method()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

method

public java.lang.reflect.Method method()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

compareTo

public int compareTo(AugmentationMethod other)

Compare applications for priority.

The greater application is the one with the lower priority so that in a stable-sorted list of application, we always take the first one.

The natural order defined is: target specificity < scope < kind so that the implied priority is to use the augmentation defined:

1. on the more specific class: to allow to override augmentations by target specificity, similar to method overriding;
2. in the more local scope: to allow to override augmentations by defining them locally;
3. by direct definition instead of named application: to allow to augment a class with a named augmentation (mixin-like) but override some of the methods by directly defining them;
4. before any other augmentation: to control augmentation application using the import or definition order.

Moreover, augmentation method with fixed arity are used in preference to variable-arity ones.

Specified by:

compareTo in interface java.lang.Comparable<AugmentationMethod>

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object