twitter4j.api
Interface FavoriteMethods

All Known Subinterfaces:

Twitter

public interface FavoriteMethods

Author:

Joern Huxhorn - jhuxhorn at googlemail.com

Method Summary

Status	createFavorite(long id) Favorites the status specified in the ID parameter as the authenticating user.
Status	destroyFavorite(long id) Un-favorites the status specified in the ID parameter as the authenticating user.
ResponseList<Status>	getFavorites() Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
ResponseList<Status>	getFavorites(int page) Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
ResponseList<Status>	getFavorites(Paging paging) Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
ResponseList<Status>	getFavorites(String id) Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
ResponseList<Status>	getFavorites(String id, int page) Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
ResponseList<Status>	getFavorites(String id, Paging paging) Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.

Method Detail

getFavorites

ResponseList<Status> getFavorites()
                                  throws TwitterException

Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
This method calls http://api.twitter.com/1/favorites.json

Returns:

List

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

GET favorites | Twitter Developers

getFavorites

ResponseList<Status> getFavorites(int page)
                                  throws TwitterException

Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
This method calls http://api.twitter.com/1/favorites.json

Parameters:

page - the number of page

Returns:

ResponseList

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

GET favorites | Twitter Developers

getFavorites

ResponseList<Status> getFavorites(String id)
                                  throws TwitterException

Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.

Parameters:

id - the ID or screen name of the user for whom to request a list of favorite statuses

Returns:

ResponseList

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

GET favorites | Twitter Developers

getFavorites

ResponseList<Status> getFavorites(String id,
                                  int page)
                                  throws TwitterException

Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
This method calls http://api.twitter.com/1/favorites/[id].json

Parameters:

id - the ID or screen name of the user for whom to request a list of favorite statuses

page - the number of page

Returns:

ResponseList

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

GET favorites | Twitter Developers

getFavorites

ResponseList<Status> getFavorites(Paging paging)
                                  throws TwitterException

Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
This method calls http://api.twitter.com/1/favorites.json

Parameters:

paging - controls pagination. Supports sinceId and page parameters.

Returns:

ResponseList

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.2.5

See Also:

GET favorites | Twitter Developers

getFavorites

ResponseList<Status> getFavorites(String id,
                                  Paging paging)
                                  throws TwitterException

Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
This method calls http://api.twitter.com/1/favorites/[id].json

Parameters:

id - the ID or screen name of the user for whom to request a list of favorite statuses

paging - controls pagination. Supports sinceId and page parameters.

Returns:

ResponseList

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.2.5

See Also:

GET favorites | Twitter Developers

createFavorite

Status createFavorite(long id)
                      throws TwitterException

Favorites the status specified in the ID parameter as the authenticating user. Returns the favorite status when successful.
This method calls http://api.twitter.com/1/favorites/create/[id].json

Parameters:

id - the ID of the status to favorite

Returns:

Status

Throws:

TwitterException - when Twitter service or network is unavailable

See Also:

POST favorites/create/:id | Twitter Developers

destroyFavorite

Status destroyFavorite(long id)
                       throws TwitterException

Un-favorites the status specified in the ID parameter as the authenticating user. Returns the un-favorited status in the requested format when successful.
This method calls http://api.twitter.com/1/favorites/destroy/[id].json

Parameters:

id - the ID of the status to un-favorite

Returns:

Status

Throws:

TwitterException - when Twitter service or network is unavailable

See Also:

POST favorites/destroy/:id | Twitter Developers