public abstract class AbstractRepositoryService extends Object implements RepositoryService
AbstractRepositoryService
provides an abstract base class for
repository service implementations. This class provides default
implementations for the following methods:
Modifier and Type | Field and Description |
---|---|
protected Map<String,QValue[]> |
descriptors
The repository descriptors.
|
protected NamespaceMapping |
namespaces
The fixed set of namespaces known to the repository service.
|
protected NodeTypeStorage |
nodeTypeDefs
The fixed set of node type definitions known to the repository service.
|
protected QNodeDefinition |
rootNodeDefinition
The node definition of the root node.
|
Modifier | Constructor and Description |
---|---|
protected |
AbstractRepositoryService() |
|
AbstractRepositoryService(Map<String,QValue[]> descriptors,
Map<String,String> namespaces,
QNodeTypeDefinition[] nodeTypeDefs) |
|
AbstractRepositoryService(Map<String,QValue[]> descriptors,
Map<String,String> namespaces,
Reader cnd) |
Modifier and Type | Method and Description |
---|---|
void |
addVersionLabel(SessionInfo sessionInfo,
NodeId versionHistoryId,
NodeId versionId,
Name label,
boolean moveLabel)
Add the given version label in the persistent layer.
|
protected void |
checkCredentials(javax.jcr.Credentials credentials,
String workspaceName)
Checks if the given
credentials are valid. |
NodeId |
checkin(SessionInfo sessionInfo,
NodeId nodeId)
Performs a checkin for the
Node identified by the given
NodeId . |
void |
checkout(SessionInfo sessionInfo,
NodeId nodeId)
Performs a checkout for the
Node identified by the given
NodeId . |
void |
checkout(SessionInfo sessionInfo,
NodeId nodeId,
NodeId activityId)
Performs a checkout for the
Node identified by the given
NodeId and for activity identified by the specified
activityId . |
NodeId |
checkpoint(SessionInfo sessionInfo,
NodeId nodeId)
Performs a checkpoint for the
Node identified by the given
NodeId . |
NodeId |
checkpoint(SessionInfo sessionInfo,
NodeId nodeId,
NodeId activityId)
Performs a checkpoint for the
Node identified by the given
NodeId . |
String[] |
checkQueryStatement(SessionInfo sessionInfo,
String statement,
String language,
Map<String,String> namespaces)
Checks if the query
statement is valid according to the
specified query language and returns the bind variable
names found in the query statement. |
protected void |
checkSessionInfo(SessionInfo sessionInfo)
Checks the type of the
sessionInfo instance. |
protected void |
checkWorkspace(String workspaceName)
Checks if the given workspace is available.
|
void |
clone(SessionInfo sessionInfo,
String srcWorkspaceName,
NodeId srcNodeId,
NodeId destParentNodeId,
Name destName,
boolean removeExisting)
Clone the subtree identified by the given
srcNodeId
in workspace named srcWorkspaceName to the destination
in the workspace specified by the given SessionInfo . |
void |
copy(SessionInfo sessionInfo,
String srcWorkspaceName,
NodeId srcNodeId,
NodeId destParentNodeId,
Name destName)
Clone the subtree identified by the given
srcNodeId
in workspace named srcWorkspaceName to the destination
in the workspace specified by the given SessionInfo . |
NodeId |
createActivity(SessionInfo sessionInfo,
String title)
Create a new activity.
|
Batch |
createBatch(SessionInfo sessionInfo,
ItemId itemId)
Indicates the start of a set of operations that cause modifications
on the underlying persistence layer.
|
NodeId |
createConfiguration(SessionInfo sessionInfo,
NodeId nodeId) |
EventFilter |
createEventFilter(SessionInfo sessionInfo,
int eventTypes,
Path absPath,
boolean isDeep,
String[] uuid,
Name[] nodeTypeName,
boolean noLocal)
Creates an event filter.
|
protected abstract QNodeDefinition |
createRootNodeDefinition(SessionInfo sessionInfo)
Create the root node definition.
|
protected SessionInfo |
createSessionInfo(javax.jcr.Credentials credentials,
String workspaceName)
Creates a session info instance for the given
credentials and
workspaceName . |
protected SessionInfo |
createSessionInfo(SessionInfo sessionInfo,
String workspaceName)
Creates a session info instance for the given
sessionInfo and
workspaceName . |
Subscription |
createSubscription(SessionInfo sessionInfo,
EventFilter[] filters)
Creates a new
Subscription for events with an initial set of
EventFilter s. |
Tree |
createTree(SessionInfo sessionInfo,
Batch batch,
Name nodeName,
Name primaryTypeName,
String uniqueId)
Creates a new
Tree that can be populated and later on be applied
to the specified Batch by calling #setTree . |
void |
createWorkspace(SessionInfo sessionInfo,
String name,
String srcWorkspaceName)
Create a new workspace with the specified
name . |
void |
deleteWorkspace(SessionInfo sessionInfo,
String name)
Deletes the workspace with the specified
name . |
void |
dispose(SessionInfo sessionInfo)
This default implementation does nothing.
|
void |
dispose(Subscription subscription)
Indicates that the passed subscription is no longer needed.
|
QueryInfo |
executeQuery(SessionInfo sessionInfo,
String statement,
String language,
Map<String,String> namespaces,
long limit,
long offset,
Map<String,QValue> values)
Execute the given query statement with the specified query language.
|
EventBundle |
getEvents(SessionInfo sessionInfo,
EventFilter filter,
long after)
Returns events from the
EventJournal after a given point in
time. |
EventBundle[] |
getEvents(Subscription subscription,
long timeout)
Retrieves the events that occurred since the last call to this method for
the passed subscription.
|
IdFactory |
getIdFactory()
Return the
IdFactory . |
LockInfo |
getLockInfo(SessionInfo sessionInfo,
NodeId nodeId)
Returns the lock information that applies to
Node identified
by the given NodeId or null . |
NameFactory |
getNameFactory()
Return the
NameFactory . |
String |
getNamespacePrefix(SessionInfo sessionInfo,
String uri)
This default implementation first calls
checkSessionInfo(SessionInfo)
with the sessionInfo , then return the namespace prefix for
the given uri . |
String |
getNamespaceURI(SessionInfo sessionInfo,
String prefix)
This default implementation first calls
checkSessionInfo(SessionInfo)
with the sessionInfo , then returns the namespace URI for the
given prefix . |
QNodeDefinition |
getNodeDefinition(SessionInfo sessionInfo,
NodeId nodeId)
This default implementation first calls
checkSessionInfo(SessionInfo)
with the sessionInfo , then lazily initializes rootNodeDefinition
if nodeId denotes the root node; otherwise throws a
UnsupportedRepositoryOperationException . |
PathFactory |
getPathFactory()
Return the
PathFactory . |
QPropertyDefinition |
getPropertyDefinition(SessionInfo sessionInfo,
PropertyId propertyId)
Returns the
QPropertyDefinition for the Property
identified by the given id. |
Iterator<QNodeTypeDefinition> |
getQNodeTypeDefinitions(SessionInfo sessionInfo)
This default implementation first calls
checkSessionInfo(SessionInfo)
with the sessionInfo , |
Iterator<QNodeTypeDefinition> |
getQNodeTypeDefinitions(SessionInfo sessionInfo,
Name[] nodetypeNames)
This default implementation first calls
checkSessionInfo(SessionInfo)
with the sessionInfo , then gathers the QNodeTypeDefinition s
with the given nodetypeNames . |
QValueFactory |
getQValueFactory()
Return the
QValueFactory defined with this SPI implementation. |
Map<String,String> |
getRegisteredNamespaces(SessionInfo sessionInfo)
This default implementation first calls
checkSessionInfo(SessionInfo)
with the sessionInfo , then returns the prefix to namespace
URL mapping that was provided in the constructor of this repository
service. |
Map<String,QValue[]> |
getRepositoryDescriptors()
This default implementation returns the descriptors that were passed
to the constructor of this repository service.
|
String[] |
getSupportedQueryLanguages(SessionInfo sessionInfo)
Returns a String array identifying all query languages supported by this
SPI implementation.
|
SessionInfo |
impersonate(SessionInfo sessionInfo,
javax.jcr.Credentials credentials)
This default implementation returns the session info returned by the call
to
obtain(Credentials, String) with the workspaceName taken from
the passed sessionInfo . |
void |
importXml(SessionInfo sessionInfo,
NodeId parentId,
InputStream xmlStream,
int uuidBehaviour)
Imports the data present in the given
InputStream into the
persistent layer. |
LockInfo |
lock(SessionInfo sessionInfo,
NodeId nodeId,
boolean deep,
boolean sessionScoped)
Create a lock on the
Node identified by the given id. |
LockInfo |
lock(SessionInfo sessionInfo,
NodeId nodeId,
boolean deep,
boolean sessionScoped,
long timeoutHint,
String ownerHint)
Create a lock on the
Node identified by the given id. |
Iterator<NodeId> |
merge(SessionInfo sessionInfo,
NodeId nodeId,
String srcWorkspaceName,
boolean bestEffort)
Merge the node identified by the given
NodeId and its subtree
with the corresponding node present in the workspace with the name of
srcWorkspaceName . |
Iterator<NodeId> |
merge(SessionInfo sessionInfo,
NodeId nodeId,
String srcWorkspaceName,
boolean bestEffort,
boolean isShallow)
Merge the node identified by the given
NodeId and its subtree
with the corresponding node present in the workspace with the name of
srcWorkspaceName . |
Iterator<NodeId> |
mergeActivity(SessionInfo sessionInfo,
NodeId activityId)
Merges the activity identified by the given
activityId into
the workspace the specified sessionInfo has been created for. |
void |
move(SessionInfo sessionInfo,
NodeId srcNodeId,
NodeId destParentNodeId,
Name destName)
Moves the node identified by the given
srcNodeId (and its
entire subtree) to the new location defined by destParentNodeId
and a new name (destName ). |
SessionInfo |
obtain(javax.jcr.Credentials credentials,
String workspaceName)
This default implementation does:
calls
checkCredentials(Credentials, String)
calls checkWorkspace(String)
calls createSessionInfo(Credentials, String)
|
SessionInfo |
obtain(SessionInfo sessionInfo,
String workspaceName)
This default implementation returns the session info returned by the call
to
createSessionInfo(SessionInfo, String) . |
void |
refreshLock(SessionInfo sessionInfo,
NodeId nodeId)
Explicit refresh of an existing lock.
|
void |
registerNamespace(SessionInfo sessionInfo,
String prefix,
String uri)
Register a new namespace with the given prefix and uri.
|
void |
registerNodeTypes(SessionInfo sessionInfo,
QNodeTypeDefinition[] nodeTypeDefinitions,
boolean allowUpdate)
Registers the node types with the specified
QNodeTypeDefinition s. |
void |
removeActivity(SessionInfo sessionInfo,
NodeId activityId)
Removes the activity identified by the specified
activityId . |
void |
removeVersion(SessionInfo sessionInfo,
NodeId versionHistoryId,
NodeId versionId)
Remove the version identified by the specified
versionId . |
void |
removeVersionLabel(SessionInfo sessionInfo,
NodeId versionHistoryId,
NodeId versionId,
Name label)
Remove the given version label in the persistent layer.
|
void |
resolveMergeConflict(SessionInfo sessionInfo,
NodeId nodeId,
NodeId[] mergeFailedIds,
NodeId[] predecessorIds)
Resolve an existing merge conflict present with the node identified by
the given
NodeId . |
void |
restore(SessionInfo sessionInfo,
NodeId[] versionIds,
boolean removeExisting)
Restore multiple versions at once.
|
void |
restore(SessionInfo sessionInfo,
NodeId nodeId,
NodeId versionId,
boolean removeExisting)
Restores the node identified by
nodeId to the state defined
by the version with the specified versionId . |
void |
submit(Batch batch)
Completes the given
Batch or discard all the previous modifications. |
void |
unlock(SessionInfo sessionInfo,
NodeId nodeId)
Releases the lock on the
Node identified by the given
NodeId . |
void |
unregisterNamespace(SessionInfo sessionInfo,
String uri)
Unregister the namespace identified by the given uri
|
void |
unregisterNodeTypes(SessionInfo sessionInfo,
Name[] nodeTypeNames)
Unregisters the node types with the specified
names . |
void |
update(SessionInfo sessionInfo,
NodeId nodeId,
String srcWorkspaceName)
Updates the node identified by the given
NodeId replacing
it (an the complete subtree) with a clone of its corresponding node
present in the workspace with the given srcWorkspaceName . |
void |
updateEventFilters(Subscription subscription,
EventFilter[] filters)
Updates events filters on the subscription.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getChildInfos, getItemInfoCache, getItemInfos, getNodeInfo, getPrivilegeDefinitions, getPrivilegeNames, getPropertyInfo, getReferences, getSupportedPrivileges, getWorkspaceNames, isGranted
protected final NamespaceMapping namespaces
protected final NodeTypeStorage nodeTypeDefs
protected QNodeDefinition rootNodeDefinition
protected AbstractRepositoryService() throws javax.jcr.RepositoryException
javax.jcr.RepositoryException
public AbstractRepositoryService(Map<String,QValue[]> descriptors, Map<String,String> namespaces, QNodeTypeDefinition[] nodeTypeDefs) throws javax.jcr.RepositoryException
javax.jcr.RepositoryException
public IdFactory getIdFactory() throws javax.jcr.RepositoryException
RepositoryService
IdFactory
.getIdFactory
in interface RepositoryService
IdFactoryImpl.getInstance()
.javax.jcr.RepositoryException
- if an error occurs.public NameFactory getNameFactory() throws javax.jcr.RepositoryException
RepositoryService
NameFactory
.getNameFactory
in interface RepositoryService
NameFactoryImpl.getInstance()
.javax.jcr.RepositoryException
- if an error occurs.public PathFactory getPathFactory() throws javax.jcr.RepositoryException
RepositoryService
PathFactory
.getPathFactory
in interface RepositoryService
PathFactoryImpl.getInstance()
.javax.jcr.RepositoryException
- if an error occurs.public QValueFactory getQValueFactory() throws javax.jcr.RepositoryException
RepositoryService
QValueFactory
defined with this SPI implementation.getQValueFactory
in interface RepositoryService
QValueFactoryImpl.getInstance()
.javax.jcr.RepositoryException
- if an error occurs.protected abstract QNodeDefinition createRootNodeDefinition(SessionInfo sessionInfo) throws javax.jcr.RepositoryException
sessionInfo
- the session info.javax.jcr.RepositoryException
- if an error occurs.protected void checkCredentials(javax.jcr.Credentials credentials, String workspaceName) throws javax.jcr.LoginException
credentials
are valid. This default
implementation is empty thus allowing all credentials.credentials
- the credentials to check.workspaceName
- the workspace to access.javax.jcr.LoginException
- if the credentials are invalid.protected void checkWorkspace(String workspaceName) throws javax.jcr.NoSuchWorkspaceException
workspaceName
- Name of the workspace to checkjavax.jcr.NoSuchWorkspaceException
- If workspaceName
is not available.protected SessionInfo createSessionInfo(javax.jcr.Credentials credentials, String workspaceName) throws javax.jcr.RepositoryException
credentials
and
workspaceName
. This default implementation creates a
SessionInfoImpl
instance and sets the userId
and
workspaceName. The user userId
is null
or the
userId
from credentials
if it is of type
SimpleCredentials
.credentials
- the credentials.workspaceName
- the name of the workspace to access or null
for the default workspace.credentials
and
workspaceName
.javax.jcr.RepositoryException
protected SessionInfo createSessionInfo(SessionInfo sessionInfo, String workspaceName) throws javax.jcr.RepositoryException
sessionInfo
and
workspaceName
. This default implementation creates a
SessionInfoImpl
instance and sets the userId
and
workspaceName. The user userId
is set to the return value of
SessionInfo.getUserID()
.sessionInfo
- the sessionInfo.workspaceName
- the name of the workspace to access.credentials
and
workspaceName
.javax.jcr.RepositoryException
protected void checkSessionInfo(SessionInfo sessionInfo) throws javax.jcr.RepositoryException
sessionInfo
instance. This default
implementation checks if sessionInfo
is of type
SessionInfoImpl
, otherwise throws a RepositoryException
.sessionInfo
- the session info to check.javax.jcr.RepositoryException
- if the given sessionInfo
is not
of the required type for this repository
service implementation.public Map<String,QValue[]> getRepositoryDescriptors() throws javax.jcr.RepositoryException
getRepositoryDescriptors
in interface RepositoryService
javax.jcr.RepositoryException
Repository.getDescriptorKeys()
,
Repository.getDescriptor(String)
public SessionInfo obtain(javax.jcr.Credentials credentials, String workspaceName) throws javax.jcr.LoginException, javax.jcr.NoSuchWorkspaceException, javax.jcr.RepositoryException
obtain
in interface RepositoryService
credentials
- the credentials for the login.workspaceName
- the name of the workspace to log in.javax.jcr.LoginException
- if the credentials are invalid.javax.jcr.NoSuchWorkspaceException
- if workspaceName
is unknown.javax.jcr.RepositoryException
- if another error occurs.public SessionInfo obtain(SessionInfo sessionInfo, String workspaceName) throws javax.jcr.LoginException, javax.jcr.NoSuchWorkspaceException, javax.jcr.RepositoryException
createSessionInfo(SessionInfo, String)
.obtain
in interface RepositoryService
sessionInfo
- for another workspaceworkspaceName
- the name of the workspace the new SessionInfo
should be built for. If the specified workspaceName is null
the implementation should select a default workspace.SessionInfo
if authentication was successful.javax.jcr.LoginException
- if authentication of the user fails.javax.jcr.NoSuchWorkspaceException
- if the specified workspaceName
is not recognized.javax.jcr.RepositoryException
- if an error occurs.public SessionInfo impersonate(SessionInfo sessionInfo, javax.jcr.Credentials credentials) throws javax.jcr.LoginException, javax.jcr.RepositoryException
obtain(Credentials, String)
with the workspaceName taken from
the passed sessionInfo
.impersonate
in interface RepositoryService
SessionInfo
if impersonate was successful.javax.jcr.LoginException
javax.jcr.RepositoryException
Session.impersonate(javax.jcr.Credentials)
public void dispose(SessionInfo sessionInfo) throws javax.jcr.RepositoryException
dispose
in interface RepositoryService
javax.jcr.RepositoryException
public Iterator<QNodeTypeDefinition> getQNodeTypeDefinitions(SessionInfo sessionInfo) throws javax.jcr.RepositoryException
checkSessionInfo(SessionInfo)
with the sessionInfo
,getQNodeTypeDefinitions
in interface RepositoryService
QNodeTypeDefinition
s.javax.jcr.RepositoryException
Workspace.getNodeTypeManager()
,
NodeTypeManager.getAllNodeTypes()
,
NodeTypeManager.getMixinNodeTypes()
,
NodeTypeManager.getPrimaryNodeTypes()
,
NodeTypeManager.getNodeType(String)
public Iterator<QNodeTypeDefinition> getQNodeTypeDefinitions(SessionInfo sessionInfo, Name[] nodetypeNames) throws javax.jcr.RepositoryException
checkSessionInfo(SessionInfo)
with the sessionInfo
, then gathers the QNodeTypeDefinition
s
with the given nodetypeNames
. If one of the nodetypeNames
is not a valid node type definition then a RepositoryException
is thrown.getQNodeTypeDefinitions
in interface RepositoryService
nodetypeNames
- names of node types to retrieveQNodeTypeDefinition
javax.jcr.nodetype.NoSuchNodeTypeException
- if for any of the given
names no QNodeTypeDefinition
exists.javax.jcr.RepositoryException
Workspace.getNodeTypeManager()
,
NodeTypeManager.getAllNodeTypes()
,
NodeTypeManager.getMixinNodeTypes()
,
NodeTypeManager.getPrimaryNodeTypes()
,
NodeTypeManager.getNodeType(String)
public QNodeDefinition getNodeDefinition(SessionInfo sessionInfo, NodeId nodeId) throws javax.jcr.RepositoryException
checkSessionInfo(SessionInfo)
with the sessionInfo
, then lazily initializes rootNodeDefinition
if nodeId
denotes the root node; otherwise throws a
UnsupportedRepositoryOperationException
.getNodeDefinition
in interface RepositoryService
Node
identified
by the given id.javax.jcr.RepositoryException
public QPropertyDefinition getPropertyDefinition(SessionInfo sessionInfo, PropertyId propertyId) throws javax.jcr.RepositoryException
RepositoryService
QPropertyDefinition
for the Property
identified by the given id. This method should only be used if the
caller is not able to unambiguously determine the applicable definition
from the parent node type definition.getPropertyDefinition
in interface RepositoryService
Property
identified by the given id.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
public void registerNodeTypes(SessionInfo sessionInfo, QNodeTypeDefinition[] nodeTypeDefinitions, boolean allowUpdate) throws javax.jcr.nodetype.InvalidNodeTypeDefinitionException, javax.jcr.nodetype.NodeTypeExistsException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
QNodeTypeDefinition
s.
If allowUpdate
is true
this method may also be
used to reregister existing node types with a modified definition, otherwise
this method will fail with NodeTypeExistsException
if any of
the specified definition has the name of an already registered node type.registerNodeTypes
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.nodetype.InvalidNodeTypeDefinitionException
- If any of the specified definitions
is invalid.javax.jcr.nodetype.NodeTypeExistsException
- If any of the specified definitions has the
name of an already registered node type and allowUpdate
is false
.javax.jcr.RepositoryException
- If another error occurs.NodeTypeManager.registerNodeTypes(javax.jcr.nodetype.NodeTypeDefinition[], boolean)
public void unregisterNodeTypes(SessionInfo sessionInfo, Name[] nodeTypeNames) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.nodetype.NoSuchNodeTypeException, javax.jcr.RepositoryException
RepositoryService
names
.unregisterNodeTypes
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.nodetype.NoSuchNodeTypeException
- If any of the specified names has no
corresponding registered node type.javax.jcr.RepositoryException
- If another error occurs.NodeTypeManager.unregisterNodeTypes(String[])
public Map<String,String> getRegisteredNamespaces(SessionInfo sessionInfo) throws javax.jcr.RepositoryException
checkSessionInfo(SessionInfo)
with the sessionInfo
, then returns the prefix to namespace
URL mapping that was provided in the constructor of this repository
service.getRegisteredNamespaces
in interface RepositoryService
javax.jcr.RepositoryException
Workspace.getNamespaceRegistry()
,
NamespaceRegistry.getPrefixes()
,
NamespaceRegistry.getURIs()
public String getNamespaceURI(SessionInfo sessionInfo, String prefix) throws javax.jcr.NamespaceException, javax.jcr.RepositoryException
checkSessionInfo(SessionInfo)
with the sessionInfo
, then returns the namespace URI for the
given prefix
.getNamespaceURI
in interface RepositoryService
sessionInfo
- the session info.prefix
- a namespace prefix to resolve.prefix
.javax.jcr.NamespaceException
- if prefix is not mapped to a namespace URI.javax.jcr.RepositoryException
- if another error occurs.NamespaceRegistry.getURI(String)
public String getNamespacePrefix(SessionInfo sessionInfo, String uri) throws javax.jcr.NamespaceException, javax.jcr.RepositoryException
checkSessionInfo(SessionInfo)
with the sessionInfo
, then return the namespace prefix for
the given uri
.getNamespacePrefix
in interface RepositoryService
sessionInfo
- the session info.uri
- the namespace URI.javax.jcr.NamespaceException
- if the URI unknown.javax.jcr.RepositoryException
- if another error occurs.NamespaceRegistry.getPrefix(String)
public Batch createBatch(SessionInfo sessionInfo, ItemId itemId) throws javax.jcr.RepositoryException
RepositoryService
Batch
must be executed at once or non must be executed upon
calling RepositoryService.submit(Batch)
.createBatch
in interface RepositoryService
itemId
- Id of the Item that is a common ancestor of all
Item
s affected upon batch execution. This Item
might itself be modified within the scope of the Batch
.RepositoryService.submit(Batch)
.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
Item.save()
,
Session.save()
,
Batch
public void submit(Batch batch) throws javax.jcr.PathNotFoundException, javax.jcr.ItemNotFoundException, javax.jcr.nodetype.NoSuchNodeTypeException, javax.jcr.ValueFormatException, javax.jcr.version.VersionException, javax.jcr.lock.LockException, javax.jcr.nodetype.ConstraintViolationException, javax.jcr.AccessDeniedException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
Batch
or discard all the previous modifications.
See RepositoryService.createBatch(SessionInfo,ItemId)
for additional information
regarding batch creation.submit
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.PathNotFoundException
javax.jcr.ItemNotFoundException
javax.jcr.nodetype.NoSuchNodeTypeException
javax.jcr.ValueFormatException
javax.jcr.version.VersionException
javax.jcr.lock.LockException
javax.jcr.nodetype.ConstraintViolationException
javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
Batch
public Tree createTree(SessionInfo sessionInfo, Batch batch, Name nodeName, Name primaryTypeName, String uniqueId) throws javax.jcr.RepositoryException
RepositoryService
Tree
that can be populated and later on be applied
to the specified Batch
by calling #setTree
.createTree
in interface RepositoryService
Tree
instance.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
public void importXml(SessionInfo sessionInfo, NodeId parentId, InputStream xmlStream, int uuidBehaviour) throws javax.jcr.ItemExistsException, javax.jcr.PathNotFoundException, javax.jcr.version.VersionException, javax.jcr.nodetype.ConstraintViolationException, javax.jcr.lock.LockException, javax.jcr.AccessDeniedException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
InputStream
into the
persistent layer. Note, that the implementation is responsible for
validating the data presented and for the integrity of the repository
upon completion.importXml
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.ItemExistsException
javax.jcr.PathNotFoundException
javax.jcr.version.VersionException
javax.jcr.nodetype.ConstraintViolationException
javax.jcr.lock.LockException
javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
Workspace.importXML(String, java.io.InputStream, int)
public void move(SessionInfo sessionInfo, NodeId srcNodeId, NodeId destParentNodeId, Name destName) throws javax.jcr.ItemExistsException, javax.jcr.PathNotFoundException, javax.jcr.version.VersionException, javax.jcr.nodetype.ConstraintViolationException, javax.jcr.lock.LockException, javax.jcr.AccessDeniedException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
srcNodeId
(and its
entire subtree) to the new location defined by destParentNodeId
and a new name (destName
).move
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.ItemExistsException
javax.jcr.PathNotFoundException
javax.jcr.version.VersionException
javax.jcr.nodetype.ConstraintViolationException
javax.jcr.lock.LockException
javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
Workspace.move(String, String)
public void copy(SessionInfo sessionInfo, String srcWorkspaceName, NodeId srcNodeId, NodeId destParentNodeId, Name destName) throws javax.jcr.NoSuchWorkspaceException, javax.jcr.nodetype.ConstraintViolationException, javax.jcr.version.VersionException, javax.jcr.AccessDeniedException, javax.jcr.PathNotFoundException, javax.jcr.ItemExistsException, javax.jcr.lock.LockException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
srcNodeId
in workspace named srcWorkspaceName
to the destination
in the workspace specified by the given SessionInfo
. The
destination is composed by the given parent id and the new name
as indicated by destName
.
Note, that srcWorkspaceName
may be the same as the one
specified within the SessionInfo
. In this case the copy
corresponds to a copy within a single workspace.
copy
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.NoSuchWorkspaceException
javax.jcr.nodetype.ConstraintViolationException
javax.jcr.version.VersionException
javax.jcr.AccessDeniedException
javax.jcr.PathNotFoundException
javax.jcr.ItemExistsException
javax.jcr.lock.LockException
javax.jcr.RepositoryException
Workspace.copy(String, String)
,
Workspace.copy(String, String, String)
public void update(SessionInfo sessionInfo, NodeId nodeId, String srcWorkspaceName) throws javax.jcr.NoSuchWorkspaceException, javax.jcr.AccessDeniedException, javax.jcr.lock.LockException, javax.jcr.InvalidItemStateException, javax.jcr.RepositoryException
RepositoryService
NodeId
replacing
it (an the complete subtree) with a clone of its corresponding node
present in the workspace with the given srcWorkspaceName
.update
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.NoSuchWorkspaceException
javax.jcr.AccessDeniedException
javax.jcr.lock.LockException
javax.jcr.InvalidItemStateException
javax.jcr.RepositoryException
Node.update(String)
public void clone(SessionInfo sessionInfo, String srcWorkspaceName, NodeId srcNodeId, NodeId destParentNodeId, Name destName, boolean removeExisting) throws javax.jcr.NoSuchWorkspaceException, javax.jcr.nodetype.ConstraintViolationException, javax.jcr.version.VersionException, javax.jcr.AccessDeniedException, javax.jcr.PathNotFoundException, javax.jcr.ItemExistsException, javax.jcr.lock.LockException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
srcNodeId
in workspace named srcWorkspaceName
to the destination
in the workspace specified by the given SessionInfo
. The
destination is composed by the given parent id and the new name
as indicated by destName
.clone
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.NoSuchWorkspaceException
javax.jcr.nodetype.ConstraintViolationException
javax.jcr.version.VersionException
javax.jcr.AccessDeniedException
javax.jcr.PathNotFoundException
javax.jcr.ItemExistsException
javax.jcr.lock.LockException
javax.jcr.RepositoryException
Workspace.clone(String, String, String, boolean)
public LockInfo lock(SessionInfo sessionInfo, NodeId nodeId, boolean deep, boolean sessionScoped) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.AccessDeniedException, javax.jcr.RepositoryException
RepositoryService
Node
identified by the given id.lock
in interface RepositoryService
LockInfo
associated with the new lock
that has been created.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.lock.LockException
- If the Node identified by the given
id cannot be locked due to an existing lock or due to missing mixin type.javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
- If another error occurs.Node.lock(boolean, boolean)
public LockInfo lock(SessionInfo sessionInfo, NodeId nodeId, boolean deep, boolean sessionScoped, long timeoutHint, String ownerHint) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.AccessDeniedException, javax.jcr.RepositoryException
RepositoryService
Node
identified by the given id.lock
in interface RepositoryService
timeoutHint
- long indicating the desired lock timeout in seconds.
The implementation is free to ignore the hint.ownerHint
- String indicating the desired lockOwner info. The
implementation is free to ignore the hint.LockInfo
associated with the new lock
that has been created.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.lock.LockException
- If the Node identified by the given
id cannot be locked due to an existing lock or due to missing mixin type.javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
- If another error occurs.LockManager.lock(String, boolean, boolean, long, String)
public LockInfo getLockInfo(SessionInfo sessionInfo, NodeId nodeId) throws javax.jcr.AccessDeniedException, javax.jcr.RepositoryException
RepositoryService
Node
identified
by the given NodeId
or null
. If the implementation
does not support locking at all, this method always returns null
.getLockInfo
in interface RepositoryService
null
.javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
- If some other error occurs.Node.getLock()
public void refreshLock(SessionInfo sessionInfo, NodeId nodeId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.AccessDeniedException, javax.jcr.RepositoryException
RepositoryService
refreshLock
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.lock.LockException
- If the Node identified by the given
id is not locked (any more) or if the SessionInfo
does not
contain the token associated with the lock to be refreshed.javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
- If another error occurs.Lock
public void unlock(SessionInfo sessionInfo, NodeId nodeId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.AccessDeniedException, javax.jcr.RepositoryException
RepositoryService
Node
identified by the given
NodeId
.
Please note, that on logout
all
session-scoped locks must be released by calling unlock.
unlock
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.lock.LockException
- If the Node identified by the given
id is not locked or if the SessionInfo
does not contain the
token associated with the lock to be released.javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
- If another error occurs.Node.unlock()
public NodeId checkin(SessionInfo sessionInfo, NodeId nodeId) throws javax.jcr.version.VersionException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.InvalidItemStateException, javax.jcr.lock.LockException, javax.jcr.RepositoryException
RepositoryService
Node
identified by the given
NodeId
.checkin
in interface RepositoryService
NodeId
of newly created versionjavax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.version.VersionException
javax.jcr.InvalidItemStateException
javax.jcr.lock.LockException
javax.jcr.RepositoryException
Node.checkin()
public void checkout(SessionInfo sessionInfo, NodeId nodeId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.RepositoryException
RepositoryService
Node
identified by the given
NodeId
. Same as RepositoryService.checkout(SessionInfo, NodeId, NodeId)
where the activityId
is null
.checkout
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.lock.LockException
javax.jcr.RepositoryException
Node.checkout()
public void checkout(SessionInfo sessionInfo, NodeId nodeId, NodeId activityId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.RepositoryException
RepositoryService
Node
identified by the given
NodeId
and for activity identified by the specified
activityId
. If the activityId
is null
this corresponds to RepositoryService.checkout(SessionInfo, NodeId)
checkout
in interface RepositoryService
activityId
- Id of the activity node set to the editing session or
null
if no activity is in effect.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.lock.LockException
javax.jcr.RepositoryException
public NodeId checkpoint(SessionInfo sessionInfo, NodeId nodeId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.RepositoryException
RepositoryService
Node
identified by the given
NodeId
.checkpoint
in interface RepositoryService
NodeId
of newly created versionjavax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
javax.jcr.lock.LockException
VersionManager.checkpoint(String)
public NodeId checkpoint(SessionInfo sessionInfo, NodeId nodeId, NodeId activityId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.RepositoryException
RepositoryService
Node
identified by the given
NodeId
. For the checkout part the specified activityId
is taken into account as specified in RepositoryService.checkout(SessionInfo, NodeId, NodeId)
.checkpoint
in interface RepositoryService
activityId
- Id of the activity node set to the editing session or
null
if no activity is in effect.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.lock.LockException
javax.jcr.RepositoryException
public void removeVersion(SessionInfo sessionInfo, NodeId versionHistoryId, NodeId versionId) throws javax.jcr.ReferentialIntegrityException, javax.jcr.AccessDeniedException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.version.VersionException, javax.jcr.RepositoryException
RepositoryService
versionId
.removeVersion
in interface RepositoryService
versionHistoryId
- NodeId
identifying the version
history the version identified by versionId
belongs to.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.ReferentialIntegrityException
javax.jcr.AccessDeniedException
javax.jcr.version.VersionException
javax.jcr.RepositoryException
VersionHistory.removeVersion(String)
public void restore(SessionInfo sessionInfo, NodeId nodeId, NodeId versionId, boolean removeExisting) throws javax.jcr.version.VersionException, javax.jcr.PathNotFoundException, javax.jcr.ItemExistsException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.lock.LockException, javax.jcr.InvalidItemStateException, javax.jcr.RepositoryException
RepositoryService
nodeId
to the state defined
by the version with the specified versionId
.restore
in interface RepositoryService
removeExisting
- boolean flag indicating how to deal with an
identifier collision that may occur if a node exists outside the subtree
to be restored with the same identified as a node that would be
introduces by the restore. If the removeExisting
is
true
the restored node takes precedence and the
existing node is removed. Otherwise the restore fails.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.version.VersionException
javax.jcr.PathNotFoundException
javax.jcr.ItemExistsException
javax.jcr.lock.LockException
javax.jcr.InvalidItemStateException
javax.jcr.RepositoryException
Node.restore(String, boolean)
,
Node.restore(javax.jcr.version.Version, boolean)
,
Node.restore(javax.jcr.version.Version, String, boolean)
,
Node.restoreByLabel(String, boolean)
public void restore(SessionInfo sessionInfo, NodeId[] versionIds, boolean removeExisting) throws javax.jcr.ItemExistsException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.version.VersionException, javax.jcr.lock.LockException, javax.jcr.InvalidItemStateException, javax.jcr.RepositoryException
RepositoryService
NodeId
s.restore
in interface RepositoryService
removeExisting
- boolean flag indicating how to deal with an
identifier collision that may occur if a node exists outside the subtrees
to be restored with the same identified as any node that would be
introduces by the restore. If the removeExisting
is
true
the node to be restored takes precedence and the
existing node is removed. Otherwise the restore fails.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.ItemExistsException
javax.jcr.version.VersionException
javax.jcr.lock.LockException
javax.jcr.InvalidItemStateException
javax.jcr.RepositoryException
Workspace.restore(javax.jcr.version.Version[], boolean)
public Iterator<NodeId> merge(SessionInfo sessionInfo, NodeId nodeId, String srcWorkspaceName, boolean bestEffort) throws javax.jcr.NoSuchWorkspaceException, javax.jcr.AccessDeniedException, javax.jcr.MergeException, javax.jcr.lock.LockException, javax.jcr.InvalidItemStateException, javax.jcr.RepositoryException
RepositoryService
NodeId
and its subtree
with the corresponding node present in the workspace with the name of
srcWorkspaceName
.merge
in interface RepositoryService
Iterator
over the NodeId
s of all nodes that
received a merge result of "fail" in the course of this operation.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.NoSuchWorkspaceException
javax.jcr.AccessDeniedException
javax.jcr.MergeException
javax.jcr.lock.LockException
javax.jcr.InvalidItemStateException
javax.jcr.RepositoryException
Node.merge(String, boolean)
public Iterator<NodeId> merge(SessionInfo sessionInfo, NodeId nodeId, String srcWorkspaceName, boolean bestEffort, boolean isShallow) throws javax.jcr.NoSuchWorkspaceException, javax.jcr.AccessDeniedException, javax.jcr.MergeException, javax.jcr.lock.LockException, javax.jcr.InvalidItemStateException, javax.jcr.RepositoryException
RepositoryService
NodeId
and its subtree
with the corresponding node present in the workspace with the name of
srcWorkspaceName
.merge
in interface RepositoryService
Iterator
over the NodeId
s of all nodes that
received a merge result of "fail" in the course of this operation.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.NoSuchWorkspaceException
javax.jcr.AccessDeniedException
javax.jcr.MergeException
javax.jcr.lock.LockException
javax.jcr.InvalidItemStateException
javax.jcr.RepositoryException
VersionManager.merge(String, String, boolean, boolean)
public void resolveMergeConflict(SessionInfo sessionInfo, NodeId nodeId, NodeId[] mergeFailedIds, NodeId[] predecessorIds) throws javax.jcr.version.VersionException, javax.jcr.InvalidItemStateException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
NodeId
.resolveMergeConflict
in interface RepositoryService
mergeFailedIds
- The NodeId
s remaining in the jcr:mergeFailed
REFERENCE property. The version id(s) to be resolved were removed from the
array and added to the predecessor ids in case of Node.doneMerge(Version)
.
In case of a Node.cancelMerge(Version)
the version id only gets
removed from the list.predecessorIds
- The complete set of predecessor id including those
that have been added in order to resolve a merge conflict.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.version.VersionException
javax.jcr.InvalidItemStateException
javax.jcr.RepositoryException
Node.cancelMerge(javax.jcr.version.Version)
,
Node.doneMerge(javax.jcr.version.Version)
public void addVersionLabel(SessionInfo sessionInfo, NodeId versionHistoryId, NodeId versionId, Name label, boolean moveLabel) throws javax.jcr.version.VersionException, javax.jcr.RepositoryException
RepositoryService
addVersionLabel
in interface RepositoryService
versionHistoryId
- NodeId
identifying the version
history the version identified by versionId
belongs to.versionId
- NodeId
identifying the version the
label belongs to.label
- The label to be added.moveLabel
- If the label is already assigned to a version within
the same version history this parameter has the following effect: If true
the label already present gets moved to be now be a label of the version
indicated by versionId
. If false
this method
fails and the label remains with the original version.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.version.VersionException
javax.jcr.RepositoryException
VersionHistory.addVersionLabel(String, String, boolean)
public void removeVersionLabel(SessionInfo sessionInfo, NodeId versionHistoryId, NodeId versionId, Name label) throws javax.jcr.version.VersionException, javax.jcr.RepositoryException
RepositoryService
removeVersionLabel
in interface RepositoryService
versionHistoryId
- NodeId
identifying the version
history the version identified by versionId
belongs to.versionId
- NodeId
identifying the version the
label belongs to.label
- The label to be removed.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.version.VersionException
javax.jcr.RepositoryException
VersionHistory.removeVersionLabel(String)
public NodeId createActivity(SessionInfo sessionInfo, String title) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
createActivity
in interface RepositoryService
NodeId
of the new activity node.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
VersionManager.createActivity(String)
public void removeActivity(SessionInfo sessionInfo, NodeId activityId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
activityId
.removeActivity
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
VersionManager.removeActivity(Node)
public Iterator<NodeId> mergeActivity(SessionInfo sessionInfo, NodeId activityId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
activityId
into
the workspace the specified sessionInfo
has been created for.mergeActivity
in interface RepositoryService
Iterator
over the NodeId
s of all nodes that
received a merge result of "fail" in the course of this operation.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
public NodeId createConfiguration(SessionInfo sessionInfo, NodeId nodeId) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
createConfiguration
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
VersionManager.createConfiguration(String)
public EventFilter createEventFilter(SessionInfo sessionInfo, int eventTypes, Path absPath, boolean isDeep, String[] uuid, Name[] nodeTypeName, boolean noLocal) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
ObservationManager.addEventListener(javax.jcr.observation.EventListener, int, java.lang.String, boolean, java.lang.String[], java.lang.String[], boolean)
.
Note, that an SPI implementation may support observation even if
the corresponding repository descriptor
does not return 'true'.
createEventFilter
in interface RepositoryService
sessionInfo
- the session info which requests an event filter.eventTypes
- A combination of one or more event type constants
encoded as a bitmask.absPath
- An absolute path.isDeep
- A boolean
.uuid
- Array of jcr:uuid properties.nodeTypeName
- Array of node type names.noLocal
- A boolean
.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
- if an error occurs while creating the
EventFilter.ObservationManager.addEventListener(javax.jcr.observation.EventListener, int, String, boolean, String[], String[], boolean)
public Subscription createSubscription(SessionInfo sessionInfo, EventFilter[] filters) throws javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.RepositoryException
RepositoryService
Subscription
for events with an initial set of
EventFilter
s. The returned subscription must provide events from
the time when the subscription was created. If an empty array of filters
is passed no events will be available through the created subscription
unless the filters are later updated by calling
RepositoryService.updateEventFilters(Subscription, EventFilter[])
.createSubscription
in interface RepositoryService
sessionInfo
- the session info.filters
- the initial event filters for the subscription.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
- if an error occurs while creating the
Subscription.public void updateEventFilters(Subscription subscription, EventFilter[] filters) throws javax.jcr.RepositoryException
RepositoryService
filters
.
An implementation is required to accept at least event filter instances
created by RepositoryService.createEventFilter(org.apache.jackrabbit.spi.SessionInfo, int, org.apache.jackrabbit.spi.Path, boolean, java.lang.String[], org.apache.jackrabbit.spi.Name[], boolean)
. Optionally an
implementation may also support event filters instanciated by the client
itself. An implementation may require special deployment in that case,
e.g. to make the event filter implementation class available to the
repository server.
Note on thread-safety: it is permissible to call this methods
while another thread is blocked in calling RepositoryService.getEvents(Subscription, long)
using the same
subscription instance as a parameter.
updateEventFilters
in interface RepositoryService
subscription
- the subscription where the event filters are
applied.filters
- the filters that are applied to the events as they
occurred on the repository. An event is included in an
event bundle if it is accept
ed by at least one of the supplied
filters. If an empty array is passed none of the potential
events are include in an event bundle. This allows a
client to skip or ignore events for a certain period of
time.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
- if an error occurs while updating the event
filters.public EventBundle[] getEvents(Subscription subscription, long timeout) throws javax.jcr.RepositoryException, InterruptedException
RepositoryService
Note, that an SPI implementation may support observation even if the
corresponding repository descriptor
does return 'false'.
An implementation should un-block a calling thread and let it return if the associated subscription is disposed by another thread.
getEvents
in interface RepositoryService
subscription
- a subscription.timeout
- a timeout in milliseconds to wait at most for an
event bundle. If timeout
is up and no
event occurred meanwhile an empty array is returned.EventBundle
s representing the events
that occurred.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
- if an error occurs while retrieving the
event bundles.InterruptedException
- if the calling thread is interrupted while
waiting for events within the specified
timeout
.public EventBundle getEvents(SessionInfo sessionInfo, EventFilter filter, long after) throws javax.jcr.RepositoryException, javax.jcr.UnsupportedRepositoryOperationException
RepositoryService
EventJournal
after a given point in
time. The returned event bundle may only contain events up to a given
time. In order to retrieve more events a client must call this method
again with the timestamp from the last event bundle. An empty bundle
indicates that there are no more events.getEvents
in interface RepositoryService
sessionInfo
- the session info.filter
- the event filter to apply. Please note: the
noLocal
flag is ignored.after
- retrieve events that occurred after the given
timestamp.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
- if an error occurs.public void dispose(Subscription subscription) throws javax.jcr.RepositoryException
RepositoryService
Note on thread-safety: it is permissible to call this methods
while another thread is blocked in calling RepositoryService.getEvents(Subscription, long)
using the same
subscription instance as a parameter.
dispose
in interface RepositoryService
javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.RepositoryException
- if an error occurs while the subscription is
disposed.public void registerNamespace(SessionInfo sessionInfo, String prefix, String uri) throws javax.jcr.NamespaceException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.AccessDeniedException, javax.jcr.RepositoryException
RepositoryService
registerNamespace
in interface RepositoryService
prefix
- Prefix of the namespace to be registered.uri
- Namespace URI to be registered.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.NamespaceException
javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
NamespaceRegistry.registerNamespace(String, String)
public void unregisterNamespace(SessionInfo sessionInfo, String uri) throws javax.jcr.NamespaceException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.AccessDeniedException, javax.jcr.RepositoryException
RepositoryService
unregisterNamespace
in interface RepositoryService
uri
- Namespace URI to be unregistered.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.NamespaceException
javax.jcr.AccessDeniedException
javax.jcr.RepositoryException
NamespaceRegistry.unregisterNamespace(String)
public void createWorkspace(SessionInfo sessionInfo, String name, String srcWorkspaceName) throws javax.jcr.AccessDeniedException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.NoSuchWorkspaceException, javax.jcr.RepositoryException
RepositoryService
name
. If
srcWorkspaceName
isn't null
the content of
that workspace is 'cloned' to the new workspace as inital content,
otherwise an empty workspace will be created.createWorkspace
in interface RepositoryService
name
- The name of the new workspace.srcWorkspaceName
- The name of the workspace from which the initial
content of the new workspace will be 'cloned'.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.AccessDeniedException
javax.jcr.NoSuchWorkspaceException
javax.jcr.RepositoryException
Workspace.createWorkspace(String)
,
Workspace.createWorkspace(String, String)
public void deleteWorkspace(SessionInfo sessionInfo, String name) throws javax.jcr.AccessDeniedException, javax.jcr.UnsupportedRepositoryOperationException, javax.jcr.NoSuchWorkspaceException, javax.jcr.RepositoryException
RepositoryService
name
.deleteWorkspace
in interface RepositoryService
name
- The name of the workspace to be deleted.javax.jcr.UnsupportedRepositoryOperationException
- always.javax.jcr.AccessDeniedException
javax.jcr.NoSuchWorkspaceException
javax.jcr.RepositoryException
Workspace.deleteWorkspace(String)
public String[] getSupportedQueryLanguages(SessionInfo sessionInfo) throws javax.jcr.RepositoryException
RepositoryService
getSupportedQueryLanguages
in interface RepositoryService
javax.jcr.RepositoryException
QueryManager.getSupportedQueryLanguages()
public String[] checkQueryStatement(SessionInfo sessionInfo, String statement, String language, Map<String,String> namespaces) throws javax.jcr.query.InvalidQueryException, javax.jcr.RepositoryException
RepositoryService
statement
is valid according to the
specified query language
and returns the bind variable
names found in the query statement.checkQueryStatement
in interface RepositoryService
sessionInfo
- the session info.statement
- the query statement to check.language
- the query language.namespaces
- the locally re-mapped namespace which may be used in
the query statement
.javax.jcr.query.InvalidQueryException
- if the query statement is invalid or the
language is not supported.javax.jcr.RepositoryException
- if an error occurs while checking the
statement.QueryManager.createQuery(String, String)
public QueryInfo executeQuery(SessionInfo sessionInfo, String statement, String language, Map<String,String> namespaces, long limit, long offset, Map<String,QValue> values) throws javax.jcr.RepositoryException
RepositoryService
namespaces
parameter provides a mapping of prefix
to namespace uri in order to be able to properly resolve prefix:localname
patterns present within the query statement.executeQuery
in interface RepositoryService
sessionInfo
- the session info that wants to execute the query.statement
- the query statement to be execute.language
- the query language used to parse the query
statement
.namespaces
- the locally re-mapped namespace which may be used in
the query statement
.limit
- The maximum result size or -1
is no
maximum is set.offset
- The offset in the total result set or -1
is no offset is set.values
- A Map of name/value pairs collected upon calls to
Query.bindValue(String,
javax.jcr.Value)
.javax.jcr.RepositoryException
- if an error occurs.Query.execute()
Copyright © 2004-2020 The Apache Software Foundation. All Rights Reserved.