Package com.atlassian.confluence.userstatus

Interface FavouriteManager

All Known Implementing Classes:
DefaultFavouriteManager
public interface FavouriteManager
Manages the favourite spaces and pages of a user. A caller of this API has permission to add or remove a favourite if either: - The caller is the user that the favourite is added or removed on behalf of. - The caller is a confluence administrator.

  • Method Details

    • isUserFavourite

      default boolean isUserFavourite(ConfluenceUser user, Space space)
      Returns whether a space is marked as a favourite for a user.
      Since:
      9.5

    • isUserFavourite

      @Deprecated(forRemoval=true, since="9.5") boolean isUserFavourite(com.atlassian.user.User user, Space space)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 9.5 use isUserFavourite(ConfluenceUser, Space)
      Returns whether a space is marked as a favourite for a user.
      Since:
      5.9

    • hasPermission

      default boolean hasPermission(ConfluenceUser user, Space space)
      Get whether the current user has permission to add or remove a space favourite.
      Since:
      9.5

    • hasPermission

      @Deprecated(forRemoval=true, since="9.5") boolean hasPermission(com.atlassian.user.User user, Space space)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 9.5 use hasPermission(ConfluenceUser, Space)
      Get whether the current user has permission to add or remove a space favourite.
      Since:
      5.9

    • addSpaceToFavourites

      default void addSpaceToFavourites(ConfluenceUser user, Space space)
      Add a space to a user's favourites by attaching a personal label to the space.
      Parameters:
      user - The user to add the favourite on behalf of.
      space - The space to add the favourite to.
      Throws:
      NotAuthorizedException - If the current user doesn't have permission to add the favourite.
      org.springframework.dao.DataAccessException - If the label save operation fails.
      Since:
      9.5

    • addSpaceToFavourites

      @Deprecated(forRemoval=true, since="9.5") void addSpaceToFavourites(com.atlassian.user.User user, Space space)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 9.5 use addSpaceToFavourites(ConfluenceUser, Space)
      Add a space to a user's favourites by attaching a personal label to the space.
      Parameters:
      user - The user to add the favourite on behalf of.
      space - The space to add the favourite to.
      Throws:
      NotAuthorizedException - If the current user doesn't have permission to add the favourite.
      org.springframework.dao.DataAccessException - If the label save operation fails.
      Since:
      5.9

    • removeSpaceFromFavourites

      default void removeSpaceFromFavourites(ConfluenceUser user, Space space)
      Remove a space from a user's favourites.
      Parameters:
      user - The user to remove the favourite on behalf of.
      space - The space to remove the favourite from.
      Throws:
      NotAuthorizedException - If the current user doesn't have permission to remove the favourite.
      org.springframework.dao.DataAccessException - If the label delete operation fails.
      Since:
      9.5

    • removeSpaceFromFavourites

      @Deprecated(forRemoval=true, since="9.5") void removeSpaceFromFavourites(com.atlassian.user.User user, Space space)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 9.5 use removeSpaceFromFavourites(ConfluenceUser, Space)
      Remove a space from a user's favourites.
      Parameters:
      user - The user to remove the favourite on behalf of.
      space - The space to remove the favourite from.
      Throws:
      NotAuthorizedException - If the current user doesn't have permission to remove the favourite.
      org.springframework.dao.DataAccessException - If the label delete operation fails.
      Since:
      5.9

    • isUserFavourite

      default boolean isUserFavourite(ConfluenceUser user, AbstractPage page)
      Returns whether a page or blog post is marked as a favourite for a user.
      Since:
      9.5

    • isUserFavourite

      @Deprecated(forRemoval=true, since="9.5") boolean isUserFavourite(com.atlassian.user.User user, AbstractPage page)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 9.5 use isUserFavourite(ConfluenceUser, AbstractPage)
      Returns whether a page or blog post is marked as a favourite for a user.

    • hasPermission

      default boolean hasPermission(ConfluenceUser user, AbstractPage page)
      Get whether the current user has permission to add or remove a page favourite.
      Since:
      9.5

    • hasPermission

      @Deprecated(forRemoval=true, since="9.5") boolean hasPermission(com.atlassian.user.User user, AbstractPage page)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 9.5 use hasPermission(ConfluenceUser, AbstractPage)
      Get whether the current user has permission to add or remove a page favourite.
      Since:
      5.9

    • addPageToFavourites

      default void addPageToFavourites(ConfluenceUser user, AbstractPage page)
      Add a page or blog post to a user's favourites by attaching a personal label to the space.
      Parameters:
      user - The user to add the favourite on behalf of.
      space - The space to add the favourite to.
      Throws:
      NotAuthorizedException - Thrown if the current user doesn't have permission to add the favourite.
      org.springframework.dao.DataAccessException - If the label save operation fails.
      Since:
      9.5

    • addPageToFavourites

      @Deprecated(forRemoval=true, since="9.5") void addPageToFavourites(com.atlassian.user.User user, AbstractPage page)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 9.5 use addPageToFavourites(ConfluenceUser, AbstractPage)
      Add a page or blog post to a user's favourites by attaching a personal label to the space.
      Parameters:
      user - The user to add the favourite on behalf of.
      space - The space to add the favourite to.
      Throws:
      NotAuthorizedException - Thrown if the current user doesn't have permission to add the favourite.
      org.springframework.dao.DataAccessException - If the label save operation fails.

    • removePageFromFavourites

      default void removePageFromFavourites(ConfluenceUser user, AbstractPage page)
      Remove a page or blog post from a user's favourites.
      Parameters:
      user - The user to remove the favourite on behalf of.
      space - The space to remove the favourite from.
      Throws:
      NotAuthorizedException - If the current user doesn't have permission to remove the favourite.
      org.springframework.dao.DataAccessException - If the label delete operation fails.
      Since:
      9.5

    • removePageFromFavourites

      @Deprecated(forRemoval=true, since="9.5") void removePageFromFavourites(com.atlassian.user.User user, AbstractPage page)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 9.5 use removePageFromFavourites(ConfluenceUser, AbstractPage)
      Remove a page or blog post from a user's favourites.
      Parameters:
      user - The user to remove the favourite on behalf of.
      space - The space to remove the favourite from.
      Throws:
      NotAuthorizedException - If the current user doesn't have permission to remove the favourite.
      org.springframework.dao.DataAccessException - If the label delete operation fails.