org.apache.marmotta.kiwi.versioning.api

Interface VersioningSail

All Superinterfaces:

org.openrdf.sail.NotifyingSail, org.openrdf.sail.Sail, TransactionalSail

All Known Implementing Classes:

KiWiVersioningSail

public interface VersioningSail
extends TransactionalSail

A Sesame SAIL with support for versioning of transaction data. Allows querying for the versions of a repository (see Version).

Author: Sebastian Schaffert

Method Summary

Methods

Modifier and Type	Method and Description
org.openrdf.sail.SailConnection	getSnapshot(Date snapshotDate) Get a read-only snapshot of the repository at the given date.
org.openrdf.repository.RepositoryResult<Version>	listVersions() List all versions of this repository.
org.openrdf.repository.RepositoryResult<Version>	listVersions(Date from, Date to) List all versions of this repository between a start and end date.
org.openrdf.repository.RepositoryResult<Version>	listVersions(org.openrdf.model.Resource r) List all versions of this repository affecting the given resource as subject.
org.openrdf.repository.RepositoryResult<Version>	listVersions(org.openrdf.model.Resource r, Date from, Date to) List all versions of this repository affecting the given resource as subject between a start and end date.

Methods inherited from interface org.apache.marmotta.commons.sesame.transactions.api.TransactionalSail

addTransactionListener, isTransactionsEnabled, removeTransactionListener, setTransactionsEnabled

Methods inherited from interface org.openrdf.sail.NotifyingSail

addSailChangedListener, getConnection, removeSailChangedListener

Methods inherited from interface org.openrdf.sail.Sail

getDataDir, getValueFactory, initialize, isWritable, setDataDir, shutDown

Method Detail

listVersions

org.openrdf.repository.RepositoryResult<Version> listVersions()
                                                              throws org.openrdf.sail.SailException

List all versions of this repository.

Returns:

Throws:

org.openrdf.sail.SailException

listVersions

org.openrdf.repository.RepositoryResult<Version> listVersions(Date from,
                                                            Date to)
                                                              throws org.openrdf.sail.SailException

List all versions of this repository between a start and end date.

Returns:

Throws:

org.openrdf.sail.SailException

getSnapshot

org.openrdf.sail.SailConnection getSnapshot(Date snapshotDate)
                                            throws org.openrdf.sail.SailException

Get a read-only snapshot of the repository at the given date. Returns a sail connection that can be used to access the triple data. Any attempts to modify the underlying data will throw a SailReadOnlyException.

Parameters:

snapshotDate - the date of which to take the snapshot; the snapshot will consist of all triples that have been created before or at the date and deleted after that date (or not deleted at all).

Returns:

a read-only sail connection to access the data of the triple store at the given date

Throws:

org.openrdf.sail.SailException

listVersions

org.openrdf.repository.RepositoryResult<Version> listVersions(org.openrdf.model.Resource r)
                                                              throws org.openrdf.sail.SailException

List all versions of this repository affecting the given resource as subject.

Returns:

Throws:

org.openrdf.sail.SailException

listVersions

org.openrdf.repository.RepositoryResult<Version> listVersions(org.openrdf.model.Resource r,
                                                            Date from,
                                                            Date to)
                                                              throws org.openrdf.sail.SailException

List all versions of this repository affecting the given resource as subject between a start and end date.

Returns:

Throws:

org.openrdf.sail.SailException