KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > hp > hpl > jena > reasoner > Finder


1 /******************************************************************
2  * File: Finder.java
3  * Created by: Dave Reynolds
4  * Created on: 18-Jan-03
5  *
6  * (c) Copyright 2003, 2004, 2005 Hewlett-Packard Development Company, LP
7  * [See end of file]
8  * $Id: Finder.java,v 1.7 2005/02/21 12:16:13 andy_seaborne Exp $
9  *****************************************************************/
10 package com.hp.hpl.jena.reasoner;
11
12 import com.hp.hpl.jena.util.iterator.ExtendedIterator;
13
14 /**
15  * Minimal interface for preforming simple pattern find operations.
16  * Should be implemented by reasoners, caches and related datastructures.
17  *
18  * @author <a HREF="mailto:der@hplb.hpl.hp.com">Dave Reynolds</a>
19  * @version $Revision: 1.7 $ on $Date: 2005/02/21 12:16:13 $
20  */
21 public interface Finder {
22
23     /**
24      * Basic pattern lookup interface.
25      * @param pattern a TriplePattern to be matched against the data
26      * @return a ClosableIterator over all Triples in the data set
27      * that match the pattern
28      */
29     public ExtendedIterator find(TriplePattern pattern);
30     
31     /**
32      * Extended find interface used in situations where the implementator
33      * may or may not be able to answer the complete query. It will
34      * attempt to answer the pattern but if its answers are not known
35      * to be complete then it will also pass the request on to the nested
36      * Finder to append more results.
37      * @param pattern a TriplePattern to be matched against the data
38      * @param continuation either a Finder or a normal Graph which
39      * will be asked for additional match results if the implementor
40      * may not have completely satisfied the query.
41      */
42     public ExtendedIterator findWithContinuation(TriplePattern pattern, Finder continuation);
43
44     /**
45      * Return true if the given pattern occurs somewhere in the find sequence.
46      */
47     public boolean contains(TriplePattern pattern);
48     
49 }
50
51 /*
52     (c) Copyright 2003, 2004, 2005 Hewlett-Packard Development Company, LP
53     All rights reserved.
54
55     Redistribution and use in source and binary forms, with or without
56     modification, are permitted provided that the following conditions
57     are met:
58
59     1. Redistributions of source code must retain the above copyright
60        notice, this list of conditions and the following disclaimer.
61
62     2. Redistributions in binary form must reproduce the above copyright
63        notice, this list of conditions and the following disclaimer in the
64        documentation and/or other materials provided with the distribution.
65
66     3. The name of the author may not be used to endorse or promote products
67        derived from this software without specific prior written permission.
68
69     THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
70     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
71     OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
72     IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
73     INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
74     NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
75     DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
76     THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
77     (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
78     THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
79 */
80
81
Popular Tags