Class LJSProcessor

  • public class LJSProcessor
extends java.lang.Object
    Annotation Processors are special compile-time classes that are automatically executed by the Java compiler (javac) whenever source code containing a recognized annotation is compiled. In many libraries, processors may generate source files, emit resources, or build documentation as part of the compilation pipeline. The JDU system uses a much lighter approach: its javac processors exist primarily to perform partial user input validation on JDU annotations, and they validate only what can be checked reliably at compile time.

    The actual documentation work is not performed inside the standard Java annotation processors. Instead, documentation is produced when the Java-Doc Upgrader (JDU) tool itself is invoked. JDU parses source files directly and uses a separate, dedicated mechanism to locate annotations and extract their contents from both Types (classes, interfaces, enums, and annotations) and Entities (constructors, methods, fields, annotation-elements, and enum-constants). This separation keeps the compile-time portion fast and conservative, while allowing the full documentation pipeline to run under JDU where richer analysis and formatting logic belongs.

    Finally, although this package contains several annotation-specific validation classes, the JDU exposes only one public javac entry-point processor. That top-level processor acts as a dispatcher and invokes the full set of internal, annotation-specific validators (currently six), ensuring that any JDU-annotated code is checked consistently during compilation without embedding any of the documentation-building logic into the compiler itself.


    • Method Summary

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait