01: /******************************************************************
02: * File: ReasonerFactory.java
03: * Created by: Dave Reynolds
04: * Created on: 09-Jan-2003
05: *
06: * (c) Copyright 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
07: * [See end of file]
08: * $Id: ReasonerFactory.java,v 1.13 2008/01/02 12:07:00 andy_seaborne Exp $
09: *****************************************************************/package com.hp.hpl.jena.reasoner;
10:
11: import com.hp.hpl.jena.rdf.model.*;
12:
13: /**
14: * The interface through which a reasoner (inference engine) can be
15: * instantiated. Instances of this are registered with the global
16: * ReasonerRegistry.
17: *
18: * @author <a href="mailto:der@hplb.hpl.hp.com">Dave Reynolds</a>
19: * @version $Revision: 1.13 $ on $Date: 2008/01/02 12:07:00 $
20: */
21: public interface ReasonerFactory {
22:
23: /**
24: * Constructor method that builds an instance of the associated Reasoner
25: * @param configuration a set of arbitrary configuration information to be
26: * passed the reasoner, encoded as RDF properties of a base configuration resource,
27: * can be null in no custom configuration is required.
28: */
29: public Reasoner create(Resource configuration);
30:
31: /**
32: * Return a description of the capabilities of this reasoner encoded in
33: * RDF. These capabilities may be static or may depend on configuration
34: * information supplied at construction time. May be null if there are
35: * no useful capabilities registered.
36: */
37: public Model getCapabilities();
38:
39: /**
40: * Return the URI labelling this type of reasoner
41: */
42: public String getURI();
43: }
44:
45: /*
46: (c) Copyright 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
47: All rights reserved.
48:
49: Redistribution and use in source and binary forms, with or without
50: modification, are permitted provided that the following conditions
51: are met:
52:
53: 1. Redistributions of source code must retain the above copyright
54: notice, this list of conditions and the following disclaimer.
55:
56: 2. Redistributions in binary form must reproduce the above copyright
57: notice, this list of conditions and the following disclaimer in the
58: documentation and/or other materials provided with the distribution.
59:
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: */
|