hudson.plugins.favorite

Class Favorites

java.lang.Object

hudson.plugins.favorite.Favorites

public final class Favorites
extends Object

Public API for Favorites

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Favorites.FavoriteException Exception for Favorite operations

Constructor Summary

Constructors

Constructor and Description
Favorites()

Method Summary

Modifier and Type	Method and Description
static void	addFavorite(hudson.model.User user, hudson.model.Item item) Add an item as a favorite for a user Fires FavoriteListener.fireOnAddFavourite(Item, User)
static Iterable<hudson.model.Item>	getFavorites(hudson.model.User user) Get all items that the provided user has favorited
static boolean	hasFavorite(hudson.model.User user, hudson.model.Item item) Check if the item has a favorite entry regardless of its state This is useful for checking if a favorite/unfavorite operation has ever been performed against this user
static boolean	isFavorite(hudson.model.User user, hudson.model.Item item) Check if the item is favorited
static void	removeFavorite(hudson.model.User user, hudson.model.Item item) Remove an item as a favorite for a user Fires FavoriteListener.fireOnRemoveFavourite(Item, User)
static boolean	toggleFavorite(hudson.model.User user, hudson.model.Item item) Toggles the favorite for a job

Methods inherited from class java.lang.Object

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

Constructor Detail

Favorites

public Favorites()

Method Detail

toggleFavorite

public static boolean toggleFavorite(@Nonnull
                                     hudson.model.User user,
                                     @Nonnull
                                     hudson.model.Item item)
                              throws Favorites.FavoriteException

Toggles the favorite for a job

Parameters:

user - that the favorite belongs to

item - to favorite

Returns:

favorite state

Throws:

Favorites.FavoriteException

isFavorite

public static boolean isFavorite(@Nonnull
                                 hudson.model.User user,
                                 @Nonnull
                                 hudson.model.Item item)

Check if the item is favorited

Parameters:

user - to check

item - to check

Returns:

favorite state

hasFavorite

public static boolean hasFavorite(@Nonnull
                                  hudson.model.User user,
                                  @Nonnull
                                  hudson.model.Item item)
                           throws Favorites.FavoriteException

Check if the item has a favorite entry regardless of its state This is useful for checking if a favorite/unfavorite operation has ever been performed against this user

Parameters:

user - to check

item - to check

Returns:

favorite state

Throws:

Favorites.FavoriteException

addFavorite

public static void addFavorite(@Nonnull
                               hudson.model.User user,
                               @Nonnull
                               hudson.model.Item item)
                        throws Favorites.FavoriteException

Add an item as a favorite for a user Fires FavoriteListener.fireOnAddFavourite(Item, User)

Parameters:

user - to add the favorite to

item - to favorite

Throws:

Favorites.FavoriteException

removeFavorite

public static void removeFavorite(@Nonnull
                                  hudson.model.User user,
                                  @Nonnull
                                  hudson.model.Item item)
                           throws Favorites.FavoriteException

Remove an item as a favorite for a user Fires FavoriteListener.fireOnRemoveFavourite(Item, User)

Parameters:

user - to remove the favorite from

item - to favorite

Throws:

Favorites.FavoriteException

getFavorites

public static Iterable<hudson.model.Item> getFavorites(@Nonnull
                                                       hudson.model.User user)

Get all items that the provided user has favorited

Parameters:

user - to lookup favorites for

Returns:

favorite items