Package org.kohsuke.github

Class GitHubAbuseLimitHandler

java.lang.Object
org.kohsuke.github.GitHubAbuseLimitHandler
Direct Known Subclasses:
AbuseLimitHandler
public abstract class GitHubAbuseLimitHandler extends Object
Pluggable strategy to determine what to do when the API rate limit is reached.
Author:
Kohsuke Kawaguchi, Liam Newman
See Also:

  • Field Details

    • TOO_MANY_REQUESTS

      public static final int TOO_MANY_REQUESTS
      The HTTP 429 Too Many Requests response status code indicates the user has sent too many requests in a given amount of time ("rate limiting"). A Retry-After header might be included to this response indicating how long to wait before making a new request. Why is this hardcoded here? The HttpURLConnection class is missing the status codes above 415, so the constant needs to be sourced from elsewhere.
      See Also:

  • Constructor Details

    • GitHubAbuseLimitHandler

      public GitHubAbuseLimitHandler()

  • Method Details

    • onError

      public abstract void onError(@Nonnull GitHubConnectorResponse connectorResponse) throws IOException
      Called when the library encounters HTTP error indicating that the API abuse limit is reached.

      Any exception thrown from this method will cause the request to fail, and the caller of github-api will receive an exception. If this method returns normally, another request will be attempted. For that to make sense, the implementation needs to wait for some time.

      Parameters:
      connectorResponse - Response information for this request.
      Throws:
      IOException - on failure
      See Also: