Class InterceptingRepositoryWrapper
- java.lang.Object
-
- org.eclipse.rdf4j.repository.base.RepositoryWrapper
-
- org.eclipse.rdf4j.repository.event.base.InterceptingRepositoryWrapper
-
- All Implemented Interfaces:
DelegatingRepository,InterceptingRepository,Repository
public class InterceptingRepositoryWrapper extends RepositoryWrapper implements InterceptingRepository
Wrapper that notifies interceptors of events on Repositories before they happen. Any interceptor can block the operation by returning true from the relevant notification method. To do so will also cause the notification process to stop, i.e. no other interceptors will be notified. The order in which interceptors are notified is unspecified.- Author:
- Herko ter Horst
- See Also:
InterceptingRepositoryConnectionWrapper
-
-
Constructor Summary
Constructors Constructor Description InterceptingRepositoryWrapper()InterceptingRepositoryWrapper(Repository delegate)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddRepositoryConnectionInterceptor(RepositoryConnectionInterceptor interceptor)Registers a RepositoryConnectionInterceptor that will receive notifications of operations that are performed on any connections that are created by this repository.voidaddRepositoryInterceptor(RepositoryInterceptor interceptor)Registers a RepositoryInterceptor that will receive notifications of operations that are performed on this repository.InterceptingRepositoryConnectiongetConnection()Opens a connection to this repository that can be used for querying and updating the contents of the repository.voidinit()Initializes this repository.voidremoveRepositoryConnectionInterceptor(RepositoryConnectionInterceptor interceptor)Removes a registered RepositoryConnectionInterceptor from this repository.voidremoveRepositoryInterceptor(RepositoryInterceptor interceptor)Removes a registered RepositoryInterceptor from this repository.voidsetDataDir(File dataDir)Set the directory where data and logging for this repository is stored.voidshutDown()Shuts the repository down, releasing any resources that it keeps hold of.-
Methods inherited from class org.eclipse.rdf4j.repository.base.RepositoryWrapper
getDataDir, getDelegate, getValueFactory, isInitialized, isWritable, setDelegate, toString
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.eclipse.rdf4j.repository.Repository
getDataDir, getValueFactory, isInitialized, isWritable
-
-
-
-
Constructor Detail
-
InterceptingRepositoryWrapper
public InterceptingRepositoryWrapper()
-
InterceptingRepositoryWrapper
public InterceptingRepositoryWrapper(Repository delegate)
-
-
Method Detail
-
addRepositoryInterceptor
public void addRepositoryInterceptor(RepositoryInterceptor interceptor)
Registers a RepositoryInterceptor that will receive notifications of operations that are performed on this repository.- Specified by:
addRepositoryInterceptorin interfaceInterceptingRepository
-
removeRepositoryInterceptor
public void removeRepositoryInterceptor(RepositoryInterceptor interceptor)
Removes a registered RepositoryInterceptor from this repository.- Specified by:
removeRepositoryInterceptorin interfaceInterceptingRepository
-
addRepositoryConnectionInterceptor
public void addRepositoryConnectionInterceptor(RepositoryConnectionInterceptor interceptor)
Registers a RepositoryConnectionInterceptor that will receive notifications of operations that are performed on any connections that are created by this repository.- Specified by:
addRepositoryConnectionInterceptorin interfaceInterceptingRepository
-
removeRepositoryConnectionInterceptor
public void removeRepositoryConnectionInterceptor(RepositoryConnectionInterceptor interceptor)
Removes a registered RepositoryConnectionInterceptor from this repository.- Specified by:
removeRepositoryConnectionInterceptorin interfaceInterceptingRepository
-
getConnection
public InterceptingRepositoryConnection getConnection() throws RepositoryException
Description copied from interface:RepositoryOpens a connection to this repository that can be used for querying and updating the contents of the repository. Created connections need to be closed to make sure that any resources they keep hold of are released. The best way to do this is to use a try-with-resources block, as follows:try (RepositoryConnection conn = repository.getConnection()) { // perform operations on the connection }Note that
RepositoryConnectionis not guaranteed to be thread-safe! The recommended pattern for repository access in a multi-threaded application is to share the Repository object between threads, but have each thread create and use its ownRepositoryConnections.- Specified by:
getConnectionin interfaceRepository- Overrides:
getConnectionin classRepositoryWrapper- Returns:
- A connection that allows operations on this repository.
- Throws:
RepositoryException- If something went wrong during the creation of the Connection.
-
init
public void init() throws RepositoryExceptionDescription copied from interface:RepositoryInitializes this repository. A repository needs to be initialized before it can be used, however explicitly calling this method is not necessary: the repository will automatically initialize itself if an operation is executed on it that requires it to be initialized.- Specified by:
initin interfaceRepository- Overrides:
initin classRepositoryWrapper- Throws:
RepositoryException- If the initialization failed.
-
setDataDir
public void setDataDir(File dataDir)
Description copied from interface:RepositorySet the directory where data and logging for this repository is stored.- Specified by:
setDataDirin interfaceRepository- Overrides:
setDataDirin classRepositoryWrapper- Parameters:
dataDir- the directory where data for this repository is stored
-
shutDown
public void shutDown() throws RepositoryExceptionDescription copied from interface:RepositoryShuts the repository down, releasing any resources that it keeps hold of. Once shut down, the repository can no longer be used until it is re-initialized.- Specified by:
shutDownin interfaceRepository- Overrides:
shutDownin classRepositoryWrapper- Throws:
RepositoryException
-
-