com.ibm.workplace.wcm.api
Interface Editable

All Superinterfaces:

Document

All Known Subinterfaces:

Content, ContentComponentContainer, Site, SiteArea, SiteFrameworkContainer

public interface Editable

extends Document

Defines the behaviour for editable objects within the API.

Editable objects may have their attributes set and changed.

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

A successful call to methods in this interface other than isChanged() will result in a call to isChanged() returning true.

Field Summary

static java.lang.String

COPYRIGHT Copyright statement

Method Summary

void	addAuthors(java.lang.String[] p_authors) Adds each author specified in the string array argument to the authors of this Editable object.
void	addDeleteAccessMembers(java.lang.String[] p_members) Adds each name specified in the string array argument to the members who have Delete access to this Editable object.
void	addEditAccessMembers(java.lang.String[] p_members) Adds each name specified in the string array argument to the members who have Edit access to this Editable object.
void	addLiveAccessMembers(java.lang.String[] p_members) Adds each name specified in the string array argument to the members who have Live access to this Editable object.
void	addOwners(java.lang.String[] p_owners) Adds each owner specified in the string array argument to the owners of this Editable object.
void	addReadAccessMembers(java.lang.String[] p_members) Adds each name specified in the string array argument to the members who have Read access to this Editable 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 Editable object.
void	removeDeleteAccessMembers(java.lang.String[] p_members) Removes each name specified in the string array argument from the members who have Delete access to this Editable object.
void	removeEditAccessMembers(java.lang.String[] p_members) Removes each name specified in the string array argument from the members who have Edit access to this Editable object.
void	removeLiveAccessMembers(java.lang.String[] p_members) Removes each name specified in the string array argument from the members who have Live access to this Editable object.
void	removeOwners(java.lang.String[] p_owners) Removes each owner specified in the string array argument from the owners of this Editable object.
void	removeReadAccessMembers(java.lang.String[] p_members) Removes each name specified in the string array argument from the members who have Read access to this Editable object.
void	setDescription(java.lang.String m_description) Sets the description of this Editable object to the specified String argument.
void	setName(java.lang.String m_name) Sets the name of this Editable 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 Editable object 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 Editable object has changed; false otherwise

setName

public void setName(java.lang.String m_name)

Sets the name of this Editable 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 Editable 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 author specified in the string array argument to the authors of this Editable object.

An author is only added if the element in the string array argument can be converted to a valid member.

Note: Each author of this Editable 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 Editable object.

An author is only removed if the element in the string array argument can be converted to a valid member and already an author on this Editable object.

Parameters:

p_authors - the authors names to remove

addOwners

public void addOwners(java.lang.String[] p_owners)

Adds each owner specified in the string array argument to the owners of this Editable object.

An owner is only added if the element in the string array argument can be converted to a valid member.

Note: Each owner of this Editable 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 Editable object.

An owner is only removed if the element in the string array argument can be converted to a valid member and already an owner on this Editable object.

Parameters:

p_owners - the owners names to remove

addLiveAccessMembers

public void addLiveAccessMembers(java.lang.String[] p_members)

Adds each name specified in the string array argument to the members who have Live access to this Editable object.

A name is only added if the element in the string array argument can be converted to a valid member.

Note: Each Live access member of this Editable 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 who have Read access to this Editable object.

A name is only added if the element in the string array argument can be converted to a valid member.

Note: Each Read access member of this Editable 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 who have Edit access to this Editable object.

A name is only added if the element in the string array argument can be converted to a valid member.

Note: Each Edit access member of this Editable 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 who have Delete access to this Editable object.

A name is only added if the element in the string array argument can be converted to a valid member.

Note: Each Delete access member of this Editable 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 who have Live access to this Editable object.

A name is only removed if the element in the string array argument can be converted to a valid member and already has Live access to this Editable object.

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 who have Read access to this Editable object.

A name is only removed if the element in the string array argument can be converted to a valid member and already has Read access to this Editable object.

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 who have Edit access to this Editable object.

A name is only removed if the element in the string array argument can be converted to a valid member and already has Edit access to this Editable object.

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 who have Delete access to this Editable object.

A name is only removed if the element in the string array argument can be converted to a valid member and already has Delete access to this Editable object.

Parameters:

p_members - the names of members to remove from Delete access