// Copyright 2016 The Bazel Authors. All rights reserved. // // 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 com.google.devtools.build.lib.query2.engine; import com.google.common.collect.ImmutableList; import com.google.devtools.build.lib.query2.engine.QueryEnvironment.Argument; /** * Performs an arbitrary transformation of a {@link QueryExpression}. * * <p>For each subclass of {@link QueryExpression}, there's a corresponding {@link #map} overload * that transforms a node of that type. By default, this method recursively applies this * {@link QueryExpressionMapper}'s transformation in a structure-preserving manner (trying to * maintain reference-equality, as an optimization). Subclasses of {@link QueryExpressionMapper} can * override these methods in order to implement an arbitrary transformation. */ public abstract class QueryExpressionMapper { public QueryExpression map(TargetLiteral targetLiteral) { return targetLiteral; } public QueryExpression map(BinaryOperatorExpression binaryOperatorExpression) { boolean changed = false; ImmutableList.Builder<QueryExpression> mappedOperandsBuilder = ImmutableList.builder(); for (QueryExpression operand : binaryOperatorExpression.getOperands()) { QueryExpression mappedOperand = operand.getMapped(this); if (mappedOperand != operand) { changed = true; } mappedOperandsBuilder.add(mappedOperand); } return changed ? new BinaryOperatorExpression( binaryOperatorExpression.getOperator(), mappedOperandsBuilder.build()) : binaryOperatorExpression; } public QueryExpression map(FunctionExpression functionExpression) { boolean changed = false; ImmutableList.Builder<Argument> mappedArgumentBuilder = ImmutableList.builder(); for (Argument argument : functionExpression.getArgs()) { switch (argument.getType()) { case EXPRESSION: { QueryExpression expr = argument.getExpression(); QueryExpression mappedExpression = expr.getMapped(this); mappedArgumentBuilder.add(Argument.of(mappedExpression)); if (expr != mappedExpression) { changed = true; } break; } default: mappedArgumentBuilder.add(argument); break; } } return changed ? new FunctionExpression(functionExpression.getFunction(), mappedArgumentBuilder.build()) : functionExpression; } public QueryExpression map(LetExpression letExpression) { boolean changed = false; QueryExpression mappedVarExpr = letExpression.getVarExpr().getMapped(this); if (mappedVarExpr != letExpression.getVarExpr()) { changed = true; } QueryExpression mappedBodyExpr = letExpression.getBodyExpr().getMapped(this); if (mappedBodyExpr != letExpression.getBodyExpr()) { changed = true; } return changed ? new LetExpression(letExpression.getVarName(), mappedVarExpr, mappedBodyExpr) : letExpression; } public QueryExpression map(SetExpression setExpression) { return setExpression; } public static QueryExpressionMapper identity() { return IdentityMapper.INSTANCE; } /** * Returns a {@link QueryExpressionMapper} which applies all the mappings provided by {@code * mappers}, in the reverse order of mapper array. */ public static QueryExpressionMapper compose(QueryExpressionMapper... mappers) { return new ComposedQueryExpressionMapper(mappers); } private static class ComposedQueryExpressionMapper extends QueryExpressionMapper { private final QueryExpressionMapper[] mappers; private ComposedQueryExpressionMapper(QueryExpressionMapper... mappers) { this.mappers = mappers; } @Override public QueryExpression map(TargetLiteral targetLiteral) { return mapAll(targetLiteral, mappers); } @Override public QueryExpression map(BinaryOperatorExpression binaryOperatorExpression) { return mapAll(binaryOperatorExpression, mappers); } @Override public QueryExpression map(FunctionExpression functionExpression) { return mapAll(functionExpression, mappers); } @Override public QueryExpression map(LetExpression letExpression) { return mapAll(letExpression, mappers); } @Override public QueryExpression map(SetExpression setExpression) { return mapAll(setExpression, mappers); } private static QueryExpression mapAll( QueryExpression expression, QueryExpressionMapper[] mappers) { QueryExpression expr = expression; for (int i = mappers.length - 1; i >= 0; i--) { expr = expr.getMapped(mappers[i]); } return expr; } } private static class IdentityMapper extends QueryExpressionMapper { private static final IdentityMapper INSTANCE = new IdentityMapper(); private IdentityMapper() { } @Override public QueryExpression map(TargetLiteral targetLiteral) { return targetLiteral; } @Override public QueryExpression map(BinaryOperatorExpression binaryOperatorExpression) { return binaryOperatorExpression; } @Override public QueryExpression map(FunctionExpression functionExpression) { return functionExpression; } @Override public QueryExpression map(LetExpression letExpression) { return letExpression; } @Override public QueryExpression map(SetExpression setExpression) { return setExpression; } } }