/******************************************************************************* * Copyright (c) 2000, 2008 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 net.sourceforge.phpdt.core.dom; import java.util.ArrayList; import java.util.List; /** * Simple or qualified "super" field access expression AST node type. * *
* SuperFieldAccess: * [ ClassName . ] super . Identifier ** *
* See FieldAccess
for guidelines on handling other expressions
* that resemble qualified names.
*
AST.JLS*
constants
* @return a list of property descriptors (element type:
* {@link StructuralPropertyDescriptor})
* @since 3.0
*/
public static List propertyDescriptors(int apiLevel) {
return PROPERTY_DESCRIPTORS;
}
/**
* The optional qualifier; null
for none; defaults to none.
*/
private Name optionalQualifier = null;
/**
* The field; lazily initialized; defaults to an unspecified,
* but legal, simple field name.
*/
private SimpleName fieldName = null;
/**
* Creates a new unparented node for a super field access expression owned
* by the given AST. By default, field name is an unspecified, but legal,
* name, and there is no qualifier.
* * N.B. This constructor is package-private. *
* * @param ast the AST that is to own this node */ SuperFieldAccess(AST ast) { super(ast); } /* (omit javadoc for this method) * Method declared on ASTNode. */ final List internalStructuralPropertiesForType(int apiLevel) { return propertyDescriptors(apiLevel); } /* (omit javadoc for this method) * Method declared on ASTNode. */ final ASTNode internalGetSetChildProperty(ChildPropertyDescriptor property, boolean get, ASTNode child) { if (property == QUALIFIER_PROPERTY) { if (get) { return getQualifier(); } else { setQualifier((Name) child); return null; } } if (property == NAME_PROPERTY) { if (get) { return getName(); } else { setName((SimpleName) child); return null; } } // allow default implementation to flag the error return super.internalGetSetChildProperty(property, get, child); } /* (omit javadoc for this method) * Method declared on ASTNode. */ final int getNodeType0() { return SUPER_FIELD_ACCESS; } /* (omit javadoc for this method) * Method declared on ASTNode. */ ASTNode clone0(AST target) { SuperFieldAccess result = new SuperFieldAccess(target); result.setSourceRange(this.getStartPosition(), this.getLength()); result.setName((SimpleName) ASTNode.copySubtree(target, getName())); result.setQualifier((Name) ASTNode.copySubtree(target, getQualifier())); return result; } /* (omit javadoc for this method) * Method declared on ASTNode. */ final boolean subtreeMatch0(ASTMatcher matcher, Object other) { // dispatch to correct overloaded match method return matcher.match(this, other); } /* (omit javadoc for this method) * Method declared on ASTNode. */ void accept0(ASTVisitor visitor) { boolean visitChildren = visitor.visit(this); if (visitChildren) { // visit children in normal left to right reading order acceptChild(visitor, getQualifier()); acceptChild(visitor, getName()); } visitor.endVisit(this); } /** * Returns the qualifier of this "super" field access expression, or *null
if there is none.
*
* @return the qualifier name node, or null
if there is none
*/
public Name getQualifier() {
return this.optionalQualifier;
}
/**
* Sets or clears the qualifier of this "super" field access expression.
*
* @param name the qualifier name node, or null
if
* there is none
* @exception IllegalArgumentException if:
* * Note that bindings are generally unavailable unless requested when the * AST is being built. *
* * @return the variable binding, ornull
if the binding cannot
* be resolved
* @since 3.0
*/
public IVariableBinding resolveFieldBinding() {
return this.ast.getBindingResolver().resolveField(this);
}
/**
* Sets the name of the field accessed in this "super" field access
* expression.
*
* @param fieldName the field name
* @exception IllegalArgumentException if:
*