org.apache.jackrabbit.core
Class RepositoryImpl

java.lang.Object
  org.apache.jackrabbit.core.RepositoryImpl

All Implemented Interfaces:

EventListener, JackrabbitRepository, Repository, SessionListener

public class RepositoryImpl

extends Object

implements JackrabbitRepository, SessionListener, EventListener

A RepositoryImpl ...

Nested Class Summary

protected class

RepositoryImpl.WorkspaceInfo WorkspaceInfo holds the objects that are shared among multiple per-session WorkspaceImpl instances representing the same named workspace, i.e.

Field Summary

static NodeId	NODETYPES_NODE_ID hardcoded id of the "/jcr:system/jcr:nodeTypes" node
protected RepositoryConfig	repConfig
static NodeId	ROOT_NODE_ID hardcoded id of the repository root node
static String	STATS_NODE_COUNT_PROPERTY
static String	STATS_PROP_COUNT_PROPERTY
static NodeId	SYSTEM_ROOT_NODE_ID hardcoded id of the "/jcr:system" node
static NodeId	VERSION_STORAGE_NODE_ID hardcoded id of the "/jcr:system/jcr:versionStorage" node

Fields inherited from interface javax.jcr.Repository

LEVEL_1_SUPPORTED, LEVEL_2_SUPPORTED, OPTION_LOCKING_SUPPORTED, OPTION_OBSERVATION_SUPPORTED, OPTION_QUERY_SQL_SUPPORTED, OPTION_TRANSACTIONS_SUPPORTED, OPTION_VERSIONING_SUPPORTED, QUERY_XPATH_DOC_ORDER, QUERY_XPATH_POS_INDEX, REP_NAME_DESC, REP_VENDOR_DESC, REP_VENDOR_URL_DESC, REP_VERSION_DESC, SPEC_NAME_DESC, SPEC_VERSION_DESC

Constructor Summary

protected

RepositoryImpl(RepositoryConfig repConfig) private constructor

Method Summary

protected void	acquireRepositoryLock() Lock the repository home.
static RepositoryImpl	create(RepositoryConfig config) Creates a new RepositoryImpl instance.
protected NamespaceRegistryImpl	createNamespaceRegistry(FileSystem fs) Creates the NamespaceRegistry instance.
protected NodeTypeRegistry	createNodeTypeRegistry(NamespaceRegistry nsReg, FileSystem fs) Creates the NodeTypeRegistry instance.
protected SessionImpl	createSession(AuthContext loginContext, String workspaceName) Creates a new repository session on the specified workspace for the authenticated subject of the given login context and adds it to the active sessions.
protected SessionImpl	createSession(Subject subject, String workspaceName) Creates a new repository session on the specified workspace for the given authenticated subject and adds it to the active sessions.
protected SessionImpl	createSessionInstance(AuthContext loginContext, WorkspaceConfig wspConfig) Creates an instance of the SessionImpl class representing a user authenticated by the loginContext instance attached to the workspace configured by the wspConfig.
protected SessionImpl	createSessionInstance(Subject subject, WorkspaceConfig wspConfig) Creates an instance of the SessionImpl class representing a user represented by the subject instance attached to the workspace configured by the wspConfig.
protected VersionManager	createVersionManager(VersioningConfig vConfig, DelegatingObservationDispatcher delegatingDispatcher) Creates the version manager.
protected void	createWorkspace(String workspaceName) Creates a workspace with the given name.
protected void	createWorkspace(String workspaceName, InputSource configTemplate) Creates a workspace with the given name and given workspace configuration template.
protected RepositoryImpl.WorkspaceInfo	createWorkspaceInfo(WorkspaceConfig wspConfig) Creates a new RepositoryImpl.WorkspaceInfo instance for wspConfig.
RepositoryConfig	getConfig() Returns the configuration of this repository.
String	getDescriptor(String key)
String[]	getDescriptorKeys()
protected RepositoryImpl.WorkspaceInfo	getWorkspaceInfo(String workspaceName) Returns the RepositoryImpl.WorkspaceInfo for the named workspace.
protected Properties	loadRepProps() Loads the repository properties by executing the following steps: if the #PROPERTIES_RESOURCE exists in the meta data store, the properties are loaded from that resource. setDefaultRepositoryProperties(Properties) is called afterwards in order to initialize/update the repository properties since some default properties might have changed and need updating. finally storeRepProps(Properties) is called in order to persist the newly generated properties.
protected NodeId	loadRootNodeId(FileSystem fs) Returns the root node uuid.
void	loggedOut(SessionImpl session) Called when a Session has been 'closed' by calling Session.logout()
void	loggingOut(SessionImpl session) Called when a Session is about to be 'closed' by calling Session.logout()
Session	login()
Session	login(Credentials credentials)
Session	login(Credentials credentials, String workspaceName)
Session	login(String workspaceName)
void	onEvent(EventIterator events)
protected void	releaseRepositoryLock() Release repository lock
protected void	sanityCheck() Performs a sanity check on this repository instance.
protected void	setDefaultRepositoryProperties(Properties props) Sets the default properties of the repository.
void	shutdown() Shuts down this repository.
protected void	storeRepProps(Properties props) Stores the properties to a persistent resource in the meta filesytem.

Methods inherited from class java.lang.Object

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

Field Detail

ROOT_NODE_ID

public static final NodeId ROOT_NODE_ID

hardcoded id of the repository root node

SYSTEM_ROOT_NODE_ID

public static final NodeId SYSTEM_ROOT_NODE_ID

hardcoded id of the "/jcr:system" node

VERSION_STORAGE_NODE_ID

public static final NodeId VERSION_STORAGE_NODE_ID

hardcoded id of the "/jcr:system/jcr:versionStorage" node

NODETYPES_NODE_ID

public static final NodeId NODETYPES_NODE_ID

hardcoded id of the "/jcr:system/jcr:nodeTypes" node

STATS_NODE_COUNT_PROPERTY

public static final String STATS_NODE_COUNT_PROPERTY

See Also:

Constant Field Values

STATS_PROP_COUNT_PROPERTY

public static final String STATS_PROP_COUNT_PROPERTY

See Also:

Constant Field Values

repConfig

protected final RepositoryConfig repConfig

Constructor Detail

RepositoryImpl

protected RepositoryImpl(RepositoryConfig repConfig)
                  throws RepositoryException

private constructor

Parameters:

repConfig -

Method Detail

createVersionManager

protected VersionManager createVersionManager(VersioningConfig vConfig,
                                              DelegatingObservationDispatcher delegatingDispatcher)
                                       throws RepositoryException

Creates the version manager.

Parameters:

vConfig - the versioning config

Returns:

the newly created version manager

Throws:

RepositoryException - if an error occurrs

acquireRepositoryLock

protected void acquireRepositoryLock()
                              throws RepositoryException

Lock the repository home.

Throws:

RepositoryException - if the repository lock can not be acquired

releaseRepositoryLock

protected void releaseRepositoryLock()

Release repository lock

loadRootNodeId

protected NodeId loadRootNodeId(FileSystem fs)
                         throws RepositoryException

Returns the root node uuid.

Parameters:

fs -

Returns:

Throws:

RepositoryException

createNamespaceRegistry

protected NamespaceRegistryImpl createNamespaceRegistry(FileSystem fs)
                                                 throws RepositoryException

Creates the NamespaceRegistry instance.

Parameters:

fs -

Returns:

Throws:

RepositoryException

createNodeTypeRegistry

protected NodeTypeRegistry createNodeTypeRegistry(NamespaceRegistry nsReg,
                                                  FileSystem fs)
                                           throws RepositoryException

Creates the NodeTypeRegistry instance.

Parameters:

fs -

Returns:

Throws:

RepositoryException

create

public static RepositoryImpl create(RepositoryConfig config)
                             throws RepositoryException

Creates a new RepositoryImpl instance.

Parameters:

config - the configuration of the repository

Returns:

a new RepositoryImpl instance

Throws:

RepositoryException - If an error occurs

sanityCheck

protected void sanityCheck()
                    throws IllegalStateException

Performs a sanity check on this repository instance.

Throws:

IllegalStateException - if this repository has been rendered invalid for some reason (e.g. if it has been shut down)

getWorkspaceInfo

protected RepositoryImpl.WorkspaceInfo getWorkspaceInfo(String workspaceName)
                                                 throws IllegalStateException,
                                                        NoSuchWorkspaceException

Returns the RepositoryImpl.WorkspaceInfo for the named workspace.

Parameters:

workspaceName - The name of the workspace whose RepositoryImpl.WorkspaceInfo is to be returned. This must not be null.

Returns:

The RepositoryImpl.WorkspaceInfo for the named workspace. This will never be null.

Throws:

IllegalStateException - If this repository has already been shut down.

NoSuchWorkspaceException - If the named workspace does not exist.

createWorkspace

protected void createWorkspace(String workspaceName)
                        throws RepositoryException

Creates a workspace with the given name.

Parameters:

workspaceName - name of the new workspace

Throws:

RepositoryException - if a workspace with the given name already exists or if another error occurs

See Also:

SessionImpl.createWorkspace(String)

createWorkspace

protected void createWorkspace(String workspaceName,
                               InputSource configTemplate)
                        throws RepositoryException

Creates a workspace with the given name and given workspace configuration template.

Parameters:

workspaceName - name of the new workspace

configTemplate - the workspace configuration template of the new workspace

Throws:

RepositoryException - if a workspace with the given name already exists or if another error occurs

See Also:

SessionImpl.createWorkspace(String,InputSource)

createSession

protected final SessionImpl createSession(AuthContext loginContext,
                                          String workspaceName)
                                   throws NoSuchWorkspaceException,
                                          AccessDeniedException,
                                          RepositoryException

Creates a new repository session on the specified workspace for the authenticated subject of the given login context and adds it to the active sessions.

Calls createSessionInstance(AuthContext, WorkspaceConfig) to create the actual SessionImpl instance.

Parameters:

loginContext - login context with authenticated subject

workspaceName - workspace name

Returns:

a new session

Throws:

NoSuchWorkspaceException - if the specified workspace does not exist

AccessDeniedException - if the subject of the given login context is not granted access to the specified workspace

RepositoryException - if another error occurs

createSession

protected final SessionImpl createSession(Subject subject,
                                          String workspaceName)
                                   throws NoSuchWorkspaceException,
                                          AccessDeniedException,
                                          RepositoryException

Creates a new repository session on the specified workspace for the given authenticated subject and adds it to the active sessions.

Calls createSessionInstance(Subject, WorkspaceConfig) to create the actual SessionImpl instance.

Parameters:

subject - authenticated subject

workspaceName - workspace name

Returns:

a new session

Throws:

NoSuchWorkspaceException - if the specified workspace does not exist

AccessDeniedException - if the subject of the given login context is not granted access to the specified workspace

RepositoryException - if another error occurs

shutdown

public void shutdown()

Shuts down this repository.

Specified by:

shutdown in interface JackrabbitRepository

getConfig

public RepositoryConfig getConfig()

Returns the configuration of this repository.

Returns:

repository configuration

setDefaultRepositoryProperties

protected void setDefaultRepositoryProperties(Properties props)
                                       throws RepositoryException

Sets the default properties of the repository.

This method loads the Properties from the org/apache/jackrabbit/core/repository.properties resource found in the class path and (re)sets the statistics properties, if not present.

Parameters:

props - the properties object to load

Throws:

RepositoryException - if the properties can not be loaded

loadRepProps

protected Properties loadRepProps()
                           throws RepositoryException

Loads the repository properties by executing the following steps:

• if the #PROPERTIES_RESOURCE exists in the meta data store, the properties are loaded from that resource.
• setDefaultRepositoryProperties(Properties) is called afterwards in order to initialize/update the repository properties since some default properties might have changed and need updating.
• finally storeRepProps(Properties) is called in order to persist the newly generated properties.

Returns:

the newly loaded/initialized repository properties

Throws:

RepositoryException

storeRepProps

protected void storeRepProps(Properties props)
                      throws RepositoryException

Stores the properties to a persistent resource in the meta filesytem.

Throws:

RepositoryException

login

public Session login(Credentials credentials,
                     String workspaceName)
              throws LoginException,
                     NoSuchWorkspaceException,
                     RepositoryException

Specified by:

login in interface Repository

Throws:

LoginException

NoSuchWorkspaceException

RepositoryException

login

public Session login(String workspaceName)
              throws LoginException,
                     NoSuchWorkspaceException,
                     RepositoryException

Specified by:

login in interface Repository

Throws:

LoginException

NoSuchWorkspaceException

RepositoryException

login

public Session login()
              throws LoginException,
                     RepositoryException

Specified by:

login in interface Repository

Throws:

LoginException

RepositoryException

login

public Session login(Credentials credentials)
              throws LoginException,
                     RepositoryException

Specified by:

login in interface Repository

Throws:

LoginException

RepositoryException

getDescriptor

public String getDescriptor(String key)

Specified by:

getDescriptor in interface Repository

getDescriptorKeys

public String[] getDescriptorKeys()

Specified by:

getDescriptorKeys in interface Repository

loggingOut

public void loggingOut(SessionImpl session)

Called when a Session is about to be 'closed' by calling Session.logout()

Specified by:

loggingOut in interface SessionListener

Parameters:

session - the Session that is about to be 'closed'

loggedOut

public void loggedOut(SessionImpl session)

Called when a Session has been 'closed' by calling Session.logout()

Specified by:

loggedOut in interface SessionListener

Parameters:

session - the Session that has been 'closed'

onEvent

public void onEvent(EventIterator events)

Specified by:

onEvent in interface EventListener

createSessionInstance

protected SessionImpl createSessionInstance(AuthContext loginContext,
                                            WorkspaceConfig wspConfig)
                                     throws AccessDeniedException,
                                            RepositoryException

Creates an instance of the SessionImpl class representing a user authenticated by the loginContext instance attached to the workspace configured by the wspConfig.

Throws:

AccessDeniedException - if the subject of the given login context is not granted access to the specified workspace

RepositoryException - If any other error occurrs creating the session.

createSessionInstance

protected SessionImpl createSessionInstance(Subject subject,
                                            WorkspaceConfig wspConfig)
                                     throws AccessDeniedException,
                                            RepositoryException

Creates an instance of the SessionImpl class representing a user represented by the subject instance attached to the workspace configured by the wspConfig.

Throws:

AccessDeniedException - if the subject of the given login context is not granted access to the specified workspace

RepositoryException - If any other error occurrs creating the session.

createWorkspaceInfo

protected RepositoryImpl.WorkspaceInfo createWorkspaceInfo(WorkspaceConfig wspConfig)

Creates a new RepositoryImpl.WorkspaceInfo instance for wspConfig.

Parameters:

wspConfig - the workspace configuration.

Returns:

a new WorkspaceInfo instance.