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

public class LocalRepositoryManager
extends RepositoryManager

An implementation of the RepositoryManager interface that operates directly on the repository data files in the local file system.

Field Summary

Fields

Modifier and Type	Field	Description
private final File	baseDir	The base dir to resolve any relative paths against.
private static final WriterConfig	CFG_CONFIG
private static final String	CFG_FILE
private SharedHttpClientSessionManager	client	dependent life cycle
private static final RDFFormat	CONFIG_FORMAT
static final String	REPOSITORIES_DIR
private SPARQLServiceResolver	serviceResolver	dependent life cycle

Fields inherited from class RepositoryManager

initializedRepositories, logger, NAMESPACE, PROXIED_ID

Constructor Summary

Constructors

Constructor	Description
LocalRepositoryManager(File baseDir)	Creates a new RepositoryManager that operates on the specfified base directory.

Method Summary

Modifier and Type	Method	Description
void	addRepositoryConfig(RepositoryConfig config)	Adds or updates the configuration of a repository to the manager.
protected Repository	createRepository(String id)	Creates and initializes the repository with the specified ID.
private Repository	createRepositoryStack(RepositoryImplConfig config)	Creates the stack of Repository objects for the repository represented by the specified RepositoryImplConfig.
List<RepositoryInfo>	getAllRepositoryInfos()	Retrieve meta information of all configured repositories.
File	getBaseDir()	Gets the base dir against which to resolve relative paths.
protected FederatedServiceResolver	getFederatedServiceResolver()
org.apache.http.client.HttpClient	getHttpClient()	HttpClient that has been assigned or has been used by this object.
URL	getLocation()	Gets the base dir against which to resolve relative paths.
RepositoryConfig	getRepositoryConfig(String id)
File	getRepositoryDir(String repositoryID)
RepositoryInfo	getRepositoryInfo(String id)	Gets the repository that is known by the specified ID from this manager.
protected SharedHttpClientSessionManager	getSesameClient()
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.
File	resolvePath(String path)	Resolves the specified path against the manager's base directory.
void	setHttpClient(org.apache.http.client.HttpClient httpClient)	Should be called before RepositoryManager.init().
void	shutDown()	Shuts down all initialized repositories.

Methods inherited from class RepositoryManager

getAllRepositories, getAllRepositoryInfos, getAllUserRepositoryInfos, getInitializedRepositories, getInitializedRepository, getInitializedRepositoryIDs, getModelFactory, getNewRepositoryID, getRepository, getRepositoryIDs, hasRepositoryConfig, init, isInitialized, isSafeToRemove, refresh, refreshRepository, removeInitializedRepository, setInitializedRepositories, setModelFactory, updateInitializedRepositories

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

REPOSITORIES_DIR

public static final String REPOSITORIES_DIR

See Also:

• Constant Field Values

CONFIG_FORMAT

private static final RDFFormat CONFIG_FORMAT

CFG_FILE

private static final String CFG_FILE

CFG_CONFIG

private static final WriterConfig CFG_CONFIG

baseDir

private final File baseDir

The base dir to resolve any relative paths against.

client

private volatile SharedHttpClientSessionManager client

dependent life cycle

serviceResolver

private volatile SPARQLServiceResolver serviceResolver

dependent life cycle

Constructor Details

LocalRepositoryManager

public LocalRepositoryManager(File baseDir)

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

public File getBaseDir()

Gets the base dir against which to resolve relative paths.

getLocation

public URL getLocation()
                throws MalformedURLException

Gets the base dir against which to resolve relative paths.

Specified by:

getLocation in class RepositoryManager

Throws:

MalformedURLException - If the path cannot be parsed as a URL

getSesameClient

protected SharedHttpClientSessionManager 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 whether HttpClient was passed to or created by this object respectively.

Specified by:

getHttpClient in interface HttpClientDependent

Specified by:

getHttpClient in class RepositoryManager

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 before RepositoryManager.init().

Specified by:

setHttpClient in interface HttpClientDependent

Specified by:

setHttpClient in class RepositoryManager

Parameters:

httpClient - The httpClient to use for remote/service calls.

getFederatedServiceResolver

protected FederatedServiceResolver getFederatedServiceResolver()

Returns:

Returns the serviceResolver.

shutDown

public void shutDown()

Description copied from class: RepositoryManager

Shuts down all initialized repositories.

Overrides:

shutDown in class RepositoryManager

See Also:

• RepositoryManager.refresh()

resolvePath

public File resolvePath(String path)

Resolves the specified path against the manager's base directory.

See Also:

• getBaseDir()

getRepositoryDir

public File getRepositoryDir(String repositoryID)

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 class RepositoryManager

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 specified RepositoryImplConfig. Uses a RepositoryFactory 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

public RepositoryConfig getRepositoryConfig(String id)

Specified by:

getRepositoryConfig in class RepositoryManager

getRepositoryInfo

public RepositoryInfo getRepositoryInfo(String id)

Description copied from class: RepositoryManager

Gets the repository that is known by the specified ID from this manager.

Overrides:

getRepositoryInfo in class RepositoryManager

Parameters:

id - A repository ID.

Returns:

A Repository object, or null if no repository was known for the specified ID.

getAllRepositoryInfos

public List<RepositoryInfo> getAllRepositoryInfos()
                                           throws RepositoryException

Description copied from class: RepositoryManager

Retrieve meta information of all configured repositories.

Specified by:

getAllRepositoryInfos in class RepositoryManager

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 class RepositoryManager

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 class RepositoryManager

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.