com.github.gumtreediff.matchers.Matcher Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of core Show documentation

GumTree core module.

The newest version!

/*
 * This file is part of GumTree.
 *
 * GumTree is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * GumTree is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with GumTree.  If not, see .
 *
 * Copyright 2011-2015 Jean-Rémy Falleri 
 * Copyright 2011-2015 Floréal Morandat 
 */

package com.github.gumtreediff.matchers;

import org.atteo.classindex.IndexSubclasses;

import com.github.gumtreediff.tree.Tree;

/**
 * Interface for matchers that produce mappings between the nodes of a src and
 * dst AST.
 *
 * @see MappingStore
 * @see Tree
 */
@IndexSubclasses
public interface Matcher extends Configurable {
    /**
     * Compute and return the mappings between a provided src and dst AST.
     * The mappings are added as a side effect in the provided mapping store.
     * The provided mapping store is return as well to allow chaining.
     */
    MappingStore match(Tree src, Tree dst, MappingStore mappings);

    /**
     * Utility method that compute and return the mappings between a provided 
     * src and dst AST in a new mapping store.
     * 
     * @see #match(Tree, Tree, MappingStore) 
     */
    default MappingStore match(Tree src, Tree dst) {
        return match(src, dst, new MappingStore(src, dst));
    }
}