com.sap.netweaver.bc.rf.mi.binding

Interface IMutableBindingManager

All Superinterfaces:

IBindingManager

public interface IMutableBindingManager

extends IBindingManager

TBD: Insufficient description. Read-And-Write interface describing a repository sub manager for bindings. Note: Please do not activate this package as-is, but try to reintegrate it into the namespace package. There are many similar but just temporarily extended interfaces/classes in the common namespace package also.

Method Summary

List	copyResource(IResourceHandle resourceHandle, ICopyDescriptor copyDescriptor) Copy resource based on a resource copy descriptor.
IResourceHandle	createResource(IBindingCreateDescriptor createDescriptor) Create resource based on a resource create descriptor.
List	deleteResource(IResourceHandle resourceHandle) Delete resource.
List	moveResource(IResourceHandle resourceHandle, IMoveDescriptor moveDescriptor) Move resource based on a resource move descriptor.

Methods inherited from interface com.sap.netweaver.bc.rf.mi.binding.IBindingManager

getBindings

Method Detail

createResource

public IResourceHandle createResource(IBindingCreateDescriptor createDescriptor)
                               throws ResourceException

Create resource based on a resource create descriptor. Default resource create descriptors reside in the same package as the interface does. A repository may supports these and/or others.

Parameters:

createDescriptor - create descriptor

Returns:

resource handle of the newly created resource

Throws:

ResourceException - when wrong parameterized, the resource create descriptor is not supported by the repository or the query failed due to other reasons

deleteResource

public List deleteResource(IResourceHandle resourceHandle)
                    throws ResourceException,
                           OperationNotCompletedException

Delete resource. All children will be deleted also, i.e. there is only deep delete. The first returned resource handle must be the deleted root resource handle, if this operation succeeded at all.

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:

resourceHandle - resource handle

Returns:

list of all deleted resources; resources failed to be deleted either of repository-internal reasons, follow-up reasons or others are stored with their respective exception inside the list

Throws:

ResourceException - when wrong parameterized or the query failed due to other reasons

OperationNotCompletedException - when the operation failed in parts

copyResource

public List copyResource(IResourceHandle resourceHandle,
                         ICopyDescriptor copyDescriptor)
                  throws ResourceException,
                         OperationNotCompletedException

Copy resource based on a resource copy descriptor. Default resource copy descriptors reside in the same package as the interface does. A repository may supports these and/or others. The first returned resource handle must be the copied root resource handle, if this operation succeeded at all.

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:

resourceHandle - resource handle

copyDescriptor - copy descriptor

Returns:

list of all newly created copied resources; resources failed to be copied either of repository-internal reasons, follow-up reasons or others are stored with their respective exception inside the list

Throws:

ResourceException - when wrong parameterized, the resource copy descriptor is not supported by the repository or the query failed due to other reasons

OperationNotCompletedException - when the operation failed in parts

moveResource

public List moveResource(IResourceHandle resourceHandle,
                         IMoveDescriptor moveDescriptor)
                  throws ResourceException,
                         OperationNotCompletedException

Move resource based on a resource move descriptor. Default resource move descriptors reside in the same package as the interface does. A repository may supports these and/or others. The first returned resource handle must be the moved root resource handle, if this operation succeeded at all.

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:

resourceHandle - resource handle

moveDescriptor - move descriptor

Returns:

list of all moved resources; resources failed to be moved either of repository-internal reasons, follow-up reasons or others are stored with their respective exception inside the list

Throws:

ResourceException - when wrong parameterized, the resource move descriptor is not supported by the repository or the query failed due to other reasons

OperationNotCompletedException - when the operation failed in parts