Invoked when an IOException is thrown during an HTTP request.
There is a simple rule that one must follow: If you modify the request object or modify its
execute interceptors in a way that should resolve the error, you must return true to
issue a retry.
whether there will actually be a retry if this handler return true
. Some handlers may want to have an effect only when there will actually be a retry after
they handle their event (e.g. a handler that implements backoff policy).
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Interface HttpIOExceptionHandler (2.0.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.0.0 (latest)](/java/docs/reference/google-http-client/latest/com.google.api.client.http.HttpIOExceptionHandler)\n- [1.47.1](/java/docs/reference/google-http-client/1.47.1/com.google.api.client.http.HttpIOExceptionHandler)\n- [1.46.3](/java/docs/reference/google-http-client/1.46.3/com.google.api.client.http.HttpIOExceptionHandler)\n- [1.45.3](/java/docs/reference/google-http-client/1.45.3/com.google.api.client.http.HttpIOExceptionHandler)\n- [1.44.2](/java/docs/reference/google-http-client/1.44.2/com.google.api.client.http.HttpIOExceptionHandler)\n- [1.43.2](/java/docs/reference/google-http-client/1.43.2/com.google.api.client.http.HttpIOExceptionHandler)\n- [1.42.3](/java/docs/reference/google-http-client/1.42.3/com.google.api.client.http.HttpIOExceptionHandler)\n- [1.41.8](/java/docs/reference/google-http-client/1.41.8/com.google.api.client.http.HttpIOExceptionHandler) \n\n public interface HttpIOExceptionHandler\n\n[Beta](/java/docs/reference/google-http-client/latest/com.google.api.client.util.Beta) \n\nHandles an [IOException](https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html) in an HTTP request.\n\nFor example, this might be used to handle an [IOException](https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html) with [BackOff](/java/docs/reference/google-http-client/latest/com.google.api.client.util.BackOff) policy.\n\npublic static class HttpBackOffIOExceptionHandler implements HttpIOExceptionHandler {\nBackOff backOff;\nSleeper sleeper;\npublic boolean handle(HttpRequest request, boolean supportsRetry) throws IOException {\nif (!supportsRetry) {\nreturn false;\n}\ntry {\nreturn BackOffUtils.next(sleeper, backOff);\n} catch (InterruptedException exception) {\nThread.currentThread().interrupt();\nreturn false;\n}\n}\n}\n\nMethods\n-------\n\n### handleIOException(HttpRequest request, boolean supportsRetry)\n\n public abstract boolean handleIOException(HttpRequest request, boolean supportsRetry)\n\nInvoked when an [IOException](https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html) is thrown during an HTTP request.\n\nThere is a simple rule that one must follow: If you modify the request object or modify its\nexecute interceptors in a way that should resolve the error, you must return `true` to\nissue a retry."]]