Why does @FunctionalInterface have a RUNTIME retention?

Question

Said in Javadoc:

If a type is annotated with this annotation type, compilers are required to generate an error message unless ...

Why isn't SOURCE or CLASS enough, like for @Override.

Answer 1

The @FunctionalInterface annotation serves two purposes. Regarding the compiler and the error it has to generate it would be indeed enough to have a SOURCE RetentionPolicy as in this regard it only affects the very class annotated with @FunctionalInterface.

However, it has a second purpose, documenting the fact that using this interface as a functional interface is indeed intended and the possibility to use it this way not just a coincidence like with, e.g. Comparable which is not intended to be used that way.

Therefore it is annotated with @Documented and has the maximum RetentionPolicy to fulfill the second purpose.

Answer 2

"Source" would not be enough, since if for example you create an API and provide your class as a pre-compiled jar, the information would not be available for the compiler anymore.

I believe "class" would also not be enough if you want to support those kind of compilers that "compile" against a class at runtime, like scripting engines that use reflection to find out about those annotations and should show a warning, too.