Class LocalRepositoryManager
java.lang.Object
org.eclipse.rdf4j.repository.manager.RepositoryManager
org.eclipse.rdf4j.repository.manager.LocalRepositoryManager
- All Implemented Interfaces:
HttpClientDependent
,RepositoryResolver
- Direct Known Subclasses:
NotifyingLocalRepositoryManager
An implementation of the
RepositoryManager
interface that operates directly on the repository data files in
the local file system.-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final File
The base dir to resolve any relative paths against.private static final WriterConfig
private static final String
private SharedHttpClientSessionManager
dependent life cycleprivate static final RDFFormat
static final String
private SPARQLServiceResolver
dependent life cycleFields inherited from class org.eclipse.rdf4j.repository.manager.RepositoryManager
initializedRepositories, logger, NAMESPACE, PROXIED_ID
-
Constructor Summary
ConstructorsConstructorDescriptionLocalRepositoryManager
(File baseDir) Creates a new RepositoryManager that operates on the specfified base directory. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addRepositoryConfig
(RepositoryConfig config) Adds or updates the configuration of a repository to the manager.protected Repository
Creates and initializes the repository with the specified ID.private Repository
Creates the stack of Repository objects for the repository represented by the specifiedRepositoryImplConfig
.Retrieve meta information of all configured repositories.Gets the base dir against which to resolve relative paths.protected FederatedServiceResolver
org.apache.http.client.HttpClient
HttpClient
that has been assigned or has been used by this object.Gets the base dir against which to resolve relative paths.getRepositoryDir
(String repositoryID) Gets the repository that is known by the specified ID from this manager.protected SharedHttpClientSessionManager
boolean
removeRepository
(String repositoryID) Removes the specified repository by deleting its configuration if such a configuration is present, and removing any persistent data associated with the repository.resolvePath
(String path) Resolves the specified path against the manager's base directory.void
setHttpClient
(org.apache.http.client.HttpClient httpClient) Should be called beforeRepositoryManager.init()
.void
shutDown()
Shuts down all initialized repositories.Methods inherited from class org.eclipse.rdf4j.repository.manager.RepositoryManager
getAllRepositories, getAllRepositoryInfos, getAllUserRepositoryInfos, getInitializedRepositories, getInitializedRepository, getInitializedRepositoryIDs, getModelFactory, getNewRepositoryID, getRepository, getRepositoryIDs, hasRepositoryConfig, init, isInitialized, isSafeToRemove, refresh, refreshRepository, removeInitializedRepository, setInitializedRepositories, setModelFactory, updateInitializedRepositories
-
Field Details
-
REPOSITORIES_DIR
- See Also:
-
CONFIG_FORMAT
-
CFG_FILE
-
CFG_CONFIG
-
baseDir
The base dir to resolve any relative paths against. -
client
dependent life cycle -
serviceResolver
dependent life cycle
-
-
Constructor Details
-
LocalRepositoryManager
Creates a new RepositoryManager that operates on the specfified base directory.- Parameters:
baseDir
- The base directory where data for repositories can be stored, among other things.
-
-
Method Details
-
getBaseDir
Gets the base dir against which to resolve relative paths. -
getLocation
Gets the base dir against which to resolve relative paths.- Specified by:
getLocation
in classRepositoryManager
- Throws:
MalformedURLException
- If the path cannot be parsed as a URL
-
getSesameClient
- Returns:
- Returns the httpClient.
-
getHttpClient
public org.apache.http.client.HttpClient getHttpClient()Description copied from interface:HttpClientDependent
HttpClient
that has been assigned or has been used by this object. The life cycle might not be or might be tied to this object, depending on whetherHttpClient
was passed to or created by this object respectively.- Specified by:
getHttpClient
in interfaceHttpClientDependent
- Specified by:
getHttpClient
in classRepositoryManager
- Returns:
- Returns the httpClient passed to
Repository
construction.
-
setHttpClient
public void setHttpClient(org.apache.http.client.HttpClient httpClient) Description copied from class:RepositoryManager
Should be called beforeRepositoryManager.init()
.- Specified by:
setHttpClient
in interfaceHttpClientDependent
- Specified by:
setHttpClient
in classRepositoryManager
- Parameters:
httpClient
- The httpClient to use for remote/service calls.
-
getFederatedServiceResolver
- Returns:
- Returns the serviceResolver.
-
shutDown
public void shutDown()Description copied from class:RepositoryManager
Shuts down all initialized repositories.- Overrides:
shutDown
in classRepositoryManager
- See Also:
-
resolvePath
Resolves the specified path against the manager's base directory.- See Also:
-
getRepositoryDir
-
createRepository
protected Repository createRepository(String id) throws RepositoryConfigException, RepositoryException Description copied from class:RepositoryManager
Creates and initializes the repository with the specified ID.- Specified by:
createRepository
in classRepositoryManager
- Parameters:
id
- A repository ID.- Returns:
- The created and initialized repository, or null if no such repository exists.
- Throws:
RepositoryConfigException
- If no repository could be created due to invalid or incomplete configuration data.RepositoryException
- If the repository could not be initialized.
-
createRepositoryStack
private Repository createRepositoryStack(RepositoryImplConfig config) throws RepositoryConfigException Creates the stack of Repository objects for the repository represented by the specifiedRepositoryImplConfig
. Uses aRepositoryFactory
to create the repository and initialize it.- Parameters:
config
- The node representing the to-be-created repository in the configuration.- Returns:
- The created repository, or null if no such repository exists.
- Throws:
RepositoryConfigException
- If no repository could be created due to invalid or incomplete configuration data.
-
getRepositoryConfig
- Specified by:
getRepositoryConfig
in classRepositoryManager
-
getRepositoryInfo
Description copied from class:RepositoryManager
Gets the repository that is known by the specified ID from this manager.- Overrides:
getRepositoryInfo
in classRepositoryManager
- Parameters:
id
- A repository ID.- Returns:
- A Repository object, or null if no repository was known for the specified ID.
-
getAllRepositoryInfos
Description copied from class:RepositoryManager
Retrieve meta information of all configured repositories.- Specified by:
getAllRepositoryInfos
in classRepositoryManager
- Returns:
- a collection of
RepositoryInfo
objects - Throws:
RepositoryException
- if the repository meta information could not be retrieved.
-
addRepositoryConfig
public void addRepositoryConfig(RepositoryConfig config) throws RepositoryException, RepositoryConfigException Description copied from class:RepositoryManager
Adds or updates the configuration of a repository to the manager. The manager may already contain a configuration for a repository with the same ID as specified by config, in which case all previous configuration data for that repository will be cleared before the new configuration is added.- Specified by:
addRepositoryConfig
in classRepositoryManager
- Parameters:
config
- The repository configuration that should be added to or updated in the manager.- Throws:
RepositoryException
- If the manager failed to update.RepositoryConfigException
- If the manager doesn't know how to update a configuration due to inconsistent configuration data. For example, this happens when there are multiple existing configurations with the concerning ID.
-
removeRepository
public boolean removeRepository(String repositoryID) throws RepositoryException, RepositoryConfigException Description copied from class:RepositoryManager
Removes the specified repository by deleting its configuration if such a configuration is present, and removing any persistent data associated with the repository. Returns true if the specified repository configuration was actually present. NB this operation can not be undone!- Overrides:
removeRepository
in classRepositoryManager
- Parameters:
repositoryID
- The ID of the repository that needs to be removed.- Throws:
RepositoryException
- If the manager failed to update the configuration.RepositoryConfigException
- If the manager doesn't know how to remove a repository due to inconsistent configuration data. For example, this can happen when there are multiple existing configurations with the concerning ID.
-