Deprecated API

Contents

• Deprecated Enums
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Enums

Enum and Description
winterwell.jtwitter.Twitter.KRequestType Replaced in 1.1 with a more flexible family of resources. Kept here for backwards compatibility only. Will be removed: June 2013!

Deprecated Fields

Field and Description
winterwell.jtwitter.OAuthSignpostClient.JTWITTER_OAUTH_KEY Please register an app with Twitter and use your own key! This consumer key (and secret) allows you to get up and running fast. However you are strongly advised to register your own app at http://dev.twitter.com Then use your own key and secret. This will be less confusing for users, and it protects you incase the JTwitter key gets changed.
winterwell.jtwitter.TwitterException.SuspendedUser.suspendedCaller Use TwitterException.SuspendedProfile instead If true, it was the calling user (ie you) who is suspended. If false, it was *probably* the target user who is suspended.
winterwell.jtwitter.Twitter.WORRIED_ABOUT_TWITTER Not used at present Set to true to perform extra error-handling & correction.

Deprecated Methods

Method and Description
winterwell.jtwitter.OAuthSignpostClient.authorizeDesktop()
winterwell.jtwitter.Twitter.befriend(String) Use Twitter.follow(String) instead, which is equivalent.
winterwell.jtwitter.Twitter.breakFriendship(String) Please use Twitter.stopFollowing(String) instead.
winterwell.jtwitter.Twitter.bulkShow(List<String>) Use Twitter_Users#show(List) instead
winterwell.jtwitter.Twitter.bulkShowById(List<? extends Number>) Use #showById(List) instead
winterwell.jtwitter.Twitter.destroyStatus(Status) in favour of Twitter.destroy(ITweet). This method will be removed by the end of 2010.
winterwell.jtwitter.Twitter.follow(String)
winterwell.jtwitter.Twitter.follow(User)
winterwell.jtwitter.Twitter_Account.getAccessLevel() It seems Twitter have stopped sending this info! Expect null from this method.
winterwell.jtwitter.InternalUtils.getAPIUsageStats()
winterwell.jtwitter.ecosystem.TwitterCounter.getClient() Not many use-cases.
winterwell.jtwitter.Twitter.getFollowerIDs()
winterwell.jtwitter.Twitter.getFollowerIDs(String)
winterwell.jtwitter.Twitter_Users.getFollowers() Twitter advise using Twitter_Users.getFollowerIDs() and Twitter_Users.show(Number)
winterwell.jtwitter.Twitter.getFollowers()
winterwell.jtwitter.Twitter_Users.getFollowers(String) Only available in v1.0 API (due to switch off soon). Returns the (latest 100) given user's followers, each with current status inline. Occasionally contains duplicates.
winterwell.jtwitter.Twitter.getFollowers(String)
winterwell.jtwitter.Twitter.getFriendIDs()
winterwell.jtwitter.Twitter.getFriendIDs(String)
winterwell.jtwitter.Twitter_Users.getFriends() Twitter advise you to use Twitter_Users.getFriendIDs() with Twitter_Users#showById(List) instead.
winterwell.jtwitter.Twitter.getFriends()
winterwell.jtwitter.Twitter_Users.getFriends(String) Only available in v1.0 API (due to switch off soon). Returns the (latest 100) given user's friends (people *they* follow), each with current status inline. Occasionally contains duplicates.
winterwell.jtwitter.Twitter.getFriends(String)
winterwell.jtwitter.Twitter.getFriendsTimeline() Replaced by Twitter.getHomeTimeline()
winterwell.jtwitter.Twitter.getLongStatus(Status) Use TwitLonger
winterwell.jtwitter.Twitter.getRateLimit(Twitter.KRequestType) Use getHttpClient().getRateLimits() What is the current rate limit status? Do we need to throttle back our usage? This is the cached info from the last call of that type. Note: The RateLimit object is created using cached info from a previous Twitter call. So this method is quick (it doesn't require a fresh call to Twitter), but the RateLimit object isn't available until after you make a call of the right type to Twitter. Status: Heading towards stable, but still a bit experimental.
winterwell.jtwitter.Twitter.IHttpClient.getRateLimit(Twitter.KRequestType)
winterwell.jtwitter.Twitter.getRateLimitStatus() Not in v1.1 How many normal rate limit calls do you have left? This calls Twitter, which makes it slower than Twitter.getRateLimit(KRequestType) but it's up-to-date and safe against threads and other-programs using the same allowance. This may update getRateLimit(KRequestType) for NORMAL requests, but sadly it doesn't fetch rate-limit info on other request types.
winterwell.jtwitter.Twitter.getReplies() Use #getMentions() for preference. This method will be removed June 2013.
winterwell.jtwitter.Twitter.getRetweetsByMe() Removed in api v1.1. Simulated with other methods. Will be removed June 2013
winterwell.jtwitter.Twitter.getUser(long)
winterwell.jtwitter.Twitter.getUser(String)
winterwell.jtwitter.Twitter.getUserTimelineWithRetweets(String) Use Twitter.setIncludeRTs(boolean) instead to control retweet behaviour. Returns the most recent statuses posted by the given user. Unlike Twitter.getUserTimeline(String), this includes new-style retweets. This will return 20 by default, though Twitter.setMaxResults(int) can be used to fetch multiple pages. There is a cap of 3200 tweets - this is the farthest back you can go down a user timeline! This method will authenticate if it can (i.e. if the Twitter object has a username and password). Authentication is needed to see the posts of a private user.
winterwell.jtwitter.Twitter.isFollower(String)
winterwell.jtwitter.Twitter.isFollower(String, String)
winterwell.jtwitter.Twitter.isFollowing(String)
winterwell.jtwitter.Twitter.isFollowing(User)
winterwell.jtwitter.Twitter.isRateLimited(Twitter.KRequestType, int) Are we rate-limited, based on cached info from previous requests?
winterwell.jtwitter.Twitter.isTwitlongerSetup() Use TwitLonger Keeping for backwards compatibility until Q2 2013
winterwell.jtwitter.Twitter_Users.leaveNotifications(String) v1.0 method, now simulated
winterwell.jtwitter.Twitter.searchUsers(String)
winterwell.jtwitter.TwitterStream.setLocation(List<double[]>)
winterwell.jtwitter.AStream.setPreviousCount(int) Twitter need to fix this :(
winterwell.jtwitter.Twitter.setSinceDate(Date)
winterwell.jtwitter.InternalUtils.setTrackAPIUsage(boolean)
winterwell.jtwitter.Twitter.setUntilDate(Date)
winterwell.jtwitter.Twitter.setupTwitlonger(String, String) User TwitLonger Keeping for backwards compatibility until Q2 2013 Set this to allow the use of twitlonger via #updateLongStatus(String, long). To get an api-key for your app, contact twitlonger as described here: http://www.twitlonger.com/api This method will be removed June 2013
winterwell.jtwitter.Twitter.show(Number)
winterwell.jtwitter.Twitter.show(String)
winterwell.jtwitter.Twitter.stopFollowing(String)
winterwell.jtwitter.Twitter.stopFollowing(User)
winterwell.jtwitter.InternalUtils.stripUrls(String) Not used anymore
winterwell.jtwitter.Twitter.updateLongStatus(String, Number) Use TwitLonger Keeping for backwards compatibility until Q2 2013 Use twitlonger.com to post a lengthy tweet. See twitlonger.com for more details on their service. Note: You need to have called Twitter.setupTwitlonger(String, String) before calling this.

Deprecated Constructors

Constructor and Description
winterwell.jtwitter.Status(User, String, Number, Date)
winterwell.jtwitter.Twitter() ALL twitter.com endpoints now require authentication. This method is kept for use with other services (e.g. identi.ca). Create a Twitter client without specifying a user.
winterwell.jtwitter.Twitter(String, String)
winterwell.jtwitter.TwitterList(String, String, Twitter) Due to the potential for confusion with TwitterList.TwitterList(String, Twitter, boolean, String) Use TwitterList.get(String, String, Twitter) instead.