webdavDelete

Home > Books > NetKernel API and Services Reference > Accessor Listing > WebDav Client > webdavDelete

Module

The webdavDelete accessor is exported by the urn:org:ten60:netkernel:mod:webdav module. Import this module to gain access to the accessor.

Syntax

URI

active:webdavDelete

Argument	Rules	Description
path	Mandatory	the uri of the resource to delete.

Example Usage

DPML

<instr>
  <type>webdavDelete</type>
  <path>http://webdav.example.com/someCollection/resource.toDelete</path>
  <target>var:deleteResponse</target>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:webdavDelete");
req.addArgument("path", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

webdavDelete deletes the resource at the location specified by the path. If the resource identified by the path does not exist then the request will fail. When the path specifies a collection then all members of that collection will be deleted, including sub-collections.

The webdavDelete URA uses the WebDav client library from the Jakarta Slide project.

References

Apache Jakarta Slide Homepage

Result document

Example result document:

<result>
  <method>deleteMethod</method>
  <path>&gt;http://webdav.example.com/someCollection/resource.xml</path>
  <success>true</success>
  <statusCode>204</statusCode>
  <statusText>No Content (204)</statusText>
  <displayName>resource.toDelete</displayName>
  <contentLength>2125</contentLength>
  <contentType>application/xml</contentType>
  <lastModified>6/02/2004 09:51:18</lastModified>
</result>

<method> contains the name of the underlying WebDav client method that was called.
<path> contains the full uri of the target of the requested operation.
<success> contains a boolean indicator of the success of the request.
<statusCode> contains the HTTP status code returned by the server.
<statusText> contains the HTTP status message returned by the server.
<displayName> contains the name to use when displaying a reference to the deleted resource.
<contentLength> if the delete resource was a collection will be 0, otherwse it will be the length of the content of the deleted resource.
<contentType> the HTTP Content-Type (MIME type) of the deleted resource. Apache WebDav always returns httpd/unix-directory for a deleted collection.
<lastModified> contains the date that the resource was last modified, i.e. was deleted, in the default date/time format for your timezone.