/*
* Copyright (c) 2005, 2019, 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;
The kind
of an element. Note that it is possible additional element kinds will be added
to accommodate new, currently unknown, language structures added to
future versions of the Java™ programming language.
Author: Joseph D. Darcy, Scott Seligman, Peter von der Ahé See Also: Since: 1.6
/**
* The {@code kind} of an element.
*
* <p>Note that it is possible additional element kinds will be added
* to accommodate new, currently unknown, language structures added to
* future versions of the Java™ programming language.
*
* @author Joseph D. Darcy
* @author Scott Seligman
* @author Peter von der Ahé
* @see Element
* @since 1.6
*/
public enum ElementKind {
A package. /** A package. */
PACKAGE,
// Declared types
An enum type. /** An enum type. */
ENUM,
A class not described by a more specific kind (like
ENUM
or RECORD
). /**
* A class not described by a more specific kind (like {@code
* ENUM} or {@code RECORD}).
*/
CLASS,
An annotation type. /** An annotation type. */
ANNOTATION_TYPE,
An interface not described by a more specific kind (like ANNOTATION_TYPE
). /**
* An interface not described by a more specific kind (like
* {@code ANNOTATION_TYPE}).
*/
INTERFACE,
// Variables
An enum constant. /** An enum constant. */
ENUM_CONSTANT,
A field not described by a more specific kind (like ENUM_CONSTANT
). /**
* A field not described by a more specific kind (like
* {@code ENUM_CONSTANT}).
*/
FIELD,
A parameter of a method or constructor. /** A parameter of a method or constructor. */
PARAMETER,
A local variable. /** A local variable. */
LOCAL_VARIABLE,
A parameter of an exception handler. /** A parameter of an exception handler. */
EXCEPTION_PARAMETER,
// Executables
A method. /** A method. */
METHOD,
A constructor. /** A constructor. */
CONSTRUCTOR,
A static initializer. /** A static initializer. */
STATIC_INIT,
An instance initializer. /** An instance initializer. */
INSTANCE_INIT,
A type parameter. /** A type parameter. */
TYPE_PARAMETER,
An implementation-reserved element. This is not the element
you are looking for.
/**
* An implementation-reserved element. This is not the element
* you are looking for.
*/
OTHER,
// Constants added since initial release
A resource variable.
Since: 1.7
/**
* A resource variable.
* @since 1.7
*/
RESOURCE_VARIABLE,
A module.
Since: 9 @spec JPMS
/**
* A module.
* @since 9
* @spec JPMS
*/
MODULE,
{@preview Associated with records, a preview feature of the Java language.
This enum constant is associated with records, a preview
feature of the Java language. Preview features
may be removed in a future release, or upgraded to permanent
features of the Java language.}
A record type.
Since: 14
/**
* {@preview Associated with records, a preview feature of the Java language.
*
* This enum constant is associated with <i>records</i>, a preview
* feature of the Java language. Preview features
* may be removed in a future release, or upgraded to permanent
* features of the Java language.}
*
* A record type.
* @since 14
*/
@jdk.internal.PreviewFeature(feature=jdk.internal.PreviewFeature.Feature.RECORDS,
essentialAPI=false)
RECORD,
{@preview Associated with records, a preview feature of the Java language.
This enum constant is associated with records, a preview feature of the Java language. Preview features may be removed in a future release, or upgraded to permanent features of the Java language.} A record component of a record
. Since: 14
/**
* {@preview Associated with records, a preview feature of the Java language.
*
* This enum constant is associated with <i>records</i>, a preview
* feature of the Java language. Preview features
* may be removed in a future release, or upgraded to permanent
* features of the Java language.}
*
* A record component of a {@code record}.
* @since 14
*/
@jdk.internal.PreviewFeature(feature=jdk.internal.PreviewFeature.Feature.RECORDS,
essentialAPI=false)
RECORD_COMPONENT,
{@preview} Associated with pattern matching for
instanceof
, a preview feature of the Java language. This enum constant is associated with pattern matching for instanceof
, a preview
feature of the Java language. Preview features
may be removed in a future release, or upgraded to permanent
features of the Java language.}
A binding variable in a pattern .
Since: 14
/**
* {@preview Associated with pattern matching for {@code
* instanceof}, a preview feature of the Java language.
*
* This enum constant is associated with <i>pattern
* matching for {@code instanceof}</i>, a preview
* feature of the Java language. Preview features
* may be removed in a future release, or upgraded to permanent
* features of the Java language.}
*
* A binding variable in a pattern .
* @since 14
*/
@jdk.internal.PreviewFeature(feature=jdk.internal.PreviewFeature.Feature.PATTERN_MATCHING_IN_INSTANCEOF,
essentialAPI=false)
BINDING_VARIABLE;
Returns true
if this is a kind of class: either CLASS
or ENUM
or RECORD
. Returns: true
if this is a kind of class
/**
* Returns {@code true} if this is a kind of class:
* either {@code CLASS} or {@code ENUM} or {@code RECORD}.
*
* @return {@code true} if this is a kind of class
*/
@SuppressWarnings("preview")
public boolean isClass() {
return this == CLASS || this == ENUM || this == RECORD;
}
Returns true
if this is a kind of interface: either INTERFACE
or ANNOTATION_TYPE
. Returns: true
if this is a kind of interface
/**
* Returns {@code true} if this is a kind of interface:
* either {@code INTERFACE} or {@code ANNOTATION_TYPE}.
*
* @return {@code true} if this is a kind of interface
*/
public boolean isInterface() {
return this == INTERFACE || this == ANNOTATION_TYPE;
}
Returns true
if this is a kind of field: either FIELD
or ENUM_CONSTANT
. Returns: true
if this is a kind of field
/**
* Returns {@code true} if this is a kind of field:
* either {@code FIELD} or {@code ENUM_CONSTANT}.
*
* @return {@code true} if this is a kind of field
*/
public boolean isField() {
return this == FIELD || this == ENUM_CONSTANT;
}
}