com.ibm.workplace.wcm.api
Interface EditableLibraryComponent

All Superinterfaces:
Document, LibraryComponent
All Known Subinterfaces:
LibraryFileComponent, LibraryHTMLComponent, LibraryImageComponent

public interface EditableLibraryComponent
extends LibraryComponent

The EditableLibraryComponent interface represents components that can be stored in the repository that are both Editable through this API and a Library Component.

Passing a null argument to a method of this interface will result in a NullPointerException, unless stated otherwise.

See Also:
Editable, LibraryComponent

Field Summary
static java.lang.String COPYRIGHT
          Copyright statement
 
Method Summary
 void addAuthors(java.lang.String[] p_authors)
          Adds each name specified in the string array argument to the authors of this EditableLibraryComponent object.
 void addDeleteAccessMembers(java.lang.String[] p_members)
          Adds each name specified in the string array argument to the members that have Delete access to this EditableLibraryComponent object.
 void addEditAccessMembers(java.lang.String[] p_members)
          Adds each name specified in the string array argument to the members that have Edit access to this EditableLibraryComponent object.
 void addLiveAccessMembers(java.lang.String[] p_members)
          Adds each name specified in the string array argument to the members that have Live access to this EditableLibraryComponent object.
 void addOwners(java.lang.String[] p_owners)
          Adds each name specified in the string array argument to the owners of this EditableLibraryComponent object.
 void addReadAccessMembers(java.lang.String[] p_members)
          Adds each name specified in the string array argument to the members that have Read access to this EditableLibraryComponent object.
 boolean isChanged()
          Returns the value of the changed flag.
 void removeAuthors(java.lang.String[] p_authors)
          Removes each author specified in the string array argument from the authors of this EditableLibraryComponent object.
 void removeDeleteAccessMembers(java.lang.String[] p_members)
          Removes each name specified in the string array argument from the members that have Delete access to this EditableLibraryComponent object.
 void removeEditAccessMembers(java.lang.String[] p_members)
          Removes each name specified in the string array argument from the members that have Edit access to this EditableLibraryComponent object.
 void removeLiveAccessMembers(java.lang.String[] p_members)
          Removes each name specified in the string array argument from the members that have Live access to this EditableLibraryComponent object.
 void removeOwners(java.lang.String[] p_owners)
          Removes each owner specified in the string array argument from the owners of this EditableLibraryComponent object.
 void removeReadAccessMembers(java.lang.String[] p_members)
          Removes each name specified in the string array argument from the members that have Read access to this EditableLibraryComponent object.
 void setDescription(java.lang.String m_description)
          Sets the description of this EditableLibraryComponent object to the specified String argument.
 void setName(java.lang.String m_name)
          Sets the name of this EditableLibraryComponent object to the specified String argument.
 
Methods inherited from interface com.ibm.workplace.wcm.api.Document
getAuthors, getDeleteAccessMembers, getDescription, getEditAccessMembers, getId, getLiveAccessMembers, getName, getOwners, getReadAccessMembers
 

Field Detail

COPYRIGHT

public static final java.lang.String COPYRIGHT
Copyright statement

See Also:
Constant Field Values
Method Detail

isChanged

public boolean isChanged()
Returns the value of the changed flag.

An EditableLibraryComponent is deemed to have changed if one or more attributes have been modified since it was last saved.

Returns:
true if at least one attribute of this EditableLibraryComponent has changed; false otherwise

setName

public void setName(java.lang.String m_name)
Sets the name of this EditableLibraryComponent object to the specified String argument.

Parameters:
m_name - the name

setDescription

public void setDescription(java.lang.String m_description)
Sets the description of this EditableLibraryComponent object to the specified String argument.

This method accepts a null argument.

Parameters:
m_description - the description

addAuthors

public void addAuthors(java.lang.String[] p_authors)
Adds each name specified in the string array argument to the authors of this EditableLibraryComponent object.

An author is only added if the name supplied in the string array argument can be converted to a valid member. Names that cannot be converted to a valid member are skipped and not added.

Note: Each author of this EditableLibraryComponent object must be unique. I.e. Duplicates are removed.

Parameters:
p_authors - the authors to add

removeAuthors

public void removeAuthors(java.lang.String[] p_authors)
Removes each author specified in the string array argument from the authors of this EditableLibraryComponent object.

An author is only removed if the name supplied in the string array argument can be converted to a valid member and already an author of this EditableLibraryComponent. Names that cannot be converted to a valid member are skipped.

Parameters:
p_authors - the authors to remove

addOwners

public void addOwners(java.lang.String[] p_owners)
Adds each name specified in the string array argument to the owners of this EditableLibraryComponent object.

An owner is only added if the name supplied in the string array argument can be converted to a valid member. Names that cannot be converted to a valid member are skipped and not added.

Note: Each owner of this EditableLibraryComponent object must be unique. I.e. Duplicates are removed.

Parameters:
p_owners - the owners to add

removeOwners

public void removeOwners(java.lang.String[] p_owners)
Removes each owner specified in the string array argument from the owners of this EditableLibraryComponent object.

An owner is only removed if the name supplied in the string array argument can be converted to a valid member and already an owner of this EditableLibraryComponent. Names that cannot be converted to a valid member are skipped.

Parameters:
p_owners - the owners to remove

addLiveAccessMembers

public void addLiveAccessMembers(java.lang.String[] p_members)
Adds each name specified in the string array argument to the members that have Live access to this EditableLibraryComponent object.

A name is only added if the name supplied in the string array argument can be converted to a valid member. Names that cannot be converted to a valid member are skipped and not added.

Note: Each owner of this EditableLibraryComponent object must be unique. I.e. Duplicates are removed.

Parameters:
p_members - the names of members to add to Live access

addReadAccessMembers

public void addReadAccessMembers(java.lang.String[] p_members)
Adds each name specified in the string array argument to the members that have Read access to this EditableLibraryComponent object.

A name is only added if the name supplied in the string array argument can be converted to a valid member. Names that cannot be converted to a valid member are skipped and not added.

Note: Each owner of this EditableLibraryComponent object must be unique. I.e. Duplicates are removed.

Parameters:
p_members - the names of members to add to Read access

addEditAccessMembers

public void addEditAccessMembers(java.lang.String[] p_members)
Adds each name specified in the string array argument to the members that have Edit access to this EditableLibraryComponent object.

A name is only added if the name supplied in the string array argument can be converted to a valid member. Names that cannot be converted to a valid member are skipped and not added.

Note: Each owner of this EditableLibraryComponent object must be unique. I.e. Duplicates are removed.

Parameters:
p_members - the names of members to add to Edit access

addDeleteAccessMembers

public void addDeleteAccessMembers(java.lang.String[] p_members)
Adds each name specified in the string array argument to the members that have Delete access to this EditableLibraryComponent object.

A name is only added if the name supplied in the string array argument can be converted to a valid member. Names that cannot be converted to a valid member are skipped and not added.

Note: Each owner of this EditableLibraryComponent object must be unique. I.e. Duplicates are removed.

Parameters:
p_members - the names of members to add to Delete access

removeLiveAccessMembers

public void removeLiveAccessMembers(java.lang.String[] p_members)
Removes each name specified in the string array argument from the members that have Live access to this EditableLibraryComponent object.

An owner is only removed if the name supplied in the string array argument can be converted to a valid member and already has Live access to this EditableLibraryComponent. Names that cannot be converted to a valid member are skipped.

Parameters:
p_members - the names of members to remove from Live access.

removeReadAccessMembers

public void removeReadAccessMembers(java.lang.String[] p_members)
Removes each name specified in the string array argument from the members that have Read access to this EditableLibraryComponent object.

An owner is only removed if the name supplied in the string array argument can be converted to a valid member and already has Read access to this EditableLibraryComponent. Names that cannot be converted to a valid member are skipped.

Parameters:
p_members - the names of members to remove from Read access.

removeEditAccessMembers

public void removeEditAccessMembers(java.lang.String[] p_members)
Removes each name specified in the string array argument from the members that have Edit access to this EditableLibraryComponent object.

An owner is only removed if the name supplied in the string array argument can be converted to a valid member and already has Edit access to this EditableLibraryComponent. Names that cannot be converted to a valid member are skipped.

Parameters:
p_members - the names of members to remove from Edit access.

removeDeleteAccessMembers

public void removeDeleteAccessMembers(java.lang.String[] p_members)
Removes each name specified in the string array argument from the members that have Delete access to this EditableLibraryComponent object.

An owner is only removed if the name supplied in the string array argument can be converted to a valid member and already has Delete access to this EditableLibraryComponent. Names that cannot be converted to a valid member are skipped.

Parameters:
p_members - the names of members to remove from Delete access.