com.hp.hpl.jena.rdf.model
Class ModelFactory

java.lang.Object
  extended by com.hp.hpl.jena.rdf.model.ModelFactoryBase
      extended by com.hp.hpl.jena.rdf.model.ModelFactory

public class ModelFactory
extends ModelFactoryBase

ModelFactory provides methods for creating standard kinds of Model. (ModelFactoryBase is helper functions for it).


Field Summary
static ReificationStyle Convenient
          Deprecated. All models are ReificationStyle.Standard by default and there is no other supported style.
static ReificationStyle Minimal
          Deprecated. All models are ReificationStyle.Standard by default and there is no other supported style.
static ReificationStyle Standard
          Deprecated. All models are ReificationStyle.Standard by default and there is no other supported style.
 
Method Summary
static Model assembleModelFrom(Model singleRoot)
          Answer a Model constructed from the single resource in singleRoot of type ja:Model.
static Model assembleModelFrom(Resource root)
          Answer a Model as described the the Assembler specification rooted at the Resource root in its Model.
static Model createDefaultModel()
          Answer a fresh Model with the default specification.
static Model createDefaultModel(ReificationStyle style)
          Deprecated. Hidden partial reifications not supported -- only style "Standard"
static ModelMaker createFileModelMaker(String root)
          Answer a ModelMaker that constructs memory-based Models that are backed by files in the root directory.
static ModelMaker createFileModelMaker(String root, ReificationStyle style)
          Deprecated. 
static InfModel createInfModel(InfGraph g)
          Build an inference model from an InfGraph.
static InfModel createInfModel(Reasoner reasoner, Model model)
          Build an inferred model by attaching the given RDF model to the given reasoner.
static InfModel createInfModel(Reasoner reasoner, Model schema, Model model)
          Build an inferred model by attaching the given RDF model to the given reasoner.
static ModelMaker createMemModelMaker()
          Answer a ModelMaker that constructs memory-based Models that do not persist past JVM termination.
static ModelMaker createMemModelMaker(ReificationStyle style)
          Deprecated. Hidden partial reifications not support -- only style "Standard"
static Model createModelForGraph(Graph g)
          Answer a model that encapsulates the given graph.
static Model createNonreifyingModel()
          Deprecated. All models are ReificationStyle.Standard by default and there is no other supported style.
static OntModel createOntologyModel()
           Answer a new ontology model which will process in-memory models of ontologies expressed the default ontology language (OWL).
static OntModel createOntologyModel(OntModelSpec spec)
          Answer a new ontology model constructed according to the specification, which includes a ModelMaker which will create the necessary base model.
static OntModel createOntologyModel(OntModelSpec spec, Model base)
           Answer a new ontology model, constructed according to the given ontology model specification, and starting with the ontology data in the given model.
static OntModel createOntologyModel(OntModelSpec spec, ModelMaker maker, Model base)
           Answer a new ontology model which will process in-memory models of ontologies expressed the default ontology language (OWL).
static OntModel createOntologyModel(String languageURI)
           Answer a new ontology model which will process in-memory models of ontologies in the given language.
static InfModel createRDFSModel(Model model)
          Return a Model through which all the RDFS entailments derivable from the given model are accessible.
static InfModel createRDFSModel(Model schema, Model model)
          Return a Model through which all the RDFS entailments derivable from the given data and schema models are accessible.
static Model createUnion(Model m1, Model m2)
          Answer a new model that is the dynamic union of two other models.
static Set<Resource> findAssemblerRoots(Model m)
          Answer a Set of resources present in m that are explicitly or implicitly of type ja:Object, ie, suitable as roots for assemblerModelFrom.
static PrefixMapping getDefaultModelPrefixes()
          Answer the current default model prefixes PrefixMapping object.
static PrefixMapping setDefaultModelPrefixes(PrefixMapping pm)
          Each Model created by ModelFactory has a default set of prefix mappings.
static Model withHiddenStatements(Model m)
          Deprecated. Hidden partial reifications not supported -- only style "Standard"
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

Standard

@Deprecated
public static final ReificationStyle Standard
Deprecated. All models are ReificationStyle.Standard by default and there is no other supported style.
The standard reification style; quadlets contribute to reified statements, and are visible to listStatements().


Convenient

@Deprecated
public static final ReificationStyle Convenient
Deprecated. All models are ReificationStyle.Standard by default and there is no other supported style.
The convenient reification style; quadlets contribute to reified statements, but are invisible to listStatements().


Minimal

@Deprecated
public static final ReificationStyle Minimal
Deprecated. All models are ReificationStyle.Standard by default and there is no other supported style.
The minimal reification style; quadlets do not contribute to reified statements, and are visible to listStatements().

Method Detail

setDefaultModelPrefixes

public static PrefixMapping setDefaultModelPrefixes(PrefixMapping pm)
Each Model created by ModelFactory has a default set of prefix mappings. These mappings are copied from a (static) default PrefixMapping which is set by setDefaultModelPrefixes. It is the reference to a PrefixMapping that is retained, not a copy of it, so a user may set the defaults with this method and continue to modify it; the modifications will appear in the next model to be created.

When a Model is created from an existing Graph, the prefixes of that Graph are not disturbed; only ones not present in the Graph are added.

Parameters:
pm - the default prefixes to use
Returns:
the previous default prefix mapping

getDefaultModelPrefixes

public static PrefixMapping getDefaultModelPrefixes()
Answer the current default model prefixes PrefixMapping object.


assembleModelFrom

public static Model assembleModelFrom(Model singleRoot)
Answer a Model constructed from the single resource in singleRoot of type ja:Model. See the Assembler howto (doc/assembler/assembler-howto.html) for documentation of Assembler descriptions. See also findAssemblerRoots to find the set of possible roots in a description, and assemblerModelFrom(Resource) for assembling a model from its single description.


findAssemblerRoots

public static Set<Resource> findAssemblerRoots(Model m)
Answer a Set of resources present in m that are explicitly or implicitly of type ja:Object, ie, suitable as roots for assemblerModelFrom. Note that the resource objects returned need not have m as their getModel() - they may be members of an extended constructed model.


assembleModelFrom

public static Model assembleModelFrom(Resource root)
Answer a Model as described the the Assembler specification rooted at the Resource root in its Model. Resource must be of rdf:type ja:Object, where ja is the prefix of Jena Assembler objects.


createDefaultModel

public static Model createDefaultModel()
Answer a fresh Model with the default specification.


createDefaultModel

@Deprecated
public static Model createDefaultModel(ReificationStyle style)
Deprecated. Hidden partial reifications not supported -- only style "Standard"

Answer a new memory-based model with the given reification style


withHiddenStatements

@Deprecated
public static Model withHiddenStatements(Model m)
Deprecated. Hidden partial reifications not supported -- only style "Standard"

Answer a read-only Model with all the statements of this Model and any statements "hidden" by reification. That model is dynamic, ie any changes this model will be reflected that one.


createNonreifyingModel

@Deprecated
public static Model createNonreifyingModel()
Deprecated. All models are ReificationStyle.Standard by default and there is no other supported style.

construct a new memory-based model that does not capture reification triples (but still handles reifyAs() and .as(ReifiedStatement).


createModelForGraph

public static Model createModelForGraph(Graph g)
Answer a model that encapsulates the given graph. Existing prefixes are undisturbed.

Parameters:
g - A graph structure
Returns:
A model presenting an API view of graph g

createFileModelMaker

public static ModelMaker createFileModelMaker(String root)
Answer a ModelMaker that constructs memory-based Models that are backed by files in the root directory. The Model is loaded from the file when it is opened, and when the Model is closed it is written back.

Parameters:
root - the name of the directory in which the backing files are held
Returns:
a ModelMaker linked to the files in the root

createFileModelMaker

@Deprecated
public static ModelMaker createFileModelMaker(String root,
                                                         ReificationStyle style)
Deprecated. 

Answer a ModelMaker that constructs memory-based Models that are backed by files in the root directory. The Model is loaded from the file when it is opened, and when the Model is closed it is written back.

Parameters:
root - the name of the directory in which the backing files are held
style - the desired reification style
Returns:
a ModelMaker linked to the files in the root

createMemModelMaker

public static ModelMaker createMemModelMaker()
Answer a ModelMaker that constructs memory-based Models that do not persist past JVM termination.

Returns:
a ModelMaker that constructs memory-based models

createMemModelMaker

@Deprecated
public static ModelMaker createMemModelMaker(ReificationStyle style)
Deprecated. Hidden partial reifications not support -- only style "Standard"

Answer a ModelMaker that constructs memory-based Models that do not persist past JVM termination, with the given reification style.

Parameters:
style - the reification style for the model
Returns:
a ModelMaker that constructs memory-based models

createRDFSModel

public static InfModel createRDFSModel(Model model)
Return a Model through which all the RDFS entailments derivable from the given model are accessible. Some work is done when the inferenced model is created but each query will also trigger some additional inference work.

Parameters:
model - the Model containing both instance data and schema assertions to be inferenced over

createRDFSModel

public static InfModel createRDFSModel(Model schema,
                                       Model model)
Return a Model through which all the RDFS entailments derivable from the given data and schema models are accessible. There is no strict requirement to separate schema and instance data between the two arguments.

Parameters:
model - a Model containing instance data assertions
schema - a Model containing RDFS schema data

createInfModel

public static InfModel createInfModel(Reasoner reasoner,
                                      Model model)
Build an inferred model by attaching the given RDF model to the given reasoner.

Parameters:
reasoner - the reasoner to use to process the data
model - the Model containing both instance data and schema assertions to be inferenced over, any statements added to the InfModel will be added to this underlying data model.

createInfModel

public static InfModel createInfModel(Reasoner reasoner,
                                      Model schema,
                                      Model model)
Build an inferred model by attaching the given RDF model to the given reasoner. This form of the call allows two data sets to be merged and reasoned over - conventionally one contains schema data and one instance data but this is not a formal requirement.

Parameters:
reasoner - the reasoner to use to process the data
schema - a Model containing RDFS schema data
model - a Model containing instance data assertions, any statements added to the InfModel will be added to this underlying data model.

createInfModel

public static InfModel createInfModel(InfGraph g)
Build an inference model from an InfGraph. Graphs and InfGraphs are internal implementation level objects rather than normal user objects so this method should only be used if you are sure this is what you need.

Parameters:
g - and inference graph
Returns:
the same graph wrapped up as an InfModel

createOntologyModel

public static OntModel createOntologyModel()

Answer a new ontology model which will process in-memory models of ontologies expressed the default ontology language (OWL). The default document manager will be used to load the ontology's included documents.

Note:The default model chosen for OWL and RDFS includes a weak reasoner that includes some entailments (such as transitive closure on the sub-class and sub-property hierarchies). Users who want either no inference at all, or alternatively more complete reasoning, should use one of the other createOntologyModel methods that allow the preferred OntModel specification to be stated.

Returns:
A new ontology model
See Also:
OntModelSpec.getDefaultSpec(java.lang.String), createOntologyModel(OntModelSpec, Model)

createOntologyModel

public static OntModel createOntologyModel(String languageURI)

Answer a new ontology model which will process in-memory models of ontologies in the given language. The default document manager will be used to load the ontology's included documents.

Parameters:
languageURI - The URI specifying the ontology language we want to process
Returns:
A new ontology model
See Also:
OntModelSpec.getDefaultSpec(java.lang.String)

createOntologyModel

public static OntModel createOntologyModel(OntModelSpec spec,
                                           ModelMaker maker,
                                           Model base)

Answer a new ontology model which will process in-memory models of ontologies expressed the default ontology language (OWL). The default document manager will be used to load the ontology's included documents.

Parameters:
spec - An ontology model specification that defines the language and reasoner to use
maker - A model maker that is used to get the initial store for the ontology (unless the base model is given), and create addtional stores for the models in the imports closure
base - The base model, which contains the contents of the ontology to be processed
Returns:
A new ontology model
See Also:
OntModelSpec

createOntologyModel

public static OntModel createOntologyModel(OntModelSpec spec,
                                           Model base)

Answer a new ontology model, constructed according to the given ontology model specification, and starting with the ontology data in the given model.

Parameters:
spec - An ontology model specification object, that will be used to construct the ontology model with different options of ontology language, reasoner, document manager and storage model
base - An existing model to treat as an ontology model, or null.
Returns:
A new ontology model
See Also:
OntModelSpec

createOntologyModel

public static OntModel createOntologyModel(OntModelSpec spec)
Answer a new ontology model constructed according to the specification, which includes a ModelMaker which will create the necessary base model.


createUnion

public static Model createUnion(Model m1,
                                Model m2)
Answer a new model that is the dynamic union of two other models. By dynamic union, we mean that changes to either m1 or m2 will be reflected in the result model, and vice versa: specifically, additions to and removals from the union will be implemented as operations on m1 only. See also the behaviour of OntModel and the MultiUnion class.

createUnion only creates two-element unions.



Licenced under the Apache License, Version 2.0