com.ibm.workplace.wcm.api
Interface Reference

public interface Reference

An interface defining a reference from one entity in the repository to another.

Method Summary

boolean	canClear() Indicates if the reference from the referer Document to the referee Document can be cleared.
boolean	canReplace() Indicates if the reference from the referer Document to the referee Document can be replaced with another referee.
void	clear() Clear the reference from the referer Document to the referee Document.
com.ibm.workplace.wcm.api.DocumentId	getRefererDocumentId() Returns the DocumentId of the Document object being referring to another Document.
void	replace(com.ibm.workplace.wcm.api.DocumentId replacementId) Replace the referer's reference with the specified Document

Method Detail

getRefererDocumentId

public com.ibm.workplace.wcm.api.DocumentId getRefererDocumentId()

Returns the DocumentId of the Document object being referring to another Document.

Returns:

the DocumentId of the referer Document

Throws:

java.lang.NullPointerException - if the name of the referer Document has not been set.

canClear

public boolean canClear()

Indicates if the reference from the referer Document to the referee Document can be cleared.

Returns:

true if the reference can be cleared.

canReplace

public boolean canReplace()

Indicates if the reference from the referer Document to the referee Document can be replaced with another referee.

Returns:

true if the reference can be replaced.

clear

public void clear()
           throws AuthorizationException,
                  OperationFailedException

Clear the reference from the referer Document to the referee Document.

Throws:

AuthorizationException - if the user is not allowed to modify the reference

OperationFailedException - if the reference is not clearable or if an item not found or repository exception is encountered.

replace

public void replace(com.ibm.workplace.wcm.api.DocumentId replacementId)
             throws AuthorizationException,
                    OperationFailedException,
                    IllegalTypeChangeException

Replace the referer's reference with the specified Document

Parameters:

replacementId - the DocumentID of the Document that is to become the new referee.

Throws:

AuthorizationException - if the user is not allowed to modify the reference

OperationFailedException - if the reference is not replacable or if an item not found or repository exception is encountered.

IllegalTypeChangeException - if the Document specified by replacementId is not of a suitable type to be used as a replacement for the reference.