01: /*
02: * $Id: XPathProcessor.java,v 1.3 2002/02/24 02:10:19 skavish Exp $
03: *
04: * ===========================================================================
05: *
06: * The JGenerator Software License, Version 1.0
07: *
08: * Copyright (c) 2000 Dmitry Skavish (skavish@usa.net). All rights reserved.
09: *
10: * Redistribution and use in source and binary forms, with or without
11: * modification, are permitted provided that the following conditions are met:
12: *
13: * 1. Redistributions of source code must retain the above copyright
14: * notice, this list of conditions and the following disclaimer.
15: *
16: * 2. Redistributions in binary form must reproduce the above copyright
17: * notice, this list of conditions and the following disclaimer in
18: * the documentation and/or other materials provided with the
19: * distribution.
20: *
21: * 3. The end-user documentation included with the redistribution, if
22: * any, must include the following acknowlegement:
23: * "This product includes software developed by Dmitry Skavish
24: * (skavish@usa.net, http://www.flashgap.com/)."
25: * Alternately, this acknowlegement may appear in the software itself,
26: * if and wherever such third-party acknowlegements normally appear.
27: *
28: * 4. The name "The JGenerator" must not be used to endorse or promote
29: * products derived from this software without prior written permission.
30: * For written permission, please contact skavish@usa.net.
31: *
32: * 5. Products derived from this software may not be called "The JGenerator"
33: * nor may "The JGenerator" appear in their names without prior written
34: * permission of Dmitry Skavish.
35: *
36: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39: * DISCLAIMED. IN NO EVENT SHALL DMITRY SKAVISH OR THE OTHER
40: * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47: * SUCH DAMAGE.
48: *
49: */
50:
51: package org.openlaszlo.iv.flash.xml;
52:
53: import java.util.Iterator;
54: import org.w3c.dom.*;
55: import javax.xml.transform.TransformerException;
56:
57: /**
58: * XPath processor
59: * <P>
60: * Provides various methods for XPath processing
61: *
62: * @author Dmitry Skavish
63: */
64: public interface XPathProcessor {
65:
66: /**
67: * Evaluates XPath to list of nodes.
68: *
69: * @param expr XPath expression
70: * @param node xml node to evaluated on
71: * @return result of xpath execution - iterator on nodes
72: * @exception Exception
73: */
74: public Iterator selectNodeList(String expr, Node node)
75: throws TransformerException;
76:
77: /**
78: * Evaluates XPath to one node.
79: *
80: * @param expr XPath expression
81: * @param node xml node to be evaluated on
82: * @return xml node
83: * @exception Exception
84: */
85: public Node selectSingleNode(String expr, Node node)
86: throws TransformerException;
87: }
|