org.nuxeo.ecm.platform.tag

Class TagServiceImpl

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.platform.tag.TagServiceImpl

All Implemented Interfaces:

TagService, Adaptable, Component, Extensible, TimestampedService

public class TagServiceImpl
extends DefaultComponent
implements TagService

The implementation of the tag service.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	TagServiceImpl.PAGE_PROVIDERS
protected static class	TagServiceImpl.UnrestrictedAddTagging
protected static class	TagServiceImpl.UnrestrictedCopyTags
protected static class	TagServiceImpl.UnrestrictedGetDocumentCloud
protected static class	TagServiceImpl.UnrestrictedGetDocumentTags
protected static class	TagServiceImpl.UnrestrictedGetTagDocumentIds
protected static class	TagServiceImpl.UnrestrictedGetTagSuggestions
protected static class	TagServiceImpl.UnrestrictedRemoveTagging

Field Summary

Fields

Modifier and Type	Field and Description
static String	NXTAG

Fields inherited from class org.nuxeo.runtime.model.DefaultComponent

lastModified

Fields inherited from interface org.nuxeo.ecm.platform.tag.TagService

ID

Constructor Summary

Constructors

Constructor and Description
TagServiceImpl()

Method Summary

Modifier and Type	Method and Description
protected static String	cleanLabel(String label, boolean allowEmpty, boolean allowPercent)
protected static String	cleanUsername(String username)
void	copyTags(CoreSession session, String srcDocId, String dstDocId) Copy all the tags applied to the source document to the destination document.
protected void	copyTags(CoreSession session, String srcDocId, String dstDocId, boolean removeExistingTags)
protected void	fireUpdateEvent(CoreSession session, String docId)
List<Tag>	getDocumentTags(CoreSession session, String docId, String username) Gets the tags applied to a document by a given user, or by all users.
List<Tag>	getDocumentTags(CoreSession session, String docId, String username, boolean useCore) Gets the tags applied to a document by a given user, or by all users.
protected static List<Map<String,Serializable>>	getItems(String pageProviderName, CoreSession session, Object... params) Returns results from calls to CoreSession.queryAndFetch(String, String, Object...) using page providers.
List<Tag>	getSuggestions(CoreSession session, String label, String username) Gets suggestions for a given tag label prefix.
List<Tag>	getTagCloud(CoreSession session, String docId, String username, Boolean normalize) Gets the tag cloud for a set of documents (tags with weight corresponding to their popularity).
List<String>	getTagDocumentIds(CoreSession session, String label, String username) Gets the documents to which a tag is applied.
boolean	isEnabled() Defines if tag service is enable.
static void	normalizeCloud(List<Tag> cloud, int min, int max, boolean linear)
void	removeTags(CoreSession session, String docId) Removes all the tags applied to a document.
void	replaceTags(CoreSession session, String srcDocId, String dstDocId) Replace all the existing tags applied on the destination document by the ones applied on the source document.
void	tag(CoreSession session, String docId, String label, String username) Tags a document with a given tag.
void	untag(CoreSession session, String docId, String label, String username) Untags a document of the given tag

Methods inherited from class org.nuxeo.runtime.model.DefaultComponent

activate, applicationStarted, deactivate, getAdapter, getApplicationStartedOrder, getLastModified, registerContribution, registerExtension, setLastModified, setModifiedNow, unregisterContribution, unregisterExtension

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NXTAG

public static final String NXTAG

See Also:

Constant Field Values

Constructor Detail

TagServiceImpl

public TagServiceImpl()

Method Detail

isEnabled

public boolean isEnabled()

Description copied from interface: TagService

Defines if tag service is enable.

Specified by:

isEnabled in interface TagService

Returns:

true if the underlying repository supports the tag feature

cleanLabel

protected static String cleanLabel(String label,
                                   boolean allowEmpty,
                                   boolean allowPercent)

cleanUsername

protected static String cleanUsername(String username)

tag

public void tag(CoreSession session,
                String docId,
                String label,
                String username)

Description copied from interface: TagService

Tags a document with a given tag.

Specified by:

tag in interface TagService

Parameters:

session - the session

docId - the document id

label - the tag

username - the user associated to the tagging

fireUpdateEvent

protected void fireUpdateEvent(CoreSession session,
                               String docId)

untag

public void untag(CoreSession session,
                  String docId,
                  String label,
                  String username)

Description copied from interface: TagService

Untags a document of the given tag

Specified by:

untag in interface TagService

Parameters:

session - the session

docId - the document id

label - the tag, or null for all tags

username - the user associated to the tagging

getDocumentTags

public List<Tag> getDocumentTags(CoreSession session,
                                 String docId,
                                 String username)

Description copied from interface: TagService

Gets the tags applied to a document by a given user, or by all users.

Specified by:

getDocumentTags in interface TagService

Parameters:

session - the session

docId - the document id

username - the user name, or null for all users

Returns:

the list of tags

getDocumentTags

public List<Tag> getDocumentTags(CoreSession session,
                                 String docId,
                                 String username,
                                 boolean useCore)

Description copied from interface: TagService

Gets the tags applied to a document by a given user, or by all users.

Alternative method allowing to specify whether the core should be used for this query.

Specified by:

getDocumentTags in interface TagService

Parameters:

session - the session

docId - the document id

username - the user name, or null for all users

useCore - if true, the core should be used to retrieve tags.

Returns:

the list of tags

removeTags

public void removeTags(CoreSession session,
                       String docId)

Description copied from interface: TagService

Removes all the tags applied to a document.

Specified by:

removeTags in interface TagService

copyTags

public void copyTags(CoreSession session,
                     String srcDocId,
                     String dstDocId)

Description copied from interface: TagService

Copy all the tags applied to the source document to the destination document.

The tags are merged.

Specified by:

copyTags in interface TagService

srcDocId - the source document id

dstDocId - the destination document id

copyTags

protected void copyTags(CoreSession session,
                        String srcDocId,
                        String dstDocId,
                        boolean removeExistingTags)

replaceTags

public void replaceTags(CoreSession session,
                        String srcDocId,
                        String dstDocId)

Description copied from interface: TagService

Replace all the existing tags applied on the destination document by the ones applied on the source document.

Specified by:

replaceTags in interface TagService

srcDocId - the source document id

dstDocId - the destination document id

getTagDocumentIds

public List<String> getTagDocumentIds(CoreSession session,
                                      String label,
                                      String username)

Description copied from interface: TagService

Gets the documents to which a tag is applied.

Specified by:

getTagDocumentIds in interface TagService

Parameters:

session - the session

label - the tag

username - the user name, or null for all users

Returns:

the set of document ids

getTagCloud

public List<Tag> getTagCloud(CoreSession session,
                             String docId,
                             String username,
                             Boolean normalize)

Description copied from interface: TagService

Gets the tag cloud for a set of documents (tags with weight corresponding to their popularity).

If a docId is passed, only documents under it are considered, otherwise all documents in the database are used.

The cloud is returned unsorted.

Specified by:

getTagCloud in interface TagService

Parameters:

session - the session

docId - the document id under which to look, or null for all documents

username - the user name, or null for all users

normalize - null for no weight normalization (a count is returned), FALSE for 0-100 normalization, TRUE for logarithmic 0-100 normalization

Returns:

the cloud (a list of weighted tags)

normalizeCloud

public static void normalizeCloud(List<Tag> cloud,
                                  int min,
                                  int max,
                                  boolean linear)

getSuggestions

public List<Tag> getSuggestions(CoreSession session,
                                String label,
                                String username)

Description copied from interface: TagService

Gets suggestions for a given tag label prefix.

Specified by:

getSuggestions in interface TagService

Parameters:

session - the session

label - the tag label prefix

username - the user name, or null for all users

Returns:

a list of tags

getItems

protected static List<Map<String,Serializable>> getItems(String pageProviderName,
                                                         CoreSession session,
                                                         Object... params)

Returns results from calls to CoreSession.queryAndFetch(String, String, Object...) using page providers.

Since:

6.0