2 * Copyright (c) 2015 Cisco Systems, Inc. and others. All rights reserved.
4 * This program and the accompanying materials are made available under the
5 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6 * and is available at http://www.eclipse.org/legal/epl-v10.html
8 package org.opendaylight.yangtools.yang.data.api.schema.xpath;
10 import com.google.common.annotations.Beta;
11 import javax.annotation.Nonnull;
14 * Interface implemented by {@link XPathExpression}s which can be further optimized for execution efficiency at the
15 * expense of additional processing being performed on them. The decision to optimize a particular expression is left
16 * to the user's discretion.
18 * Implementations supporting profile-driven and similar optimizations which depend on data being gathered during
19 * evaluation should not implement this interface, but rather perform these optimizations transparently behind the
20 * scenes. That implies the users can expect those optimizations not interfering with the user's ability to evaluate
24 public interface OptimizableXPathExpression extends XPathExpression {
26 * Perform optimization of this expression. If an implementation supports different levels of optimization, it
27 * should return an {@link OptimizableXPathExpression} as a result of progressing optimizations for as long as
28 * it determines further processing can result in execution benefits. Note this expression is expected to remain
31 * @return An optimized version of this expression.
33 @Nonnull XPathExpression optimizeExpression();