com.sap.netweaver.bc.rf.mi.idmapper

Interface IMutableIdMapperManager

All Superinterfaces:

IIdMapperManager

public interface IMutableIdMapperManager
extends IIdMapperManager

Read-And-Write interface describing a repository sub manager for id mapping. Ids must identify a resource uniquely in the repository, no matter how its position or properties change. When its identity really gets lost or is replaced, the id must never be used again resp. a new id must be assigned to the new resource replacing the old (possibly on the same position). Ids must never be reused in order to undoubtedly identify a resource resp. that the resource no longer exists (e.g. when ids sent through emails are used to identify the referenced resource again). This interface allows to assign unique ids to resources in a repository from outside. They should be globally unique ids in order to fulfill the requirements (uniqueness, no reuse) in a performant way (no check expected here where all resources are checked for the new id in the repository).

Created 23. Januar 2003

Method Summary

Modifier and Type	Method and Description
void	assignToResource(IResourceHandle resourceHandle, String uniqueId) Assign unique id to resource handle.
void	assignToResources(Map uniqueIdsIndexedByResourceHandles) Assign list of unique ids to list of resource handles.
void	assignToRid(IRid resourceId, String uniqueId) Assign unique id to resource id.
void	assignToRids(Map uniqueIdsIndexedByResourceIds) Assign list of unique ids to list of resource ids.

Methods inherited from interface com.sap.netweaver.bc.rf.mi.idmapper.IIdMapperManager

getUniqueId, getUniqueIds, lookup, lookup

Method Detail

assignToRid

void assignToRid(IRid resourceId,
                 String uniqueId)
          throws ResourceException

Assign unique id to resource id.

Parameters:

resourceId - resource id

uniqueId - unique id to be assigned

Throws:

ResourceException - when a general problem occurs, the resource id is invalid or the unique id is already in use

assignToResource

void assignToResource(IResourceHandle resourceHandle,
                      String uniqueId)
               throws ResourceException

Assign unique id to resource handle.

Parameters:

resourceHandle - resource handle

uniqueId - unique id to be assigned

Throws:

ResourceException - when a general problem occurs, the resource handle is invalid or the unique id is already in use

assignToRids

void assignToRids(Map uniqueIdsIndexedByResourceIds)
           throws ResourceException,
                  OperationNotCompletedException

Assign list of unique ids to list of resource ids. Note: This method needs not to be handled atomically! Although this operation may fail in parts, the operation on one of the many operands provided through the parameter list is always expected to be atomic!

Parameters:

uniqueIdsIndexedByResourceIds - map of unique ids to be assigned indexed by resource ids

Throws:

ResourceException - when a general problem occurs

OperationNotCompletedException - when the operation failed in parts

assignToResources

void assignToResources(Map uniqueIdsIndexedByResourceHandles)
                throws ResourceException,
                       OperationNotCompletedException

Assign list of unique ids to list of resource handles. Note: This method needs not to be handled atomically! Although this operation may fail in parts, the operation on one of the many operands provided through the parameter list is always expected to be atomic!

Parameters:

uniqueIdsIndexedByResourceHandles - map of unique ids to be assigned indexed by resource handles

Throws:

ResourceException - when a general problem occurs

OperationNotCompletedException - when the operation failed in parts