com.atlassian.jira.issue.watchers
Interface WatcherManager

All Known Implementing Classes:
DefaultWatcherManager

public interface WatcherManager

Allows watching of issues. I.e.: Users watching an issue will receive notifications for every update of the issue.


Method Summary
 List<String> getCurrentWatcherUsernames(org.ofbiz.core.entity.GenericValue issue)
          Deprecated. Use getCurrentWatcherUsernames(com.atlassian.jira.issue.Issue) instead. Since v5.0.
 List<String> getCurrentWatcherUsernames(Issue issue)
          Retrieve the list of usernames of users watching the given issue
 Collection<com.atlassian.crowd.embedded.api.User> getCurrentWatchList(Issue issue, Locale userLocale)
          Retrieve collection of users that are currently watching this issue (including the current user)
 boolean isWatching(com.atlassian.crowd.embedded.api.User user, org.ofbiz.core.entity.GenericValue issue)
          Deprecated. Use isWatching(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v5.0.
 boolean isWatching(com.atlassian.crowd.embedded.api.User user, Issue issue)
          Determine whether the current user is already watching the issue or not
 boolean isWatchingEnabled()
           
 void removeAllWatchesForUser(com.atlassian.crowd.embedded.api.User user)
          Remove all watches for a given user
 void startWatching(com.atlassian.crowd.embedded.api.User user, org.ofbiz.core.entity.GenericValue issue)
          Deprecated. Use startWatching(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v5.0.
 void startWatching(com.atlassian.crowd.embedded.api.User user, Issue issue)
          Enable watching of a particular issue for the user supplied.
 void stopWatching(String username, org.ofbiz.core.entity.GenericValue issue)
          Deprecated. Use stopWatching(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v5.0.
 void stopWatching(com.atlassian.crowd.embedded.api.User user, org.ofbiz.core.entity.GenericValue issue)
          Deprecated. Use stopWatching(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v5.0.
 void stopWatching(com.atlassian.crowd.embedded.api.User user, Issue issue)
          Disable watching of a particular issue for the user supplied.
 

Method Detail

isWatchingEnabled

boolean isWatchingEnabled()

isWatching

boolean isWatching(com.atlassian.crowd.embedded.api.User user,
                   Issue issue)
Determine whether the current user is already watching the issue or not

Parameters:
user - user
issue - issue being watched
Returns:
True if a user is watching the issue specified.

isWatching

boolean isWatching(com.atlassian.crowd.embedded.api.User user,
                   org.ofbiz.core.entity.GenericValue issue)
Deprecated. Use isWatching(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v5.0.

Determine whether the current user is already watching the issue or not

Parameters:
user - user
issue - issue being watched
Returns:
True if a user is watching the issue specified.

getCurrentWatchList

Collection<com.atlassian.crowd.embedded.api.User> getCurrentWatchList(Issue issue,
                                                                      Locale userLocale)
Retrieve collection of users that are currently watching this issue (including the current user)

Parameters:
userLocale - the locale of the user making this call, this is used for sorting the list values.
issue - issue being watched
Returns:
A collection of Users
Since:
v4.3

getCurrentWatcherUsernames

List<String> getCurrentWatcherUsernames(Issue issue)
                                        throws DataAccessException
Retrieve the list of usernames of users watching the given issue

Parameters:
issue - issue being watched
Returns:
the list of usernames of users watching the given issue
Throws:
DataAccessException - if cannot retrieve watchers

getCurrentWatcherUsernames

List<String> getCurrentWatcherUsernames(org.ofbiz.core.entity.GenericValue issue)
                                        throws DataAccessException
Deprecated. Use getCurrentWatcherUsernames(com.atlassian.jira.issue.Issue) instead. Since v5.0.

Retrieve the list of usernames of users watching the given issue

Parameters:
issue - issue being watched
Returns:
the list of usernames of users watching the given issue
Throws:
DataAccessException - if cannot retrieve watchers

startWatching

void startWatching(com.atlassian.crowd.embedded.api.User user,
                   Issue issue)
Enable watching of a particular issue for the user supplied. This means the user will receive updates for any modifications to the issue. Note, that this will not check if a user has the BROWSE_ISSUE permission. Notifications will however only be sent to users who have the appropriate permissions. Adding a permission check here would complicate updating permission schemes a lot, as it would have to update issue's watchers lists.

Parameters:
user - user that starts watching the given issue
issue - issue being watched

startWatching

void startWatching(com.atlassian.crowd.embedded.api.User user,
                   org.ofbiz.core.entity.GenericValue issue)
Deprecated. Use startWatching(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v5.0.

Enable watching of a particular issue for the user supplied. This means the user will receive updates for any modifications to the issue. Note, that this will not check if a user has the BROWSE_ISSUE permission. Notifications will however only be sent to users who have the appropriate permissions. Adding a permission check here would complicate updating permission schemes a lot, as it would have to update issue's watchers lists.

Parameters:
user - user that starts watching the given issue
issue - issue being watched

stopWatching

void stopWatching(com.atlassian.crowd.embedded.api.User user,
                  Issue issue)
Disable watching of a particular issue for the user supplied.

Parameters:
user - user that stops watching the given issue
issue - issue being watched

stopWatching

void stopWatching(com.atlassian.crowd.embedded.api.User user,
                  org.ofbiz.core.entity.GenericValue issue)
Deprecated. Use stopWatching(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v5.0.

Disable watching of a particular issue for the user supplied.

Parameters:
user - user that stops watching the given issue
issue - issue being watched

stopWatching

void stopWatching(String username,
                  org.ofbiz.core.entity.GenericValue issue)
Deprecated. Use stopWatching(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v5.0.

Disable watching of a particular issue for the user supplied.

Note: Use this method in case when user no longer exists in JIRA, e.g. JIRA uses external user management and user was removed externally.

Parameters:
username - username of the user that stops watching the given issue
issue - issue being watched

removeAllWatchesForUser

void removeAllWatchesForUser(com.atlassian.crowd.embedded.api.User user)
Remove all watches for a given user

Parameters:
user - The user that has most probably been deleted
Since:
v3.13


Copyright © 2002-2012 Atlassian. All Rights Reserved.