org.ontoware.rdf2go.model

Interface ModelValueFactory

All Known Subinterfaces:

Model, ModelSet, PersistentModel

All Known Implementing Classes:

AbstractLockingModel, AbstractModel, AbstractModelSetImpl, DelegatingModel, DelegatingModelSet, DirtyAbstractModel, LoggingModel, LoggingModelSet, NotifyingModelLayer, NotifyingModelSetLayer, RepositoryModel, RepositoryModelSet

public interface ModelValueFactory

Factory-like parts of an RDF2Go-Model

Author:

voelkel

Method Summary

Modifier and Type	Method and Description
BlankNode	createBlankNode() Create (but do not add) a new blank node
BlankNode	createBlankNode(String internalID) Create a new blank node with the given internal ID.
DatatypeLiteral	createDatatypeLiteral(String literal, URI datatypeURI)
LanguageTagLiteral	createLanguageTagLiteral(String literal, String langugeTag)
PlainLiteral	createPlainLiteral(String literal) Create a new plain literal
Statement	createStatement(Resource subject, URI predicate, Node object) Create a new statement - but DOES NOT add it to the model
URI	createURI(String uriString) The model must create URIs it would accept itself.
boolean	isValidURI(String uriString) CHecks URI for syntax errors.
URI	newRandomUniqueURI() Implementations are free to choose if their semantics are unique within the this model, the ModelSet, or unique in the universe

Method Detail

createBlankNode

BlankNode createBlankNode()

Create (but do not add) a new blank node

Returns:

a new blank node

createBlankNode

BlankNode createBlankNode(String internalID)

Create a new blank node with the given internal ID. The id should be one returned from BlankNode.getInternalID().

Parameters:

internalID -

Returns:

a BlankNode with the given internal ID.

Throws:

UnsupportedOperationException - if the underlying store cannot create BlankNodes from IDs.

IllegalArgumentException - if the internalID could not be used

createURI

URI createURI(String uriString)
       throws IllegalArgumentException

The model must create URIs it would accept itself.

Returns:

a new URI from the given String

Throws:

IllegalArgumentException, - e.g. if URI is invalid

IllegalArgumentException

isValidURI

boolean isValidURI(String uriString)

CHecks URI for syntax errors.

Parameters:

uriString -

Returns:

true if the URI is valid for the given implementation

createPlainLiteral

PlainLiteral createPlainLiteral(String literal)

Create a new plain literal

Parameters:

literal -

Returns:

a PlainLiteral

createLanguageTagLiteral

LanguageTagLiteral createLanguageTagLiteral(String literal,
                                            String langugeTag)
                                     throws ModelRuntimeException

Parameters:

literal -

langugeTag -

Returns:

a LanguageTagLiteral

Throws:

ModelRuntimeException - e.g. if the language tag is malformed

createDatatypeLiteral

DatatypeLiteral createDatatypeLiteral(String literal,
                                      URI datatypeURI)
                               throws ModelRuntimeException

Parameters:

literal -

datatypeURI -

Returns:

a DatatypeLiteral

Throws:

ModelRuntimeException - e.g. if the datatype URI causes problems

createStatement

Statement createStatement(Resource subject,
                          URI predicate,
                          Node object)

Create a new statement - but DOES NOT add it to the model

Parameters:

subject -

predicate -

object -

Returns:

a Statement

newRandomUniqueURI

URI newRandomUniqueURI()

Implementations are free to choose if their semantics are unique within the this model, the ModelSet, or unique in the universe

Returns:

a new, unique URI