cdc.applic.expressions.parsing.Recognizer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of cdc-applic-expressions Show documentation

Applicabilities Expressions.

The newest version!

package cdc.applic.expressions.parsing;

import java.util.function.Consumer;

import cdc.applic.expressions.LexicalException;
import cdc.applic.expressions.SyntacticException;

/**
 * Class used to check syntactical validity of an Expression.
 * 
 * This class is not reentrant.
 *
 * @author Damien Carbonne
 */
public class Recognizer {
    private final Analyzer analyzer = new Analyzer();

    private static final Consumer VOID = e -> {
        // Ignore
    };

    public Recognizer() {
        super();
    }

    /**
     * Checks the syntactical validity of an expression.
     *
     * @param expression The expression to check.
     * @return {@code true} if the expression is syntactically valid.
     */
    public boolean isValid(String expression) {
        try {
            recognize(expression);
            return true;
        } catch (final LexicalException | SyntacticException e) {
            // Ignore e
            return false;
        }
    }

    /**
     * Recognizes an expression from a syntactical point of view.
     * 
     * If the expression is syntactically invalid, an exception is raised.
     *
     * @param expression The expression to recognize.
     * @throws LexicalException When the expression is lexically invalid.
     * @throws SyntacticException When the expression is syntactically invalid.
     */
    public void recognize(String expression) {
        analyzer.analyze(expression, VOID);
    }
}