com.hp.hpl.jena.rdf.model
Interface ModelMaker

All Superinterfaces:

ModelSpec

public interface ModelMaker

extends ModelSpec

A ModelMaker contains a collection of named models, methods for creating new models [both named and anonymous] and opening previously-named models, removing models, and accessing a single "default" Model for this Maker.

Author:

kers

Method Summary

void	close() Close the factory - no more requests need be honoured, and any clean-up can be done.
Model	createModel() Create a new anonymous Model, as per ModelSpec.
Model	createModel(java.lang.String name) Create a Model that does not already exist - equivalent to createModel( name, false ).
Model	createModel(java.lang.String name, boolean strict) Create a new Model associated with the given name.
GraphMaker	getGraphMaker() Answer a GraphMaker that makes graphs the same way this ModelMaker makes models.
Model	getModel() Answer the default Model for this Maker.
boolean	hasModel(java.lang.String name) return true iff the factory has a Model with the given name
ExtendedIterator	listModels() Answer an [extended] iterator where each element is the name of a model in the maker, and the complete sequence exhausts the set of names.
Model	openModel(java.lang.String name) Equivalent to openModel( name, false )
Model	openModel(java.lang.String name, boolean strict) Find an existing Model that this factory knows about under the given name.
void	removeModel(java.lang.String name) Remove the association between the name and the Model. create will now be able to create a Model with that name, and open will no longer be able to find it.

Methods inherited from interface com.hp.hpl.jena.rdf.model.ModelSpec

addDescription, createModelOver, getDescription, getDescription

Method Detail

createModel

public Model createModel(java.lang.String name,
                         boolean strict)

Create a new Model associated with the given name. If there is no such association, create one and return it. If one exists but strict is false, return the associated Model. Otherwise throw an AlreadyExistsException.

Parameters:

name - the name to give to the new Model

strict - true to cause existing bindings to throw an exception

Throws:

AlreadyExistsException - if that name is already bound.

createModel

public Model createModel(java.lang.String name)

Create a Model that does not already exist - equivalent to
createModel( name, false ).

createModel

public Model createModel()

Create a new anonymous Model, as per ModelSpec.

Specified by:

createModel in interface ModelSpec

Returns:

a fresh Model, not accessible under a[nother] name.

getModel

public Model getModel()

Answer the default Model for this Maker. Each call gets the same [or equivalent] model. The Model need not be created until the first such call.

Returns:

the default Model for this Maker.

openModel

public Model openModel(java.lang.String name,
                       boolean strict)

Find an existing Model that this factory knows about under the given name. If such a Model exists, return it. Otherwise, if strict is false, create a new Model, associate it with the name, and return it. Otherwise throw a DoesNotExistException.

Parameters:

name - the name of the Model to find and return

strict - false to create a new one if one doesn't already exist

Throws:

DoesNotExistException - if there's no such named Model

openModel

public Model openModel(java.lang.String name)

Equivalent to openModel( name, false )

removeModel

public void removeModel(java.lang.String name)

Remove the association between the name and the Model. create will now be able to create a Model with that name, and open will no longer be able to find it. Throws an exception if there's no such Model. The Model itself is not touched.

Parameters:

name - the name to disassociate

Throws:

DoesNotExistException - if the name is unbound

hasModel

public boolean hasModel(java.lang.String name)

return true iff the factory has a Model with the given name

Parameters:

name - the name of the Model to look for

Returns:

true iff there's a Model with that name

close

public void close()

Close the factory - no more requests need be honoured, and any clean-up can be done.

getGraphMaker

public GraphMaker getGraphMaker()

Answer a GraphMaker that makes graphs the same way this ModelMaker makes models. In general this will be an underlying GraphMaker.

listModels

public ExtendedIterator listModels()

Answer an [extended] iterator where each element is the name of a model in the maker, and the complete sequence exhausts the set of names. No particular order is expected from the list.

Returns:

an extended iterator over the names of models known to this Maker.