com.sapportals.wcm.app.xmlforms

Class ResourceUtils

java.lang.Object

com.sapportals.wcm.app.xmlforms.ResourceUtils

public class ResourceUtils
extends Object

Method Summary

Modifier and Type	Method and Description
IResource	createOrUpdateResource(IResourceContext resContext, ICollection c, String name, IContent content, IPropertyMap props) Create a resource, or update its content and properties, if it exists
IResource	createOrUpdateResource(IResourceContext resContext, RID rid, IContent content, IPropertyMap props) Create a resource, or update its content and properties, if it exists
IResource	createOrUpdateResource(IResourceContext resContext, String uri, IContent content, IPropertyMap props) Create a resource, or update its content and properties, if it exists
IResource	createOrUpdateResourceWithPropertyErrors(IResourceContext resContext, ICollection c, String name, IContent content, IPropertyMap props) Creates a resource, or update its content and properties, if it exists.
IResource	createOrUpdateResourceWithPropertyErrors(IResourceContext resContext, RID rid, IContent content, IPropertyMap props) Creates a resource, or update its content and properties, if it exists.
IResource	createOrUpdateResourceWithPropertyErrors(IResourceContext resContext, String uri, IContent content, IPropertyMap props) Creates a resource, or update its content and properties, if it exists.
IResource	createResource(ICollection c, String name, IContent content, IPropertyMap props, IResourceContext resContext) Create a resource
IResource	createResource(IResourceContext resContext, RID rid, IContent content, IPropertyMap props) Create a resource
IResource	createResource(IResourceContext resContext, String uri, IContent content, IPropertyMap props) Create a resource
boolean	existsResource(IResourceContext resContext, RID rid) Checks if a resource exists
boolean	existsResource(IResourceContext resContext, String uri) Checks if a resource exists
ICollection	getCollection(IResourceContext resContext, RID rid) Get a collection by its RID.
static ResourceUtils	getInstance()
IResource	getResource(IResourceContext resContext, RID rid) Get a resource by its RID
IResource	getResource(IResourceContext resContext, String uri) Get a resource by its URI
IResource	getResource(RID rid) Get a resource by its RID with the service context
IResource	getResource(String uri) Get a resource by its URI with the service context
IResourceFactory	getResourceFactory() Get a shared resource factory instance
IResource	getResourceNoException(IResourceContext resContext, RID rid) Get a resource by its RID, but do not throw an exception in error case
IResource	getResourceNoException(IResourceContext resContext, String uri) Get a resource by its URI, but do not throw an exception in error case
IResource	getResourceNoException(RID rid) Get a resource by its RID with the service context, but do not throw an exception in error case
IResource	getResourceNoException(String uri) Get a resource by its URI with the service context, but do not throw an exception in error case
IResourceContext	getServiceContext() Gets service context
InputStream	getUnfilteredContentStream(IResource res) Returns the content of this resource as a stream
IResource	updateResource(IResource resource, IContent content, IPropertyMap props) Update content and properties of an existing resource

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static ResourceUtils getInstance()
                                 throws XFException

Throws:

XFException

getResourceFactory

public IResourceFactory getResourceFactory()

Get a shared resource factory instance

Returns:

the resource factory

getResource

public IResource getResource(String uri)
                      throws XFException

Get a resource by its URI with the service context

Parameters:

uri - the resource URI

Returns:

an IResource, or null, if the resource does not exist

Throws:

XFException - if there is a problem to get a resource with the provided uri

getResource

public IResource getResource(RID rid)
                      throws XFException

Get a resource by its RID with the service context

Parameters:

rid - the resource RID

Returns:

an IResource, or null, if the resource does not exist

Throws:

XFException - if there is a problem to get a resource with the provided rid

getResource

public IResource getResource(IResourceContext resContext,
                             String uri)
                      throws XFException

Get a resource by its URI

Parameters:

resContext - the context to use

uri - the resource URI

Returns:

an IResource, or null, if the resource does not exist

Throws:

XFException - if there is a problem to get a resource with the provided uri, e.g. access denied to this resource or locked resource.

getResource

public IResource getResource(IResourceContext resContext,
                             RID rid)
                      throws XFException

Get a resource by its RID

Parameters:

resContext - the context to use

rid - the resource RID

Returns:

an IResource, or null, if the resource does not exist

Throws:

XFException - if there is a problem to get a resource with the provided uri, e.g. access denied to this resource or locked resource.

getCollection

public ICollection getCollection(IResourceContext resContext,
                                 RID rid)
                          throws XFException

Get a collection by its RID. If the collection does not exist, it is created.

Parameters:

resContext - the context to use

rid - the collection RID

Returns:

an ICollection representing the collection

Throws:

XFException - if there is a problem to get a collection with the provided rid, e.g. access denied to this collection, collection is locked or the provided rid is not a collection rid.

existsResource

public boolean existsResource(IResourceContext resContext,
                              String uri)
                       throws XFException

Checks if a resource exists

Parameters:

resContext - the context to use

uri - the resource URI

Returns:

true, if the resource exists, false otherwise

Throws:

XFException - if there is a problem to get a resource with the provided uri

existsResource

public boolean existsResource(IResourceContext resContext,
                              RID rid)
                       throws XFException

Checks if a resource exists

Parameters:

resContext - the context to use

rid - the resource RID

Returns:

true, if the resource exists, false otherwise

Throws:

XFException - in case there is a problem to get a resource with the provided rid

getResourceNoException

public IResource getResourceNoException(IResourceContext resContext,
                                        String uri)

Get a resource by its URI, but do not throw an exception in error case

Parameters:

resContext - the context to use

uri - the resource URI

Returns:

an IResource, or null, if the resource does not exist, or if an error occurred

getResourceNoException

public IResource getResourceNoException(IResourceContext resContext,
                                        RID rid)

Get a resource by its RID, but do not throw an exception in error case

Parameters:

resContext - the context to use

rid - the resource RID

Returns:

an IResource, or null, if the resource does not exist, or if an error occurred

getResourceNoException

public IResource getResourceNoException(String uri)

Get a resource by its URI with the service context, but do not throw an exception in error case

Parameters:

uri - the resource URI

Returns:

an IResource, or null, if the resource does not exist, or if an error occurred

getResourceNoException

public IResource getResourceNoException(RID rid)

Get a resource by its RID with the service context, but do not throw an exception in error case

Parameters:

rid - the resource RID

Returns:

an IResource, or null, if the resource does not exist, or if an error occurred

createResource

public IResource createResource(ICollection c,
                                String name,
                                IContent content,
                                IPropertyMap props,
                                IResourceContext resContext)
                         throws XFException

Create a resource

Parameters:

c - the parent collection

name - the name of the new resource

content - the content of the new resource

props - the resource properties

resContext - the context to use

Returns:

a handle to the new resource

Throws:

XFException - in case there is a problem to create a resource in the provided collection with the provided name or access denied to the provided collection

createResource

public IResource createResource(IResourceContext resContext,
                                String uri,
                                IContent content,
                                IPropertyMap props)
                         throws XFException

Create a resource

Parameters:

resContext - the context to use

uri - the URI of the new resource

content - the content of the new resource

props - the resource properties

Returns:

a handle to the new resource

Throws:

XFException - if there is a problem to create a resource with the provided uri

createResource

public IResource createResource(IResourceContext resContext,
                                RID rid,
                                IContent content,
                                IPropertyMap props)
                         throws XFException

Create a resource

Parameters:

resContext - the context to use

rid - the RID of the new resource

content - the content of the new resource

props - the resource properties

Returns:

a handle to the new resource

Throws:

XFException - there is a problem to create a resource with the provided rid

createOrUpdateResource

public IResource createOrUpdateResource(IResourceContext resContext,
                                        ICollection c,
                                        String name,
                                        IContent content,
                                        IPropertyMap props)
                                 throws XFException

Create a resource, or update its content and properties, if it exists

Parameters:

resContext - the context to use

c - the parent collection

name - the new or existing resource name

content - the new resource content

props - the new resource properties

Returns:

a handle to the resource

Throws:

XFException - if cannot get RID of parent collection or if there is a problem to create/update a resource with the provided name

createOrUpdateResource

public IResource createOrUpdateResource(IResourceContext resContext,
                                        RID rid,
                                        IContent content,
                                        IPropertyMap props)
                                 throws XFException

Create a resource, or update its content and properties, if it exists

Parameters:

resContext - the context to use

rid - the RID of the new or existing resource

content - the new resource content

props - the new resource properties

Returns:

a handle to the resource

Throws:

XFException - if there is a problem to get, create or update a resource with the provided rid

createOrUpdateResource

public IResource createOrUpdateResource(IResourceContext resContext,
                                        String uri,
                                        IContent content,
                                        IPropertyMap props)
                                 throws XFException

Create a resource, or update its content and properties, if it exists

Parameters:

resContext - the context to use

uri - the URI of the new or existing resource

content - the new resource content

props - the new resource properties

Returns:

a handle to the resource

Throws:

XFException - if there is a problem to get, create or update a resource with the provided rid

updateResource

public IResource updateResource(IResource resource,
                                IContent content,
                                IPropertyMap props)
                         throws XFException

Update content and properties of an existing resource

Parameters:

resource - the resource to update

content - the new resource content

props - the new resource properties.

Returns:

a handle to the resource

Throws:

XFException - if there is a problem to get resource properties, e.g. get properties not supported or access denied to this resource, or resource is locked.

getUnfilteredContentStream

public InputStream getUnfilteredContentStream(IResource res)
                                       throws XFException

Returns the content of this resource as a stream

Parameters:

res - handle to the resource

Returns:

InputStream to unfiltered resource content

Throws:

XFException - if there is a problem to get a resource content of the provided resource, e.g. the resource has not content, access denied or resource is locked.

getServiceContext

public IResourceContext getServiceContext()
                                   throws XFException

Gets service context

Returns:

ResourceContext

Throws:

XFException - If cannot get service context

createOrUpdateResourceWithPropertyErrors

public IResource createOrUpdateResourceWithPropertyErrors(IResourceContext resContext,
                                                          ICollection c,
                                                          String name,
                                                          IContent content,
                                                          IPropertyMap props)
                                                   throws XFException,
                                                          AbstractPropertyException,
                                                          SetPropertiesException

Creates a resource, or update its content and properties, if it exists. Throw property exceptions, if any.

Parameters:

resContext - the context to use

c - the parent collection

name - the new or existing resource name

content - the new resource content

props - the new resource properties

Returns:

a handle to the resource

Throws:

XFException - in case there is a problem to get, create or update a resource with the provided name

AbstractPropertyException - in case there is a problem to get, create or update a resource with the provided name

SetPropertiesException - in case there is a problem to get, create or update a resource with the provided name

createOrUpdateResourceWithPropertyErrors

public IResource createOrUpdateResourceWithPropertyErrors(IResourceContext resContext,
                                                          RID rid,
                                                          IContent content,
                                                          IPropertyMap props)
                                                   throws XFException,
                                                          AbstractPropertyException,
                                                          SetPropertiesException

Creates a resource, or update its content and properties, if it exists. Throw property exceptions, if any.

Parameters:

resContext - the context to use

rid - the RID of the new or existing resource

content - the new resource content

props - the new resource properties

Returns:

a handle to the resource

Throws:

XFException - in case there is a problem to get, create or update a resource with the provided rid

AbstractPropertyException - in case there is a problem to get, create or update a resource with the provided rid

SetPropertiesException - in case there is a problem to get, create or update a resource with the provided rid

createOrUpdateResourceWithPropertyErrors

public IResource createOrUpdateResourceWithPropertyErrors(IResourceContext resContext,
                                                          String uri,
                                                          IContent content,
                                                          IPropertyMap props)
                                                   throws XFException,
                                                          AbstractPropertyException,
                                                          SetPropertiesException

Creates a resource, or update its content and properties, if it exists. Throw property exceptions, if any.

Parameters:

resContext - the context to use

uri - the URI of the new or existing resource

content - the new resource content

props - the new resource properties

Returns:

a handle to the resource

Throws:

XFException - in case there is a problem to get, create or update a resource with the provided uri

AbstractPropertyException - in case there is a problem to get, create or update a resource with the provided uri

SetPropertiesException - in case there is a problem to get, create or update a resource with the provided uri