org.alfresco.service.cmr.repository
Interface CopyService

All Known Implementing Classes:
CopyServiceImpl

public interface CopyService

Copy operations service interface.

This interface provides methods to copy nodes within and across workspaces and to update the state of a node, with that of another node, within and across workspaces.


Nested Class Summary
static class CopyService.CopyInfo
          Data pojo to carry information about node copies
 
Method Summary
 void copy(org.alfresco.service.cmr.repository.NodeRef sourceNodeRef, org.alfresco.service.cmr.repository.NodeRef destinationNodeRef)
          Copies the state of one node on top of another.
 org.alfresco.service.cmr.repository.NodeRef copy(org.alfresco.service.cmr.repository.NodeRef sourceNodeRef, org.alfresco.service.cmr.repository.NodeRef targetParentNodeRef, org.alfresco.service.namespace.QName assocTypeQName, org.alfresco.service.namespace.QName assocQName)
          By default children of the source node are not copied.
 org.alfresco.service.cmr.repository.NodeRef copy(org.alfresco.service.cmr.repository.NodeRef sourceNodeRef, org.alfresco.service.cmr.repository.NodeRef targetParentNodeRef, org.alfresco.service.namespace.QName assocTypeQName, org.alfresco.service.namespace.QName assocQName, boolean copyChildren)
          Creates a copy of the given node.
 org.alfresco.service.cmr.repository.NodeRef copyAndRename(org.alfresco.service.cmr.repository.NodeRef sourceNodeRef, org.alfresco.service.cmr.repository.NodeRef targetParentNodeRef, org.alfresco.service.namespace.QName assocTypeQName, org.alfresco.service.namespace.QName assocQName, boolean copyChildren)
           
 java.util.List getCopies(org.alfresco.service.cmr.repository.NodeRef nodeRef)
          Deprecated. This method is too open-ended. See CopyService.getCopies(NodeRef, PagingRequest).
 org.alfresco.query.PagingResults getCopies(org.alfresco.service.cmr.repository.NodeRef originalNodeRef, org.alfresco.service.cmr.repository.NodeRef copyParentNodeRef, org.alfresco.query.PagingRequest pagingRequest)
          Get the copies of a given node
 org.alfresco.query.PagingResults getCopies(org.alfresco.service.cmr.repository.NodeRef originalNodeRef, org.alfresco.query.PagingRequest pagingRequest)
          Get the copies of a given node
 org.alfresco.service.cmr.repository.NodeRef getOriginal(org.alfresco.service.cmr.repository.NodeRef copiedNodeRef)
          Get the original for a given copied node
 

Method Detail

copy

@Auditable(parameters={"sourceNodeRef", "targetParentNodeRef", "assocTypeQName", "assocQName", "copyChildren"})
org.alfresco.service.cmr.repository.NodeRef copy(org.alfresco.service.cmr.repository.NodeRef sourceNodeRef,
                                                           org.alfresco.service.cmr.repository.NodeRef targetParentNodeRef,
                                                           org.alfresco.service.namespace.QName assocTypeQName,
                                                           org.alfresco.service.namespace.QName assocQName,
                                                           boolean copyChildren)
Creates a copy of the given node.

If the new node resides in a different workspace the new node will have the same id.

NOTE: It is up to the client code to set the name of the newly created node. Use the node service and catch the DuplicateChildNodeNameException

If the new node resides in the same workspace then the new node will have the Copy aspect applied to it which will reference the original node.

The aspects applied to source node will also be applied to destination node and all the property value will be duplicated accordingly. This is with the exception of the aspects that have been marked as having 'Non-Transferable State'. In this case the aspect will be applied to the copy, but the properties will take on the default values.

Child associations are copied onto the destination node. If the child of copied association is not present in the destination workspace the child association is not copied. This is unless is has been specified that the children of the source node should also be copied.

Target associations are copied to the destination node. If the target of the association is not present in the destination workspace then the association is not copied.

Source association are not copied.

NOTE: The top-level node has it's cm:name property removed for associations that do not allow duplicately named children in order to prevent any chance of a duplicate name clash. Reassign the cm:name property and catch the DuplicateChildNodeNameException.

Parameters:
sourceNodeRef - the node reference used as the source of the copy
targetParentNodeRef - the intended parent of the new node
assocTypeQName - the type of the new child assoc
assocQName - the qualified name of the child association from the parent to the new node
copyChildren - indicates that the children of the node should also be copied
Returns:
the new node reference

copyAndRename

@Auditable(parameters={"sourceNodeRef", "targetParentNodeRef", "assocTypeQName", "assocQName", "copyChildren"})
org.alfresco.service.cmr.repository.NodeRef copyAndRename(org.alfresco.service.cmr.repository.NodeRef sourceNodeRef,
                                                                    org.alfresco.service.cmr.repository.NodeRef targetParentNodeRef,
                                                                    org.alfresco.service.namespace.QName assocTypeQName,
                                                                    org.alfresco.service.namespace.QName assocQName,
                                                                    boolean copyChildren)
Parameters:
sourceNodeRef - the node reference used as the source of the copy
targetParentNodeRef - the intended parent of the new node
assocTypeQName - the type of the new child assoc
assocQName - the qualified name of the child association from the parent to the new node
copyChildren - indicates that the children of the node should also be copied
Returns:
the new node reference
See Also:
Ensures the copy name is the same as the origional or is renamed to prevent duplicate names.

copy

@Auditable(parameters={"sourceNodeRef", "targetParentNodeRef", "assocTypeQName", "assocQName"})
org.alfresco.service.cmr.repository.NodeRef copy(org.alfresco.service.cmr.repository.NodeRef sourceNodeRef,
                                                           org.alfresco.service.cmr.repository.NodeRef targetParentNodeRef,
                                                           org.alfresco.service.namespace.QName assocTypeQName,
                                                           org.alfresco.service.namespace.QName assocQName)
By default children of the source node are not copied.

Parameters:
sourceNodeRef - the node reference used as the source of the copy
targetParentNodeRef - the intended parent of the new node
assocTypeQName - the type of the new child assoc
assocQName - the qualified name of the child association from the parent to the new node
Returns:
the new node reference
See Also:
CopyService.copy(NodeRef, NodeRef, QName, QName, boolean)

copy

@Auditable(parameters={"sourceNodeRef", "destinationNodeRef"})
void copy(org.alfresco.service.cmr.repository.NodeRef sourceNodeRef,
                    org.alfresco.service.cmr.repository.NodeRef destinationNodeRef)
Copies the state of one node on top of another.

The state of destination node is overlayed with the state of the source node. Any conflicts are resolved by setting the state to that of the source node.

If data (for example an association) does not exist on the source node, but does exist on the destination node this data is NOT deleted from the destination node.

Child associations and target associations are updated on the destination based on the current state of the source node.

If the node that either a child or target association points to on the source node is not present in the destinations workspace then the association is not updated to the destination node.

All aspects found on the source node are applied to the destination node where missing. The properties of the aspects are updated accordingly except in the case where the aspect has been marked as having 'Non-Transferable State'. In this case aspect properties will take on the values already assigned to them in the destination node.

Parameters:
sourceNodeRef - the source node reference
destinationNodeRef - the destination node reference

getOriginal

@Auditable(parameters="nodeRef")
org.alfresco.service.cmr.repository.NodeRef getOriginal(org.alfresco.service.cmr.repository.NodeRef copiedNodeRef)
Get the original for a given copied node

Parameters:
copiedNodeRef - the copied node reference
Returns:
the original node reference or null if it isn't a copy or the original has been deleted

getCopies

@Auditable(parameters="nodeRef")
java.util.List getCopies(org.alfresco.service.cmr.repository.NodeRef nodeRef)
Deprecated. This method is too open-ended. See CopyService.getCopies(NodeRef, PagingRequest).

Gets all the copies of a given node that have been made using this service.

Parameters:
nodeRef - the original node reference
Returns:
a list of copies, empty is none

getCopies

@Auditable(parameters="originalNodeRef")
org.alfresco.query.PagingResults getCopies(org.alfresco.service.cmr.repository.NodeRef originalNodeRef,
                                                     org.alfresco.query.PagingRequest pagingRequest)
Get the copies of a given node

Parameters:
originalNodeRef - the original node reference
pagingRequest - page request details
Returns:
the page(s) of nodes that were copied from the given node

getCopies

@Auditable(parameters={"originalNodeRef", "copyParentNodeRef"})
org.alfresco.query.PagingResults getCopies(org.alfresco.service.cmr.repository.NodeRef originalNodeRef,
                                                     org.alfresco.service.cmr.repository.NodeRef copyParentNodeRef,
                                                     org.alfresco.query.PagingRequest pagingRequest)
Get the copies of a given node

Parameters:
originalNodeRef - the original node reference
copyParentNodeRef - only find copies that are homed in this node
copyNodeAspectsToIgnore - only find copies that don't have these aspects
pagingRequest - page request details
Returns:
the page(s) of nodes that were copied from the given node


Copyright © 2005 - 2010 Alfresco Software, Inc. All Rights Reserved.