1. Overview

This quick tutorial shows how to cancel an HTTP Request with the Apache HttpClient 4.

This is especially useful for potentially long-running requests or large download files that would otherwise unnecessarily consume bandwidth and connections.

If you want to dig deeper and learn other cool things you can do with the HttpClient – head on over to the main HttpClient tutorial.

2. Abort a GET Request

To abort an ongoing request, the client can simply use:


This will make sure that the client doesn't have to consume the entire body of the request to release the connection:

public void whenRequestIsCanceled_thenCorrect() 
  throws ClientProtocolException, IOException {
    HttpClient instance = HttpClients.custom().build();
    HttpGet request = new HttpGet(SAMPLE_URL);
    HttpResponse response = instance.execute(request);

    try {
    } finally {

3. Conclusion

This article illustrated how to abort an ongoing request with the HTTP client. Another option to stop long-running requests is to make sure that they will time out.

The implementation of all these examples and code snippets can be found in my GitHub project – this is an Eclipse-based project, so it should be easy to import and run as it is.