src.jdk.compiler.share.classes.module-info Maven / Gradle / Ivy
Show all versions of nb-javac Show documentation
/*
* Copyright (c) 2014, 2022, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Defines the implementation of the
* {@linkplain javax.tools.ToolProvider#getSystemJavaCompiler system Java compiler}
* and its command line equivalent, {@index javac javac tool}.
*
* The {@code com.sun.source.*} packages provide the {@index "Compiler Tree API"}:
* an API for accessing the abstract trees (ASTs) representing Java source code
* and documentation comments, used by javac, javadoc and related tools.
*
*
javac
*
*
* This module provides the equivalent of command-line access to javac
* via the {@link java.util.spi.ToolProvider ToolProvider} and
* {@link javax.tools.Tool} service provider interfaces (SPIs),
* and more flexible access via the {@link javax.tools.JavaCompiler JavaCompiler}
* SPI.
*
* Instances of the tools can be obtained by calling
* {@link java.util.spi.ToolProvider#findFirst ToolProvider.findFirst}
* or the {@linkplain java.util.ServiceLoader service loader} with the name
* {@code "javac"}.
*
*
* In addition, instances of {@link javax.tools.JavaCompiler.CompilationTask}
* obtained from {@linkplain javax.tools.JavaCompiler JavaCompiler} can be
* downcast to {@link com.sun.source.util.JavacTask JavacTask} for access to
* lower level aspects of javac, such as the
* {@link com.sun.source.tree Abstract Syntax Tree} (AST).
*
* This module uses the {@link java.nio.file.spi.FileSystemProvider
* FileSystemProvider} API to locate file system providers. In particular,
* this means that a jar file system provider, such as that in the
* {@code jdk.zipfs} module, must be available if the compiler is to be able
* to read JAR files.
*
*
SuppressWarnings
*
* JLS {@jls 9.6.4.5} specifies a number of strings that can be used to
* suppress warnings that may be generated by a Java compiler.
*
* In addition, javac also supports other strings that can be used
* to suppress other kinds of warnings. The following table lists all the
* strings that can be used with {@code @SuppressWarnings}.
*
*
* Strings supported by {@code SuppressWarnings}
*
* String Suppress Warnings About ...
*
*
* {@code auxiliaryclass} an auxiliary class that is hidden in a source file, and is used
* from other files
* {@code cast} use of unnecessary casts
* {@code classfile} issues related to classfile contents
* {@code deprecation} use of deprecated items
* {@code dep-ann} items marked as deprecated in a documentation comment but not
* using the {@code @Deprecated} annotation
* {@code divzero} division by constant integer {@code 0}
* {@code empty} empty statement after {@code if}
* {@code exports} issues regarding module exports
* {@code fallthrough} falling through from one case of a {@code switch} statement to
* the next
* {@code finally} {@code finally} clauses that do not terminate normally
* {@code missing-explicit-ctor} missing explicit constructors in public and protected classes
* in exported packages
* {@code module} module system related issues
* {@code opens} issues regarding module opens
* {@code overloads} issues regarding method overloads
* {@code overrides} issues regarding method overrides
* {@code path} invalid path elements on the command line
* {@code preview} use of preview language features
* {@code rawtypes} use of raw types
* {@code removal} use of API that has been marked for removal
* {@code requires-automatic} use of automatic modules in the {@code requires} clauses
* {@code requires-transitive-automatic} automatic modules in {@code requires transitive}
* {@code serial} {@link java.base/java.io.Serializable Serializable} classes
* that do not have a {@code serialVersionUID} field, or other
* suspect declarations in {@code Serializable} and
* {@link java.base/java.io.Externalizable Externalizable} classes
* and interfaces
* {@code static} accessing a static member using an instance
* {@code strictfp} unnecessary use of the {@code strictfp} modifier
* {@code synchronization} synchronization attempts on instances of value-based classes
* {@code text-blocks} inconsistent white space characters in text block indentation
* {@code try} issues relating to use of {@code try} blocks
* (that is, try-with-resources)
* {@code unchecked} unchecked operations
* {@code varargs} potentially unsafe vararg methods
* {@code doclint:accessibility} accessibility issues found in documentation comments
* {@code doclint:all} all issues found in documentation comments
* {@code doclint:html} HTML issues found in documentation comments
* {@code doclint:missing} missing items in documentation comments
* {@code doclint:reference} reference issues found in documentation comments
* {@code doclint:syntax} syntax issues found in documentation comments
*
*
*
* @toolGuide javac
*
* @provides java.util.spi.ToolProvider
* Use {@link java.util.spi.ToolProvider#findFirst ToolProvider.findFirst("javac")}
* to obtain an instance of a {@code ToolProvider} that provides the equivalent
* of command-line access to the {@code javac} tool.
* @provides com.sun.tools.javac.platform.PlatformProvider
* @provides javax.tools.JavaCompiler
* @provides javax.tools.Tool
*
* @uses javax.annotation.processing.Processor
* @uses com.sun.source.util.Plugin
* @uses com.sun.tools.javac.platform.PlatformProvider
*
* @moduleGraph
* @since 9
*/
module jdk.compiler {
requires transitive java.compiler;
requires jdk.zipfs;
exports com.sun.source.doctree;
exports com.sun.source.tree;
exports com.sun.source.util;
exports com.sun.tools.javac;
exports com.sun.tools.doclint to
jdk.javadoc;
exports com.sun.tools.javac.api to
jdk.javadoc,
jdk.jshell;
exports com.sun.tools.javac.resources to
jdk.jshell;
exports com.sun.tools.javac.code to
jdk.javadoc,
jdk.jshell;
exports com.sun.tools.javac.comp to
jdk.javadoc,
jdk.jshell;
exports com.sun.tools.javac.file to
jdk.jdeps,
jdk.javadoc;
exports com.sun.tools.javac.jvm to
jdk.javadoc;
exports com.sun.tools.javac.main to
jdk.javadoc,
jdk.jshell;
exports com.sun.tools.javac.model to
jdk.javadoc;
exports com.sun.tools.javac.parser to
jdk.jshell;
exports com.sun.tools.javac.platform to
jdk.jdeps,
jdk.javadoc;
exports com.sun.tools.javac.tree to
jdk.javadoc,
jdk.jshell;
exports com.sun.tools.javac.util to
jdk.jdeps,
jdk.javadoc,
jdk.jshell;
exports jdk.internal.shellsupport.doc to
jdk.jshell;
uses javax.annotation.processing.Processor;
uses com.sun.source.util.Plugin;
uses com.sun.tools.doclint.DocLint;
uses com.sun.tools.javac.platform.PlatformProvider;
provides java.util.spi.ToolProvider with
com.sun.tools.javac.main.JavacToolProvider;
provides com.sun.tools.javac.platform.PlatformProvider with
com.sun.tools.javac.platform.JDKPlatformProvider;
provides javax.tools.JavaCompiler with
com.sun.tools.javac.api.JavacTool;
provides javax.tools.Tool with
com.sun.tools.javac.api.JavacTool;
}