com.bigdata.gom.om

Interface IObjectManager

All Superinterfaces:

INativeTransaction

All Known Implementing Classes:

NanoSparqlObjectManager, ObjectManager, ObjectMgrModel

public interface IObjectManager
extends INativeTransaction

The object manager is the abstraction for a connection the back end.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Close the object manager, which terminates its connection with the backing store.
IGPO	createGPO() The ObjectManager is able to assign automatic ids for a new object.
ICloseableIterator<org.openrdf.query.BindingSet>	evaluate(String queryStr)
ICloseableIterator<org.openrdf.model.Statement>	evaluateGraph(String query)
void	execute(String updateStr)
IGPO	getGPO(org.openrdf.model.Resource id) Return a canonical IGPO for the Resource (canonical within the scope of this object manager) and never null.
IGPO	getGPO(org.openrdf.model.Statement stmt)
Iterator<WeakReference<IGPO>>	getGPOs() An iterator that visits the weak reference values in the running object table.
UUID	getID() Deprecated. Why do we need this? It should be hidden in how we generate URIs, not part of the public API.
Iterator<org.openrdf.model.URI>	getNames() Deprecated.
BigdataValueFactory	getValueFactory() The value factory for the KB instance associated with this object manager view.
Map<org.openrdf.model.Resource,IGPO>	initGPOs(ICloseableIterator<org.openrdf.model.Statement> itr) Partially materialize IGPOs from a stream of Statements.
boolean	isPersistent() Return true iff the object manager is backed by some persistence layer.
void	materialize(IGPO gpo) Ensure Statements are materialized for gpo's Resource: DESCRIBE ?s.
org.openrdf.model.Value	recall(org.openrdf.model.URI key) Deprecated.
IGPO	recallAsGPO(org.openrdf.model.URI key)
void	remove(IGPO gpo) Remove all assertions involving the specified object.
void	save(org.openrdf.model.URI key, org.openrdf.model.Value value) Deprecated.

Methods inherited from interface com.bigdata.gom.om.INativeTransaction

beginNativeTransaction, commitNativeTransaction, getNativeTransactionCounter, rollbackNativeTransaction

Method Detail

getID

UUID getID()

Deprecated. Why do we need this? It should be hidden in how we generate URIs, not part of the public API.

Returns:

the UUID that identifies this ObjectManager

getGPO

IGPO getGPO(org.openrdf.model.Resource id)

Return a canonical IGPO for the Resource (canonical within the scope of this object manager) and never null.

Parameters:

id - The Resource.

Returns:

The IGPO.

See Also:

IGPO.getId()

getGPO

IGPO getGPO(org.openrdf.model.Statement stmt)

initGPOs

Map<org.openrdf.model.Resource,IGPO> initGPOs(ICloseableIterator<org.openrdf.model.Statement> itr)

Partially materialize IGPOs from a stream of Statements.

Parameters:

itr - The Statements.

Returns:

A hard reference collection that will keep the any materialized IGPOs from being finalized before the caller has a chance to do something with them.

getGPOs

Iterator<WeakReference<IGPO>> getGPOs()

An iterator that visits the weak reference values in the running object table. You must test each weak reference in order to determine whether its value has been cleared as of the moment that you request that value. The entries visited by the iterator are not "touched" so the use of the iterator will not cause them to be retained any longer than they otherwise would have been retained. TODO We could do one-step look ahead and buffer a hard reference to the next IGPO to be visited. That would allow us to eliminate the WeakReference from this method signature.

materialize

void materialize(IGPO gpo)

Ensure Statements are materialized for gpo's Resource: DESCRIBE ?s.

close

void close()

Close the object manager, which terminates its connection with the backing store. Any open concurrent or nested/native transactions are flushed to the store. The object manager can not be used after it has been closed.

Throws:

IllegalStateException - if the store is already closed.

isPersistent

boolean isPersistent()

Return true iff the object manager is backed by some persistence layer.

getValueFactory

BigdataValueFactory getValueFactory()

The value factory for the KB instance associated with this object manager view.

evaluate

ICloseableIterator<org.openrdf.query.BindingSet> evaluate(String queryStr)

execute

void execute(String updateStr)

evaluateGraph

ICloseableIterator<org.openrdf.model.Statement> evaluateGraph(String query)

createGPO

IGPO createGPO()

The ObjectManager is able to assign automatic ids for a new object. These will be of the form "gpo:#[genid]"

Returns:

a new GPO

save

@Deprecated
void save(org.openrdf.model.URI key,
                   org.openrdf.model.Value value)

Deprecated.

Simple save/recall interface that the ObjectManager provides to simplify other pattern implementations. Internally it uses a NameManager GPO

recall

@Deprecated
org.openrdf.model.Value recall(org.openrdf.model.URI key)

Deprecated.

Simple save/recall interface that the ObjectManager provides to simplify other pattern implementations. Internally it uses a NameManager GPO

recallAsGPO

IGPO recallAsGPO(org.openrdf.model.URI key)

getNames

@Deprecated
Iterator<org.openrdf.model.URI> getNames()

Deprecated.

Return the list of names that have been used to save references. These are the properties of the internal NameManager.

remove

void remove(IGPO gpo)

Remove all assertions involving the specified object.