All Downloads are FREE. Search and download functionalities are using the official Maven repository.

gumtree.spoon.builder.NodeCreator Maven / Gradle / Ivy

Go to download

Computes the AST difference between two Spoon abstract syntax trees using the Gumtree algorithm.

There is a newer version: 1.94
Show newest version
/* *****************************************************************************
 * Copyright 2016 Matias Martinez
 * Copyright (c) 2022, Oracle and/or its affiliates.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 * *****************************************************************************/

package gumtree.spoon.builder;

import com.github.gumtreediff.tree.Tree;
import spoon.reflect.code.CtExpression;
import spoon.reflect.cu.CompilationUnit;
import spoon.reflect.cu.SourcePosition;
import spoon.reflect.cu.position.NoSourcePosition;
import spoon.reflect.declaration.CtAnnotation;
import spoon.reflect.declaration.CtElement;
import spoon.reflect.declaration.CtMethod;
import spoon.reflect.declaration.CtModifiable;
import spoon.reflect.declaration.CtTypeInformation;
import spoon.reflect.declaration.CtTypedElement;
import spoon.reflect.declaration.CtVariable;
import spoon.reflect.path.CtRole;
import spoon.reflect.reference.CtActualTypeContainer;
import spoon.reflect.reference.CtTypeReference;
import spoon.reflect.visitor.CtInheritanceScanner;
import spoon.support.reflect.CtExtendedModifier;
import spoon.support.reflect.cu.position.SourcePositionImpl;

import java.lang.annotation.Annotation;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.TreeSet;

/**
 * responsible to add additional nodes only overrides scan* to add new nodes
 */
public class NodeCreator extends CtInheritanceScanner {
    public static final String MODIFIERS = "Modifiers_";
    private final TreeScanner builder;

    NodeCreator(TreeScanner builder) {
        this.builder = builder;
    }

    private static SourcePosition computeSourcePositionOfVirtualElement(List modifierPositions) {
        CompilationUnit cu = null;
        Integer sourceStart = null;
        Integer sourceEnd = null;
        for (SourcePosition position : modifierPositions) {
            if (position instanceof NoSourcePosition) {
                return SourcePosition.NOPOSITION;
            }
            if (sourceStart == null || position.getSourceStart() < sourceStart) {
                sourceStart = position.getSourceStart();
            }
            if (sourceEnd == null || position.getSourceEnd() > sourceEnd) {
                sourceEnd = position.getSourceEnd();
            }
            if (cu == null) {
                cu = position.getCompilationUnit();
            }
        }
        return new SourcePositionImpl(cu, sourceStart, sourceEnd, cu.getLineSeparatorPositions());
    }

    @Override
    public void scanCtModifiable(CtModifiable m) {

        if (m.getModifiers().isEmpty())
            return;

        // We add the type of modifiable element
        String type = MODIFIERS + getClassName(m.getClass().getSimpleName());
        Tree modifiers = builder.createNode(type, "");
        SpoonGumTreeBuilder.setPosition(modifiers, m);

        int modifierStart = Integer.MAX_VALUE;
        int modifierEnd = Integer.MIN_VALUE;
        // ensuring an order (instead of hashset)
        // otherwise some flaky tests in CI
        Set modifiers1 = new TreeSet<>(Comparator.comparing(o -> o.getKind().name()));
        modifiers1.addAll(m.getExtendedModifiers());

        // we skip creating virtual nodes if all modifiers are implicit
        // this will not impact diff results as the diff is on source level and implicit modifiers are not in the source
        if (modifiers1.stream().map(em -> em.getPosition() instanceof NoSourcePosition).allMatch(Boolean.TRUE::equals)) {
            return;
        }

        // We create a virtual node
        CtVirtualElement virtualElement = new CtVirtualElement(type, m, m.getModifiers(), CtRole.MODIFIER);
        modifiers.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, virtualElement);
        SpoonGumTreeBuilder.setPosition(modifiers, virtualElement);

        List modifierPositions = new ArrayList<>();

        for (CtExtendedModifier mod : modifiers1) {
            if (mod.isImplicit()) {
                continue;
            }
            modifierStart = Math.min(modifierStart, mod.getPosition().getSourceStart());
            modifierEnd = Math.max(modifierEnd, mod.getPosition().getSourceEnd());
            Tree modifier = builder.createNode("Modifier", mod.getKind().toString());
            modifiers.addChild(modifier);
            // We wrap the modifier's kind (which is not a CtElement)
            CtWrapper wrapper = new CtWrapper<>(mod.getKind(), m, CtRole.MODIFIER);
            wrapper.setPosition(mod.getPosition());
            modifierPositions.add(mod.getPosition());
            modifier.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, wrapper);
            SpoonGumTreeBuilder.setPosition(modifier, wrapper);
        }
        modifiers.setPos(modifierStart);
        modifiers.setLength(modifierEnd - modifierStart);
        virtualElement.setPosition(computeSourcePositionOfVirtualElement(modifierPositions));
        builder.addSiblingNode(modifiers);
    }

    private String getClassName(String simpleName) {
        if (simpleName == null)
            return "";
        return simpleName.replace("Ct", "").replace("Impl", "");
    }

    @Override
    public  void scanCtVariable(CtVariable e) {
        CtTypeReference type = e.getType();
        if (type != null) {
            Tree variableType = builder.createNode("VARIABLE_TYPE", type.getQualifiedName());
            variableType.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, type);
            type.putMetadata(SpoonGumTreeBuilder.GUMTREE_NODE, variableType);
            computeTreeOfTypeReferences(type, variableType);
            SpoonGumTreeBuilder.setPosition(variableType, type);
            builder.addSiblingNode(variableType);
        }
    }

    @Override
    public void scanCtActualTypeContainer(CtActualTypeContainer reference) {
        for (CtTypeReference ctTypeArgument : reference.getActualTypeArguments()) {
            Tree typeArgument = builder.createNode("TYPE_ARGUMENT", ctTypeArgument.getQualifiedName());
            typeArgument.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, ctTypeArgument);
            ctTypeArgument.putMetadata(SpoonGumTreeBuilder.GUMTREE_NODE, typeArgument);
            computeTreeOfTypeReferences(ctTypeArgument, typeArgument);
            SpoonGumTreeBuilder.setPosition(typeArgument, ctTypeArgument);
            builder.addSiblingNode(typeArgument);
        }
    }

    @Override
    public  void scanCtTypeInformation(CtTypeInformation typeReference) {
        if (typeReference.getSuperInterfaces().isEmpty()) {
            return;
        }

        // create the root super interface node whose children will be *actual* spoon
        // nodes of interfaces
        Tree superInterfaceRoot = builder.createNode("SUPER_INTERFACES", "");
        String virtualNodeDescription = "SuperInterfaces_" + typeReference.getQualifiedName();
        CtVirtualElement superInterfaceVirtualElement = new CtVirtualElement(virtualNodeDescription, (CtElement) typeReference,
                typeReference.getSuperInterfaces(), CtRole.INTERFACE);
        superInterfaceRoot.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, superInterfaceVirtualElement);

        List superInterfacePositions = new ArrayList<>();
        // attach each super interface to the root created above
        for (CtTypeReference superInterface : typeReference.getSuperInterfaces()) {
            Tree superInterfaceNode = builder.createNode("INTERFACE", superInterface.getQualifiedName());
            superInterfaceNode.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, superInterface);
            superInterface.putMetadata(SpoonGumTreeBuilder.GUMTREE_NODE, superInterfaceNode);
            SpoonGumTreeBuilder.setPosition(superInterfaceNode, superInterface);
            superInterfaceRoot.addChild(superInterfaceNode);
            superInterfacePositions.add(superInterface.getPosition());
            computeTreeOfTypeReferences(superInterface, superInterfaceNode);
        }
        superInterfaceVirtualElement.setPosition(computeSourcePositionOfVirtualElement(superInterfacePositions));
        SpoonGumTreeBuilder.setPosition(superInterfaceRoot, superInterfaceVirtualElement);
        builder.addSiblingNode(superInterfaceRoot);
    }

    /**
     * Creates a tree of nested type references where each nested type reference is
     * a child of its container.
     */
    private void computeTreeOfTypeReferences(CtTypeReference type, Tree parentType) {
        for (CtTypeReference ctTypeArgument : type.getActualTypeArguments()) {
            Tree typeArgument = builder.createNode("TYPE_ARGUMENT", ctTypeArgument.getQualifiedName());
            typeArgument.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, ctTypeArgument);
            ctTypeArgument.putMetadata(SpoonGumTreeBuilder.GUMTREE_NODE, typeArgument);
            SpoonGumTreeBuilder.setPosition(typeArgument, ctTypeArgument);
            parentType.addChild(typeArgument);
            computeTreeOfTypeReferences(ctTypeArgument, typeArgument);
        }
    }

    @Override
    public  void visitCtMethod(CtMethod e) {
        // add the return type of the method
        CtTypeReference type = e.getType();
        if (type != null) {
            Tree returnType = builder.createNode("RETURN_TYPE", type.getQualifiedName());
            returnType.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, type);
            type.putMetadata(SpoonGumTreeBuilder.GUMTREE_NODE, returnType);
            computeTreeOfTypeReferences(type, returnType);
            SpoonGumTreeBuilder.setPosition(returnType, type);
            builder.addSiblingNode(returnType);
        }

        if (!e.getThrownTypes().isEmpty()) {
            Tree thrownTypeRoot = builder.createNode("THROWN_TYPES", "");
            String virtualNodeDescription = "ThrownTypes_" + e.getSimpleName();
            CtVirtualElement thrownTypeVirtualElement = new CtVirtualElement(virtualNodeDescription, e, e.getThrownTypes(), CtRole.THROWN);
            thrownTypeRoot.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT,
                    thrownTypeVirtualElement);
            List thrownTypePositions = new ArrayList<>();

            for (CtTypeReference thrownType : e.getThrownTypes()) {
                Tree thrownNode = builder.createNode("THROWN", thrownType.getQualifiedName());
                thrownNode.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, thrownType);
                thrownType.putMetadata(SpoonGumTreeBuilder.GUMTREE_NODE, thrownNode);
                SpoonGumTreeBuilder.setPosition(thrownNode, thrownType);
                thrownTypeRoot.addChild(thrownNode);
                thrownTypePositions.add(thrownType.getPosition());
            }
            thrownTypeVirtualElement.setPosition(computeSourcePositionOfVirtualElement(thrownTypePositions));
            SpoonGumTreeBuilder.setPosition(thrownTypeRoot, thrownTypeVirtualElement);
            builder.addSiblingNode(thrownTypeRoot);
        }
        super.visitCtMethod(e);
    }

    @Override
    public  void visitCtAnnotation(CtAnnotation annotation) {
        if (annotation.getValues().isEmpty()) {
            return;
        }

        final String virtualNodeDescription = "AnnotationValues_" + getClassName(annotation.getClass().getSimpleName());
        Tree annotationNode = builder.createNode(virtualNodeDescription, "");

        CtVirtualElement annotationVirtualElement = new CtVirtualElement(virtualNodeDescription, annotation, annotation.getValues().entrySet(), CtRole.VALUE);
        annotationNode.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT,
                annotationVirtualElement);

        List annotationPositions = new ArrayList<>();
        for (Map.Entry entry : annotation.getValues().entrySet()) {
            Tree annotationValueNode = builder.createNode("ANNOTATION_VALUE", entry.toString());
            annotationNode.addChild(annotationValueNode);
            CtWrapper wrapper = new CtWrapper(entry, annotation, CtRole.VALUE);
            wrapper.setPosition(entry.getValue().getPosition());
            annotationValueNode.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, wrapper);
            SpoonGumTreeBuilder.setPosition(annotationValueNode, entry.getValue());
            annotationPositions.add(entry.getValue().getPosition());
        }
        annotationVirtualElement.setPosition(computeSourcePositionOfVirtualElement(annotationPositions));
        SpoonGumTreeBuilder.setPosition(annotationNode, annotationVirtualElement);

        builder.addSiblingNode(annotationNode);
    }

    @Override
    public  void scanCtTypedElement(CtTypedElement e) {
        if (e instanceof CtExpression) {
            CtExpression expression = (CtExpression) e;

            for (CtTypeReference ctTypeCast : expression.getTypeCasts()) {
                Tree typeCast = builder.createNode("TYPE_CAST", ctTypeCast.getQualifiedName());
                typeCast.setMetadata(SpoonGumTreeBuilder.SPOON_OBJECT, ctTypeCast);
                ctTypeCast.putMetadata(SpoonGumTreeBuilder.GUMTREE_NODE, typeCast);
                computeTreeOfTypeReferences(ctTypeCast, typeCast);
                SpoonGumTreeBuilder.setPosition(typeCast, ctTypeCast);
                builder.addSiblingNode(typeCast);
            }
        }
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy