modelspec.java

Jena推理机

/*
  (c) Copyright 2003, 2004, 2005, 2006, 2007 Hewlett-Packard Development Company, LP
  [See end of file]
  $Id: ModelSpec.java,v 1.19 2007/01/02 11:48:34 andy_seaborne Exp $
*/

package com.hp.hpl.jena.rdf.model;

/**
    A ModelSpec allows Models to be created.
    
 	@author kers
    @deprecated in favour of the Assembler system
*/
public interface ModelSpec extends ModelSource
    {    
    /**
        Answer a Model that fits the specification of this ModelSpec and is built over some
        underlying model with the given name. [It is not necessary for the resulting model
        to be known by that name.]
        
        <p>NOTE: this method is likely to become deprecated, and then deleted, absent
        user pressure to retain it.
    */
    Model createModelOver( String name );
    
    /**
        A specialisation of ModelSource::openModel( String ). ModelSpecs will
        return the same Model when given the same String argument.
        
        @see com.hp.hpl.jena.rdf.model.ModelSource#openModel(java.lang.String)
    */
    Model openModel( String name );
    
    /**
        Open the "default" model. Do not create one.
    */
    Model openModel();
    
    /**
        Answer an RDF description of this ModelSpec using the JenaModelSpec vocabulary. The
        description root will be a freshly-created bnode.
    */
    Model getDescription();
    
    /**
        Answer an RDF description of this ModelSpec using the JenaModelSpec vocabulary, with
        the given Resource as root.
        
        @param root the resource to be used for all the top-level properties
        @return a description of this ModelSpec
    */
    Model getDescription( Resource root );
    
    /**
        Add this ModelSpec's description to a given model, under the given resource
        @param m the model to which the description is to be added
        @param self the resource to which the properties are to be added
        @return the model m (for cascading and convenience)
    */
    Model addDescription( Model m, Resource self );
    }


/*
    (c) Copyright 2003, 2004, 2005, 2006, 2007 Hewlett-Packard Development Company, LP
    All rights reserved.

    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions
    are met:

    1. Redistributions of source code must retain the above copyright
       notice, this list of conditions and the following disclaimer.

    2. Redistributions in binary form must reproduce the above copyright
       notice, this list of conditions and the following disclaimer in the
       documentation and/or other materials provided with the distribution.

    3. The name of the author may not be used to endorse or promote products
       derived from this software without specific prior written permission.

    THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
    OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
    IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
    THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/