com.sapportals.wcm.repository

Interface IExtendedCollection

public interface IExtendedCollection

Extended interface for collections, providing
- extended link creation methods.
- workspace support methods.

Copyright (c) SAP AG 2002-2005

Method Summary

IResource	createExternalLink(String name, IUri absoluteTargetUri, boolean isPermanent, IPosition position, IPropertyMap properties, boolean ignorePropertyFailures) Creates an external link, compatible to LinkType.EXTERNAL
IResource	createInternalDynamicLink(String name, RID targetRid, IPosition position, IPropertyMap properties, boolean ignorePropertyFailures) Creates an internal link that automatically follows the target resource and disappears when the link target disappears.
IResource	createInternalStaticLink(String name, RID targetRid, boolean isPermanent, IPosition position, IPropertyMap properties, boolean ignorePropertyFailures) Creates an internal link, compatible to LinkType.INTERNAL
IResource	createVersionControlledResource(RID baseRevisionRid, String name, IPosition position) If called on a workspace controlled collection, a new version controlled resource based on the given revision is created
ICollection	createWorkspace(String name, IPosition position) Creates a new workspace resource.
IResourceList	getChildren(Boolean visible, Boolean collections, Boolean links) Returns a filtered list of the resources in this collection.

Method Detail

createExternalLink

public IResource createExternalLink(String name,
                                    IUri absoluteTargetUri,
                                    boolean isPermanent,
                                    IPosition position,
                                    IPropertyMap properties,
                                    boolean ignorePropertyFailures)
                             throws ResourceException

Creates an external link, compatible to LinkType.EXTERNAL

Parameters:

name - member name in collection

isPermanent - whether the redirection is temporary (continue using the RID of the link) or permanent (use of the RID of the link discouraged)

position - position where to create the link (or null when unspecified)

properties - initial property map for link resource

ignorePropertyFailures - set to true to ignore errors while initializing the property map

absoluteTargetUri - link target (either an absolute URI or a relative URI reference starting with an absolute path)

Returns:

link resource

Throws:

ResourceException

createInternalDynamicLink

public IResource createInternalDynamicLink(String name,
                                           RID targetRid,
                                           IPosition position,
                                           IPropertyMap properties,
                                           boolean ignorePropertyFailures)
                                    throws ResourceException

Creates an internal link that automatically follows the target resource and disappears when the link target disappears. Note that this type of link can only be created when the link target already exists.

Note that a relative RID will be resolved upon creation of the link resource.

Parameters:

name - member name in collection

targetRid - link target

position - position where to create the link (or null when unspecified)

properties - initial property map for link resource

ignorePropertyFailures - set to true to ignore errors while initializing the property map

Returns:

link resource

Throws:

ResourceException

createInternalStaticLink

public IResource createInternalStaticLink(String name,
                                          RID targetRid,
                                          boolean isPermanent,
                                          IPosition position,
                                          IPropertyMap properties,
                                          boolean ignorePropertyFailures)
                                   throws ResourceException

Creates an internal link, compatible to LinkType.INTERNAL

Parameters:

name - member name in collection

isPermanent - whether the redirection is temporary (continue using the RID of the link) or permanent (use of the RID of the link discouraged)

position - position where to create the link (or null when unspecified)

properties - initial property map for link resource

ignorePropertyFailures - set to true to ignore errors while initializing the property map

targetRid - link target

Returns:

link resource

Throws:

ResourceException

createWorkspace

public ICollection createWorkspace(String name,
                                   IPosition position)
                            throws ResourceException,
                                   NotSupportedException

Creates a new workspace resource.

Parameters:

name - member name in collection

position - position where to create the link (or null when unspecified)

Returns:

workspace resource

Throws:

NotSupportedException - if called on a resource that is not a workspace collection

ResourceException

createVersionControlledResource

public IResource createVersionControlledResource(RID baseRevisionRid,
                                                 String name,
                                                 IPosition position)
                                          throws ResourceException,
                                                 NotSupportedException

If called on a workspace controlled collection, a new version controlled resource based on the given revision is created

Parameters:

baseRevisionRid - the rid of the new vcr's base revision

name - member name in collection

position - position where to create the vcr (or null when unspecified)

Returns:

version controlled resource

Throws:

NotSupportedException - if called on a resource that is not a sibling of a workspace resource
- if the resource identified by baseRevisionRid doesn't exist or is no version resource

ResourceException

getChildren

public IResourceList getChildren(Boolean visible,
                                 Boolean collections,
                                 Boolean links)
                          throws ResourceException,
                                 AccessDeniedException

Returns a filtered list of the resources in this collection.

Parameters:

visible - true: only visible resource (system property "hidden" is false), false: only hidden resources, null: not relevant

collections - true: only collections, false: only resources which are not collections, null: note relevant

links - true: only links, false: only non-link resources, null: not relevant

Returns:

A list of resources

Throws:

AccessDeniedException - If the resource is locked, readonly or authorization failed

ResourceException