Examples of org.eclipse.jdt.core.dom.ASTNode

org.eclipse.jdt.core.dom.ASTNode
Abstract superclass of all Abstract Syntax Tree (AST) node types.
An AST node represents a Java source code construct, such as a name, type, expression, statement, or declaration.

Each AST node belongs to a unique AST instance, called the owning AST. The children of an AST node always have the same owner as their parent node. If a node from one AST is to be added to a different AST, the subtree must be cloned first to ensure that the added nodes have the correct owning AST.

When an AST node is part of an AST, it has a unique parent node. Clients can navigate upwards, from child to parent, as well as downwards, from parent to child. Newly created nodes are unparented. When an unparented node is set as a child of a node (using a setCHILD method), its parent link is set automatically and the parent link of the former child is set to null. For nodes with properties that include a list of children (for example, Block whose statements property is a list of statements), adding or removing an element to/for the list property automatically updates the parent links. These lists support the List.set method; however, the constraint that the same node cannot appear more than once means that this method cannot be used to swap elements without first removing the node.

ASTs must not contain cycles. All operations that could create a cycle detect this possibility and fail.

ASTs do not contain "holes" (missing subtrees). If a node is required to have a certain property, a syntactically plausible initial value is always supplied.

The hierarchy of AST node types has some convenient groupings marked by abstract superclasses:
- expressions - Expression
- names - Name (a sub-kind of expression)
- statements - Statement
- types - Type
- type body declarations - BodyDeclaration
Abstract syntax trees may be hand constructed by clients, using the newTYPE factory methods (see AST) to create new nodes, and the various setCHILD methods to connect them together.

The class {@link ASTParser} parses a stringcontaining a Java source code and returns an abstract syntax tree for it. The resulting nodes carry source ranges relating the node back to the original source characters. The source range covers the construct as a whole.

Each AST node carries bit flags, which may convey additional information about the node. For instance, the parser uses a flag to indicate a syntax error. Newly created nodes have no flags set.

Each AST node is capable of carrying an open-ended collection of client-defined properties. Newly created nodes have none. getProperty and setProperty are used to access these properties.

AST nodes are thread-safe for readers provided there are no active writers. If one thread is modifying an AST, including creating new nodes or cloning existing ones, it is not safe for another thread to read, visit, write, create, or clone any of the nodes on the same AST. When synchronization is required, consider using the common AST object that owns the node; that is, use synchronize (node.getAST()) {...}.

ASTs also support the visitor pattern; see the class ASTVisitor for details. The NodeFinder class can be used to find a specific node inside a tree.

Compilation units created by ASTParser from a source document can be serialized after arbitrary modifications with minimal loss of original formatting. See {@link CompilationUnit#recordModifications()} for details.See also {@link org.eclipse.jdt.core.dom.rewrite.ASTRewrite} foran alternative way to describe and serialize changes to a read-only AST.
@see ASTParser @see ASTVisitor @see NodeFinder @since 2.0 @noextend This class is not intended to be subclassed by clients.

        "}");
    // check captured position
    {
      assertTrue(openSourcePosition.hasCaptured());
      assertTrue(openSourcePosition.getValue() != 0);
      ASTNode enclosingNode = m_lastEditor.getEnclosingNode(openSourcePosition.getValue());
      assertEquals("new MyCommand()", m_lastEditor.getSource(enclosingNode));
    }
  }

View Full Code Here

      assertTrue(creationSupport.canReparent());
      assertTrue(creationSupport.canDelete());
    }
    // assert that "image" is bound to AST
    {
      ASTNode node = getNode("image = ");
      assertTrue(newImage.isRepresentedBy(node));
    }
  }

View Full Code Here

            }
          }
        }
      }


      ASTNode a = ASTNode.copySubtree(ast, dropTypeDec);
      @SuppressWarnings("unchecked")
      List<TypeDeclaration> types = astRoot.types();
      ArrayList<TypeDeclaration> newTypes = new ArrayList<TypeDeclaration>();
      newTypes.add((TypeDeclaration) a);
      if (types.addAll(newTypes)) {

View Full Code Here

   * @param ext the list of modifier and annotation nodes
   * (element type: <code>IExtendedModifiers</code>)
   */
  void printModifiers(List ext) {
    for (Iterator it = ext.iterator(); it.hasNext(); ) {
      ASTNode p = (ASTNode) it.next();
      p.accept(this);
      this.buffer.append(" ");//$NON-NLS-1$
    }
  }

View Full Code Here

   */
  public boolean visit(Javadoc node) {
    printIndent();
    this.buffer.append("/** ");//$NON-NLS-1$
    for (Iterator it = node.tags().iterator(); it.hasNext(); ) {
      ASTNode e = (ASTNode) it.next();
      e.accept(this);
    }
    this.buffer.append("\n */\n");//$NON-NLS-1$
    return false;
  }

View Full Code Here

   * @param nodeType Type of the node to create. Use the type constants in {@link NodeInfoStore}.
   * @return Returns a place holder node.
   */
  public final ASTNode newPlaceholderNode(int nodeType) {
      try {
        ASTNode node= this.ast.createInstance(nodeType);
        switch (node.getNodeType()) {
        case ASTNode.FIELD_DECLARATION:
            ((FieldDeclaration) node).fragments().add(this.ast.newVariableDeclarationFragment());
            break;
        case ASTNode.MODIFIER:
            ((Modifier) node).setKeyword(Modifier.ModifierKeyword.ABSTRACT_KEYWORD);

View Full Code Here

      this.buffer.append(node.getTagName());
      previousRequiresWhiteSpace = true;
    }
    boolean previousRequiresNewLine = false;
    for (Iterator it = node.fragments().iterator(); it.hasNext(); ) {
      ASTNode e = (ASTNode) it.next();
      // assume text elements include necessary leading and trailing whitespace
      // but Name, MemberRef, MethodRef, and nested TagElement do not include white space
      boolean currentIncludesWhiteSpace = (e instanceof TextElement);
      if (previousRequiresNewLine && currentIncludesWhiteSpace) {
        this.buffer.append("\n * ");//$NON-NLS-1$
      }
      previousRequiresNewLine = currentIncludesWhiteSpace;
      // add space if required to separate
      if (previousRequiresWhiteSpace && !currentIncludesWhiteSpace) {
        this.buffer.append(" "); //$NON-NLS-1$
      }
      e.accept(this);
      previousRequiresWhiteSpace = !currentIncludesWhiteSpace && !(e instanceof TagElement);
    }
    if (node.isNested()) {
      this.buffer.append("}");//$NON-NLS-1$
    }

View Full Code Here

  public TextEdit rewriteAST(IDocument document, Map options) throws IllegalArgumentException {
    if (document == null) {
      throw new IllegalArgumentException();
    }


    ASTNode rootNode= getRootNode();
    if (rootNode == null) {
      return new MultiTextEdit(); // no changes
    }


    char[] content= document.get().toCharArray();
    LineInformation lineInfo= LineInformation.create(document);
    String lineDelim= TextUtilities.getDefaultLineDelimiter(document);


    ASTNode astRoot= rootNode.getRoot();
    List commentNodes= astRoot instanceof CompilationUnit ? ((CompilationUnit) astRoot).getCommentList() : null;
    Map currentOptions = options == null ? JavaCore.getOptions() : options;
    return internalRewriteAST(content, lineInfo, lineDelim, commentNodes, currentOptions, rootNode, (RecoveryScannerData)((CompilationUnit) astRoot).getStatementsRecoveryData());
  }

View Full Code Here

   * is thrown if the document passed does not correspond to the AST that is rewritten.
   *
   * @since 3.2
   */
  public TextEdit rewriteAST() throws JavaModelException, IllegalArgumentException {
    ASTNode rootNode= getRootNode();
    if (rootNode == null) {
      return new MultiTextEdit(); // no changes
    }


    ASTNode root= rootNode.getRoot();
    if (!(root instanceof CompilationUnit)) {
      throw new IllegalArgumentException("This API can only be used if the AST is created from a compilation unit or class file"); //$NON-NLS-1$
    }
    CompilationUnit astRoot= (CompilationUnit) root;
    ITypeRoot typeRoot = astRoot.getTypeRoot();

View Full Code Here

    this.eventStore.revertMovedNodes();
    return result;
  }


  private ASTNode getRootNode() {
    ASTNode node= null;
    int start= -1;
    int end= -1;


    for (Iterator iter= getRewriteEventStore().getChangeRootIterator(); iter.hasNext();) {
      ASTNode curr= (ASTNode) iter.next();
      if (!RewriteEventStore.isNewNode(curr)) {
        int currStart= curr.getStartPosition();
        int currEnd= currStart + curr.getLength();
        if (node == null || currStart < start && currEnd > end) {
          start= currStart;
          end= currEnd;
          node= curr;
        } else if (currStart < start) {
          start= currStart;
        } else if (currEnd > end) {
          end= currEnd;
        }
      }
    }
    if (node != null) {
      int currStart= node.getStartPosition();
      int currEnd= currStart + node.getLength();
      while (start < currStart || end > currEnd) { // go up until a node covers all
        node= node.getParent();
        currStart= node.getStartPosition();
        currEnd= currStart + node.getLength();
      }
      ASTNode parent= node.getParent(); // go up until a parent has different range
      while (parent != null && parent.getStartPosition() == node.getStartPosition() && parent.getLength() == node.getLength()) {
        node= parent;
        parent= node.getParent();
      }
    }
    return node;

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of org.eclipse.jdt.core.dom.ASTNode

ai.cfg.MethodCFGBuilder

archmapper.main.conformance.StyleCheckResult

at.ssw.coco.ide.features.contentAssist.codeCompletion.semanticCompletion.JavaCompletionProcessor

br.com.objectos.way.code.WayCode

br.com.objectos.way.code.WayCode$CreateAst

com.google.gdt.eclipse.designer.gwtext.model.widgets.GridPanelInfo

com.google.gdt.eclipse.designer.gxt.model.widgets.GridInfo

com.halware.nakedide.eclipse.ext.annot.utils.AstUtils

com.onpositive.gae.baseviewer.ProjectMiner

de.innovationgate.eclipse.editors.tmlscript.parsing.ReflectionManager

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.