winterwell.jtwitter
Class TwitterException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by 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)