public class DefaultItemResource extends Object
DefaultItemResource represents JCR property item.Property| Modifier and Type | Field and Description |
|---|---|
protected boolean |
initedProps |
protected Item |
item |
protected DavPropertyNameSet |
names |
protected DavPropertySet |
properties |
protected SupportedLock |
supportedLock |
protected SupportedReportSetProperty |
supportedReports |
METHODSEXCLUSIVE_SESSION, JCR_DEFINITION, JCR_DEPTH, JCR_GET_STRING, JCR_INDEX, JCR_ISMODIFIED, JCR_ISNEW, JCR_LENGTH, JCR_LENGTHS, JCR_MIXINNODETYPES, JCR_NAME, JCR_NAMESPACES, JCR_NODETYPES_CND, JCR_PARENT, JCR_PATH, JCR_PRIMARYITEM, JCR_PRIMARYNODETYPE, JCR_REFERENCES, JCR_SELECTOR_NAME, JCR_TYPE, JCR_UUID, JCR_VALUE, JCR_VALUES, JCR_VERSIONABLEUUID, JCR_WEAK_REFERENCES, JCR_WORKSPACE_NAME, METHODS, NAMESPACE, PRIVILEGE_JCR_ADD_NODE, PRIVILEGE_JCR_READ, PRIVILEGE_JCR_REMOVE, PRIVILEGE_JCR_SET_PROPERTYATTR_VALUE_TYPE, IMPORT_UUID_BEHAVIOR, JCR_DEFINITION_LN, JCR_DEPTH_LN, JCR_GET_STRING_LN, JCR_INDEX_LN, JCR_ISMODIFIED_LN, JCR_ISNEW_LN, JCR_LENGTH_LN, JCR_LENGTHS_LN, JCR_MIXINNODETYPES_LN, JCR_NAME_LN, JCR_NAMESPACES_LN, JCR_NODETYPES_CND_LN, JCR_PARENT_LN, JCR_PATH_LN, JCR_PRIMARYITEM_LN, JCR_PRIMARYNODETYPE_LN, JCR_QUERY_RESULT_LN, JCR_REFERENCES_LN, JCR_SELECTOR_NAME_LN, JCR_TYPE_LN, JCR_UUID_LN, JCR_VALUE_LN, JCR_VALUES_LN, JCR_VERSIONABLEUUID_LN, JCR_WEAK_REFERENCES_LN, JCR_WORKSPACE_NAME_LN, NS_PREFIX, NS_URI, RELATION_REMOTE_SESSION_ID, RELATION_USER_DATA, REPORT_EXPORT_VIEW, REPORT_LOCATE_BY_UUID, REPORT_LOCATE_CORRESPONDING_NODE, REPORT_NODETYPES, REPORT_PRIVILEGES, REPORT_REGISTERED_NAMESPACES, REPORT_REPOSITORY_DESCRIPTORS, ROOT_ITEM_PATH, ROOT_ITEM_RESOURCEPATH, VERSIONSTORAGE_PATH, XML_ALLOWUPDATE, XML_CND, XML_DESCRIPTOR, XML_DESCRIPTORKEY, XML_DESCRIPTORVALUE, XML_EXCLUSIVE_SESSION_SCOPED, XML_LENGTH, XML_NAMESPACE, XML_NODETYPENAME, XML_PREFIX, XML_PRIMARYNODETYPE, XML_QUERY_RESULT_COLUMN, XML_RELPATH, XML_REMOVEEXISTING, XML_URI, XML_VALUEMETHODSMETHODS, METHODS_INCL_MKWORKSPACEMETHODS| Constructor and Description |
|---|
DefaultItemResource(DavResourceLocator locator,
JcrDavSession session,
DavResourceFactory factory,
Item item)
Create a new
DefaultItemResource. |
| Modifier and Type | Method and Description |
|---|---|
void |
addLockManager(LockManager lockMgr)
Add an external
LockManager to this resource. |
void |
addMember(DavResource resource,
InputContext inputContext)
Method is not allowed.
|
void |
addWorkspace(DavResource workspace)
The JCR api does not provide methods to create new workspaces.
|
MultiStatusResponse |
alterProperties(List<? extends PropEntry> changeList)
Loops over the given
List and alters the properties accordingly. |
void |
copy(DavResource destination,
boolean shallow)
Copies the underlying repository item to the indicated destination.
|
protected DavResource |
createResourceFromLocator(DavResourceLocator loc)
Create a new
DavResource from the given locator. |
boolean |
exists()
Returns true if there exists a
repository item with the given
resource path, false otherwise. |
DavResource |
getCollection()
Returns the resource representing the parent item of the repository item
represented by this resource.
|
String |
getComplianceClass()
Returns a string listing the compliance classes for this resource as it
is required for the DAV response header.
|
protected String |
getCreationDate()
Returns the creation date which is used for the
DavPropertyName.CREATIONDATE property. |
protected String |
getCreatorDisplayName()
Returns the display name of the creator which is used for the protected
DeltaVConstants.CREATOR_DISPLAYNAME property. |
String |
getDisplayName()
Retrieves the last segment of the item path (or the resource path if
this resource does not exist).
|
DavResourceFactory |
getFactory()
Return the
DavResourceFactory that created this resource. |
String |
getHref()
Returns the absolute href of this resource as returned in the
multistatus response body.
|
protected static String |
getItemName(String itemPath)
Retrieves the last segment of the given path and removes the index if
present.
|
DavResourceLocator |
getLocator()
Returns the
locator object for this webdav resource,
which encapsulates the information for building the complete 'href'. |
protected DavResourceLocator |
getLocatorFromItem(Item repositoryItem)
Build a new
DavResourceLocator from the given repository item. |
protected DavResourceLocator |
getLocatorFromItemPath(String itemPath)
Build a
DavResourceLocator from the given itemPath path. |
ActiveLock |
getLock(Type type,
Scope scope)
JCR properties are locked if their
parent node is locked; thus this method will always return the
lock object from the collection this resource is
internal member of. |
ActiveLock[] |
getLocks()
Returns an array of all locks applied to the given resource.
|
DavResourceIterator |
getMembers()
Always returns an empty iterator for a non-collection resource might
not have internal members.
|
long |
getModificationTime()
Always returns 'now'
|
OptionsResponse |
getOptionResponse(OptionsInfo optionsInfo)
Retrieves the information requested in the OPTIONS request body and
returns the corresponding values.
|
DavPropertySet |
getProperties()
Returns all webdav properties present on this resource that will be
return upon a
DavConstants.PROPFIND_ALL_PROP request. |
DavProperty<?> |
getProperty(DavPropertyName name)
Return the webdav property with the specified name.
|
DavPropertyName[] |
getPropertyNames()
Returns an array of all
property names available
on this resource. |
QueryGrammerSet |
getQueryGrammerSet()
Returns the protected DAV:supported-method-set property which is defined
mandatory by RTF 3253.
|
DavResource[] |
getReferenceResources(DavPropertyName hrefPropertyName)
Return an array of
DavResource objects that are referenced
by the property with the specified name. |
Report |
getReport(ReportInfo reportInfo)
Runs the report specified by the given
ReportInfo. |
protected Session |
getRepositorySession()
Shortcut for
getSession().getRepositorySession() |
String |
getResourcePath()
Returns the path of the underlying repository item or the item to
be created (PUT/MKCOL).
|
DavSession |
getSession()
Retrieve the
DavSession associated with this resource. |
String |
getSupportedMethods()
Returns a comma separated list of all METHODS supported by the given
resource.
|
String |
getTransactionId()
The TransactionId or
null according to the value of the
corresponding request header
field. |
protected String |
getWorkspaceHref()
Retrieve the href of the workspace the current session belongs to.
|
boolean |
hasLock(Type type,
Scope scope)
Returns true if this resource has a lock applied with the given type and scope.
|
void |
init(SubscriptionManager subsMgr)
Initializes this resource.
|
void |
init(TxLockManager txMgr,
String transactionId)
Initializes the
TransactionResource. |
protected void |
initLockSupport()
Initialize the
SupportedLock property
with entries that are valid for any type item resources. |
protected void |
initProperties()
Add resource specific properties.
|
protected void |
initPropertyNames()
Property names common to all resources.
|
protected void |
initSupportedReports()
Define the set of reports supported by this resource.
|
boolean |
isCollection()
Returns false.
|
boolean |
isLockable(Type type,
Scope scope)
Returns true, if the
SupportedLock property contains an entry
with the given type and scope. |
ActiveLock |
lock(LockInfo reqLockInfo)
Lock this webdav resource with the information retrieve from the request
and return the resulting lockdiscovery object.
|
void |
move(DavResource destination)
Moves the underlying repository item to the indicated destination.
|
EventDiscovery |
poll(String subscriptionId,
long timeout)
Retrieve the list of events that where recorded for the event listener
with the given SubscriptionId.
|
ActiveLock |
refreshLock(LockInfo info,
String lockToken)
Only transaction lock may be available on this resource.
|
void |
removeMember(DavResource member)
Method is not allowed.
|
void |
removeProperty(DavPropertyName propertyName)
Removing properties is not allowed, for a single-value JCR-property without
a value does not exist.
|
MultiStatus |
search(SearchInfo sInfo)
Runs a search with the language and query defined in the
SearchInfo
object specified and returns a MultiStatus object listing the
results. |
void |
setProperty(DavProperty<?> property)
Sets the given property.
|
void |
spool(OutputContext outputContext)
In case an underlying repository
property exists the following
logic is applied to spool the property content:
Property is not multi valued: Return the stream representation of the property value.
Property is multivalue: Return the xml representation of the values.
|
Subscription |
subscribe(SubscriptionInfo info,
String subscriptionId)
Subscribe this resource for event listening defined by the specified
subscription info.
|
void |
unlock(String lockToken)
Throws
HttpServletResponse.SC_METHOD_NOT_ALLOWED since only transaction
locks may be present on this resource, that need to be released by calling
TransactionResource.unlock(String, org.apache.jackrabbit.webdav.transaction.TransactionInfo). |
void |
unlock(String lockToken,
TransactionInfo tInfo)
Overloads the
unlock method of the DavResource
interface. |
void |
unsubscribe(String subscriptionId)
Unsubscribe the event listener with the given SubscriptionId.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitaddLockManager, getFactory, getHref, getLocator, getLocks, getProperties, getPropertyNames, getResourcePath, getSession, hasLock, isLockable, lock, refreshLock, unlockprotected final Item item
protected boolean initedProps
protected DavPropertySet properties
protected DavPropertyNameSet names
protected SupportedLock supportedLock
protected SupportedReportSetProperty supportedReports
public DefaultItemResource(DavResourceLocator locator, JcrDavSession session, DavResourceFactory factory, Item item)
DefaultItemResource.locator - session - public boolean isCollection()
DavResource.isCollection()public long getModificationTime()
DavResource.getModificationTime()public void spool(OutputContext outputContext) throws IOException
property exists the following
logic is applied to spool the property content:
stream representation of the property value.spool in interface DavResourceoutputContext - IOException - If an error occurs.DavResource.spool(OutputContext)public DavProperty<?> getProperty(DavPropertyName name)
DavResourcegetProperty in interface DavResourcename - name of the webdav propertyDavProperty with the given name or null
if the property does not exist.DavResource.getProperty(org.apache.jackrabbit.webdav.property.DavPropertyName)public void setProperty(DavProperty<?> property) throws DavException
ItemResourceConstants.JCR_VALUE and ItemResourceConstants.JCR_VALUES
are the only resource properties that are allowed to be modified. Any other
property is read-only and will throw an exception ('Conflict').setProperty in interface DavResourceproperty - DavExceptionDavResource.setProperty(org.apache.jackrabbit.webdav.property.DavProperty)public void removeProperty(DavPropertyName propertyName) throws DavException
values array
may be specified with by setting the 'values' webdav property.removeProperty in interface DavResourcepropertyName - DavExceptionDavResource.removeProperty(org.apache.jackrabbit.webdav.property.DavPropertyName)public MultiStatusResponse alterProperties(List<? extends PropEntry> changeList) throws DavException
List and alters the properties accordingly.
Changes are persisted at the end only according to the rules defined with
the complete() method.Please note: since there is only a single property than can be set from a client (i.e. jcr:value OR jcr:values) this method either succeeds or throws an exception, even if this violates RFC 2518.
alterProperties in interface DavResourcechangeList - DavExceptionDavResource.alterProperties(List)public void addMember(DavResource resource, InputContext inputContext) throws DavException
resource - DavResource to be added as internal member.inputContext - Context providing the properties and content for the
internal member to be created or replaced.DavExceptionDavResource.addMember(org.apache.jackrabbit.webdav.DavResource, InputContext)public DavResourceIterator getMembers()
DavResource.getMembers()public void removeMember(DavResource member) throws DavException
DavExceptionDavResource.removeMember(DavResource)public ActiveLock getLock(Type type, Scope scope)
JCR properties are locked if their
parent node is locked; thus this method will always return the
lock object from the collection this resource is
internal member of.getLock in interface DavResourcetype - scope - null if this resource
has no lock.DavResource.getLock(Type, Scope)protected void initPropertyNames()
protected void initProperties()
public String getComplianceClass()
getComplianceClass in interface DavResourceDavResource.getComplianceClass()public String getSupportedMethods()
DavResourcegetSupportedMethods in interface DavResourceDavResource.getSupportedMethods()public boolean exists()
repository item with the given
resource path, false otherwise.exists in interface DavResourceDavResource.exists()public String getDisplayName()
item name
which is exposed with the {http://www.day.com/jcr/webdav/1.0}name property.getDisplayName in interface DavResourceDavResource.getDisplayName()public DavResource getCollection()
RootCollection is returned.getCollection in interface DavResourceDavResource.getCollection()public void move(DavResource destination) throws DavException
move in interface DavResourcedestination - DavExceptionDavResource.move(DavResource),
Session.move(String, String)public void copy(DavResource destination, boolean shallow) throws DavException
Workspace.copy(String, String, String) is used to perform
the copy operation, Workspace.copy(String, String) otherwise.
Note, that this implementation does not support shallow copy.
copy in interface DavResourcedestination - shallow - DavExceptionDavResource.copy(DavResource, boolean),
Workspace.copy(String, String),
Workspace.copy(String, String, String)public void init(SubscriptionManager subsMgr)
ObservationResourceinit in interface ObservationResourcesubsMgr - subscription manager objectObservationResource.init(SubscriptionManager)public Subscription subscribe(SubscriptionInfo info, String subscriptionId) throws DavException
ObservationResourcesubscribe in interface ObservationResourceinfo - SubscriptionInfo object as defined by the
request body and headers.subscriptionId - or null if the
SubscriptionId header
is missing.Subscription object in case the subscription was
successful.DavExceptionObservationResource.subscribe(org.apache.jackrabbit.webdav.observation.SubscriptionInfo, String),
SubscriptionManager.subscribe(org.apache.jackrabbit.webdav.observation.SubscriptionInfo, String, org.apache.jackrabbit.webdav.observation.ObservationResource)public void unsubscribe(String subscriptionId) throws DavException
ObservationResourceunsubscribe in interface ObservationResourcesubscriptionId - as present in the SubscriptionId header.DavExceptionObservationResource.unsubscribe(String),
SubscriptionManager.unsubscribe(String, org.apache.jackrabbit.webdav.observation.ObservationResource)public EventDiscovery poll(String subscriptionId, long timeout) throws DavException
ObservationResourcepoll in interface ObservationResourcesubscriptionId - as present in the
SubscriptionId header.timeout - as present in the
ObservationConstants.HEADER_POLL_TIMEOUT header or 0 (zero) if
none is present.EventDiscovery objectDavExceptionObservationResource.poll(String, long),
SubscriptionManager.poll(String, long, org.apache.jackrabbit.webdav.observation.ObservationResource)protected void initLockSupport()
SupportedLock property
with entries that are valid for any type item resources.SupportedLock,
TxLockEntry,
AbstractResource.initLockSupport()protected String getWorkspaceHref()
null if this resource
does not represent a repository item.AbstractResource.getWorkspaceHref()protected static String getItemName(String itemPath)
itemPath - public DavResourceLocator getLocator()
DavResourcelocator object for this webdav resource,
which encapsulates the information for building the complete 'href'.getLocator in interface DavResourceDavResource.getLocator()public String getResourcePath()
null is returned.getResourcePath in interface DavResourceDavResource.getResourcePath(),
DavResourceLocator.getResourcePath()public String getHref()
DavResourcegetHref in interface DavResourceDavResource.getHref(),
DavResourceLocator.getHref(boolean)public DavPropertyName[] getPropertyNames()
DavResourceproperty names available
on this resource.getPropertyNames in interface DavResourceDavResource.getPropertyNames()public DavPropertySet getProperties()
DavResourceDavConstants.PROPFIND_ALL_PROP request. The
implementation may in addition expose other (protected or calculated)
properties which should be marked accordingly (see also
DavProperty.isInvisibleInAllprop().getProperties in interface DavResourceDavPropertySet containing at least all properties
of this resource that are exposed in 'allprop' PROPFIND request.DavResource.getProperties()public boolean isLockable(Type type, Scope scope)
SupportedLock property contains an entry
with the given type and scope. By default resources allow for transaction lock only.isLockable in interface DavResourcetype - scope - DavResource.isLockable(org.apache.jackrabbit.webdav.lock.Type, org.apache.jackrabbit.webdav.lock.Scope)public boolean hasLock(Type type, Scope scope)
hasLock in interface DavResourcetype - scope - DavResource.hasLock(Type, Scope)public ActiveLock[] getLocks()
DavResourcegetLocks in interface DavResourcetodo improve....public ActiveLock lock(LockInfo reqLockInfo) throws DavException
DavResourcelock in interface DavResourcereqLockInfo - lock info as retrieved from the request.DavException is thrown.DavException - if the lock could not be obtained.DavResource.lock(org.apache.jackrabbit.webdav.lock.LockInfo)public ActiveLock refreshLock(LockInfo info, String lockToken) throws DavException
refreshLock in interface DavResourceinfo - lockToken - DavException is thrown.DavExceptionDavResource.refreshLock(org.apache.jackrabbit.webdav.lock.LockInfo, String)public void unlock(String lockToken) throws DavException
HttpServletResponse.SC_METHOD_NOT_ALLOWED since only transaction
locks may be present on this resource, that need to be released by calling
TransactionResource.unlock(String, org.apache.jackrabbit.webdav.transaction.TransactionInfo).unlock in interface DavResourcelockToken - DavException - Always throws HttpServletResponse.SC_METHOD_NOT_ALLOWEDpublic void addLockManager(LockManager lockMgr)
DavResourceLockManager to this resource. This method may
throw UnsupportedOperationException if the resource does handle
locking itself.addLockManager in interface DavResourceDavResource.addLockManager(org.apache.jackrabbit.webdav.lock.LockManager)public DavResourceFactory getFactory()
DavResourceDavResourceFactory that created this resource.getFactory in interface DavResourceDavResource.getFactory()public DavSession getSession()
DavResourceDavSession associated with this resource.getSession in interface DavResourceDavResource.getSession(),
DavResource.getSession()public void init(TxLockManager txMgr, String transactionId)
TransactionResourceTransactionResource.init in interface TransactionResourceTransactionResource.init(TxLockManager, String)public void unlock(String lockToken, TransactionInfo tInfo) throws DavException
TransactionResourceunlock method of the DavResource
interface.unlock in interface TransactionResourcelockToken - lock token as present in the request header.tInfo - transaction info object as present in the UNLOCK request body.DavException - if an error occursTransactionResource.unlock(String, org.apache.jackrabbit.webdav.transaction.TransactionInfo)public String getTransactionId()
TransactionResourcenull according to the value of the
corresponding request header
field.getTransactionId in interface TransactionResourcenullTransactionResource.getTransactionId()public OptionsResponse getOptionResponse(OptionsInfo optionsInfo)
DeltaVResourcegetOptionResponse in interface DeltaVResourceoptionsInfo - nullDeltaVResource.getOptionResponse(org.apache.jackrabbit.webdav.version.OptionsInfo)public Report getReport(ReportInfo reportInfo) throws DavException
DeltaVResourceReportInfo.getReport in interface DeltaVResourcereportInfo - DavExceptionDeltaVResource.getReport(org.apache.jackrabbit.webdav.version.report.ReportInfo)public void addWorkspace(DavResource workspace) throws DavException
addWorkspace on this resource will always fail.addWorkspace in interface DeltaVResourceworkspace - DavException - Always throws.DeltaVResource.addWorkspace(org.apache.jackrabbit.webdav.DavResource)public DavResource[] getReferenceResources(DavPropertyName hrefPropertyName) throws DavException
DavResource objects that are referenced
by the property with the specified name.getReferenceResources in interface DeltaVResourcehrefPropertyName - DavResourcesDavExceptionDeltaVResource.getReferenceResources(org.apache.jackrabbit.webdav.property.DavPropertyName)public QueryGrammerSet getQueryGrammerSet()
SearchResourceDavResource.getProperty(SearchConstants.QUERY_GRAMMER_SET).getQueryGrammerSet in interface SearchResourceSearchResource.getQueryGrammerSet()public MultiStatus search(SearchInfo sInfo) throws DavException
SearchResourceSearchInfo
object specified and returns a MultiStatus object listing the
results.search in interface SearchResourcesInfo - DavExceptionSearchResource.search(org.apache.jackrabbit.webdav.search.SearchInfo)protected DavResource createResourceFromLocator(DavResourceLocator loc) throws DavException
DavResource from the given locator.loc - DavResourceDavExceptionprotected DavResourceLocator getLocatorFromItemPath(String itemPath)
DavResourceLocator from the given itemPath path.itemPath - DavResourceLocatorDavLocatorFactory.createResourceLocator(String, String, String)protected DavResourceLocator getLocatorFromItem(Item repositoryItem)
DavResourceLocator from the given repository item.repositoryItem - getLocatorFromItemPath(String)protected Session getRepositorySession()
getSession().getRepositorySession()AbstractResource.session.protected void initSupportedReports()
SupportedReportSetProperty,
AbstractResource.initSupportedReports()protected String getCreatorDisplayName()
DeltaVConstants.CREATOR_DISPLAYNAME property.null; subclasses may provide a regular value.protected String getCreationDate()
DavPropertyName.CREATIONDATE property.Copyright © 2004–2022 The Apache Software Foundation. All rights reserved.