AnnotationOnSameLine

Since Checkstyle 8.2

Description

Checks that annotations are located on the same line with their targets. Verifying with this check is not good practice, but it is using by some style guides.

Properties

name description type default value since
tokens tokens to check subset of tokens CLASS_DEF , INTERFACE_DEF , ENUM_DEF , METHOD_DEF , CTOR_DEF , VARIABLE_DEF , PARAMETER_DEF , ANNOTATION_DEF , TYPECAST , LITERAL_THROWS , IMPLEMENTS_CLAUSE , TYPE_ARGUMENT , LITERAL_NEW , DOT , ANNOTATION_FIELD_DEF , RECORD_DEF , COMPACT_CTOR_DEF . CLASS_DEF , INTERFACE_DEF , ENUM_DEF , METHOD_DEF , CTOR_DEF , VARIABLE_DEF , RECORD_DEF , COMPACT_CTOR_DEF . 8.2

Examples

To configure the check: 

<module name="Checker">
  <module name="TreeWalker">
    <module name="AnnotationOnSameLine"/>
  </module>
</module>

Example:

class Example1 {

  @SuppressWarnings("deprecation") // violation
  public Example1() {
  }

  @SuppressWarnings("unchecked") public void fun2() {  // OK
  }

  public void fun1() {
  }

}

@SuppressWarnings("unchecked") class Test1 extends Example1 {  // OK

  @Deprecated public Test1() {  // OK
  }

  @Override // violation
  public void fun1() {
  }

  @Before // violation
  @Override public void fun2() {  // OK
  }

  @SuppressWarnings("deprecation") // violation
  @Before public void fun3() {
  }

}

To configure the check to check for annotations applied on interfaces, variables and constructors: 

<module name="Checker">
  <module name="TreeWalker">
    <module name="AnnotationOnSameLine">
      <property name="tokens"
                value="INTERFACE_DEF, VARIABLE_DEF, CTOR_DEF"/>
    </module>
  </module>
</module>

Example:

@Deprecated interface Foo {  // OK

  void doSomething();

}

class Example2 implements Foo {

  @SuppressWarnings("deprecation") // violation
  public Example2() {
  }

  @Override  // OK
  public void doSomething() {
  }

  @Nullable // violation
  String s;

}

Example of Usage

Violation Messages

All messages can be customized if the default message doesn't suit you. Please see the documentation to learn how to.

Package

com.puppycrawl.tools.checkstyle.checks.annotation

Parent Module

TreeWalker