com.atlassian.confluence.content.render.xhtml.storage.link.user
Interface UserMentionsExtractor

All Known Implementing Classes:

DefaultUserMentionsExtractor

public interface UserMentionsExtractor

The interface defines the mechanism for extracting mentions from a storage format. Not every link to a user is a mention - see extractMentionedUsers(javax.xml.stream.XMLEventReader)

Since:

4.3

Method Summary

java.util.List<ConfluenceUser>	extractMentionedUsers(javax.xml.stream.XMLEventReader reader) Given a stream of storage format extracts all user links that are considered a 'mention'.
java.util.List<java.lang.String>	extractUserMentions(javax.xml.stream.XMLEventReader reader) Deprecated. since 5.3 Use extractMentionedUsers(javax.xml.stream.XMLEventReader)

Method Detail

extractUserMentions

@Deprecated
java.util.List<java.lang.String> extractUserMentions(javax.xml.stream.XMLEventReader reader)
                                                     throws javax.xml.stream.XMLStreamException

Deprecated. since 5.3 Use extractMentionedUsers(javax.xml.stream.XMLEventReader)

Given a stream of storage format extracts all user links that are considered a 'mention'. Not every link to a user is a mention e.g. the first link to a user inside an inline task is actually an assignee and should not be considered as a mention (because we deal with it differently).

Parameters:

reader - reader of a storage format.

Returns:

the list of usernames of mentioned users.

Throws:

javax.xml.stream.XMLStreamException

extractMentionedUsers

java.util.List<ConfluenceUser> extractMentionedUsers(javax.xml.stream.XMLEventReader reader)
                                                     throws javax.xml.stream.XMLStreamException

Given a stream of storage format extracts all user links that are considered a 'mention'. Not every link to a user is a mention e.g. the first link to a user inside an inline task is actually an assignee and should not be considered as a mention (because we deal with it differently).

Parameters:

reader - reader of a storage format.

Returns:

the list of usernames of mentioned users.

Throws:

javax.xml.stream.XMLStreamException