winterwell.jtwitter
Class TwitterException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              winterwell.jtwitter.TwitterException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

TwitterException.E40X, TwitterException.E50X, TwitterException.IO, TwitterException.Parsing, TwitterException.RateLimit, TwitterException.TwitLongerException, TwitterException.Unexplained

public class TwitterException
extends java.lang.RuntimeException

A runtime exception for when Twitter requests don't work. All Twitter methods can throw this.

This contains several subclasses which should be thrown to mark different problems. Error handling is particularly important as Twitter tends to be a bit flaky.

I believe unchecked exceptions are preferable to checked ones, because they avoid the problems caused by swallowing exceptions. But if you don't like runtime exceptions, just edit this class.

See Also:

Serialized Form

Nested Class Summary

static class	TwitterException.AccessLevel Subclass of 403 thrown when you breach the access level of the app / oauth-token.
static class	TwitterException.BadParameter Exception thrown when Twitter doesn't like a parameter.
static class	TwitterException.E401 An unauthorised exception.
static class	TwitterException.E403 A Forbidden exception.
static class	TwitterException.E404 Indicates a 404: resource does not exist error from Twitter.
static class	TwitterException.E406 Not Acceptable.
static class	TwitterException.E40X A user-error.
static class	TwitterException.E413 Too Long.
static class	TwitterException.E416 Range Unacceptable.
static class	TwitterException.E50X A code 50X error (e.g.
static class	TwitterException.FollowerLimit Subclass of 403 thrown when you follow too many people.
static class	TwitterException.IO An IO exception, eg.
static class	TwitterException.Parsing Problems reading the JSON returned by Twitter.
static class	TwitterException.RateLimit Indicates a rate limit error (i.e.
static class	TwitterException.Repetition Subclass of 403 thrown when you try to do something twice, like post the same status.
static class	TwitterException.SuspendedUser Exception thrown when trying to query a suspended account.
static class	TwitterException.Timeout A timeout exception - probably caused by Twitter being overloaded.
static class	TwitterException.TooManyLogins A code 420 error indicates that the account has been logging in too often.
static class	TwitterException.TooRecent Thrown if you poll too frequently.
static class	TwitterException.TwitLongerException Exception thrown if something goes wrong with twilonger.com integration for long tweets.
static class	TwitterException.Unexplained Something has gone wrong.
static class	TwitterException.UpdateToOAuth Legacy exception thrown when trying to use basic auth instead of oauth.

Constructor Summary

TwitterException(java.lang.String string)

TwitterException(java.lang.String string, java.lang.String additionalInfo)

Method Summary

java.lang.String	getAdditionalInfo()
void	setAdditionalInfo(java.lang.String additionalInfo)

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

TwitterException

public TwitterException(java.lang.String string)

Parameters:

string -

TwitterException

public TwitterException(java.lang.String string,
                        java.lang.String additionalInfo)

Method Detail

getAdditionalInfo

public java.lang.String getAdditionalInfo()

setAdditionalInfo

public void setAdditionalInfo(java.lang.String additionalInfo)