/*******************************************************************************
* Copyright (c) 2000, 2020 IBM Corporation and others.
*
* This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.jdt.core.dom;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
/**
* Modifier node.
* <pre>
* Modifier:
* <b>public</b>
* <b>protected</b>
* <b>private</b>
* <b>static</b>
* <b>abstract</b>
* <b>final</b>
* <b>native</b>
* <b>synchronized</b>
* <b>transient</b>
* <b>volatile</b>
* <b>strictfp</b>
* <b>default</b>
* <b>sealed</b>
* <b>non-sealed</b>
* </pre>
* <p>
* The numeric values of these flags match the ones for class
* files as described in the Java Virtual Machine Specification
* (except for {@link #DEFAULT}). Note that the Java model class
* {@link org.eclipse.jdt.core.Flags} also provides the same
* constants as this class.
* </p>
*
* @since 2.0
* @noinstantiate This class is not intended to be instantiated by clients.
*/
@SuppressWarnings({"rawtypes", "unchecked"})
public final class Modifier extends ASTNode implements IExtendedModifier {
/**
* Modifier keywords (typesafe enumeration).
* @since 3.0
*/
public static class ModifierKeyword {
/** "abstract" modifier with flag value {@link Modifier#ABSTRACT}. */
public static final ModifierKeyword ABSTRACT_KEYWORD = new ModifierKeyword("abstract", ABSTRACT);//$NON-NLS-1$
/** "final" modifier with flag value {@link Modifier#FINAL}. */
public static final ModifierKeyword FINAL_KEYWORD = new ModifierKeyword("final", FINAL);//$NON-NLS-1$
/**
* Map from token to operator (key type: <code>String</code>;
* value type: <code>Operator</code>).
*/
private static final Map KEYWORDS;
/** "native" modifier with flag value {@link Modifier#NATIVE}. */
public static final ModifierKeyword NATIVE_KEYWORD = new ModifierKeyword("native", NATIVE);//$NON-NLS-1$
/** "private" modifier with flag value {@link Modifier#PRIVATE}. */
public static final ModifierKeyword PRIVATE_KEYWORD = new ModifierKeyword("private", PRIVATE);//$NON-NLS-1$
/** "protected" modifier with flag value {@link Modifier#PROTECTED}. */
public static final ModifierKeyword PROTECTED_KEYWORD = new ModifierKeyword("protected", PROTECTED);//$NON-NLS-1$
/** "public" modifier with flag value {@link Modifier#PUBLIC}. */
public static final ModifierKeyword PUBLIC_KEYWORD = new ModifierKeyword("public", PUBLIC);//$NON-NLS-1$
/** "static" modifier with flag value {@link Modifier#STATIC}. */
public static final ModifierKeyword STATIC_KEYWORD = new ModifierKeyword("static", STATIC);//$NON-NLS-1$
/** "strictfp" modifier with flag value {@link Modifier#STRICTFP}. */
public static final ModifierKeyword STRICTFP_KEYWORD = new ModifierKeyword("strictfp", STRICTFP);//$NON-NLS-1$
/** "synchronized" modifier with flag value {@link Modifier#SYNCHRONIZED}. */
public static final ModifierKeyword SYNCHRONIZED_KEYWORD = new ModifierKeyword("synchronized", SYNCHRONIZED);//$NON-NLS-1$
/** "transient" modifier with flag value {@link Modifier#TRANSIENT}. */
public static final ModifierKeyword TRANSIENT_KEYWORD = new ModifierKeyword("transient", TRANSIENT);//$NON-NLS-1$
/** "volatile" modifier with flag value {@link Modifier#VOLATILE}. */
public static final ModifierKeyword VOLATILE_KEYWORD = new ModifierKeyword("volatile", VOLATILE);//$NON-NLS-1$
/**
* "default" modifier with flag value {@link Modifier#DEFAULT} (added in JLS8 API).
* <p>
* Note that the value of this modifier is
* internal and is not specified in the Java Virtual Machine Specification.
* </p>
* @since 3.10
*/
public static final ModifierKeyword DEFAULT_KEYWORD = new ModifierKeyword("default", DEFAULT);//$NON-NLS-1$
/**
* @since 3.24
*/
public static final ModifierKeyword SEALED_KEYWORD = new ModifierKeyword("sealed", SEALED);//$NON-NLS-1$
/**
* @since 3.24
*/
public static final ModifierKeyword NON_SEALED_KEYWORD = new ModifierKeyword("non-sealed", NON_SEALED);//$NON-NLS-1$
static {
KEYWORDS = new HashMap(20);
ModifierKeyword[] ops = {
PUBLIC_KEYWORD,
PROTECTED_KEYWORD,
PRIVATE_KEYWORD,
STATIC_KEYWORD,
ABSTRACT_KEYWORD,
FINAL_KEYWORD,
NATIVE_KEYWORD,
SYNCHRONIZED_KEYWORD,
TRANSIENT_KEYWORD,
VOLATILE_KEYWORD,
STRICTFP_KEYWORD,
DEFAULT_KEYWORD,
SEALED_KEYWORD,
NON_SEALED_KEYWORD
};
for (int i = 0; i < ops.length; i++) {
KEYWORDS.put(ops[i].toString(), ops[i]);
}
}
/**
* Returns the modifier corresponding to the given single-bit flag value,
* or <code>null</code> if none or if more than one bit is set.
* <p>
* <code>fromFlagValue</code> is the converse of <code>toFlagValue</code>:
* that is, <code>ModifierKind.fromFlagValue(k.toFlagValue()) == k</code> for
* all modifier keywords <code>k</code>.
* </p>
*
* @param flagValue the single-bit flag value for the modifier
* @return the modifier keyword, or <code>null</code> if none
* @see #toFlagValue()
*/
public static ModifierKeyword fromFlagValue(int flagValue) {
for (Iterator it = KEYWORDS.values().iterator(); it.hasNext(); ) {
ModifierKeyword k = (ModifierKeyword) it.next();
if (k.toFlagValue() == flagValue) {
return k;
}
}
return null;
}
/**
* Returns the modifier corresponding to the given string,
* or <code>null</code> if none.
* <p>
* <code>toKeyword</code> is the converse of <code>toString</code>:
* that is, <code>ModifierKind.toKeyword(k.toString()) == k</code> for
* all modifier keywords <code>k</code>.
* </p>
*
* @param keyword the lowercase string name for the modifier
* @return the modifier keyword, or <code>null</code> if none
* @see #toString()
*/
public static ModifierKeyword toKeyword(String keyword) {
return (ModifierKeyword) KEYWORDS.get(keyword);
}
/**
* The flag value for the modifier.
*/
private int flagValue;
/**
* The keyword modifier string.
*/
private String keyword;
/**
* Creates a new modifier with the given keyword.
* <p>
* Note: this constructor is private. The only instances
* ever created are the ones for the standard modifiers.
* </p>
*
* @param keyword the character sequence for the modifier
* @param flagValue flag value as described in the Java Virtual Machine Specification
*/
private ModifierKeyword(String keyword, int flagValue) {
this.keyword = keyword;
this.flagValue = flagValue;
}
/**
* Returns the modifier flag value corresponding to this modifier keyword.
* These flag values are as described in the Java Virtual Machine Specification.
*
* @return one of the <code>Modifier</code> constants
* @see #fromFlagValue(int)
*/
public int toFlagValue() {
return this.flagValue;
}
/**
* Returns the keyword for the modifier.
*
* @return the keyword for the modifier
* @see #toKeyword(String)
*/
@Override
public String toString() {
return this.keyword;
}
}
/**
* "abstract" modifier constant (bit mask).
* Applicable to types and methods.
* @since 2.0
*/
public static final int ABSTRACT = 0x0400;
/**
* "final" modifier constant (bit mask).
* Applicable to types, methods, fields, and variables.
* @since 2.0
*/
public static final int FINAL = 0x0010;
/**
* The "keyword" structural property of this node type (type: {@link Modifier.ModifierKeyword}).
* @since 3.0
*/
public static final SimplePropertyDescriptor KEYWORD_PROPERTY =
new SimplePropertyDescriptor(Modifier.class, "keyword", Modifier.ModifierKeyword.class, MANDATORY); //$NON-NLS-1$
/**
* "native" modifier constant (bit mask).
* Applicable only to methods.
* @since 2.0
*/
public static final int NATIVE = 0x0100;
/**
* Modifier constant (bit mask, value 0) indicating no modifiers.
* @since 2.0
*/
public static final int NONE = 0x0000;
/**
* "private" modifier constant (bit mask).
* Applicable to types, methods, constructors, and fields.
* @since 2.0
*/
public static final int PRIVATE = 0x0002;
/**
* A list of property descriptors (element type:
* {@link StructuralPropertyDescriptor}),
* or null if uninitialized.
*/
private static final List PROPERTY_DESCRIPTORS;
/**
* "protected" modifier constant (bit mask).
* Applicable to types, methods, constructors, and fields.
* @since 2.0
*/
public static final int PROTECTED = 0x0004;
/**
* "public" modifier constant (bit mask).
* Applicable to types, methods, constructors, and fields.
* @since 2.0
*/
public static final int PUBLIC = 0x0001;
/**
* "static" modifier constant (bit mask).
* Applicable to types, methods, fields, and initializers.
* @since 2.0
*/
public static final int STATIC = 0x0008;
/**
* "strictfp" modifier constant (bit mask).
* Applicable to types and methods.
* @since 2.0
*/
public static final int STRICTFP = 0x0800;
/**
* "synchronized" modifier constant (bit mask).
* Applicable only to methods.
* @since 2.0
*/
public static final int SYNCHRONIZED = 0x0020;
/**
* "transient" modifier constant (bit mask).
* Applicable only to fields.
* @since 2.0
*/
public static final int TRANSIENT = 0x0080;
/**
* "volatile" modifier constant (bit mask).
* Applicable only to fields.
* @since 2.0
*/
public static final int VOLATILE = 0x0040;
/**
* "sealed" modifier constant (bit mask).
* Applicable only to types.
* @since 3.24
*/
public static final int SEALED = 0x0200;
/**
* "non-sealed" modifier constant (bit mask).
* Applicable only to types.
* @since 3.24
*/
public static final int NON_SEALED = 0x1000;
/**
* "default" modifier constant (bit mask) (added in JLS8 API).
* Applicable only to methods in interfaces (but not for annotation methods with a default value).
* <p>
* Note that the value of this flag is internal and is not
* specified in the Java Virtual Machine Specification.
* </p>
* @since 3.10
*/
public static final int DEFAULT = 0x10000;
static {
List properyList = new ArrayList(2);
createPropertyList(Modifier.class, properyList);
addProperty(KEYWORD_PROPERTY, properyList);
PROPERTY_DESCRIPTORS = reapPropertyList(properyList);
}
/**
* Returns whether the given flags includes the "abstract" modifier.
* Applicable to types and methods.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>ABSTRACT</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isAbstract(int flags) {
return (flags & ABSTRACT) != 0;
}
/**
* Returns whether the given flags includes the "final" modifier.
* Applicable to types, methods, fields, and variables.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>FINAL</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isFinal(int flags) {
return (flags & FINAL) != 0;
}
/**
* Returns whether the given flags includes the "native" modifier.
* Applicable only to methods.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>NATIVE</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isNative(int flags) {
return (flags & NATIVE) != 0;
}
/**
* Returns whether the given flags includes the "private" modifier.
* Applicable to types, methods, constructors, and fields.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>PRIVATE</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isPrivate(int flags) {
return (flags & PRIVATE) != 0;
}
/**
* Returns whether the given flags includes the "protected" modifier.
* Applicable to types, methods, constructors, and fields.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>PROTECTED</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isProtected(int flags) {
return (flags & PROTECTED) != 0;
}
/**
* Returns whether the given flags includes the "public" modifier.
* Applicable to types, methods, constructors, and fields.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>PUBLIC</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isPublic(int flags) {
return (flags & PUBLIC) != 0;
}
/**
* Returns whether the given flags includes the "static" modifier.
* Applicable to types, methods, fields, and initializers.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>STATIC</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isStatic(int flags) {
return (flags & STATIC) != 0;
}
/**
* Returns whether the given flags includes the "strictfp" modifier.
* Applicable to types and methods.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>STRICTFP</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isStrictfp(int flags) {
return (flags & STRICTFP) != 0;
}
/**
* Returns whether the given flags includes the "synchronized" modifier.
* Applicable only to methods.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>SYNCHRONIZED</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isSynchronized(int flags) {
return (flags & SYNCHRONIZED) != 0;
}
/**
* Returns whether the given flags includes the "transient" modifier.
* Applicable only to fields.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>TRANSIENT</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isTransient(int flags) {
return (flags & TRANSIENT) != 0;
}
/**
* Returns whether the given flags includes the "volatile" modifier.
* Applicable only to fields.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>VOLATILE</code> bit is
* set, and <code>false</code> otherwise
* @since 2.0
*/
public static boolean isVolatile(int flags) {
return (flags & VOLATILE) != 0;
}
/**
* Returns whether the given flags includes the "default" modifier.
* Applicable only to methods in interfaces.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>DEFAULT</code> bit is set
* and <code>false</code> otherwise
* @since 3.10
*/
public static boolean isDefault(int flags) {
return (flags & DEFAULT) != 0;
}
/**
* Returns whether the given flags includes the "sealed" modifier.
* Applicable only to types.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>SEALED</code> bit is set
* and <code>false</code> otherwise
* @since 3.24
*/
public static boolean isSealed(int flags) {
return (flags & SEALED) != 0;
}
/**
* Returns whether the given flags includes the "non-sealed" modifier.
* Applicable only to types.
*
* @param flags the modifier flags
* @return <code>true</code> if the <code>NON_SEALED</code> bit is set
* and <code>false</code> otherwise
* @since 3.24
*/
public static boolean isNonSealed(int flags) {
return (flags & NON_SEALED) != 0;
}
/**
* Returns a list of structural property descriptors for this node type.
* Clients must not modify the result.
*
* @param apiLevel the API level; one of the
* <code>AST.JLS*</code> constants
* @return a list of property descriptors (element type:
* {@link StructuralPropertyDescriptor})
* @since 3.0
*/
public static List propertyDescriptors(int apiLevel) {
return PROPERTY_DESCRIPTORS;
}
/**
* The modifier keyword; defaults to an unspecified modifier.
* @since 3.0
*/
private ModifierKeyword modifierKeyword = ModifierKeyword.PUBLIC_KEYWORD;
/**
* Creates a new unparented modifier node owned by the given AST.
* By default, the node has unspecified (but legal) modifier.
* <p>
* N.B. This constructor is package-private.
* </p>
*
* @param ast the AST that is to own this node
* @since 3.0
*/
Modifier(AST ast) {
super(ast);
unsupportedIn2();
}
@Override
void accept0(ASTVisitor visitor) {
visitor.visit(this);
visitor.endVisit(this);
}
@Override
ASTNode clone0(AST target) {
Modifier result = new Modifier(target);
result.setSourceRange(getStartPosition(), getLength());
result.setKeyword(getKeyword());
return result;
}
/**
* Returns the modifier keyword of this modifier node.
*
* @return the modifier keyword
* @since 3.0
*/
public ModifierKeyword getKeyword() {
return this.modifierKeyword;
}
@Override
final int getNodeType0() {
return MODIFIER;
}
@Override
final Object internalGetSetObjectProperty(SimplePropertyDescriptor property, boolean get, Object value) {
if (property == KEYWORD_PROPERTY) {
if (get) {
return getKeyword();
} else {
setKeyword((ModifierKeyword) value);
return null;
}
}
// allow default implementation to flag the error
return super.internalGetSetObjectProperty(property, get, value);
}
@Override
final List internalStructuralPropertiesForType(int apiLevel) {
return propertyDescriptors(apiLevel);
}
/**
* Answer true if the receiver is the abstract modifier, false otherwise.
*
* @return true if the receiver is the abstract modifier, false otherwise
* @since 3.2
*/
public boolean isAbstract() {
return this.modifierKeyword == ModifierKeyword.ABSTRACT_KEYWORD;
}
/**
* @see IExtendedModifier#isAnnotation()
*/
@Override
public boolean isAnnotation() {
return false;
}
/**
* Answer true if the receiver is the final modifier, false otherwise.
*
* @return true if the receiver is the final modifier, false otherwise
* @since 3.2
*/
public boolean isFinal() {
return this.modifierKeyword == ModifierKeyword.FINAL_KEYWORD;
}
/**
* @see IExtendedModifier#isModifier()
*/
@Override
public boolean isModifier() {
return true;
}
/**
* Answer true if the receiver is the native modifier, false otherwise.
*
* @return true if the receiver is the native modifier, false otherwise
* @since 3.2
*/
public boolean isNative() {
return this.modifierKeyword == ModifierKeyword.NATIVE_KEYWORD;
}
/**
* Answer true if the receiver is the private modifier, false otherwise.
*
* @return true if the receiver is the private modifier, false otherwise
* @since 3.2
*/
public boolean isPrivate() {
return this.modifierKeyword == ModifierKeyword.PRIVATE_KEYWORD;
}
/**
* Answer true if the receiver is the protected modifier, false otherwise.
*
* @return true if the receiver is the protected modifier, false otherwise
* @since 3.2
*/
public boolean isProtected() {
return this.modifierKeyword == ModifierKeyword.PROTECTED_KEYWORD;
}
/**
* Answer true if the receiver is the public modifier, false otherwise.
*
* @return true if the receiver is the public modifier, false otherwise
* @since 3.2
*/
public boolean isPublic() {
return this.modifierKeyword == ModifierKeyword.PUBLIC_KEYWORD;
}
/**
* Answer true if the receiver is the static modifier, false otherwise.
*
* @return true if the receiver is the static modifier, false otherwise
* @since 3.2
*/
public boolean isStatic() {
return this.modifierKeyword == ModifierKeyword.STATIC_KEYWORD;
}
/**
* Answer true if the receiver is the strictfp modifier, false otherwise.
*
* @return true if the receiver is the strictfp modifier, false otherwise
* @since 3.2
*/
public boolean isStrictfp() {
return this.modifierKeyword == ModifierKeyword.STRICTFP_KEYWORD;
}
/**
* Answer true if the receiver is the synchronized modifier, false otherwise.
*
* @return true if the receiver is the synchronized modifier, false otherwise
* @since 3.2
*/
public boolean isSynchronized() {
return this.modifierKeyword == ModifierKeyword.SYNCHRONIZED_KEYWORD;
}
/**
* Answer true if the receiver is the transient modifier, false otherwise.
*
* @return true if the receiver is the transient modifier, false otherwise
* @since 3.2
*/
public boolean isTransient() {
return this.modifierKeyword == ModifierKeyword.TRANSIENT_KEYWORD;
}
/**
* Answer true if the receiver is the volatile modifier, false otherwise.
*
* @return true if the receiver is the volatile modifier, false otherwise
* @since 3.2
*/
public boolean isVolatile() {
return this.modifierKeyword == ModifierKeyword.VOLATILE_KEYWORD;
}
/**
* Answer true if the receiver is the default modifier, false otherwise.
* @return true if the receiver is the default modifier, false otherwise
* @since 3.10
*/
public boolean isDefault() {
return this.modifierKeyword == ModifierKeyword.DEFAULT_KEYWORD;
}
/**
* Answer true if the receiver is the sealed modifier, false otherwise.
*
* @return true if the receiver is the sealed modifier, false otherwise
* @since 3.24
*/
public boolean isSealed() {
return this.modifierKeyword == ModifierKeyword.SEALED_KEYWORD;
}
/**
* Answer true if the receiver is the non-sealed modifier, false otherwise.
*
* @return true if the receiver is the non-sealed modifier, false otherwise
* @since 3.24
*/
public boolean isNonSealed() {
return this.modifierKeyword == ModifierKeyword.NON_SEALED_KEYWORD;
}
@Override
int memSize() {
// treat ModifierKeyword as free
return BASE_NODE_SIZE + 1 * 4;
}
/**
* Sets the modifier keyword of this modifier node.
*
* @param modifierKeyord the modifier keyword
* @exception IllegalArgumentException if the argument is <code>null</code>
* @since 3.0
*/
public void setKeyword(ModifierKeyword modifierKeyord) {
if (modifierKeyord == null) {
throw new IllegalArgumentException();
}
preValueChange(KEYWORD_PROPERTY);
this.modifierKeyword = modifierKeyord;
postValueChange(KEYWORD_PROPERTY);
}
@Override
final boolean subtreeMatch0(ASTMatcher matcher, Object other) {
// dispatch to correct overloaded match method
return matcher.match(this, other);
}
@Override
int treeSize() {
return memSize();
}
}
