Package groovy.util.logging

Annotation Type Log4j2

@Documented
@Retention(SOURCE)
@Target(TYPE)
public @interface Log4j2
This local transform adds a logging ability to your program using Log4j2 logging. Every method call on a unbound variable named log will be mapped to a call to the logger. For this a log field will be inserted in the class. If the field already exists the usage of this transform will cause a compilation error. The method name will be used to determine what to call on the logger. 
 log.name(exp)
is mapped to 
 if (log.isNameEnabled() {
    log.name(exp)
 }
Here name is a place holder for info, debug, warning, error, etc. If the expression exp is a constant or only a variable access the method call will not be transformed. But this will still cause a call on the injected logger.
Since:
2.2.0

  • Element Details

    • value

      String value
      Default:
      "log"

    • category

      String category
      Default:
      "##default-category-name##"

    • visibilityId

      String visibilityId
      If specified, must match the "id" attribute in a VisibilityOptions annotation to enable a custom visibility.
      Since:
      3.0.0
      Default:
      "<DummyUndefinedMarkerString-DoNotUse>"

    • loggingStrategy

      Class<? extends LogASTTransformation.LoggingStrategy> loggingStrategy
      Default:
      groovy.util.logging.Log4j2.Log4j2LoggingStrategy.class