AsyncTwitterImpl

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

twitter4j
Class AsyncTwitterImpl

java.lang.Object
  twitter4j.TwitterBaseImpl
      twitter4j.AsyncTwitterImpl

All Implemented Interfaces:: java.io.Serializable, AccountMethodsAsync, BlockMethodsAsync, DirectMessageMethodsAsync, FavoriteMethodsAsync, FriendsFollowersMethodsAsync, FriendshipMethodsAsync, GeoMethodsAsync, HelpMethodsAsync, LegalResourcesAsync, ListMembersMethodsAsync, ListMethodsAsync, ListSubscribersMethodsAsync, LocalTrendsMethodsAsync, NewTwitterMethodsAsync, NotificationMethodsAsync, SavedSearchesMethodsAsync, SearchMethodsAsync, SpamReportingMethodsAsync, StatusMethodsAsync, TimelineMethodsAsync, TrendsMethodsAsync, UserMethodsAsync, AsyncTwitter, OAuthSupport, twitter4j.internal.http.HttpResponseListener, TwitterBase

class AsyncTwitterImpl
extends TwitterBaseImpl
implements AsyncTwitter
extends TwitterBaseImpl
implements AsyncTwitter

Twitter API with a series of asynchronous APIs.
With this class, you can call TwitterAPI asynchronously.
Note that currently this class is NOT compatible with Google App Engine as it is maintaining threads internally.
Currently this class is not carefully designed to be extended. It is suggested to extend this class only for mock testing purporse.

Author:: Yusuke Yamamoto - yusuke at mac.com
See Also:: AsyncTwitter, TwitterListener

Nested Class Summary
`(package private) class`	`AsyncTwitterImpl.AsyncTask`

Field Summary
`private static twitter4j.internal.async.Dispatcher`	`dispatcher`
`private java.util.List<TwitterListener>`	`listeners`
`private static long`	`serialVersionUID`
`private Twitter`	`twitter`

Fields inherited from class twitter4j.TwitterBaseImpl
`auth, conf, http, id, screenName`

Constructor Summary
`AsyncTwitterImpl(Configuration conf)`
`AsyncTwitterImpl(Configuration conf, Authorization auth)`

Method Summary
`void`	`addListener(TwitterListener listener)` Adds twitter listener
`void`	`addUserListMember(int listId, long userId)` Adds a member to a list.
`void`	`addUserListMembers(int listId, long[] userIds)` Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names.
`void`	`addUserListMembers(int listId, java.lang.String[] screenNames)` Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names.
`void`	`checkUserListMembership(java.lang.String listOwnerScreenName, int listId, long userId)` Check if a user is a member of the specified list. This method calls http://api.twitter.com/1/[listOwner]/[listId]/members/id.json
`void`	`checkUserListSubscription(java.lang.String listOwnerScreenName, int listId, long userId)` Check if the specified user is a subscriber of the specified list.
`void`	`createBlock(long userId)` Blocks the user specified in the ID parameter as the authenticating user.
`void`	`createBlock(java.lang.String screenName)` Blocks the user specified in the ID parameter as the authenticating user.
`void`	`createFavorite(long id)` Favorites the status specified in the ID parameter as the authenticating user.
`void`	`createFriendship(long userId)` Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended user in the requested format when successful.
`void`	`createFriendship(long userId, boolean follow)` Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended user in the requested format when successful.
`void`	`createFriendship(java.lang.String screenName)` Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended user in the requested format when successful.
`void`	`createFriendship(java.lang.String screenName, boolean follow)` Allows the authenticating users to follow the user specified in the ID parameter. Returns the befriended user in the requested format when successful.
`void`	`createPlace(java.lang.String name, java.lang.String containedWithin, java.lang.String token, GeoLocation location, java.lang.String streetAddress)` Creates a new place at the given latitude and longitude.
`void`	`createUserList(java.lang.String listName, boolean isPublicList, java.lang.String description)` Creates a new list for the authenticated user.
`void`	`deleteUserListMember(int listId, long userId)` Removes the specified member from the list.
`void`	`destroyBlock(long userId)` Un-blocks the user specified in the ID parameter as the authenticating user.
`void`	`destroyBlock(java.lang.String screenName)` Un-blocks the user specified in the ID parameter as the authenticating user.
`void`	`destroyDirectMessage(long id)` Destroys the direct message specified in the required ID parameter.
`void`	`destroyFavorite(long id)` Favorites the status specified in the ID parameter as the authenticating user.
`void`	`destroyFriendship(long userId)` Allows the authenticating users to unfollow the user specified in the ID parameter. Returns the unfollowed user in the requested format when successful.
`void`	`destroyFriendship(java.lang.String screenName)` Allows the authenticating users to unfollow the user specified in the ID parameter. Returns the unfollowed user in the requested format when successful.
`void`	`destroyStatus(long statusId)` Destroys the status specified by the required ID parameter. Usage note: The authenticating user must be the author of the specified status.
`void`	`destroyUserList(int listId)` Deletes the specified list.
`void`	`disableNotification(long userId)` Disables notifications for updates from the specified user to the authenticating user.
`void`	`disableNotification(java.lang.String screenName)` Disables notifications for updates from the specified user to the authenticating user.
`void`	`enableNotification(long userId)` Enables notifications for updates from the specified user to the authenticating user.
`void`	`enableNotification(java.lang.String screenName)` Enables notifications for updates from the specified user to the authenticating user.
`boolean`	`equals(java.lang.Object o)`
`void`	`existsBlock(long userId)` Returns if the authenticating user is blocking a target user.
`void`	`existsBlock(java.lang.String screenName)` Returns if the authenticating user is blocking a target user.
`void`	`existsFriendship(java.lang.String userA, java.lang.String userB)` Tests for the existence of friendship between two users.
`void`	`getAccountSettings()` Returns the current trend, geo and sleep time information for the authenticating user.
`void`	`getAccountTotals()` Returns the current count of friends, followers, updates (statuses) and favorites of the authenticating user.
`void`	`getAllSubscribingUserLists(long userId)` Returns all lists the authenticating or specified user subscribes to, including their own.
`void`	`getAllSubscribingUserLists(java.lang.String screenName)` Returns all lists the authenticating or specified user subscribes to, including their own.
`void`	`getAvailableTrends()` Retrieves the locations that Twitter has trending topic information for.
`void`	`getAvailableTrends(GeoLocation location)` Retrieves the sorted locations that Twitter has trending topic information for.
`void`	`getBlockingUsers()` Returns a list of user objects that the authenticating user is blocking.
`void`	`getBlockingUsers(int page)` Returns a list of user objects that the authenticating user is blocking.
`void`	`getBlockingUsersIDs()` Returns an array of numeric user ids the authenticating user is blocking.
`void`	`getCurrentTrends()` Returns the current top 10 trending topics on Twitter.
`void`	`getCurrentTrends(boolean excludeHashTags)` Returns the current top 10 trending topics on Twitter.
`void`	`getDailyTrends()` Returns the top 20 trending topics for each hour in a given day.
`void`	`getDailyTrends(java.util.Date date, boolean excludeHashTags)` Returns the top 20 trending topics for each hour in a given day.
`void`	`getDirectMessages()` Returns a list of the direct messages sent to the authenticating user.
`void`	`getDirectMessages(Paging paging)` Returns a list of the direct messages sent to the authenticating user.
`private twitter4j.internal.async.Dispatcher`	`getDispatcher()`
`void`	`getFavorites()` Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
`void`	`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.
`void`	`getFavorites(java.lang.String id)` Returns the 20 most recent favorite statuses for the authenticating user or user specified by the ID parameter in the requested format.
`void`	`getFavorites(java.lang.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.
`void`	`getFollowersIDs(long cursor)` Returns an array of numeric IDs for every user the specified user is followed by.
`void`	`getFollowersIDs(long userId, long cursor)` Returns an array of numeric IDs for every user the specified user is followed by.
`void`	`getFollowersIDs(java.lang.String screenName, long cursor)` Returns an array of numeric IDs for every user the specified user is followed by.
`void`	`getFollowersStatuses(long cursor)` Returns the authenticating user's followers, each with current status inline.
`void`	`getFollowersStatuses(long userId, long cursor)` Returns the specified user's followers, each with current status inline.
`void`	`getFollowersStatuses(java.lang.String screenName, long cursor)` Returns the specified user's followers, each with current status inline.
`void`	`getFriendsIDs(long cursor)` Returns an array of numeric IDs for every user the authenticating user is following.
`void`	`getFriendsIDs(long userId, long cursor)` Returns an array of numeric IDs for every user the specified user is following.
`void`	`getFriendsIDs(java.lang.String screenName, long cursor)` Returns an array of numeric IDs for every user the specified user is following.
`void`	`getFriendsStatuses(long cursor)` Returns a user's friends, each with current status inline.
`void`	`getFriendsStatuses(long userId, long cursor)` Returns a user's friends, each with current status inline.
`void`	`getFriendsStatuses(java.lang.String screenName, long cursor)` Returns a user's friends, each with current status inline.
`void`	`getFriendsTimeline()` Returns the 20 most recent statuses posted by the authenticating user and that user's friends.
`void`	`getFriendsTimeline(Paging paging)` Returns the 20 most recent statuses posted by the authenticating user and that user's friends.
`void`	`getGeoDetails(java.lang.String id)` Find out more details of a place that was returned from the `GeoMethodsAsync.reverseGeoCode(twitter4j.GeoQuery)` method.
`void`	`getHomeTimeline()` Returns the 20 most recent statuses, including retweets, posted by the authenticating user and that user's friends.
`void`	`getHomeTimeline(Paging paging)` Returns the 20 most recent statuses, including retweets, posted by the authenticating user and that user's friends.
`void`	`getIncomingFriendships(long cursor)` Returns an array of numeric IDs for every user who has a pending request to follow the authenticating user.
`void`	`getLocationTrends(int woeid)` Retrieves the top 10 trending topics for a specific location Twitter has trending topic information for.
`void`	`getMemberSuggestions(java.lang.String categorySlug)` Access the users in a given category of the Twitter suggested user list and return their most recent status if they are not a protected user.
`void`	`getMentions()` Returns the 20 most recent replies (status updates prefixed with @username) to the authenticating user.
`void`	`getMentions(Paging paging)` Returns the 20 most recent replies (status updates prefixed with @username) to the authenticating user.
`AccessToken`	`getOAuthAccessToken()` Returns an access token associated with this instance. If no access token is associated with this instance, this will retrieve a new access token.
`AccessToken`	`getOAuthAccessToken(RequestToken requestToken)` Retrieves an access token associated with the supplied request token and sets userId.
`AccessToken`	`getOAuthAccessToken(RequestToken requestToken, java.lang.String oauthVerifier)` Retrieves an access token associated with the supplied request token and sets userId.
`AccessToken`	`getOAuthAccessToken(java.lang.String oauthVerifier)` Retrieves an access token.
`AccessToken`	`getOAuthAccessToken(java.lang.String screenName, java.lang.String password)` Retrieves an access token associated with the supplied screen name and password using xAuth. In order to get access acquire AccessToken using xAuth, you must apply by sending an email to api@twitter.com — all other applications will receive an HTTP 401 error.
`RequestToken`	`getOAuthRequestToken()` Retrieves a request token
`RequestToken`	`getOAuthRequestToken(java.lang.String callbackUrl)` Retrieves a request token
`void`	`getOutgoingFriendships(long cursor)` Returns an array of numeric IDs for every protected user for whom the authenticating user has a pending follow request.
`void`	`getPrivacyPolicy()` Returns Twitter's Privacy Policy.
`void`	`getProfileImage(java.lang.String screenName, ProfileImage.ImageSize size)` Access the profile image in various sizes for the user with the indicated screen_name.
`void`	`getPublicTimeline()` Returns the 20 most recent statuses from non-protected users who have set a custom user icon.
`void`	`getRateLimitStatus()` Gets the remaining number of API requests available to the requesting user before the API limit is reached for the current hour.
`void`	`getRelatedResults(long statusId)` If available, returns an array of replies and mentions related to the specified Tweet.
`void`	`getRetweetedBy(long statusId)` Show user objects of up to 100 members who retweeted the status.
`void`	`getRetweetedByIDs(long statusId)` Show user ids of up to 100 users who retweeted the status represented by id This method calls http://api.twitter.com/1/statuses/:id/retweeted_by/ids.format
`void`	`getRetweetedByMe()` Returns the 20 most recent retweets posted by the authenticating user.
`void`	`getRetweetedByMe(Paging paging)` Returns the 20 most recent retweets posted by the authenticating user.
`void`	`getRetweetedByUser(long userId, Paging paging)` Returns the 20 most recent retweets posted by the specified user.
`void`	`getRetweetedByUser(java.lang.String screenName, Paging paging)` Returns the 20 most recent retweets posted by the specified user.
`void`	`getRetweetedToMe()` Returns the 20 most recent retweets posted by the authenticating user's friends.
`void`	`getRetweetedToMe(Paging paging)` Returns the 20 most recent retweets posted by the authenticating user's friends.
`void`	`getRetweetedToUser(long userId, Paging paging)` Returns the 20 most recent retweets posted by users the specified user follows.
`void`	`getRetweetedToUser(java.lang.String screenName, Paging paging)` Returns the 20 most recent retweets posted by users the specified user follows.
`void`	`getRetweets(long statusId)` Returns up to 100 of the first retweets of a given tweet.
`void`	`getRetweetsOfMe()` Returns the 20 most recent tweets of the authenticated user that have been retweeted by others.
`void`	`getRetweetsOfMe(Paging paging)` Returns the 20 most recent tweets of the authenticated user that have been retweeted by others.
`void`	`getSentDirectMessages()` Returns a list of the direct messages sent by the authenticating user.
`void`	`getSentDirectMessages(Paging paging)` Returns a list of the direct messages sent by the authenticating user.
`void`	`getSimilarPlaces(GeoLocation location, java.lang.String name, java.lang.String containedWithin, java.lang.String streetAddress)` Locates places near the given coordinates which are similar in name.
`void`	`getSuggestedUserCategories()` Access to Twitter's suggested user list.
`void`	`getTermsOfService()` Returns Twitter's' Terms of Service.
`void`	`getTrends()` Returns the top ten topics that are currently trending on Twitter.
`void`	`getUserListMembers(long listOwnerId, int listId, long cursor)` Returns the members of the specified list.
`void`	`getUserListMembers(java.lang.String listOwnerScreenName, int listId, long cursor)` Returns the members of the specified list.
`void`	`getUserListMemberships(java.lang.String listMemberScreenName, long cursor)` List the lists the specified user has been added to.
`void`	`getUserLists(java.lang.String listOwnerScreenName, long cursor)` List the lists of the specified user.
`void`	`getUserListStatuses(long listOwnerId, int id, Paging paging)` Show tweet timeline for members of the specified list.
`void`	`getUserListStatuses(java.lang.String listOwnerScreenName, int id, Paging paging)` Show tweet timeline for members of the specified list.
`void`	`getUserListSubscribers(java.lang.String listOwnerScreenName, int listId, long cursor)` Returns the subscribers of the specified list.
`void`	`getUserListSubscriptions(java.lang.String listOwnerScreenName, long cursor)` List the lists the specified user follows.
`void`	`getUserSuggestions(java.lang.String categorySlug)` Access the users in a given category of the Twitter suggested user list. It is recommended that end clients cache this data for no more than one hour.
`void`	`getUserTimeline()` Returns the 20 most recent statuses posted from the authenticating user.
`void`	`getUserTimeline(long userId)` Returns the 20 most recent statuses posted from the authenticating user.
`void`	`getUserTimeline(long userId, Paging paging)` Returns the 20 most recent statuses posted from the authenticating user.
`void`	`getUserTimeline(Paging paging)` Returns the 20 most recent statuses posted from the authenticating user.
`void`	`getUserTimeline(java.lang.String screenName)` Returns the 20 most recent statuses posted from the authenticating user.
`void`	`getUserTimeline(java.lang.String screenName, Paging paging)` Returns the 20 most recent statuses posted from the authenticating user.
`void`	`getWeeklyTrends()` Returns the top 30 trending topics for each day in a given week.
`void`	`getWeeklyTrends(java.util.Date date, boolean excludeHashTags)` Returns the top 30 trending topics for each day in a given week.
`int`	`hashCode()`
`void`	`lookupFriendships(long[] ids)` Returns the relationship of the authenticating user to the specified users.
`void`	`lookupFriendships(java.lang.String[] screenNames)` Returns the relationship of the authenticating user to the specified users.
`void`	`lookupUsers(long[] ids)` Return up to 100 users worth of extended information, specified by either ID, screen name, or combination of the two.
`void`	`lookupUsers(java.lang.String[] screenNames)` Return up to 100 users worth of extended information, specified by either ID, screen name, or combination of the two.
`void`	`reportSpam(long userId)` The user specified in the id is blocked by the authenticated user and reported as a spammer.
`void`	`reportSpam(java.lang.String screenName)` The user specified in the id is blocked by the authenticated user and reported as a spammer.
`void`	`retweetStatus(long statusId)` Retweets a tweet.
`void`	`reverseGeoCode(GeoQuery query)` Search for places (cities and neighborhoods) that can be attached to a statuses/update.
`void`	`search(Query query)` Returns tweets that match a specified query.
`void`	`searchPlaces(GeoQuery query)` Search for places that can be attached to a statuses/update.
`void`	`searchUsers(java.lang.String query, int page)` Run a search for users similar to the Find People button on Twitter.com; the same results returned by people search on Twitter.com will be returned by using this API. Usage note: It is only possible to retrieve the first 1000 matches from this API.
`void`	`sendDirectMessage(long userId, java.lang.String text)` Sends a new direct message to the specified user from the authenticating user.
`void`	`sendDirectMessage(java.lang.String screenName, java.lang.String text)` Sends a new direct message to the specified user from the authenticating user.
`void`	`setOAuthAccessToken(AccessToken accessToken)` Sets the access token
`void`	`setOAuthConsumer(java.lang.String consumerKey, java.lang.String consumerSecret)` sets the OAuth consumer key and consumer secret
`void`	`showDirectMessage(long id)` Returns a single direct message, specified by an id parameter.
`void`	`showFriendship(long sourceId, long targetId)` Returns detailed information about the relationship between two users.
`void`	`showFriendship(java.lang.String sourceScreenName, java.lang.String targetScreenName)` Returns detailed information about the relationship between two users.
`void`	`showStatus(long id)` Returns a single status, specified by the id parameter below.
`void`	`showUser(long userId)` Returns extended information of a given user, specified by ID or screen name as per the required id parameter.
`void`	`showUser(java.lang.String screenName)` Returns extended information of a given user, specified by ID or screen name as per the required id parameter.
`void`	`showUserList(java.lang.String listOwnerScreenName, int id)` Show the specified list.
`void`	`shutdown()`
`void`	`subscribeUserList(java.lang.String listOwnerScreenName, int listId)` Make the authenticated user follow the specified list.
`void`	`test()` Returns the string "ok" in the requested format with a 200 OK HTTP status code.
`java.lang.String`	`toString()`
`void`	`unsubscribeUserList(java.lang.String listOwnerScreenName, int listId)` Unsubscribes the authenticated user form the specified list.
`void`	`updateFriendship(long userId, boolean enableDeviceNotification, boolean retweet)` Allows you to enable or disable retweets and device notifications from the specified user.
`void`	`updateFriendship(java.lang.String screenName, boolean enableDeviceNotification, boolean retweet)` Allows you to enable or disable retweets and device notifications from the specified user.
`void`	`updateProfile(java.lang.String name, java.lang.String url, java.lang.String location, java.lang.String description)` Sets values that users are able to set under the "Account" tab of their settings page.
`void`	`updateProfileBackgroundImage(java.io.File image, boolean tile)` Updates the authenticating user's profile background image.
`void`	`updateProfileBackgroundImage(java.io.InputStream image, boolean tile)` Updates the authenticating user's profile background image.
`void`	`updateProfileColors(java.lang.String profileBackgroundColor, java.lang.String profileTextColor, java.lang.String profileLinkColor, java.lang.String profileSidebarFillColor, java.lang.String profileSidebarBorderColor)` Sets one or more hex values that control the color scheme of the authenticating user's profile page on twitter.com.
`void`	`updateProfileImage(java.io.File image)` Updates the authenticating user's profile image.
`void`	`updateProfileImage(java.io.InputStream image)` Updates the authenticating user's profile image.
`void`	`updateStatus(StatusUpdate latestStatus)` Updates the authenticating user's status.
`void`	`updateStatus(java.lang.String statusText)` Updates the authenticating user's status.
`void`	`updateUserList(int listId, java.lang.String newListName, boolean isPublicList, java.lang.String newDescription)` Updates the specified list.
`void`	`verifyCredentials()` Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; returns a 401 status code and an error message if not.

Methods inherited from class twitter4j.TwitterBaseImpl
`addRateLimitStatusListener, ensureAuthorizationEnabled, ensureOAuthEnabled, fillInIDAndScreenName, getAuthorization, getConfiguration, getId, getScreenName, httpResponseReceived`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Methods inherited from interface twitter4j.TwitterBase
`addRateLimitStatusListener, getAuthorization, getConfiguration, getId, getScreenName`

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:: Constant Field Values

twitter

private final Twitter twitter

listeners

private final java.util.List<TwitterListener> listeners

dispatcher

private static transient twitter4j.internal.async.Dispatcher dispatcher

Constructor Detail

AsyncTwitterImpl

AsyncTwitterImpl(Configuration conf)

AsyncTwitterImpl

AsyncTwitterImpl(Configuration conf,
                 Authorization auth)

Method Detail

addListener

public void addListener(TwitterListener listener)

Adds twitter listener

Specified by:: addListener in interface AsyncTwitter

Parameters:: listener - TwitterListener

search

public void search(Query query)

Returns tweets that match a specified query.
This method calls http://search.twitter.com/search.json

Specified by:: search in interface SearchMethodsAsync

Parameters:: query - - the search condition
See Also:: GET search | dev.twitter.com, Twitter API / Search Operators

getTrends

public void getTrends()

Returns the top ten topics that are currently trending on Twitter. The response includes the time of the request, the name of each trend, and the url to the Twitter Search results page for that topic.
This method calls http://search.twitter.com/trends.json

Specified by:: getTrends in interface TrendsMethodsAsync

See Also:: GET trends | dev.twitter.com

getCurrentTrends

public void getCurrentTrends()

Returns the current top 10 trending topics on Twitter. The response includes the time of the request, the name of each trending topic, and query used on Twitter Search results page for that topic.
This method calls http://search.twitter.com/trends/current.json

Specified by:: getCurrentTrends in interface TrendsMethodsAsync

See Also:: GET trends/current | dev.twitter.com

getCurrentTrends

public void getCurrentTrends(boolean excludeHashTags)

Specified by:: getCurrentTrends in interface TrendsMethodsAsync

Parameters:: excludeHashTags - Setting this to true will remove all hashtags from the trends list.
See Also:: GET trends/current | dev.twitter.com

getDailyTrends

public void getDailyTrends()

Returns the top 20 trending topics for each hour in a given day.
This method calls http://search.twitter.com/trends/daily.json

Specified by:: getDailyTrends in interface TrendsMethodsAsync

See Also:: GET trends/daily | dev.twitter.com

getDailyTrends

public void getDailyTrends(java.util.Date date,
                           boolean excludeHashTags)

Returns the top 20 trending topics for each hour in a given day.
This method calls http://search.twitter.com/trends/daily.json

Specified by:: getDailyTrends in interface TrendsMethodsAsync

Parameters:: date - Permits specifying a start date for the report.; excludeHashTags - Setting this to true will remove all hashtags from the trends list.
See Also:: GET trends/daily | dev.twitter.com

getWeeklyTrends

public void getWeeklyTrends()

Returns the top 30 trending topics for each day in a given week.
This method calls http://search.twitter.com/trends/weekly.json

Specified by:: getWeeklyTrends in interface TrendsMethodsAsync

See Also:: GET trends/weekly | dev.twitter.com

getWeeklyTrends

public void getWeeklyTrends(java.util.Date date,
                            boolean excludeHashTags)

Returns the top 30 trending topics for each day in a given week.
This method calls http://search.twitter.com/trends/weekly.json

Specified by:: getWeeklyTrends in interface TrendsMethodsAsync

Parameters:: date - Permits specifying a start date for the report.; excludeHashTags - Setting this to true will remove all hashtags from the trends list.
See Also:: GET trends/weekly | dev.twitter.com

getPublicTimeline

public void getPublicTimeline()

Returns the 20 most recent statuses from non-protected users who have set a custom user icon. The public timeline is cached for 60 seconds and requesting it more often than that is unproductive and a waste of resources.
This method calls http://api.twitter.com/1/statuses/public_timeline

Specified by:: getPublicTimeline in interface TimelineMethodsAsync

See Also:: GET statuses/public_timeline | dev.twitter.com

getHomeTimeline

public void getHomeTimeline()

Returns the 20 most recent statuses, including retweets, posted by the authenticating user and that user's friends. This is the equivalent of /timeline/home on the Web.
Usage note: This home_timeline call is identical to statuses/friends_timeline, except that home_timeline also contains retweets, while statuses/friends_timeline does not for backwards compatibility reasons. In a future version of the API, statuses/friends_timeline will be deprected and replaced by home_timeline.
This method calls http://api.twitter.com/1/statuses/home_timeline

Specified by:: getHomeTimeline in interface TimelineMethodsAsync

See Also:: GET statuses/home_timeline | dev.twitter.com

getHomeTimeline

public void getHomeTimeline(Paging paging)

Specified by:: getHomeTimeline in interface TimelineMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET statuses/home_timeline | dev.twitter.com

getFriendsTimeline

public void getFriendsTimeline()

Returns the 20 most recent statuses posted by the authenticating user and that user's friends. This is the equivalent of /timeline/home on the Web.

Specified by:: getFriendsTimeline in interface TimelineMethodsAsync

See Also:: GET statuses/friends_timeline | dev.twitter.com

getFriendsTimeline

public void getFriendsTimeline(Paging paging)

Returns the 20 most recent statuses posted by the authenticating user and that user's friends. This is the equivalent of /timeline/home on the Web.
This method calls http://api.twitter.com/1/statuses/friends_timeline

Specified by:: getFriendsTimeline in interface TimelineMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET statuses/friends_timeline | dev.twitter.com

getUserTimeline

public void getUserTimeline(java.lang.String screenName,
                            Paging paging)

Returns the 20 most recent statuses posted from the authenticating user. It's also possible to request another user's timeline via the id parameter.
This is the equivalent of the Web / page for your own user, or the profile page for a third party.
For backwards compatibility reasons, retweets are stripped out of the user_timeline when calling in XML or JSON (they appear with 'RT' in RSS and Atom). If you'd like them included, you can merge them in from statuses retweeted_by_me.

This method calls http://api.twitter.com/1/statuses/user_timeline

Specified by:: getUserTimeline in interface TimelineMethodsAsync

Parameters:: screenName - Specifies the screen name of the user for whom to return the user_timeline.; paging - controls pagination
See Also:: GET statuses/user_timeline | dev.twitter.com

getUserTimeline

public void getUserTimeline(long userId,
                            Paging paging)

Specified by:: getUserTimeline in interface TimelineMethodsAsync

Parameters:: userId - Specifies the ID of the user for whom to return the user_timeline.; paging - controls pagination
See Also:: GET statuses/user_timeline | dev.twitter.com

getUserTimeline

public void getUserTimeline(Paging paging)

Specified by:: getUserTimeline in interface TimelineMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET statuses/user_timeline | dev.twitter.com

getUserTimeline

public void getUserTimeline(java.lang.String screenName)

Specified by:: getUserTimeline in interface TimelineMethodsAsync

Parameters:: screenName - Specifies the screen name of the user for whom to return the user_timeline.
See Also:: GET statuses/user_timeline | dev.twitter.com

getUserTimeline

public void getUserTimeline(long userId)

Specified by:: getUserTimeline in interface TimelineMethodsAsync

Parameters:: userId - Specifies the ID of the user for whom to return the user_timeline.
See Also:: GET statuses/user_timeline | dev.twitter.com

getUserTimeline

public void getUserTimeline()

Specified by:: getUserTimeline in interface TimelineMethodsAsync

See Also:: GET statuses/user_timeline | dev.twitter.com

getMentions

public void getMentions()

Returns the 20 most recent replies (status updates prefixed with @username) to the authenticating user. Replies are only available to the authenticating user; you can not request a list of replies to another user whether public or protected.
This method calls http://api.twitter.com/1/statuses/mentions

Specified by:: getMentions in interface TimelineMethodsAsync

See Also:: GET statuses/mentions | dev.twitter.com

getMentions

public void getMentions(Paging paging)

Specified by:: getMentions in interface TimelineMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET statuses/mentions | dev.twitter.com

getRetweetedByMe

public void getRetweetedByMe()

Returns the 20 most recent retweets posted by the authenticating user.
This method calls http://api.twitter.com/1/statuses/retweeted_by_me

Specified by:: getRetweetedByMe in interface TimelineMethodsAsync

See Also:: GET statuses/retweeted_by_me | dev.twitter.com

getRetweetedByMe

public void getRetweetedByMe(Paging paging)

Returns the 20 most recent retweets posted by the authenticating user.
This method calls http://api.twitter.com/1/statuses/retweeted_by_me

Specified by:: getRetweetedByMe in interface TimelineMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET statuses/retweeted_by_me | dev.twitter.com

getRetweetedToMe

public void getRetweetedToMe()

Returns the 20 most recent retweets posted by the authenticating user's friends.
This method calls http://api.twitter.com/1/statuses/retweeted_to_me

Specified by:: getRetweetedToMe in interface TimelineMethodsAsync

See Also:: GET statuses/retweeted_to_me | dev.twitter.com

getRetweetedToMe

public void getRetweetedToMe(Paging paging)

Returns the 20 most recent retweets posted by the authenticating user's friends.
This method calls http://api.twitter.com/1/statuses/retweeted_to_me

Specified by:: getRetweetedToMe in interface TimelineMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET statuses/retweeted_to_me | dev.twitter.com

getRetweetsOfMe

public void getRetweetsOfMe()

Returns the 20 most recent tweets of the authenticated user that have been retweeted by others.
This method calls http://api.twitter.com/1/statuses/retweets_of_me

Specified by:: getRetweetsOfMe in interface TimelineMethodsAsync

See Also:: GET statuses/retweets_of_me | dev.twitter.com

getRetweetsOfMe

public void getRetweetsOfMe(Paging paging)

Returns the 20 most recent tweets of the authenticated user that have been retweeted by others.
This method calls http://api.twitter.com/1/statuses/retweets_of_me

Specified by:: getRetweetsOfMe in interface TimelineMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET statuses/retweets_of_me | dev.twitter.com

getRetweetedByUser

public void getRetweetedByUser(java.lang.String screenName,
                               Paging paging)

Returns the 20 most recent retweets posted by the specified user. This method is identical to statuses/retweeted_by_me except you can choose the user to view.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/statuses/retweeted_by_user

Specified by:: getRetweetedByUser in interface TimelineMethodsAsync

Parameters:: screenName - the user to view; paging - controls pagination. Supports since_id, max_id, count and page parameters.
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

getRetweetedByUser

public void getRetweetedByUser(long userId,
                               Paging paging)

Specified by:: getRetweetedByUser in interface TimelineMethodsAsync

Parameters:: userId - the user to view; paging - controls pagination. Supports since_id, max_id, count and page parameters.
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

getRetweetedToUser

public void getRetweetedToUser(java.lang.String screenName,
                               Paging paging)

Returns the 20 most recent retweets posted by users the specified user follows. This method is identical to statuses/retweeted_to_me except you can choose the user to view.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/statuses/retweeted_to_user

Specified by:: getRetweetedToUser in interface TimelineMethodsAsync

Parameters:: screenName - the user to view; paging - controls pagination. Supports since_id, max_id, count and page parameters.
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

getRetweetedToUser

public void getRetweetedToUser(long userId,
                               Paging paging)

Specified by:: getRetweetedToUser in interface TimelineMethodsAsync

Parameters:: userId - the user to view; paging - controls pagination. Supports since_id, max_id, count and page parameters.
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

showStatus

public void showStatus(long id)

Returns a single status, specified by the id parameter below. The status's author will be returned inline.
This method calls http://api.twitter.com/1/statuses/show

Specified by:: showStatus in interface StatusMethodsAsync

Parameters:: id - int
See Also:: GET statuses/show/:id | dev.twitter.com

updateStatus

public void updateStatus(java.lang.String statusText)

Updates the authenticating user's status. A status update with text identical to the authenticating user's text identical to the authenticating user's current status will be ignored to prevent duplicates.
This method calls http://api.twitter.com/1/statuses/update

Specified by:: updateStatus in interface StatusMethodsAsync

Parameters:: statusText - String
See Also:: POST statuses/update | dev.twitter.com

updateStatus

public void updateStatus(StatusUpdate latestStatus)

Updates the authenticating user's status. A status update with text identical to the authenticating user's text identical to the authenticating user's current status will be ignored to prevent duplicates.
Statuses over 140 characters will be forcibly truncated.
This method calls http://api.twitter.com/1/statuses/update

Specified by:: updateStatus in interface StatusMethodsAsync

Parameters:: latestStatus - the latest status to be updated.
See Also:: POST statuses/update | dev.twitter.com

destroyStatus

public void destroyStatus(long statusId)

Destroys the status specified by the required ID parameter.
Usage note: The authenticating user must be the author of the specified status.
This method calls http://api.twitter.com/1/statuses/destroy

Specified by:: destroyStatus in interface StatusMethodsAsync

Parameters:: statusId - String
See Also:: POST statuses/destroy/:id | dev.twitter.com

retweetStatus

public void retweetStatus(long statusId)

Retweets a tweet. Returns the original tweet with retweet details embedded.
This method calls http://api.twitter.com/1/statuses/retweet

Specified by:: retweetStatus in interface StatusMethodsAsync

Parameters:: statusId - The ID of the status to retweet.
See Also:: POST statuses/retweet/:id | dev.twitter.com

getRetweets

public void getRetweets(long statusId)

Returns up to 100 of the first retweets of a given tweet.
This method calls http://api.twitter.com/1/statuses/retweets

Specified by:: getRetweets in interface StatusMethodsAsync

Parameters:: statusId - The numerical ID of the tweet you want the retweets of.
See Also:: Tweets Resources › statuses/retweets/:id

getRetweetedBy

public void getRetweetedBy(long statusId)

Show user objects of up to 100 members who retweeted the status.
This method calls http://api.twitter.com/1/statuses/:id/retweeted_by

Specified by:: getRetweetedBy in interface StatusMethodsAsync

Parameters:: statusId - The ID of the status you want to get retweeters of
See Also:: GET statuses/:id/retweeted_by | dev.twitter.com

getRetweetedByIDs

public void getRetweetedByIDs(long statusId)

Show user ids of up to 100 users who retweeted the status represented by id
This method calls http://api.twitter.com/1/statuses/:id/retweeted_by/ids.format

Specified by:: getRetweetedByIDs in interface StatusMethodsAsync

Parameters:: statusId - The ID of the status you want to get retweeters of
See Also:: GET statuses/:id/retweeted_by/ids | dev.twitter.com

showUser

public void showUser(java.lang.String screenName)

Returns extended information of a given user, specified by ID or screen name as per the required id parameter. The author's most recent status will be returned inline.
This method calls http://api.twitter.com/1/users/show.json

Specified by:: showUser in interface UserMethodsAsync

Parameters:: screenName - the screen name of the user for whom to request the detail
See Also:: GET users/show | dev.twitter.com

showUser

public void showUser(long userId)

Specified by:: showUser in interface UserMethodsAsync

Parameters:: userId - the ID of the user for whom to request the retrieve
See Also:: GET users/show | dev.twitter.com

lookupUsers

public void lookupUsers(java.lang.String[] screenNames)

Return up to 100 users worth of extended information, specified by either ID, screen name, or combination of the two. The author's most recent status (if the authenticating user has permission) will be returned inline.
This method calls http://api.twitter.com/1/users/lookup.json

Specified by:: lookupUsers in interface UserMethodsAsync

Parameters:: screenNames - Specifies the screen names of the users to retrieve.
See Also:: GET users/lookup | dev.twitter.com

lookupUsers

public void lookupUsers(long[] ids)

Specified by:: lookupUsers in interface UserMethodsAsync

Parameters:: ids - Specifies the screen names of the users to retrieve.
See Also:: GET users/lookup | dev.twitter.com

searchUsers

public void searchUsers(java.lang.String query,
                        int page)

Run a search for users similar to the Find People button on Twitter.com; the same results returned by people search on Twitter.com will be returned by using this API.
Usage note: It is only possible to retrieve the first 1000 matches from this API.
This method calls http://api.twitter.com/1/users/search.json

Specified by:: searchUsers in interface UserMethodsAsync

Parameters:: query - The query to run against people search.; page - Specifies the page of results to retrieve. Number of statuses per page is fixed to 20.
See Also:: GET users/search | dev.twitter.com

getSuggestedUserCategories

public void getSuggestedUserCategories()

Access to Twitter's suggested user list. This returns the list of suggested user categories. The category can be used in the users/suggestions/category endpoint to get the users in that category.
This method calls http://api.twitter.com/1/users/suggestions/:slug.json

Specified by:: getSuggestedUserCategories in interface UserMethodsAsync

See Also:: GET users/suggestions/:slug | dev.twitter.com

getUserSuggestions

public void getUserSuggestions(java.lang.String categorySlug)

Access the users in a given category of the Twitter suggested user list.
It is recommended that end clients cache this data for no more than one hour.
This method calls http://api.twitter.com/1/users/suggestions/:slug.json

Specified by:: getUserSuggestions in interface UserMethodsAsync

Parameters:: categorySlug - slug
See Also:: GET users/suggestions/slug | dev.twitter.com

getMemberSuggestions

public void getMemberSuggestions(java.lang.String categorySlug)

Access the users in a given category of the Twitter suggested user list and return their most recent status if they are not a protected user.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/users/suggestions/:slug/members.json

Specified by:: getMemberSuggestions in interface UserMethodsAsync

Parameters:: categorySlug - slug
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

getProfileImage

public void getProfileImage(java.lang.String screenName,
                            ProfileImage.ImageSize size)

Access the profile image in various sizes for the user with the indicated screen_name. If no size is provided the normal image is returned. This resource does not return JSON or XML, but instead returns a 302 redirect to the actual image resource. This method should only be used by application developers to lookup or check the profile image URL for a user. This method must not be used as the image source URL presented to users of your application.
This method calls http://api.twitter.com/1/users/profile_image/:screen_name.json

Specified by:: getProfileImage in interface UserMethodsAsync

Parameters:: screenName - The screen name of the user for whom to return results for.; size - Specifies the size of image to fetch. Not specifying a size will give the default, normal size of 48px by 48px. Valid options include: BIGGER - 73px by 73px NORMAL - 48px by 48px MINI - 24px by 24px
See Also:: GET users/profile_image/:screen_name | dev.twitter.com

getAccountTotals

public void getAccountTotals()

Returns the current count of friends, followers, updates (statuses) and favorites of the authenticating user.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/account/totals.json

Specified by:: getAccountTotals in interface AccountMethodsAsync

See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

getAccountSettings

public void getAccountSettings()

Returns the current trend, geo and sleep time information for the authenticating user.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/account/settings.json

Specified by:: getAccountSettings in interface AccountMethodsAsync

See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

getFriendsStatuses

public void getFriendsStatuses(long cursor)

Returns a user's friends, each with current status inline. They are ordered by the order in which the user followed them, most recently followed first, 100 at a time. (Please note that the result set isn't guaranteed to be 100 every time as suspended users will be filtered out.)
This method calls http://api.twitter.com/1/statuses/friends

Specified by:: getFriendsStatuses in interface UserMethodsAsync

Parameters:: cursor - Breaks the results into pages. A single page contains 100 users. This is recommended for users who are followed by many other users. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET statuses/friends | dev.twitter.com

getFriendsStatuses

public void getFriendsStatuses(java.lang.String screenName,
                               long cursor)

Specified by:: getFriendsStatuses in interface UserMethodsAsync

Parameters:: screenName - the screen name of the user for whom to request a list of friends; cursor - Breaks the results into pages. A single page contains 100 users. This is recommended for users who are followed by many other users. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET statuses/friends | dev.twitter.com

getFriendsStatuses

public void getFriendsStatuses(long userId,
                               long cursor)

Specified by:: getFriendsStatuses in interface UserMethodsAsync

Parameters:: userId - the screen name of the user for whom to request a list of friends; cursor - Breaks the results into pages. A single page contains 100 users. This is recommended for users who are followed by many other users. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET statuses/friends | dev.twitter.com

getFollowersStatuses

public void getFollowersStatuses(long cursor)

Returns the authenticating user's followers, each with current status inline. They are ordered by the order in which they joined Twitter (this is going to be changed).
This method calls http://api.twitter.com/1/statuses/followers.json

Specified by:: getFollowersStatuses in interface UserMethodsAsync

Parameters:: cursor - Breaks the results into pages. A single page contains 100 users. This is recommended for users who are followed by many other users. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET statuses/followers | dev.twitter.com

getFollowersStatuses

public void getFollowersStatuses(java.lang.String screenName,
                                 long cursor)

Returns the specified user's followers, each with current status inline. They are ordered by the order in which they joined Twitter (this is going to be changed).
This method calls http://api.twitter.com/1/statuses/followers.json

Specified by:: getFollowersStatuses in interface UserMethodsAsync

Parameters:: screenName - The screen name of the user for whom to request a list of followers.; cursor - Breaks the results into pages. A single page contains 100 users. This is recommended for users who are followed by many other users. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET statuses/followers | dev.twitter.com

getFollowersStatuses

public void getFollowersStatuses(long userId,
                                 long cursor)

Specified by:: getFollowersStatuses in interface UserMethodsAsync

Parameters:: userId - The ID of the user for whom to request a list of followers.; cursor - Breaks the results into pages. A single page contains 100 users. This is recommended for users who are followed by many other users. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET statuses/followers | dev.twitter.com

createUserList

public void createUserList(java.lang.String listName,
                           boolean isPublicList,
                           java.lang.String description)

Creates a new list for the authenticated user. Accounts are limited to 20 lists.
This method calls http://api.twitter.com/1/user/lists.json

Specified by:: createUserList in interface ListMethodsAsync

Parameters:: listName - The name of the list you are creating. Required.; isPublicList - set true if you wish to make a public list; description - The description of the list you are creating. Optional.
See Also:: POST :user/lists | dev.twitter.com

updateUserList

public void updateUserList(int listId,
                           java.lang.String newListName,
                           boolean isPublicList,
                           java.lang.String newDescription)

Updates the specified list.
This method calls http://api.twitter.com/1/:user/lists/:id.json

Specified by:: updateUserList in interface ListMethodsAsync

Parameters:: listId - The id of the list to update.; newListName - What you'd like to change the list's name to.; isPublicList - Whether your list is public or private. Optional. Values can be public or private. Lists are public by default if no mode is specified.; newDescription - What you'd like to change the list description to.
See Also:: POST :user/lists/:id | dev.twitter.com

getUserLists

public void getUserLists(java.lang.String listOwnerScreenName,
                         long cursor)

List the lists of the specified user. Private lists will be included if the authenticated users is the same as the user whose lists are being returned.
This method calls http://api.twitter.com/1/:user/lists.json

Specified by:: getUserLists in interface ListMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; cursor - Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET :user/lists | dev.twitter.com

showUserList

public void showUserList(java.lang.String listOwnerScreenName,
                         int id)

Show the specified list. Private lists will only be shown if the authenticated user owns the specified list.
This method calls http://api.twitter.com/1/:user/lists/:id.json

Specified by:: showUserList in interface ListMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; id - The id of the list to show
See Also:: GET :user/lists/:id | dev.twitter.com

destroyUserList

public void destroyUserList(int listId)

Deletes the specified list. Must be owned by the authenticated user.
This method calls http://api.twitter.com/1/:user/lists/:id.json

Specified by:: destroyUserList in interface ListMethodsAsync

Parameters:: listId - The id of the list to delete
See Also:: DELETE :user/lists/:id | dev.twitter.com

getUserListStatuses

public void getUserListStatuses(java.lang.String listOwnerScreenName,
                                int id,
                                Paging paging)

Show tweet timeline for members of the specified list.
http://api.twitter.com/1/user/lists/list_id/statuses.json

Specified by:: getUserListStatuses in interface ListMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; id - The id of the list to delete; paging - controls pagination. Supports since_id, max_id, count and page parameters.
See Also:: GET :user/lists/:id/statuses | dev.twitter.com

getUserListStatuses

public void getUserListStatuses(long listOwnerId,
                                int id,
                                Paging paging)

Show tweet timeline for members of the specified list.
http://api.twitter.com/1/user/lists/list_id/statuses.json

Specified by:: getUserListStatuses in interface ListMethodsAsync

Parameters:: listOwnerId - The screen name of the list owner; id - The id of the list to delete; paging - controls pagination. Supports since_id, max_id, count and page parameters.
See Also:: GET :user/lists/:id/statuses | dev.twitter.com

getUserListMemberships

public void getUserListMemberships(java.lang.String listMemberScreenName,
                                   long cursor)

List the lists the specified user has been added to.
This method calls http://api.twitter.com/1/:user/lists/memberships.json

Specified by:: getUserListMemberships in interface ListMethodsAsync

Parameters:: listMemberScreenName - The screen name of the list member; cursor - Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET :user/lists/memberships | dev.twitter.com

getUserListSubscriptions

public void getUserListSubscriptions(java.lang.String listOwnerScreenName,
                                     long cursor)

List the lists the specified user follows.
This method calls http://api.twitter.com/1/[user]/lists/subscriptions.json

Specified by:: getUserListSubscriptions in interface ListMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; cursor - Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET :user/lists/subscriptions | dev.twitter.com

getAllSubscribingUserLists

public void getAllSubscribingUserLists(java.lang.String screenName)

Returns all lists the authenticating or specified user subscribes to, including their own.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/lists/all.json

Specified by:: getAllSubscribingUserLists in interface ListMethodsAsync

Parameters:: screenName - screen name to look up

getAllSubscribingUserLists

public void getAllSubscribingUserLists(long userId)

Specified by:: getAllSubscribingUserLists in interface ListMethodsAsync

Parameters:: userId - user id to look up

getUserListMembers

public void getUserListMembers(java.lang.String listOwnerScreenName,
                               int listId,
                               long cursor)

Returns the members of the specified list.
This method calls http://api.twitter.com/1/[user]/[list_id]/members.json

Specified by:: getUserListMembers in interface ListMembersMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; listId - The id of the list; cursor - Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET :user/:list_id/members | dev.twitter.com

getUserListMembers

public void getUserListMembers(long listOwnerId,
                               int listId,
                               long cursor)

Returns the members of the specified list.
This method calls http://api.twitter.com/1/[user]/[list_id]/members.json

Specified by:: getUserListMembers in interface ListMembersMethodsAsync

Parameters:: listOwnerId - The id of the list owner; listId - The id of the list; cursor - Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET :user/:list_id/members | dev.twitter.com

addUserListMember

public void addUserListMember(int listId,
                              long userId)

Adds a member to a list. The authenticated user must own the list to be able to add members to it. Lists are limited to having 500 members.
This method calls http://api.twitter.com/1/[listOwner]/[listId]/members.json

Specified by:: addUserListMember in interface ListMembersMethodsAsync

Parameters:: listId - The id of the list.; userId - The id of the user to add as a member of the list.
See Also:: POST :user/:list_id/members | dev.twitter.com

addUserListMembers

public void addUserListMembers(int listId,
                               long[] userIds)

Adds multiple members to a list, by specifying a comma-separated list of member ids or screen names. The authenticated user must own the list to be able to add members to it. Lists are limited to having 500 members, and you are limited to adding up to 100 members to a list at a time with this method.
This method calls http://api.twitter.com/1/[user]/[list_id]/members/create_all.json

Specified by:: addUserListMembers in interface ListMembersMethodsAsync

Parameters:: listId - The id of the list.; userIds - The array of ids of the user to add as member of the list. up to 100 are allowed in a single request.
See Also:: POST :user/:list_id/create_all | dev.twitter.com

addUserListMembers

public void addUserListMembers(int listId,
                               java.lang.String[] screenNames)

Specified by:: addUserListMembers in interface ListMembersMethodsAsync

Parameters:: listId - The id of the list.; screenNames - The array of screen names of the user to add as member of the list. up to 100 are allowed in a single request.
See Also:: POST :user/:list_id/create_all | dev.twitter.com

deleteUserListMember

public void deleteUserListMember(int listId,
                                 long userId)

Removes the specified member from the list. The authenticated user must be the list's owner to remove members from the list.
This method calls http://api.twitter.com/1/[listOwner]/[listId]/members.json

Specified by:: deleteUserListMember in interface ListMembersMethodsAsync

Parameters:: listId - The id of the list.; userId - The screen name of the member you wish to remove from the list.
See Also:: DELETE :user/:id/members | dev.twitter.com

checkUserListMembership

public void checkUserListMembership(java.lang.String listOwnerScreenName,
                                    int listId,
                                    long userId)

Check if a user is a member of the specified list.

This method calls http://api.twitter.com/1/[listOwner]/[listId]/members/id.json

Specified by:: checkUserListMembership in interface ListMembersMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; listId - The id of the list.; userId - The id of the user who you want to know is a member or not of the specified list.
See Also:: GET :user/:list_id/members/:id | dev.twitter.com

getUserListSubscribers

public void getUserListSubscribers(java.lang.String listOwnerScreenName,
                                   int listId,
                                   long cursor)

Returns the subscribers of the specified list.
This method calls http://api.twitter.com/1/:user/:list_id/subscribers.json

Specified by:: getUserListSubscribers in interface ListSubscribersMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; listId - The id of the list; cursor - Breaks the results into pages. A single page contains 20 lists. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET :user/:list_id/subscribers | dev.twitter.com

subscribeUserList

public void subscribeUserList(java.lang.String listOwnerScreenName,
                              int listId)

Make the authenticated user follow the specified list.
This method calls http://api.twitter.com/1/:listOwner/:listId/subscribers.json

Specified by:: subscribeUserList in interface ListSubscribersMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; listId - The id of the list.
See Also:: POST :user/:list_id/subscribers | dev.twitter.com

unsubscribeUserList

public void unsubscribeUserList(java.lang.String listOwnerScreenName,
                                int listId)

Unsubscribes the authenticated user form the specified list.
This method calls http://api.twitter.com/1/:listOwner/:listId/subscribers.json

Specified by:: unsubscribeUserList in interface ListSubscribersMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; listId - The id of the list.
See Also:: DELETE :user/:list_id/subscribers | dev.twitter.com

checkUserListSubscription

public void checkUserListSubscription(java.lang.String listOwnerScreenName,
                                      int listId,
                                      long userId)

Check if the specified user is a subscriber of the specified list.
This method calls http://api.twitter.com/1/:listOwner/:listId/subscribers/:userId.json

Specified by:: checkUserListSubscription in interface ListSubscribersMethodsAsync

Parameters:: listOwnerScreenName - The screen name of the list owner; listId - The id of the list.; userId - The id of the user who you want to know is a member or not of the specified list. , or the user is not a member of the specified list(TwitterException.getStatusCode() returns 404 in that case.)
See Also:: GET :user/:list_id/subscribers/:id | dev.twitter.com

getDirectMessages

public void getDirectMessages()

Returns a list of the direct messages sent to the authenticating user.
This method calls http://api.twitter.com/1/direct_messages

Specified by:: getDirectMessages in interface DirectMessageMethodsAsync

See Also:: GET direct_messages | dev.twitter.com

getDirectMessages

public void getDirectMessages(Paging paging)

Returns a list of the direct messages sent to the authenticating user.
This method calls http://api.twitter.com/1/direct_messages

Specified by:: getDirectMessages in interface DirectMessageMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET direct_messages | dev.twitter.com

getSentDirectMessages

public void getSentDirectMessages()

Returns a list of the direct messages sent by the authenticating user.
This method calls http://api.twitter.com/1/direct_messages/sent

Specified by:: getSentDirectMessages in interface DirectMessageMethodsAsync

See Also:: GET direct_messages/sent | dev.twitter.com

getSentDirectMessages

public void getSentDirectMessages(Paging paging)

Returns a list of the direct messages sent by the authenticating user.
This method calls http://api.twitter.com/1/direct_messages/sent

Specified by:: getSentDirectMessages in interface DirectMessageMethodsAsync

Parameters:: paging - controls pagination
See Also:: GET direct_messages/sent | dev.twitter.com

sendDirectMessage

public void sendDirectMessage(java.lang.String screenName,
                              java.lang.String text)

Sends a new direct message to the specified user from the authenticating user. Requires both the user and text parameters below. The text will be trimed if the length of the text is exceeding 140 characters.
This method calls http://api.twitter.com/1/direct_messages/new

Specified by:: sendDirectMessage in interface DirectMessageMethodsAsync

Parameters:: screenName - the screen name of the user to whom send the direct message; text - The text of your direct message.
See Also:: POST direct_messages/new | dev.twitter.com

sendDirectMessage

public void sendDirectMessage(long userId,
                              java.lang.String text)

Specified by:: sendDirectMessage in interface DirectMessageMethodsAsync

Parameters:: userId - the screen name of the user to whom send the direct message; text - The text of your direct message.
See Also:: POST direct_messages/new | dev.twitter.com

destroyDirectMessage

public void destroyDirectMessage(long id)

Destroys the direct message specified in the required ID parameter. The authenticating user must be the recipient of the specified direct message.
This method calls http://api.twitter.com/1/direct_messages/destroy

Specified by:: destroyDirectMessage in interface DirectMessageMethodsAsync

Parameters:: id - int
See Also:: POST direct_messages/destroy/:id | dev.twitter.com

showDirectMessage

public void showDirectMessage(long id)

Returns a single direct message, specified by an id parameter.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/direct_messages/show/:id.json

Specified by:: showDirectMessage in interface DirectMessageMethodsAsync

Parameters:: id - message id
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

createFriendship

public void createFriendship(java.lang.String screenName)

Allows the authenticating users to follow the user specified in the ID parameter.
Returns the befriended user in the requested format when successful. Returns a string describing the failure condition when unsuccessful. If you are already friends with the user an HTTP 403 will be returned.
This method calls http://api.twitter.com/1/friendships/create

Specified by:: createFriendship in interface FriendshipMethodsAsync

Parameters:: screenName - the screen name of the user to be befriended
See Also:: POST friendships/create | dev.twitter.com

createFriendship

public void createFriendship(long userId)

Specified by:: createFriendship in interface FriendshipMethodsAsync

Parameters:: userId - the ID of the user to be befriended
See Also:: POST friendships/create | dev.twitter.com

createFriendship

public void createFriendship(java.lang.String screenName,
                             boolean follow)

Specified by:: createFriendship in interface FriendshipMethodsAsync

Parameters:: screenName - the screen name of the user to be befriended; follow - Enable notifications for the target user in addition to becoming friends.
See Also:: POST friendships/create | dev.twitter.com

createFriendship

public void createFriendship(long userId,
                             boolean follow)

Specified by:: createFriendship in interface FriendshipMethodsAsync

Parameters:: userId - the ID of the user to be befriended; follow - Enable notifications for the target user in addition to becoming friends.
See Also:: POST friendships/create | dev.twitter.com

destroyFriendship

public void destroyFriendship(java.lang.String screenName)

Allows the authenticating users to unfollow the user specified in the ID parameter.
Returns the unfollowed user in the requested format when successful. Returns a string describing the failure condition when unsuccessful.
This method calls http://api.twitter.com/1/friendships/destroy

Specified by:: destroyFriendship in interface FriendshipMethodsAsync

Parameters:: screenName - the screen name of the user to be befriended
See Also:: POST friendships/destroy | dev.twitter.com

destroyFriendship

public void destroyFriendship(long userId)

Specified by:: destroyFriendship in interface FriendshipMethodsAsync

Parameters:: userId - the screen name of the user to be befriended
See Also:: POST friendships/destroy | dev.twitter.com

existsFriendship

public void existsFriendship(java.lang.String userA,
                             java.lang.String userB)

Tests for the existence of friendship between two users. Will return true if user_a follows user_b, otherwise will return false.
This method calls http://api.twitter.com/1/friendships/exists

Specified by:: existsFriendship in interface FriendshipMethodsAsync

Parameters:: userA - The ID or screen_name of the first user to test friendship for.; userB - The ID or screen_name of the second user to test friendship for.
See Also:: GET friendships/exists | dev.twitter.com

showFriendship

public void showFriendship(java.lang.String sourceScreenName,
                           java.lang.String targetScreenName)

Returns detailed information about the relationship between two users.
This method calls http://api.twitter.com/1/friendships/show.json

Specified by:: showFriendship in interface FriendshipMethodsAsync

Parameters:: sourceScreenName - the screen name of the source user; targetScreenName - the screen name of the target user
See Also:: GET friendships/show | dev.twitter.com

showFriendship

public void showFriendship(long sourceId,
                           long targetId)

Returns detailed information about the relationship between two users.
This method calls http://api.twitter.com/1/friendships/show.json

Specified by:: showFriendship in interface FriendshipMethodsAsync

Parameters:: sourceId - the ID of the source user; targetId - the ID of the target user
See Also:: GET friendships/show | dev.twitter.com

getIncomingFriendships

public void getIncomingFriendships(long cursor)

Returns an array of numeric IDs for every user who has a pending request to follow the authenticating user.
This method calls http://api.twitter.com/1/friendships/incoming.json

Specified by:: getIncomingFriendships in interface FriendshipMethodsAsync

Parameters:: cursor - Breaks the results into pages. A single page contains 5000 identifiers. Provide a value of -1 to begin paging.
See Also:: GET friendships/incoming | dev.twitter.com

getOutgoingFriendships

public void getOutgoingFriendships(long cursor)

Returns an array of numeric IDs for every protected user for whom the authenticating user has a pending follow request.
This method calls http://api.twitter.com/1/friendships/outgoing.json

Specified by:: getOutgoingFriendships in interface FriendshipMethodsAsync

Parameters:: cursor - Breaks the results into pages. A single page contains 5000 identifiers. Provide a value of -1 to begin paging.
See Also:: GET friendships/outgoing | dev.twitter.com

lookupFriendships

public void lookupFriendships(java.lang.String[] screenNames)

Returns the relationship of the authenticating user to the specified users.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/friendships/lookup.json

Specified by:: lookupFriendships in interface FriendshipMethodsAsync

Parameters:: screenNames - array of the screen names to lookup
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

lookupFriendships

public void lookupFriendships(long[] ids)

Specified by:: lookupFriendships in interface FriendshipMethodsAsync

Parameters:: ids - array of the ids to lookup
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

updateFriendship

public void updateFriendship(java.lang.String screenName,
                             boolean enableDeviceNotification,
                             boolean retweet)

Allows you to enable or disable retweets and device notifications from the specified user.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/friendships/update.json

Specified by:: updateFriendship in interface FriendshipMethodsAsync

Parameters:: screenName - screen name to update; enableDeviceNotification - set true to enable device notification; retweet - set true to enable retweets
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

updateFriendship

public void updateFriendship(long userId,
                             boolean enableDeviceNotification,
                             boolean retweet)

Specified by:: updateFriendship in interface FriendshipMethodsAsync

Parameters:: userId - user id to update; enableDeviceNotification - set true to enable device notification; retweet - set true to enable retweets
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

getFriendsIDs

public void getFriendsIDs(long cursor)

Returns an array of numeric IDs for every user the authenticating user is following.
This method calls http://api.twitter.com/1/friends/ids.json

Specified by:: getFriendsIDs in interface FriendsFollowersMethodsAsync

Parameters:: cursor - Specifies the page number of the results beginning at 1. A single page contains 5000 ids. This is recommended for users with large ID lists. If not provided all ids are returned.
See Also:: GET friends/ids | dev.twitter.com

getFriendsIDs

public void getFriendsIDs(long userId,
                          long cursor)

Returns an array of numeric IDs for every user the specified user is following.
This method calls http://api.twitter.com/1/friends/ids.json

Specified by:: getFriendsIDs in interface FriendsFollowersMethodsAsync

Parameters:: userId - Specifies the ID of the user for whom to return the friends list.; cursor - Specifies the page number of the results beginning at 1. A single page contains 5000 ids. This is recommended for users with large ID lists. If not provided all ids are returned.
See Also:: GET friends/ids | dev.twitter.com

getFriendsIDs

public void getFriendsIDs(java.lang.String screenName,
                          long cursor)

Returns an array of numeric IDs for every user the specified user is following.
This method calls http://api.twitter.com/1/friends/ids.json

Specified by:: getFriendsIDs in interface FriendsFollowersMethodsAsync

Parameters:: screenName - Specifies the screen name of the user for whom to return the friends list.; cursor - Specifies the page number of the results beginning at 1. A single page contains 5000 ids. This is recommended for users with large ID lists. If not provided all ids are returned.
See Also:: GET friends/ids | dev.twitter.com

getFollowersIDs

public void getFollowersIDs(long cursor)

Returns an array of numeric IDs for every user the specified user is followed by.
This method calls http://api.twitter.com/1/followers/ids.json

Specified by:: getFollowersIDs in interface FriendsFollowersMethodsAsync

Parameters:: cursor - Breaks the results into pages. A single page contains 100 users. This is recommended for users who are followed by many other users. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
See Also:: GET followers/ids | dev.twitter.com

getFollowersIDs

public void getFollowersIDs(long userId,
                            long cursor)

Returns an array of numeric IDs for every user the specified user is followed by.
This method calls http://api.twitter.com/1/followers/ids.json

Specified by:: getFollowersIDs in interface FriendsFollowersMethodsAsync

Parameters:: userId - Specifies the ID of the user for whom to return the followers list.; cursor - Specifies the page number of the results beginning at 1. A single page contains 5000 ids. This is recommended for users with large ID lists. If not provided all ids are returned.
See Also:: GET followers/ids | dev.twitter.com

getFollowersIDs

public void getFollowersIDs(java.lang.String screenName,
                            long cursor)

Returns an array of numeric IDs for every user the specified user is followed by.
This method calls http://api.twitter.com/1/followers/ids.json

Specified by:: getFollowersIDs in interface FriendsFollowersMethodsAsync

Parameters:: screenName - Specifies the screen name of the user for whom to return the followers list.; cursor - Specifies the page number of the results beginning at 1. A single page contains 5000 ids. This is recommended for users with large ID lists. If not provided all ids are returned.
See Also:: GET followers/ids | dev.twitter.com

verifyCredentials

public void verifyCredentials()

Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; returns a 401 status code and an error message if not. Use this method to test if supplied user credentials are valid.
This method calls http://api.twitter.com/1/account/verify_credentials.json

Specified by:: verifyCredentials in interface AccountMethodsAsync

See Also:: GET account/verify_credentials | dev.twitter.com

updateProfile

public void updateProfile(java.lang.String name,
                          java.lang.String url,
                          java.lang.String location,
                          java.lang.String description)

Sets values that users are able to set under the "Account" tab of their settings page. Only the parameters specified(non-null) will be updated.

Specified by:: updateProfile in interface AccountMethodsAsync

Parameters:: name - Optional. Maximum of 20 characters.; url - Optional. Maximum of 100 characters. Will be prepended with "http://" if not present.; location - Optional. Maximum of 30 characters. The contents are not normalized or geocoded in any way.; description - Optional. Maximum of 160 characters.
See Also:: POST account/update_profile | dev.twitter.com

getRateLimitStatus

public void getRateLimitStatus()

Gets the remaining number of API requests available to the requesting user before the API limit is reached for the current hour. Calls to rate_limit_status do not count against the rate limit. If authentication credentials are provided, the rate limit status for the authenticating user is returned. Otherwise, the rate limit status for the requester's IP address is returned.
This method calls http://api.twitter.com/1/account/rate_limit_status

Specified by:: getRateLimitStatus in interface AccountMethodsAsync

See Also:: GET account/rate_limit_status | dev.twitter.com

updateProfileColors

public void updateProfileColors(java.lang.String profileBackgroundColor,
                                java.lang.String profileTextColor,
                                java.lang.String profileLinkColor,
                                java.lang.String profileSidebarFillColor,
                                java.lang.String profileSidebarBorderColor)

Sets one or more hex values that control the color scheme of the authenticating user's profile page on twitter.com. Each parameter's value must be a valid hexadecimal value, and may be either three or six characters (ex: #fff or #ffffff).
This method calls http://api.twitter.com/1/account/update_profile_colors

Specified by:: updateProfileColors in interface AccountMethodsAsync

Parameters:: profileBackgroundColor - optional, can be null; profileTextColor - optional, can be null; profileLinkColor - optional, can be null; profileSidebarFillColor - optional, can be null; profileSidebarBorderColor - optional, can be null
See Also:: POST account/update_profile_colors | dev.twitter.com

updateProfileImage

public void updateProfileImage(java.io.File image)

Updates the authenticating user's profile image.
This method calls http://api.twitter.com/1/account/update_profile_image.json

Specified by:: updateProfileImage in interface AccountMethodsAsync

Parameters:: image - Must be a valid GIF, JPG, or PNG image of less than 700 kilobytes in size. Images with width larger than 500 pixels will be scaled down.
See Also:: POST account/update_profile_image | dev.twitter.com

updateProfileImage

public void updateProfileImage(java.io.InputStream image)

Updates the authenticating user's profile image.
This method calls http://api.twitter.com/1/account/update_profile_image.json

Specified by:: updateProfileImage in interface AccountMethodsAsync

Parameters:: image - Must be a valid GIF, JPG, or PNG image of less than 700 kilobytes in size. Images with width larger than 500 pixels will be scaled down.
See Also:: POST account/update_profile_image | dev.twitter.com

updateProfileBackgroundImage

public void updateProfileBackgroundImage(java.io.File image,
                                         boolean tile)

Updates the authenticating user's profile background image.
This method calls http://api.twitter.com/1/account/update_profile_background_image.json

Specified by:: updateProfileBackgroundImage in interface AccountMethodsAsync

Parameters:: image - Must be a valid GIF, JPG, or PNG image of less than 800 kilobytes in size. Images with width larger than 2048 pixels will be forcibly scaled down.; tile - If set to true the background image will be displayed tiled. The image will not be tiled otherwise.
See Also:: POST account/update_profile_background_image | dev.twitter.com

updateProfileBackgroundImage

public void updateProfileBackgroundImage(java.io.InputStream image,
                                         boolean tile)

Updates the authenticating user's profile background image.
This method calls http://api.twitter.com/1/account/update_profile_background_image.json

Specified by:: updateProfileBackgroundImage in interface AccountMethodsAsync

Parameters:: image - Must be a valid GIF, JPG, or PNG image of less than 800 kilobytes in size. Images with width larger than 2048 pixels will be forcibly scaled down.; tile - If set to true the background image will be displayed tiled. The image will not be tiled otherwise.
See Also:: POST account/update_profile_background_image | dev.twitter.com

getFavorites

public void getFavorites()

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

Specified by:: getFavorites in interface FavoriteMethodsAsync

See Also:: GET favorites | dev.twitter.com

getFavorites

public void 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.
This method calls http://api.twitter.com/1/favorites

Specified by:: getFavorites in interface FavoriteMethodsAsync

Parameters:: page - number of page to retrieve favorites
See Also:: GET favorites | dev.twitter.com

getFavorites

public void getFavorites(java.lang.String id)

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

Specified by:: getFavorites in interface FavoriteMethodsAsync

Parameters:: id - the ID or screen name of the user for whom to request a list of favorite statuses
See Also:: GET favorites | dev.twitter.com

getFavorites

public void getFavorites(java.lang.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.
This method calls http://api.twitter.com/1/favorites

Specified by:: getFavorites in interface FavoriteMethodsAsync

Parameters:: id - the ID or screen name of the user for whom to request a list of favorite statuses.; page - retrieves the 20 next most recent favorite statuses.
See Also:: GET favorites | dev.twitter.com

createFavorite

public void createFavorite(long id)

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%C2%A0

Specified by:: createFavorite in interface FavoriteMethodsAsync

Parameters:: id - the ID or screen name of the user for whom to request a list of favorite statuses.
See Also:: POST favorites/create/:id | dev.twitter.com

destroyFavorite

public void destroyFavorite(long id)

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/destroy

Specified by:: destroyFavorite in interface FavoriteMethodsAsync

Parameters:: id - the ID or screen name of the user for whom to request a list of un-favorite statuses.
See Also:: POST favorites/destroy/:id | dev.twitter.com

enableNotification

public void enableNotification(java.lang.String screenName)

Enables notifications for updates from the specified user to the authenticating user. Returns the specified user when successful.
This method calls http://api.twitter.com/1/notifications/follow.json

Specified by:: enableNotification in interface NotificationMethodsAsync

Parameters:: screenName - Specifies the screen name of the user to follow with device updates.
See Also:: POST notifications/follow | dev.twitter.com

enableNotification

public void enableNotification(long userId)

Enables notifications for updates from the specified user to the authenticating user. Returns the specified user when successful.
This method calls http://api.twitter.com/1/notifications/follow.json

Specified by:: enableNotification in interface NotificationMethodsAsync

Parameters:: userId - Specifies the ID of the user to follow with device updates.
See Also:: POST notifications/follow | dev.twitter.com

disableNotification

public void disableNotification(java.lang.String screenName)

Disables notifications for updates from the specified user to the authenticating user. Returns the specified user when successful.
This method calls http://api.twitter.com/1/notifications/leave.json

Specified by:: disableNotification in interface NotificationMethodsAsync

Parameters:: screenName - Specifies the screen name of the user to disable device notifications.
See Also:: POST notifications/leave | dev.twitter.com

disableNotification

public void disableNotification(long userId)

Disables notifications for updates from the specified user to the authenticating user. Returns the specified user when successful.
This method calls http://api.twitter.com/1/notifications/leave.json

Specified by:: disableNotification in interface NotificationMethodsAsync

Parameters:: userId - Specifies the ID of the user to disable device notifications.
See Also:: POST notifications/leave | dev.twitter.com

createBlock

public void createBlock(java.lang.String screenName)

Blocks the user specified in the ID parameter as the authenticating user. Returns the blocked user in the requested format when successful.
This method calls http://api.twitter.com/1/blocks/create%C2%A0

Specified by:: createBlock in interface BlockMethodsAsync

Parameters:: screenName - the screen_name of the user to block
See Also:: POST blocks/create | dev.twitter.com

createBlock

public void createBlock(long userId)

Specified by:: createBlock in interface BlockMethodsAsync

Parameters:: userId - the screen_name of the user to block
See Also:: POST blocks/create | dev.twitter.com

destroyBlock

public void destroyBlock(java.lang.String screenName)

Un-blocks the user specified in the ID parameter as the authenticating user. Returns the un-blocked user in the requested format when successful.
This method calls http://api.twitter.com/1/blocks/create%C2%A0

Specified by:: destroyBlock in interface BlockMethodsAsync

Parameters:: screenName - the screen_name of the user to block
See Also:: POST blocks/destroy | dev.twitter.com

destroyBlock

public void destroyBlock(long userId)

Specified by:: destroyBlock in interface BlockMethodsAsync

Parameters:: userId - the ID of the user to block
See Also:: POST blocks/destroy | dev.twitter.com

existsBlock

public void existsBlock(java.lang.String screenName)

Returns if the authenticating user is blocking a target user. Will return the blocked user's object if a block exists, and error with a HTTP 404 response code otherwise.
This method calls http://api.twitter.com/1/blocks/exists/id.xml

Specified by:: existsBlock in interface BlockMethodsAsync

Parameters:: screenName - The screen_name of the potentially blocked user.
See Also:: GET blocks/exists | dev.twitter.com

existsBlock

public void existsBlock(long userId)

Specified by:: existsBlock in interface BlockMethodsAsync

Parameters:: userId - The ID of the potentially blocked user.
See Also:: GET blocks/exists | dev.twitter.com

getBlockingUsers

public void getBlockingUsers()

Returns a list of user objects that the authenticating user is blocking.
This method calls http://api.twitter.com/1/blocks/blocking.xml

Specified by:: getBlockingUsers in interface BlockMethodsAsync

See Also:: GET blocks/blocking | dev.twitter.com

getBlockingUsers

public void getBlockingUsers(int page)

Returns a list of user objects that the authenticating user is blocking.
This method calls http://api.twitter.com/1/blocks/blocking.xml

Specified by:: getBlockingUsers in interface BlockMethodsAsync

Parameters:: page - the number of page
See Also:: GET blocks/blocking | dev.twitter.com

getBlockingUsersIDs

public void getBlockingUsersIDs()

Returns an array of numeric user ids the authenticating user is blocking.
This method calls http://api.twitter.com/1/blocks/blocking/ids

Specified by:: getBlockingUsersIDs in interface BlockMethodsAsync

See Also:: GET blocks/blocking/ids | dev.twitter.com

reportSpam

public void reportSpam(long userId)

The user specified in the id is blocked by the authenticated user and reported as a spammer.
This method calls http://api.twitter.com/1/report_spam.json

Specified by:: reportSpam in interface SpamReportingMethodsAsync

Parameters:: userId - The ID of the user you want to report as a spammer.
See Also:: POST report_spam | dev.twitter.com

reportSpam

public void reportSpam(java.lang.String screenName)

The user specified in the id is blocked by the authenticated user and reported as a spammer.
This method calls http://api.twitter.com/1/report_spam.json

Specified by:: reportSpam in interface SpamReportingMethodsAsync

Parameters:: screenName - The screen name of the user you want to report as a spammer.
See Also:: POST report_spam | dev.twitter.com

getAvailableTrends

public void getAvailableTrends()

Retrieves the locations that Twitter has trending topic information for. The response is an array of "locations" that encode the location's WOEID (a Yahoo! Where On Earth ID) and some other human-readable information such as a canonical name and country the location belongs in.
This method calls http://api.twitter.com/1/trends/available.json

Specified by:: getAvailableTrends in interface LocalTrendsMethodsAsync

See Also:: GET trends/available | dev.twitter.com

getAvailableTrends

public void getAvailableTrends(GeoLocation location)

Retrieves the sorted locations that Twitter has trending topic information for. The response is an array of "locations" that encode the location's WOEID (a Yahoo! Where On Earth ID) and some other human-readable information such as a canonical name and country the location belongs in.
This method calls http://api.twitter.com/1/trends/available.json

Specified by:: getAvailableTrends in interface LocalTrendsMethodsAsync

Parameters:: location - the available trend locations will be sorted by distance to the lat and long passed in. The sort is nearest to furthest.
See Also:: GET trends/available | dev.twitter.com

getLocationTrends

public void getLocationTrends(int woeid)

Retrieves the top 10 trending topics for a specific location Twitter has trending topic information for. The response is an array of "trend" objects that encode the name of the trending topic, the query parameter that can be used to search for the topic on Search, and the direct URL that can be issued against Search. This information is cached for five minutes, and therefore users are discouraged from querying these endpoints faster than once every five minutes. Global trends information is also available from this API by using a WOEID of 1.
This method calls http://api.twitter.com/1/trends/:woeid.json

Specified by:: getLocationTrends in interface LocalTrendsMethodsAsync

Parameters:: woeid - The WOEID of the location to be querying for
See Also:: GET trends/:woeid | dev.twitter.com

searchPlaces

public void searchPlaces(GeoQuery query)

Search for places that can be attached to a statuses/update. Given a latitude and a longitude pair, an IP address, or a name, this request will return a list of all the valid places that can be used as the place_id when updating a status.
Conceptually, a query can be made from the user's location, retrieve a list of places, have the user validate the location he or she is at, and then send the ID of this location with a call to statuses/update.
This is the recommended method to use find places that can be attached to statuses/update. Unlike geo/reverse_geocode which provides raw data access, this endpoint can potentially re-order places with regards to the user who is authenticated. This approach is also preferred for interactive place matching with the user.
This method calls http://api.twitter.com/1/geo/search.json

Specified by:: searchPlaces in interface GeoMethodsAsync

Parameters:: query - search query
See Also:: GET geo/search | dev.twitter.com

getSimilarPlaces

public void getSimilarPlaces(GeoLocation location,
                             java.lang.String name,
                             java.lang.String containedWithin,
                             java.lang.String streetAddress)

Description copied from interface: GeoMethodsAsync

Locates places near the given coordinates which are similar in name.
Conceptually you would use this method to get a list of known places to choose from first. Then, if the desired place doesn't exist, make a request to post/geo/place to create a new one.
The token contained in the response is the token needed to be able to create a new place.
This method calls http://api.twitter.com/1/geo/similar_places.json

Specified by:: getSimilarPlaces in interface GeoMethodsAsync

Parameters:: location - The latitude and longitude to search around.; name - The name a place is known as.; containedWithin - optional: the place_id which you would like to restrict the search results to. Setting this value means only places within the given place_id will be found.; streetAddress - optional: This parameter searches for places which have this given street address. There are other well-known, and application specific attributes available. Custom attributes are also permitted. Learn more about Place Attributes.

reverseGeoCode

public void reverseGeoCode(GeoQuery query)

Search for places (cities and neighborhoods) that can be attached to a statuses/update. Given a latitude and a longitude, return a list of all the valid places that can be used as a place_id when updating a status. Conceptually, a query can be made from the user's location, retrieve a list of places, have the user validate the location he or she is at, and then send the ID of this location up with a call to statuses/update.
There are multiple granularities of places that can be returned -- "neighborhoods", "cities", etc. At this time, only United States data is available through this method.
This API call is meant to be an informative call and will deliver generalized results about geography.
This method calls http://api.twitter.com/1/geo/reverse_geocode.json

Specified by:: reverseGeoCode in interface GeoMethodsAsync

Parameters:: query - search query
See Also:: GET geo/reverse_geocode | dev.twitter.com

getGeoDetails

public void getGeoDetails(java.lang.String id)

Find out more details of a place that was returned from the GeoMethodsAsync.reverseGeoCode(twitter4j.GeoQuery) method.
This method calls http://api.twitter.com/1/geo/id/:id.json

Specified by:: getGeoDetails in interface GeoMethodsAsync

Parameters:: id - The ID of the location to query about.
See Also:: GET geo/id/:place_id | dev.twitter.com

createPlace

public void createPlace(java.lang.String name,
                        java.lang.String containedWithin,
                        java.lang.String token,
                        GeoLocation location,
                        java.lang.String streetAddress)

Description copied from interface: GeoMethodsAsync

Creates a new place at the given latitude and longitude.
This method calls http://api.twitter.com/1/geo/place.json

Specified by:: createPlace in interface GeoMethodsAsync

Parameters:: name - The name a place is known as.; containedWithin - The place_id within which the new place can be found. Try and be as close as possible with the containing place. For example, for a room in a building, set the contained_within as the building place_id.; token - The token found in the response from geo/similar_places.; location - The latitude and longitude the place is located at.; streetAddress - optional: This parameter searches for places which have this given street address. There are other well-known, and application specific attributes available. Custom attributes are also permitted. Learn more about Place Attributes.
See Also:: POST geo/place | dev.twitter.com

getTermsOfService

public void getTermsOfService()

Returns Twitter's' Terms of Service.
This method calls http://api.twitter.com/1/legal/tos.json

Specified by:: getTermsOfService in interface LegalResourcesAsync

See Also:: GET legal/tos | dev.twitter.com

getPrivacyPolicy

public void getPrivacyPolicy()

Returns Twitter's Privacy Policy.
This method calls http://api.twitter.com/1/legal/privacy.json

Specified by:: getPrivacyPolicy in interface LegalResourcesAsync

See Also:: GET legal/privacy | dev.twitter.com

getRelatedResults

public void getRelatedResults(long statusId)

Description copied from interface: NewTwitterMethodsAsync

If available, returns an array of replies and mentions related to the specified Tweet. There is no guarantee there will be any replies or mentions in the response. This method is only available to users who have access to #newtwitter.
This method calls http://api.twitter.com/1/related_results/show/:id

Specified by:: getRelatedResults in interface NewTwitterMethodsAsync

Parameters:: statusId - the numerical ID of the status you're trying to retrieve
See Also:: #newtwitter and the API - Twitter API Announcements | Google Group

test

public void test()

Returns the string "ok" in the requested format with a 200 OK HTTP status code.
This method calls http://api.twitter.com/1/help/test

Specified by:: test in interface HelpMethodsAsync

See Also:: GET help/test | dev.twitter.com

shutdown

public void shutdown()

Specified by:: shutdown in interface TwitterBase
Overrides:: shutdown in class TwitterBaseImpl

getDispatcher

private twitter4j.internal.async.Dispatcher getDispatcher()

setOAuthConsumer

public void setOAuthConsumer(java.lang.String consumerKey,
                             java.lang.String consumerSecret)

sets the OAuth consumer key and consumer secret

Specified by:: setOAuthConsumer in interface OAuthSupport
Overrides:: setOAuthConsumer in class TwitterBaseImpl

Parameters:: consumerKey - OAuth consumer key; consumerSecret - OAuth consumer secret

getOAuthRequestToken

public RequestToken getOAuthRequestToken()
                                  throws TwitterException

Retrieves a request token

Specified by:: getOAuthRequestToken in interface OAuthSupport
Overrides:: getOAuthRequestToken in class TwitterBaseImpl

Returns:: generated request token.
Throws:: TwitterException - when Twitter service or network is unavailable
See Also:: OAuth FAQ | dev.twitter.com, OAuth Core 1.0a - 6.1. Obtaining an Unauthorized Request Token

getOAuthRequestToken

public RequestToken getOAuthRequestToken(java.lang.String callbackUrl)
                                  throws TwitterException

Retrieves a request token

Specified by:: getOAuthRequestToken in interface OAuthSupport
Overrides:: getOAuthRequestToken in class TwitterBaseImpl

Parameters:: callbackUrl - callback URL
Returns:: generated request token
Throws:: TwitterException - when Twitter service or network is unavailable
See Also:: OAuth FAQ | dev.twitter.com, OAuth Core 1.0a - 6.1. Obtaining an Unauthorized Request Token

getOAuthAccessToken

public AccessToken getOAuthAccessToken()
                                throws TwitterException

Returns an access token associated with this instance.
If no access token is associated with this instance, this will retrieve a new access token. Basic authenticated instance of this class will try acquiring an AccessToken using xAuth.
In order to get access acquire AccessToken using xAuth, you must apply by sending an email to api@twitter.com all other applications will receive an HTTP 401 error. Web-based applications will not be granted access, except on a temporary basis for when they are converting from basic-authentication support to full OAuth support.
Storage of Twitter usernames and passwords is forbidden. By using xAuth, you are required to store only access tokens and access token secrets. If the access token expires or is expunged by a user, you must ask for their login and password again before exchanging the credentials for an access token. Basic authenticated instance of this class will try acquiring an AccessToken using xAuth.
In order to get access acquire AccessToken using xAuth, you must apply by sending an email to api@twitter.com all other applications will receive an HTTP 401 error. Web-based applications will not be granted access, except on a temporary basis for when they are converting from basic-authentication support to full OAuth support.
Storage of Twitter usernames and passwords is forbidden. By using xAuth, you are required to store only access tokens and access token secrets. If the access token expires or is expunged by a user, you must ask for their login and password again before exchanging the credentials for an access token.

Specified by:: getOAuthAccessToken in interface OAuthSupport
Overrides:: getOAuthAccessToken in class TwitterBaseImpl

Returns:: access token
Throws:: TwitterException - When Twitter service or network is unavailable, when the user has not authorized, or when the client application is not permitted to use xAuth
See Also:: Twitter REST API Method: oauth access_token for xAuth

getOAuthAccessToken

public AccessToken getOAuthAccessToken(java.lang.String oauthVerifier)
                                throws TwitterException

Retrieves an access token.

Specified by:: getOAuthAccessToken in interface OAuthSupport
Overrides:: getOAuthAccessToken in class TwitterBaseImpl

Parameters:: oauthVerifier - OAuth verifier. AKA pin.
Returns:: access token
Throws:: java.lang.IllegalStateException - when AccessToken has already been retrieved or set; TwitterException - when Twitter service or network is unavailable, or the user has not authorized
See Also:: OAuth FAQ | dev.twitter.com - How long does an access token last?, OAuth Core 1.0a - 6.2. Obtaining User Authorization

getOAuthAccessToken

public AccessToken getOAuthAccessToken(RequestToken requestToken)
                                throws TwitterException

Retrieves an access token associated with the supplied request token and sets userId.

Specified by:: getOAuthAccessToken in interface OAuthSupport
Overrides:: getOAuthAccessToken in class TwitterBaseImpl

Parameters:: requestToken - the request token
Returns:: access token associated with the supplied request token.
Throws:: java.lang.IllegalStateException - when AccessToken has already been retrieved or set; TwitterException - when Twitter service or network is unavailable, or the user has not authorized
See Also:: OAuth FAQ | dev.twitter.com - How long does an access token last?, OAuth Core 1.0a - 6.2. Obtaining User Authorization

getOAuthAccessToken

public AccessToken getOAuthAccessToken(RequestToken requestToken,
                                       java.lang.String oauthVerifier)
                                throws TwitterException

Retrieves an access token associated with the supplied request token and sets userId.

Specified by:: getOAuthAccessToken in interface OAuthSupport
Overrides:: getOAuthAccessToken in class TwitterBaseImpl

Parameters:: requestToken - the request token; oauthVerifier - OAuth verifier. AKA pin.
Returns:: access token associated with the supplied request token.
Throws:: java.lang.IllegalStateException - when AccessToken has already been retrieved or set; TwitterException - when Twitter service or network is unavailable, or the user has not authorized
See Also:: OAuth Core 1.0a - 6.2. Obtaining User Authorization

setOAuthAccessToken

public void setOAuthAccessToken(AccessToken accessToken)

Sets the access token

Specified by:: setOAuthAccessToken in interface OAuthSupport
Overrides:: setOAuthAccessToken in class TwitterBaseImpl

Parameters:: accessToken - accessToken

getOAuthAccessToken

public AccessToken getOAuthAccessToken(java.lang.String screenName,
                                       java.lang.String password)
                                throws TwitterException

Retrieves an access token associated with the supplied screen name and password using xAuth.
In order to get access acquire AccessToken using xAuth, you must apply by sending an email to api@twitter.com — all other applications will receive an HTTP 401 error. Web-based applications will not be granted access, except on a temporary basis for when they are converting from basic-authentication support to full OAuth support.
Storage of Twitter usernames and passwords is forbidden. By using xAuth, you are required to store only access tokens and access token secrets. If the access token expires or is expunged by a user, you must ask for their login and password again before exchanging the credentials for an access token.

Specified by:: getOAuthAccessToken in interface OAuthSupport
Overrides:: getOAuthAccessToken in class TwitterBaseImpl

Parameters:: screenName - the screen name; password - the password
Returns:: access token associated with the supplied request token.
Throws:: TwitterException - when Twitter service or network is unavailable, or the user has not authorized
See Also:: OAuth FAQ | dev.twitter.com - How long does an access token last?, Twitter REST API Method: oauth access_token for xAuth

equals

public boolean equals(java.lang.Object o)

Overrides:: equals in class TwitterBaseImpl

hashCode

public int hashCode()

Overrides:: hashCode in class TwitterBaseImpl

toString

public java.lang.String toString()

Overrides:: toString in class TwitterBaseImpl

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

twitter4j Class AsyncTwitterImpl

serialVersionUID

twitter

listeners

dispatcher

AsyncTwitterImpl

AsyncTwitterImpl

addListener

search

getTrends

getCurrentTrends

getCurrentTrends

getDailyTrends

getDailyTrends

getWeeklyTrends

getWeeklyTrends

getPublicTimeline

getHomeTimeline

getHomeTimeline

getFriendsTimeline

getFriendsTimeline

getUserTimeline

getUserTimeline

getUserTimeline

getUserTimeline

getUserTimeline

getUserTimeline

getMentions

getMentions

getRetweetedByMe

getRetweetedByMe

getRetweetedToMe

getRetweetedToMe

getRetweetsOfMe

getRetweetsOfMe

getRetweetedByUser

getRetweetedByUser

getRetweetedToUser

getRetweetedToUser

showStatus

updateStatus

updateStatus

destroyStatus

retweetStatus

getRetweets

getRetweetedBy

getRetweetedByIDs

showUser

showUser

lookupUsers

lookupUsers

searchUsers

getSuggestedUserCategories

getUserSuggestions

getMemberSuggestions

getProfileImage

getAccountTotals

getAccountSettings

getFriendsStatuses

getFriendsStatuses

getFriendsStatuses

getFollowersStatuses

getFollowersStatuses

getFollowersStatuses

createUserList

updateUserList

getUserLists

showUserList

destroyUserList

getUserListStatuses

getUserListStatuses

getUserListMemberships

getUserListSubscriptions

getAllSubscribingUserLists

getAllSubscribingUserLists

getUserListMembers

getUserListMembers

addUserListMember

addUserListMembers

addUserListMembers

twitter4j
Class AsyncTwitterImpl