/* * Copyright (c) 2005, 2020, 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. */ package javax.lang.model.element; import java.util.List; import javax.lang.model.type.TypeMirror; /** * Represents a module program element. Provides access to * information about the module, its directives, and its members. * * @see javax.lang.model.util.Elements#getModuleOf * @since 9 * @jls 7.7 Module Declarations * @spec JPMS */ public interface ModuleElement extends Element, QualifiedNameable { /** * Returns a {@linkplain javax.lang.model.type.NoType pseudo-type} * for this module. * @return a pseudo-type for this module * * @see javax.lang.model.type.NoType * @see javax.lang.model.type.TypeKind#MODULE */ @Override TypeMirror asType(); /** * Returns the fully qualified name of this module. For an * {@linkplain #isUnnamed() unnamed module}, an empty name is returned. * * @apiNote If the module name consists of one identifier, then * this method returns that identifier, which is deemed to be * module's fully qualified name despite not being in qualified * form. If the module name consists of more than one identifier, * then this method returns the entire name. * * @return the fully qualified name of this module, or an * empty name if this is an unnamed module * * @jls 6.2 Names and Identifiers */ @Override Name getQualifiedName(); /** * Returns the simple name of this module. For an {@linkplain * #isUnnamed() unnamed module}, an empty name is returned. * * @apiNote If the module name consists of one identifier, then * this method returns that identifier. If the module name * consists of more than one identifier, then this method returns * the rightmost such identifier, which is deemed to be the * module's simple name. * * @return the simple name of this module or an empty name if * this is an unnamed module * * @jls 6.2 Names and Identifiers */ @Override Name getSimpleName(); /** * Returns the packages within this module. * @return the packages within this module */ @Override List extends Element> getEnclosedElements(); /** * Returns {@code true} if this is an open module and {@code * false} otherwise. * * @return {@code true} if this is an open module and {@code * false} otherwise */ boolean isOpen(); /** * Returns {@code true} if this is an unnamed module and {@code * false} otherwise. * * @return {@code true} if this is an unnamed module and {@code * false} otherwise * * @jls 7.7.5 Unnamed Modules */ boolean isUnnamed(); /** * Returns {@code null} since a module is not enclosed by another * element. * * @return {@code null} */ @Override Element getEnclosingElement(); /** * Returns the directives contained in the declaration of this module. * @return the directives in the declaration of this module */ List extends Directive> getDirectives(); /** * The {@code kind} of a directive. * *
Note that it is possible additional directive kinds will be added * to accommodate new, currently unknown, language structures added to * future versions of the Java programming language. * * @since 9 * @spec JPMS */ enum DirectiveKind { /** A "requires (static|transitive)* module-name" directive. */ REQUIRES, /** An "exports package-name [to module-name-list]" directive. */ EXPORTS, /** An "opens package-name [to module-name-list]" directive. */ OPENS, /** A "uses service-name" directive. */ USES, /** A "provides service-name with implementation-name" directive. */ PROVIDES }; /** * Represents a directive within the declaration of this * module. The directives of a module declaration configure the * module in the Java Platform Module System. * * @since 9 * @spec JPMS */ interface Directive { /** * Returns the {@code kind} of this directive. *
the type of the additional parameter to the visitor's methods
* @param v the visitor operating on this directive
* @param p additional parameter to the visitor
* @return a visitor-specified result
*/
Classes implementing this interface may or may not throw a
* {@code NullPointerException} if the additional parameter {@code p}
* is {@code null}; see documentation of the implementing class for
* details.
*
* WARNING: It is possible that methods will be added to
* this interface to accommodate new, currently unknown, language
* structures added to future versions of the Java programming
* language. Methods to accommodate new language constructs will
* be added in a source compatible way using
* default methods.
*
* @param the type of the additional parameter to this visitor's
* methods. Use {@code Void} for visitors that do not need an
* additional parameter.
*
* @since 9
* @spec JPMS
*/
interface DirectiveVisitorvisitXyz
method applicable
* to that directive is invoked.
*
*