KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > hp > hpl > jena > util > xml > SimpleXMLPathComponent


1 /*****************************************************************************
2  * Source code information
3  * -----------------------
4  * Original author Ian Dickinson, HP Labs Bristol
5  * Author email ian.dickinson@hp.com
6  * Package Jena 2
7  * Web http://sourceforge.net/projects/jena/
8  * Created 04-Dec-2003
9  * Filename $RCSfile: SimpleXMLPathComponent.java,v $
10  * Revision $Revision: 1.3 $
11  * Release status $State: Exp $
12  *
13  * Last modified on $Date: 2005/02/21 12:20:40 $
14  * by $Author: andy_seaborne $
15  *
16  * (c) Copyright 2001, 2002, 2003, 2004, 2005 Hewlett-Packard Development Company, LP
17  * [See end of file]
18  *****************************************************************************/
19
20 // Package
21 ///////////////
22 package com.hp.hpl.jena.util.xml;
23
24
25
26 // Imports
27 ///////////////
28 import org.w3c.dom.*;
29
30 import java.util.*;
31
32
33 /**
34  * <p>
35  * General interface for components of a simple XML path structure.
36  * </p>
37  *
38  * @author Ian Dickinson, HP Labs (<a HREF="mailto:Ian.Dickinson@hp.com" >email</a>)
39  * @version CVS $Id: SimpleXMLPathComponent.java,v 1.3 2005/02/21 12:20:40 andy_seaborne Exp $
40  */
41 public interface SimpleXMLPathComponent
42 {
43     // Constants
44 //////////////////////////////////
45
46     // External signature methods
47 //////////////////////////////////
48
49     /**
50      * <p>Answer an iterator over all of the values of this path component when
51      * evaluated with respect to the given node.</p>
52      * @param node The parent node to evaluate against
53      * @return An iterator over all of the objects that correspond to evaluating
54      * this path against the given node.
55      */
56     public Iterator getAll( Node node );
57     
58     /**
59      * <p>Answer the first value for this path expression against the given node.</p>
60      * @param node The parent node to evalauate against
61      * @return The first object that corresponds to evaluating
62      * this path against the given node, or null if there is no such value
63      */
64     public Object JavaDoc getFirst( Node node );
65 }
66
67
68 /*
69  * (c) Copyright 2001, 2002, 2003, 2004, 2005 Hewlett-Packard Development Company, LP
70  * All rights reserved.
71  *
72  * Redistribution and use in source and binary forms, with or without
73  * modification, are permitted provided that the following conditions
74  * are met:
75  * 1. Redistributions of source code must retain the above copyright
76  * notice, this list of conditions and the following disclaimer.
77  * 2. Redistributions in binary form must reproduce the above copyright
78  * notice, this list of conditions and the following disclaimer in the
79  * documentation and/or other materials provided with the distribution.
80  * 3. The name of the author may not be used to endorse or promote products
81  * derived from this software without specific prior written permission.
82  *
83  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
84  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
85  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
86  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
87  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
88  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
89  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
90  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
91  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
92  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
93  */
94
Popular Tags