Package groovy.transform

# Annotation Interface SelfType

@Documented @Retention(RUNTIME) @Target(TYPE) public @interface SelfType
This annotation can be added on a trait to declare the list of types that a class implementing that trait is supposed to extend. This is useful when you want to be able to call methods from the class implementing the trait without having to declare all of them as members of the trait. Self types are particularly useful in combination with `CompileStatic`, if you know that a trait can only be applied to a specific type but that the trait cannot extend that type itself. For example, imagine the following code:

         class Component { void methodInComponent() }
         trait ComponentDecorator {
             void logAndCall() {
                 println "Calling method in component"
                 methodInComponent()
             }
             // other useful methods
         }
         class DecoratedComponent extends Component implements ComponentDecorator {}

This will work because the trait uses the dynamic backend, so there is no check at compile time that the methodInComponent call in logAndCall is actually defined. If you annotate the trait with `CompileStatic`, compilation will fail because the trait does not define the method. To declare that the trait can be applied on something that will extend Component, you need to add the SelfType annotation like this:

         class Component { void methodInComponent() }

         @CompileStatic
         @SelfType(Component)
         trait ComponentDecorator {
             void logAndCall() {
                 println "Calling method in component"
                 methodInComponent()
             }
             // other useful methods
         }
         class DecoratedComponent extends Component implements ComponentDecorator {}

This pattern can therefore be used to avoid explicit casts everywhere you need to call a method that you know is defined in the class that will implement the trait but normally don't have access to, which is often the case where a trait needs to be applied on a class provided by a third-party library.

Since:
  2.4.0

- ## Required Element Summary

  Required Elements
  Modifier and Type
  Required Element
  Description
  `Class[]`
  `value`
  Returns the types that an implementing class must extend or implement.

- ## Element Details

  - ### value

    Class[] value
    Returns the types that an implementing class must extend or implement.
    Returns:
      the required self types