com.logicaldoc.webdav.resource.service

Interface ResourceService

All Superinterfaces:

Serializable

All Known Implementing Classes:

ResourceServiceImpl

public interface ResourceService
extends Serializable

All CRUD as well as versioning functionalities against logicalDOC will be handled through this service pattern. Therefore it is called the most common-class where changes must be done during the time. Security mechanism are also implemented through every method. Therefore the caller (WebDAV-Implementation) has just pass the required path or

Author:

Sebastian Wenzky

Method Summary

Methods

Modifier and Type	Method and Description
void	checkout(Resource resource, DavSession session) Versioning-part.
void	copyResource(Resource destinResource, Resource resource, DavSession session) Copying of a resource within logicalDOC.
Resource	createResource(Resource parentResource, String name, boolean isCollection, ImportContext context, DavSession session) Handle of resource creation by passed parent resource as well as the most import parameters needed for a resource creation.
void	deleteResource(Resource resource, DavSession session) Deletion of a resource within logicalDOC.
Resource	getChildByName(Resource parentResource, String name) Based on the parent resource it will be tried to get a child by a specific name
List<Resource>	getChildResources(Resource parentResource) On passing a valid
List<Resource>	getHistory(Resource resource) Versioning-part.
Resource	getParentResource(Resource resource) Based on the current resource location it will be turned back the upper resource
Resource	getParentResource(String location, long userId, DavSession session) Based on a location path (given by
Resource	getResource(String location, DavSession session) On passing a location as well as the current session you gettin back the appropriated resource.
Resource	move(Resource target, Resource destination, DavSession session) Moves a resource named target to the folder dictionary destination
boolean	resourceExists(Resource resource) Check for existing resource(logically)
void	streamIn(Resource resource, InputStream is)
InputStream	streamOut(Resource resource)
void	uncheckout(Resource resource, DavSession session)
Resource	updateResource(Resource resource) Updating a resource on passing all new properties though a valid resource object.
void	updateResource(Resource resource, ImportContext context, DavSession session) Updating a resource on passing all new properties though a valid resource object.

Method Detail

getResource

Resource getResource(String location,
                   DavSession session)
                     throws org.apache.jackrabbit.webdav.DavException

On passing a location as well as the current session you gettin back the appropriated resource.

Parameters:

location - The location retrieved through DavResourceLocator.getResourcePath()

session - The current session

Returns:

Throws:

org.apache.jackrabbit.webdav.DavException

getChildResources

List<Resource> getChildResources(Resource parentResource)

On passing a valid

Parameters:

parentResource - The resource(mostly a folder) from which are all direct childs has to be fetched and turned back

Returns:

direct childs of the parent resource

createResource

Resource createResource(Resource parentResource,
                      String name,
                      boolean isCollection,
                      ImportContext context,
                      DavSession session)
                        throws org.apache.jackrabbit.webdav.DavException

Handle of resource creation by passed parent resource as well as the most import parameters needed for a resource creation.

Parameters:

parentResource - The parent resource(mostly a folder)

name - the filename and titlename of the child

isCollection - is the resource folder?

context - for inputstream

session - the current session

Returns:

the newly created Resource

Throws:

org.apache.jackrabbit.webdav.DavException

updateResource

Resource updateResource(Resource resource)

Updating a resource on passing all new properties though a valid resource object. This resource object must correspond on the ID attribute with a valid resource in logicalDOC.

Parameters:

resource - The updateable resource

Returns:

the updated resource

updateResource

void updateResource(Resource resource,
                  ImportContext context,
                  DavSession session)
                    throws org.apache.jackrabbit.webdav.DavException

Updating a resource on passing all new properties though a valid resource object. This resource object must correspond on the ID attribute with a valid resource in logicalDOC.

Parameters:

resource - The updateable resource

context - the ImportContext

session - the current session

Throws:

org.apache.jackrabbit.webdav.DavException

resourceExists

boolean resourceExists(Resource resource)

Check for existing resource(logically)

Parameters:

resource - The Resource

Returns:

True if foud else false

getChildByName

Resource getChildByName(Resource parentResource,
                      String name)

Based on the parent resource it will be tried to get a child by a specific name

Parameters:

parentResource - The parent resource

name - name of the child must be

Returns:

The resource that matches, else it will be returned null

getParentResource

Resource getParentResource(Resource resource)

Based on the current resource location it will be turned back the upper resource

Parameters:

resource - the current resource

Returns:

the parent resource

getParentResource

Resource getParentResource(String location,
                         long userId,
                         DavSession session)

Based on a location path (given by

Parameters:

location - the resource path

userId - the user id

session - the current session

Returns:

the parent resource

See Also:

DavResourceLocator#getResourcePath()} the system tries to get the parent resource

move

Resource move(Resource target,
            Resource destination,
            DavSession session)
              throws org.apache.jackrabbit.webdav.DavException

Moves a resource named target to the folder dictionary destination

Parameters:

target - the resource that is involved

destination - the destination of the move operation

session - the current session

Returns:

the moved resource

Throws:

org.apache.jackrabbit.webdav.DavException

streamIn

void streamIn(Resource resource,
            InputStream is)

Parameters:

resource -

is -

streamOut

InputStream streamOut(Resource resource)

Parameters:

resource -

Returns:

deleteResource

void deleteResource(Resource resource,
                  DavSession session)
                    throws org.apache.jackrabbit.webdav.DavException

Deletion of a resource within logicalDOC.

Parameters:

resource - a vaild resource

session - the current session

Throws:

org.apache.jackrabbit.webdav.DavException

copyResource

void copyResource(Resource destinResource,
                Resource resource,
                DavSession session)
                  throws org.apache.jackrabbit.webdav.DavException

Copying of a resource within logicalDOC. Not supported those days.

Parameters:

destinResource -

resource -

session - the current session

Throws:

org.apache.jackrabbit.webdav.DavException

checkout

void checkout(Resource resource,
            DavSession session)
              throws org.apache.jackrabbit.webdav.DavException

Versioning-part. Checkout causes the system to make a version "overwriteable" to put a new version on it.

Parameters:

resource - The appropriated resource that has to be checked out

session - the current session

Throws:

org.apache.jackrabbit.webdav.DavException

getHistory

List<Resource> getHistory(Resource resource)

Versioning-part. Based upon the current resource, the versionhistory is returned matches to this resource.

Parameters:

resource - The appropriated resource

Returns:

All Versions

uncheckout

void uncheckout(Resource resource,
              DavSession session)

Parameters:

resource -

session - the current session