From 3d645cf80854ebad53cd0ae85995f36a5a4d46ea Mon Sep 17 00:00:00 2001
From: Arjen Poutsma <apoutsma@gopivotal.com>
Date: Wed, 28 Aug 2013 14:09:07 +0200
Subject: [PATCH] Added documentation on DecompressingHttpClient

Added documentation on the support for gzip encoding using the
DecompressingHttpClient in Apache HttpComponents.

Issue: SPR-7874
---
 src/reference/docbook/remoting.xml | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/src/reference/docbook/remoting.xml b/src/reference/docbook/remoting.xml
index b65cd7b59a..1af73d50ec 100644
--- a/src/reference/docbook/remoting.xml
+++ b/src/reference/docbook/remoting.xml
@@ -1125,7 +1125,7 @@ String result =
       <classname>HttpClient</classname> directly rewritten to use the
       <classname>RestTemplate</classname> is shown below</para>
 
-      <programlisting>uri = "http://example.com/hotels/{id}/bookings";
+        <programlisting language="java">uri = "http://example.com/hotels/{id}/bookings";
 
 RestTemplate template = new RestTemplate();
 
@@ -1134,6 +1134,20 @@ Booking booking = // create booking object
 URI location = template.postForLocation(uri, booking, "1");
 </programlisting>
 
+      <para>To use Apache HttpComponents instead of the native <literal>java.net</literal>
+      functionality, construct the <classname>RestTemplate</classname> as follows:</para>
+
+      <programlisting language="java">RestTemplate template = new RestTemplate(new HttpComponentsClientHttpRequestFactory());</programlisting>
+
+      <tip><para>Apache HttpClient supports gzip encoding via the
+      <classname>DecompressingHttpClient</classname>. To use it, construct a
+      <classname>HttpComponentsClientHttpRequestFactory</classname> like so:</para>
+
+      <programlisting language="java">HttpClient httpClient = new DecompressingHttpClient(new DefaultHttpClient());
+ClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
+RestTemplate template = new RestTemplate(requestFactory);</programlisting>
+      </tip>
+
       <para>The general callback interface is
       <interfacename>RequestCallback</interfacename> and is called when the
       execute method is invoked.</para>
-- 
GitLab