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.E401, TwitterException.E403, TwitterException.E404, TwitterException.E50X, TwitterException.Parsing, TwitterException.RateLimit, TwitterException.Timeout, 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.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.E50X
          A code 50X error (e.g.
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.TwitLongerException
          Exception thrown if something goes wrong with twilonger.com integration for long tweets.
static class TwitterException.Unexplained
          Something has gone wrong.
 
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

setAdditionalInfo

public void setAdditionalInfo(java.lang.String additionalInfo)

getAdditionalInfo

public java.lang.String getAdditionalInfo()