org.eclipse.jdt.core.dom.SimplePropertyDescriptor Maven / Gradle / Ivy

/*******************************************************************************
 * Copyright (c) 2004, 2013 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.jdt.core.dom;

/**
 * Descriptor for a simple property of an AST node.
 * A simple property is one whose value is a
 * primitive type (such as int or boolean)
 * or some simple value type (such as String or
 * InfixExpression.Operator).
 *
 * @see org.eclipse.jdt.core.dom.ASTNode#getStructuralProperty(StructuralPropertyDescriptor)
 * @see org.eclipse.jdt.core.dom.ASTNode#setStructuralProperty(StructuralPropertyDescriptor, Object)
 * @since 3.0
 * @noinstantiate This class is not intended to be instantiated by clients.
 */
@SuppressWarnings("rawtypes")
public final class SimplePropertyDescriptor extends StructuralPropertyDescriptor {

	/**
	 * Value type. For example, for a node type like
	 * SingleVariableDeclaration, the modifiers property is int.class
	 */
	private final Class valueType;

	/**
	 * Indicates whether a value is mandatory. A property value is allowed
	 * to be null only if it is not mandatory.
	 */
	private final boolean mandatory;

	/**
	 * Creates a new simple property descriptor with the given property id.
	 * Note that this constructor is declared package-private so that
	 * property descriptors can only be created by the AST
	 * implementation.
	 *
	 * @param nodeClass concrete AST node type that owns this property
	 * @param propertyId the property id
	 * @param valueType the value type of this property
	 * @param mandatory true if the property is mandatory,
	 * and false if it is may be null
	 */
	SimplePropertyDescriptor(Class nodeClass, String propertyId, Class valueType, boolean mandatory) {
		super(nodeClass, propertyId);
		if (valueType == null || ASTNode.class.isAssignableFrom(valueType)) {
			throw new IllegalArgumentException();
		}
		this.valueType = valueType;
		this.mandatory = mandatory;
	}

	/**
	 * Returns the value type of this property.
	 * 
	 * For example, for a node type like SingleVariableDeclaration,
	 * the "modifiers" property returns int.class.
	 * 
	 *
	 * @return the value type of the property
	 */
	public Class getValueType() {
		return this.valueType;
	}

	/**
	 * Returns whether this property is mandatory. A property value
	 * is not allowed to be null if it is mandatory.
	 *
	 * @return true if the property is mandatory,
	 * and false if it is may be null
	 */
	public boolean isMandatory() {
		return this.mandatory;
	}
}