callsuper-annotation

Java annotation that forces you to call super method if it was annotated with CallSuper. Inspired by upcoming CallSuper annotation in Android shown at Google IO 2015. This library is currently provided as experimental version, please report any issues.

Current version: 0.1.3
Current snapshot version: 0.1.4-SNAPSHOT

Maven:

<dependency>
     <groupId>com.kotcrab.annotation</groupId>
     <artifactId>callsuper</artifactId>
     <version>0.1.1-SNAPSHOT</version>
</dependency>

Don't forget to enable annotation processing in your IDE and build tools!

Maven:

<plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.3</version>
        <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <annotationProcessors>
                     <annotationProcessor>com.kotcrab.annotation.callsuper.CallSuperProcessor</annotationProcessor>
                </annotationProcessors>
        </configuration>
</plugin>

Usage:

public class SuperClass {
    @CallSuper
    public void callMe () {
    }
}

class TestClass extends SuperClass {
    @Override //overriding method must be annotated with @Override
    public void callMe () {
        super.callMe(); //not calling super will cause error
    }
}

It is possible to override CallSuper check.

public class SuperClass {
    @CallSuper
    public void callMe () {
    }
}

class TestClass extends SuperClass {
    @Override @OverrideCallSuper
    public void callMe () {
        //super.callMe(); //allowed, this method has @OverrideCallSuper annotation
    }
}

Issues and limitations

• @Override annotation is required to trigger annotation processor - #1
• Anonymous classes are not processed by annotation processor thus can't be checked if super was called - #8