Eclipse JDT
Release 3.7

org.eclipse.jdt.core.dom
Class ArrayCreation

java.lang.Object
  extended by org.eclipse.jdt.core.dom.ASTNode
      extended by org.eclipse.jdt.core.dom.Expression
          extended by org.eclipse.jdt.core.dom.ArrayCreation

public class ArrayCreation
extends Expression

Array creation expression AST node type. For JLS2:

 ArrayCreation:
    new PrimitiveType [ Expression ] { [ Expression ] } { [ ] }
    new TypeName [ Expression ] { [ Expression ] } { [ ] }
    new PrimitiveType [ ] { [ ] } ArrayInitializer
    new TypeName [ ] { [ ] } ArrayInitializer
 

The mapping from Java language syntax to AST nodes is as follows:

For JLS3, type arguments are added:
 ArrayCreation:
    new PrimitiveType [ Expression ] { [ Expression ] } { [ ] }
    new TypeName [ < Type { , Type } > ]
        [ Expression ] { [ Expression ] } { [ ] }
    new PrimitiveType [ ] { [ ] } ArrayInitializer
    new TypeName [ < Type { , Type } > ]
        [ ] { [ ] } ArrayInitializer
 

Since:
2.0
Restriction:
This class is not intended to be instantiated by clients.

Field Summary
static ChildListPropertyDescriptor DIMENSIONS_PROPERTY
          The "dimensions" structural property of this node type (element type: Expression).
static ChildPropertyDescriptor INITIALIZER_PROPERTY
          The "initializer" structural property of this node type (child type: ArrayInitializer).
static ChildPropertyDescriptor TYPE_PROPERTY
          The "type" structural property of this node type (child type: ArrayType).
 
Fields inherited from class org.eclipse.jdt.core.dom.ASTNode
ANNOTATION_TYPE_DECLARATION, ANNOTATION_TYPE_MEMBER_DECLARATION, ANONYMOUS_CLASS_DECLARATION, ARRAY_ACCESS, ARRAY_CREATION, ARRAY_INITIALIZER, ARRAY_TYPE, ASSERT_STATEMENT, ASSIGNMENT, BLOCK, BLOCK_COMMENT, BOOLEAN_LITERAL, BREAK_STATEMENT, CAST_EXPRESSION, CATCH_CLAUSE, CHARACTER_LITERAL, CLASS_INSTANCE_CREATION, COMPILATION_UNIT, CONDITIONAL_EXPRESSION, CONSTRUCTOR_INVOCATION, CONTINUE_STATEMENT, DO_STATEMENT, EMPTY_STATEMENT, ENHANCED_FOR_STATEMENT, ENUM_CONSTANT_DECLARATION, ENUM_DECLARATION, EXPRESSION_STATEMENT, FIELD_ACCESS, FIELD_DECLARATION, FOR_STATEMENT, IF_STATEMENT, IMPORT_DECLARATION, INFIX_EXPRESSION, INITIALIZER, INSTANCEOF_EXPRESSION, JAVADOC, LABELED_STATEMENT, LINE_COMMENT, MALFORMED, MARKER_ANNOTATION, MEMBER_REF, MEMBER_VALUE_PAIR, METHOD_DECLARATION, METHOD_INVOCATION, METHOD_REF, METHOD_REF_PARAMETER, MODIFIER, NORMAL_ANNOTATION, NULL_LITERAL, NUMBER_LITERAL, ORIGINAL, PACKAGE_DECLARATION, PARAMETERIZED_TYPE, PARENTHESIZED_EXPRESSION, POSTFIX_EXPRESSION, PREFIX_EXPRESSION, PRIMITIVE_TYPE, PROTECT, QUALIFIED_NAME, QUALIFIED_TYPE, RECOVERED, RETURN_STATEMENT, SIMPLE_NAME, SIMPLE_TYPE, SINGLE_MEMBER_ANNOTATION, SINGLE_VARIABLE_DECLARATION, STRING_LITERAL, SUPER_CONSTRUCTOR_INVOCATION, SUPER_FIELD_ACCESS, SUPER_METHOD_INVOCATION, SWITCH_CASE, SWITCH_STATEMENT, SYNCHRONIZED_STATEMENT, TAG_ELEMENT, TEXT_ELEMENT, THIS_EXPRESSION, THROW_STATEMENT, TRY_STATEMENT, TYPE_DECLARATION, TYPE_DECLARATION_STATEMENT, TYPE_LITERAL, TYPE_PARAMETER, VARIABLE_DECLARATION_EXPRESSION, VARIABLE_DECLARATION_FRAGMENT, VARIABLE_DECLARATION_STATEMENT, WHILE_STATEMENT, WILDCARD_TYPE
 
Method Summary
 List dimensions()
          Returns the live ordered list of dimension expressions in this array initializer.
 ArrayInitializer getInitializer()
          Returns the array initializer of this array creation expression, or null if there is none.
 ArrayType getType()
          Returns the array type in this array creation expression.
static List propertyDescriptors(int apiLevel)
          Returns a list of structural property descriptors for this node type.
 void setInitializer(ArrayInitializer initializer)
          Sets or clears the array initializer of this array creation expression.
 void setType(ArrayType type)
          Sets the array type in this array creation expression.
 
Methods inherited from class org.eclipse.jdt.core.dom.Expression
resolveBoxing, resolveConstantExpressionValue, resolveTypeBinding, resolveUnboxing
 
Methods inherited from class org.eclipse.jdt.core.dom.ASTNode
accept, copySubtree, copySubtrees, delete, equals, getAST, getFlags, getLength, getLocationInParent, getNodeType, getParent, getProperty, getRoot, getStartPosition, getStructuralProperty, hashCode, nodeClassForType, properties, setFlags, setProperty, setSourceRange, setStructuralProperty, structuralPropertiesForType, subtreeBytes, subtreeMatch, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

TYPE_PROPERTY

public static final ChildPropertyDescriptor TYPE_PROPERTY
The "type" structural property of this node type (child type: ArrayType).

Since:
3.0

DIMENSIONS_PROPERTY

public static final ChildListPropertyDescriptor DIMENSIONS_PROPERTY
The "dimensions" structural property of this node type (element type: Expression).

Since:
3.0

INITIALIZER_PROPERTY

public static final ChildPropertyDescriptor INITIALIZER_PROPERTY
The "initializer" structural property of this node type (child type: ArrayInitializer).

Since:
3.0
Method Detail

propertyDescriptors

public static List propertyDescriptors(int apiLevel)
Returns a list of structural property descriptors for this node type. Clients must not modify the result.

Parameters:
apiLevel - the API level; one of the AST.JLS* constants
Returns:
a list of property descriptors (element type: StructuralPropertyDescriptor)
Since:
3.0

getType

public ArrayType getType()
Returns the array type in this array creation expression.

Returns:
the array type

setType

public void setType(ArrayType type)
Sets the array type in this array creation expression.

Parameters:
type - the new array type
Throws:
IllegalArgumentException - if:
  • the node belongs to a different AST
  • the node already has a parent

dimensions

public List dimensions()
Returns the live ordered list of dimension expressions in this array initializer.

Returns:
the live list of dimension expressions (element type: Expression)

getInitializer

public ArrayInitializer getInitializer()
Returns the array initializer of this array creation expression, or null if there is none.

Returns:
the array initializer node, or null if there is none

setInitializer

public void setInitializer(ArrayInitializer initializer)
Sets or clears the array initializer of this array creation expression.

Parameters:
initializer - the array initializer node, or null if there is none
Throws:
IllegalArgumentException - if:
  • the node belongs to a different AST
  • the node already has a parent
  • a cycle in would be created

Eclipse JDT
Release 3.7

Guidelines for using Eclipse APIs.

Copyright (c) 2000, 2011 IBM Corporation and others. All rights reserved.