org.modeshape.jcr

Class JcrRepositoryManager

java.lang.Object

org.modeshape.jcr.JcrRepositoryManager

All Implemented Interfaces:

RepositoryManager

public class JcrRepositoryManager
extends Object
implements RepositoryManager

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JcrRepositoryManager(org.modeshape.jcr.JcrWorkspace workspace)

Method Summary

Modifier and Type	Method and Description
Problems	backupRepository(File backupDirectory) Begin a backup operation of the entire repository, writing the files associated with the backup to the specified directory on the local file system.
Problems	backupRepository(File backupDirectory, BackupOptions backupOptions) Begin a backup operation of the entire repository, writing the files associated with the backup to the specified directory on the local file system.
JcrRepositoryMonitor	getRepositoryMonitor() A RepositoryMonitor object represents a monitoring view of the Session's Repository instance.
org.modeshape.jcr.JcrWorkspace	getWorkspace() Return the Workspace object through which this repository manager was created.
Problems	restoreRepository(File backupDirectory) Begin a restore operation of the entire repository, reading the backup files in the specified directory on the local file system.
Problems	restoreRepository(File backupDirectory, RestoreOptions options) Begin a restore operation of the entire repository, reading the backup files in the specified directory on the local file system.

Methods inherited from class java.lang.Object

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

Constructor Detail

JcrRepositoryManager

protected JcrRepositoryManager(org.modeshape.jcr.JcrWorkspace workspace)

Method Detail

getWorkspace

public org.modeshape.jcr.JcrWorkspace getWorkspace()

Description copied from interface: RepositoryManager

Return the Workspace object through which this repository manager was created.

Specified by:

getWorkspace in interface RepositoryManager

Returns:

the @ Workspace} object.

getRepositoryMonitor

public JcrRepositoryMonitor getRepositoryMonitor()
                                          throws RepositoryException

Description copied from interface: RepositoryManager

A RepositoryMonitor object represents a monitoring view of the Session's Repository instance. This is useful for applications that embed a JCR repository and need a way to monitor the health, status and performance of that Repository instance. Each RepositoryMonitor object is associated one-to-one with a Session object and is defined by the authorization settings of that session object.

The RepositoryMonitor object can be acquired using a Session by calling Session.getWorkspace().getRepositoryMonitor() on a session object.

Specified by:

getRepositoryMonitor in interface RepositoryManager

Returns:

the repository monitor; never null

Throws:

RepositoryException - if there is a problem obtaining the monitory

backupRepository

public Problems backupRepository(File backupDirectory)
                          throws RepositoryException

Description copied from interface: RepositoryManager

Begin a backup operation of the entire repository, writing the files associated with the backup to the specified directory on the local file system.

The repository must be active when this operation is invoked, and it can continue to be used during backup (e.g., this can be a "live" backup operation), but this is not recommended if the backup will be used as part of a migration to a different version of ModeShape or to different installation.

Multiple backup operations can operate at the same time, so it is the responsibility of the caller to not overload the repository with backup operations.

Specified by:

backupRepository in interface RepositoryManager

Parameters:

backupDirectory - the directory on the local file system into which all backup files will be written; this directory need not exist, but the process must have write privilege for this directory

Returns:

the problems that occurred during the backup operation

Throws:

AccessDeniedException - if the current session does not have sufficient privileges to perform the backup

RepositoryException - if the backup cannot be run

backupRepository

public Problems backupRepository(File backupDirectory,
                                 BackupOptions backupOptions)
                          throws RepositoryException

Description copied from interface: RepositoryManager

Begin a backup operation of the entire repository, writing the files associated with the backup to the specified directory on the local file system.

The repository must be active when this operation is invoked, and it can continue to be used during backup (e.g., this can be a "live" backup operation), but this is not recommended if the backup will be used as part of a migration to a different version of ModeShape or to different installation.

Multiple backup operations can operate at the same time, so it is the responsibility of the caller to not overload the repository with backup operations.

Specified by:

backupRepository in interface RepositoryManager

Parameters:

backupDirectory - the directory on the local file system into which all backup files will be written; this directory need not exist, but the process must have write privilege for this directory

backupOptions - a BackupOptions instance which can be used for more fine-grained control of the elements that are backed up.

Returns:

the problems that occurred during the backup operation

Throws:

AccessDeniedException - if the current session does not have sufficient privileges to perform the backup

RepositoryException - if the backup cannot be run

restoreRepository

public Problems restoreRepository(File backupDirectory)
                           throws RepositoryException

Description copied from interface: RepositoryManager

Begin a restore operation of the entire repository, reading the backup files in the specified directory on the local file system. Upon completion of the restore operation, the repository will be restarted automatically.

The repository must be active when this operation is invoked. However, the repository may not be used by any other activities during the restore operation; doing so will likely result in a corrupt repository.

It is the responsibility of the caller to ensure that this method is only invoked once; calling multiple times wil lead to a corrupt repository.

Specified by:

restoreRepository in interface RepositoryManager

Parameters:

backupDirectory - the directory on the local file system in which all backup files exist and were written by a previous backup operation; this directory must exist, and the process must have read privilege for all contents in this directory

Returns:

the problems that occurred during the restore operation

Throws:

AccessDeniedException - if the current session does not have sufficient privileges to perform the restore

RepositoryException - if the restoration cannot be run

restoreRepository

public Problems restoreRepository(File backupDirectory,
                                  RestoreOptions options)
                           throws RepositoryException

Description copied from interface: RepositoryManager

Begin a restore operation of the entire repository, reading the backup files in the specified directory on the local file system. Upon completion of the restore operation, the repository will be restarted automatically.

The repository must be active when this operation is invoked. However, the repository may not be used by any other activities during the restore operation; doing so will likely result in a corrupt repository.

It is the responsibility of the caller to ensure that this method is only invoked once; calling multiple times wil lead to a corrupt repository.

Specified by:

restoreRepository in interface RepositoryManager

Parameters:

backupDirectory - the directory on the local file system in which all backup files exist and were written by a previous backup operation; this directory must exist, and the process must have read privilege for all contents in this directory

options - a RestoreOptions instance which can be used to control the elements and the behavior of the restore process.

Returns:

the problems that occurred during the restore operation

Throws:

AccessDeniedException - if the current session does not have sufficient privileges to perform the restore

RepositoryException - if the restoration cannot be run