KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > hp > hpl > jena > rdql > QueryExecution


1 /*
2  * (c) Copyright 2001, 2002, 2003, 2004, 2005 Hewlett-Packard Development Company, LP
3  * [See end of file]
4  */
5
6 package com.hp.hpl.jena.rdql;
7
8 /** Interface for query execution engines.
9  * The normal sequence is:
10  * <code>
11  * QueryExecution qe = new .... ;
12  * qe.init() ;
13  * QueryResults qres = qe.exec() ;
14  * ....
15  * qres.close() ;
16  * qe.end() ;
17  * </code>
18  *
19  * @see QueryEngine
20  *
21  * @author Andy Seaborne
22  * @version $Id: QueryExecution.java,v 1.8 2005/02/21 12:15:24 andy_seaborne Exp $
23  */
24
25
26 public interface QueryExecution
27 {
28     /** Initialise a query execution. Should be called before exec. */
29     public void init();
30
31     /** Do it! */
32     public QueryResults exec();
33
34     /** Do a query, given an initial starting set of bindings*/
35     //public QueryResults exec(ResultBindingImpl startBinding) ;
36
37     /** Stop in mid execution.
38      * No guarantee that the concrete implementation actual will stop or
39      * that it will do so immediately.
40      */
41
42     public void abort();
43
44     /** Normal end of use of this execution */
45     public void close();
46 }
47
48 /*
49  * (c) Copyright 2001, 2002, 2003, 2004, 2005 Hewlett-Packard Development Company, LP
50  * All rights reserved.
51  *
52  * Redistribution and use in source and binary forms, with or without
53  * modification, are permitted provided that the following conditions
54  * are met:
55  * 1. Redistributions of source code must retain the above copyright
56  * notice, this list of conditions and the following disclaimer.
57  * 2. Redistributions in binary form must reproduce the above copyright
58  * notice, this list of conditions and the following disclaimer in the
59  * documentation and/or other materials provided with the distribution.
60  * 3. The name of the author may not be used to endorse or promote products
61  * derived from this software without specific prior written permission.
62  *
63  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
64  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
65  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
66  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
67  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
68  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
69  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
70  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
71  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
72  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
73  */
74
Popular Tags