com.jivesoftware.community.webservices
Interface TagService

public interface TagService

Provides a service to create, retrieve and delete tags.

Method Summary

void	addTag(java.lang.String tag, JiveObject jiveObject) Associates a tag with this object
ContentTag	createTag(java.lang.String tagname) Creates a tag in the database.
ContentTag	getTagByID(long tagID) Returns a tag given a tag ID.
ContentTag	getTagByName(java.lang.String tagname) Returns a tag by tag name.
ContentTag[]	getTags(JiveObject jiveObject) Return an Iterable for all the tags associated with this manager.
void	removeAllTags(JiveObject jiveObject) Disassociates this object with all tags.
void	removeTag(java.lang.String tag, JiveObject jiveObject) Disassociates this object with the given tag.

Method Detail

createTag

ContentTag createTag(java.lang.String tagname)

Creates a tag in the database.

Parameters:

tagname - the name of the tag to create.

Returns:

the newly created tag.

getTagByName

ContentTag getTagByName(java.lang.String tagname)
                        throws com.jivesoftware.community.TagObjectNotFoundException

Returns a tag by tag name.

Parameters:

tagname - the name of the tag to lookup.

Returns:

the tag

Throws:

com.jivesoftware.community.TagObjectNotFoundException - if no tag exists with that name.

getTagByID

ContentTag getTagByID(long tagID)
                      throws com.jivesoftware.community.TagObjectNotFoundException

Returns a tag given a tag ID.

Parameters:

tagID - The id of the tag.

Returns:

the tag

Throws:

com.jivesoftware.community.TagObjectNotFoundException - if no tag exists with that ID.

addTag

void addTag(java.lang.String tag,
            JiveObject jiveObject)
            throws UnauthorizedException

Associates a tag with this object

Parameters:

jiveObject - The object to add a tag for.

tag - The tag, must be the unfiltered value.

Throws:

UnauthorizedException - if does not have permission to the tag @param tag The tag to add

getTags

ContentTag[] getTags(JiveObject jiveObject)

Return an Iterable for all the tags associated with this manager.

Parameters:

jiveObject - Tags to acquire.

Returns:

an Iterable for all tags associated with this manager.

removeTag

void removeTag(java.lang.String tag,
               JiveObject jiveObject)
               throws UnauthorizedException

Disassociates this object with the given tag.

Parameters:

jiveObject - The jive Object to remove a tag for.

tag - The tag, must be the unfiltered value.

Throws:

UnauthorizedException - if does not have permission to remove tag. @param tag the tag to remove from this object

removeAllTags

void removeAllTags(JiveObject jiveObject)
                   throws UnauthorizedException

Disassociates this object with all tags.

Parameters:

jiveObject - The jive object to remove all the tags from.

Throws:

UnauthorizedException - if user does not have administrator permissions.