19f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/*
29f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Licensed to the Apache Software Foundation (ASF) under one
39f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * or more contributor license agreements. See the NOTICE file
49f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * distributed with this work for additional information
59f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * regarding copyright ownership. The ASF licenses this file
69f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * to you under the Apache License, Version 2.0 (the  "License");
79f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * you may not use this file except in compliance with the License.
89f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * You may obtain a copy of the License at
99f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson *
109f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson *     http://www.apache.org/licenses/LICENSE-2.0
119f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson *
129f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Unless required by applicable law or agreed to in writing, software
139f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * distributed under the License is distributed on an "AS IS" BASIS,
149f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
159f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * See the License for the specific language governing permissions and
169f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * limitations under the License.
179f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */
189f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/*
199f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * $Id: XPathVisitable.java 468655 2006-10-28 07:12:06Z minchau $
209f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */
219f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonpackage org.apache.xpath;
229f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson
239f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/**
249f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * A class that implements this interface will call a XPathVisitor
259f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * for itself and members within it's heararchy.  If the XPathVisitor's
269f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * method returns false, the sub-member heararchy will not be
279f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * traversed.
289f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */
299f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonpublic interface XPathVisitable
309f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson{
319f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	/**
329f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	 * This will traverse the heararchy, calling the visitor for
339f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	 * each member.  If the called visitor method returns
349f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	 * false, the subtree should not be called.
359f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	 *
369f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	 * @param owner The owner of the visitor, where that path may be
379f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	 *              rewritten if needed.
389f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	 * @param visitor The visitor whose appropriate method will be called.
399f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	 */
409f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson	public void callVisitors(ExpressionOwner owner, XPathVisitor visitor);
419f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson}
429f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson
43