diff --git a/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java b/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java new file mode 100644 index 000000000..a78e5a76d --- /dev/null +++ b/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java @@ -0,0 +1,64 @@ +/* + * ==================================================================== + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + * ==================================================================== + * + * This software consists of voluntary contributions made by many + * individuals on behalf of the Apache Software Foundation. For more + * information on the Apache Software Foundation, please see + * . + * + */ + +package org.apache.hc.client5.http.examples; + +import org.apache.hc.client5.http.classic.methods.HttpGet; +import org.apache.hc.client5.http.impl.classic.CloseableHttpClient; +import org.apache.hc.client5.http.impl.classic.HttpClients; +import org.apache.hc.core5.http.ClassicHttpResponse; +import org.apache.hc.core5.http.HttpHost; +import org.apache.hc.core5.http.io.entity.EntityUtils; +import org.apache.hc.core5.http.message.StatusLine; + +/** + * This example demonstrates how to ensure the release of the underlying HTTP connection back to + * the connection manager in case of a manual processing of HTTP responses. + */ +public class ClientConnectionRelease { + + public static void main(final String[] args) throws Exception { + try (final CloseableHttpClient httpclient = HttpClients.createDefault()) { + final HttpHost target = new HttpHost("http", "httpbin.org"); + final HttpGet httpget = new HttpGet("/get"); + + System.out.println("Executing request " + httpget.getMethod() + " " + httpget.getUri()); + + // Make sure the response is always closed at the end of the message exchange + try (ClassicHttpResponse response = httpclient.executeOpen(target, httpget, null)) { + System.out.println("----------------------------------------"); + System.out.println(httpget + "->" + new StatusLine(response)); + // Make sure the response content entity has been fully consumed + // in order to ensure the underlying connection can be re-used for + // subsequent requests + EntityUtils.consume(response.getEntity()); + } + } + } + +} +