001: /******************************************************************
002: * File: GenericRuleReasonerFactory.java
003: * Created by: Dave Reynolds
004: * Created on: 08-Jun-2003
005: *
006: * (c) Copyright 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
007: * [See end of file]
008: * $Id: GenericRuleReasonerFactory.java,v 1.13 2008/01/02 12:07:47 andy_seaborne Exp $
009: *****************************************************************/package com.hp.hpl.jena.reasoner.rulesys;
010:
011: import com.hp.hpl.jena.rdf.model.*;
012: import com.hp.hpl.jena.reasoner.*;
013: import com.hp.hpl.jena.vocabulary.ReasonerVocabulary;
014:
015: /**
016: * Factory object for creating general rule reasoner instances. The
017: * specific rule set and mode confriguration can be set either be method
018: * calls to the created reasoner or though parameters in the configuration Model.
019: *
020: * @author <a href="mailto:der@hplb.hpl.hp.com">Dave Reynolds</a>
021: * @version $Revision: 1.13 $ on $Date: 2008/01/02 12:07:47 $
022: */
023: public class GenericRuleReasonerFactory implements ReasonerFactory {
024:
025: /** Single global instance of this factory */
026: private static GenericRuleReasonerFactory theInstance = new GenericRuleReasonerFactory();
027:
028: /** Static URI for this reasoner type */
029: public static final String URI = "http://jena.hpl.hp.com/2003/GenericRuleReasoner";
030:
031: /** Cache of the capabilities description */
032: protected Model capabilities;
033:
034: /**
035: * Return the single global instance of this factory
036: */
037: public static GenericRuleReasonerFactory theInstance() {
038: return theInstance;
039: }
040:
041: /**
042: * Constructor method that builds an instance of the associated Reasoner
043: * @param configuration a set of arbitrary configuration information to be
044: * passed the reasoner, encoded as RDF properties of a base configuration resource,
045: * can be null in no custom configuration is required.
046: */
047: public Reasoner create(Resource configuration) {
048: return new GenericRuleReasoner(this , configuration);
049: }
050:
051: /**
052: * Return a description of the capabilities of this reasoner encoded in
053: * RDF. This method is normally called by the ReasonerRegistry which caches
054: * the resulting information so dynamically creating here is not really an overhead.
055: */
056: public Model getCapabilities() {
057: if (capabilities == null) {
058: capabilities = ModelFactory.createDefaultModel();
059: Resource base = capabilities.createResource(getURI());
060: base.addProperty(ReasonerVocabulary.nameP,
061: "Generic Rule Reasoner").addProperty(
062: ReasonerVocabulary.descriptionP,
063: "Generic rule reasoner, configurable").addProperty(
064: ReasonerVocabulary.versionP, "0.1");
065: }
066: return capabilities;
067: }
068:
069: /**
070: * Return the URI labelling this type of reasoner
071: */
072: public String getURI() {
073: return URI;
074: }
075:
076: }
077:
078: /*
079: (c) Copyright 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
080: All rights reserved.
081:
082: Redistribution and use in source and binary forms, with or without
083: modification, are permitted provided that the following conditions
084: are met:
085:
086: 1. Redistributions of source code must retain the above copyright
087: notice, this list of conditions and the following disclaimer.
088:
089: 2. Redistributions in binary form must reproduce the above copyright
090: notice, this list of conditions and the following disclaimer in the
091: documentation and/or other materials provided with the distribution.
092:
093: 3. The name of the author may not be used to endorse or promote products
094: derived from this software without specific prior written permission.
095:
096: THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
097: IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
098: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
099: IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
100: INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
101: NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
102: DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
103: THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
104: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
105: THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
106: */
|