{"id":843,"date":"2013-07-17T17:50:00","date_gmt":"2013-07-17T17:50:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/dotnet\/2013\/07\/17\/httpclient-2-2-is-now-stable\/"},"modified":"2021-10-04T12:28:08","modified_gmt":"2021-10-04T19:28:08","slug":"httpclient-2-2-is-now-stable","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/httpclient-2-2-is-now-stable\/","title":{"rendered":"HttpClient 2.2 is now stable"},"content":{"rendered":"

As promised<\/a>, we’ve just pushed the RTM version of HttpClient 2.2 to NuGet<\/a>. This version adds support for automatic decompression. As announced here<\/a>, this doesn’t require a dependency on Microsoft.Bcl.Compression<\/a>. This allowed us to support automatic decompression on more platforms and without forcing your projects to change the CPU architecture.<\/p>\n

It’s worth noting that we didn’t make any changes since the RC version we published a week ago<\/a> (despite changing the version).<\/p>\n

How to use automatic decompression<\/h2>\n

(For the sake of keeping this post self-contained I’ve copied the content from the post that introduced automatic decompression<\/a>)<\/em><\/p>\n

First, automatic decompression is not enabled by default for HttpClient<\/strong>. To use it, you need to set the AutomaticDecompression property<\/a> on HttpClientHandler to GZip or Deflate<\/a>. This API follows the optional feature pattern; meaning it exposes an API that indicates whether a particular feature is supported. Automatic decompression support is indicated with the SupportsAutomaticDecompression property<\/a>.<\/p>\n

If an implementation of HttpClient<\/strong> doesn’t support automatic decompression, it returns false<\/strong> from the SupportsAutomaticDecompression<\/strong> property and throws a NotSupportedException<\/strong> from the setter and getter for the AutomaticDecompression property.<\/p>\n

With this pattern in mind, using automatic decompression looks like this:<\/p>\n

var handler = new HttpClientHandler();\nif (handler.SupportsAutomaticDecompression)\n{\n    handler.AutomaticDecompression = DecompressionMethods.GZip |\n                                     DecompressionMethods.Deflate;\n}\nvar httpClient = new HttpClient(handler);\nvar str = await httpClient.GetStringAsync(\"http:\/\/en.wikipedia.org\/wiki\/Gzip\");\n<\/pre>\n
The request then provides the additional Accept-Encoding header:<\/p>\n
GET http:\/\/en.wikipedia.org\/wiki\/Gzip HTTP\/1.1\nHost: en.wikipedia.org\nAccept-Encoding: gzip, deflate<\/span>\nConnection: Keep-Alive\n<\/pre>\n
Servers that choose to support it will respond and indicate the compression algorithm they used. In this example, the server compressedt he body using gzip:<\/p>\n
HTTP\/1.1 200 OK\nServer: nginx\/1.1.19\nDate: Wed, 13 Mar 2013 14:04:24 GMT\nContent-Type: text\/html; charset=UTF-8\nContent-Length: 17765\nConnection: keep-alive\nX-Content-Type-Options: nosniff\nContent-Language: en\nLast-Modified: Tue, 05 Mar 2013 03:38:51 GMT\nContent-Encoding: gzip<\/span>\nExpires: Thu, 01 Jan 1970 00:00:00 GMT\nCache-Control: private, s-maxage=0, max-age=0, must-revalidate\nVary: Accept-Encoding,Cookie\nAge: 179\n<\/pre>\n
The response stream<\/a> that HttpClient<\/strong> returns to you will automatically decompress the result using the appropriate algorithm. On my machine I got the following results:<\/p>\n
\"Content-Length<\/p>\n
This yields to a reduction by 77%<\/strong>. Needless to say, the actual results depend on the request and how well it compresses. So your results will naturally vary.<\/p>\n
Summary<\/h2>\n
We’ve just shipped the RTM version of HttpClient 2.2, which updates HttpClient<\/a> by adding support for automatic decompression. It’s supported on .NET 4.0, Windows Phone 7.5, and partially supported on Silverlight (see this blog post for details<\/a>).<\/p>\n
Thanks for all the feedback we’ve received. We’d love to hear how you like the new version!<\/p>\n","protected":false},"excerpt":{"rendered":"
As promised, we’ve just pushed the RTM version of HttpClient 2.2 to NuGet. This version adds support for automatic decompression. As announced here, this doesn’t require a dependency on Microsoft.Bcl.Compression. This allowed us to support automatic decompression on more platforms and without forcing your projects to change the CPU architecture. It’s worth noting that we […]<\/p>\n","protected":false},"author":335,"featured_media":58792,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[685],"tags":[30,43,104,110],"class_list":["post-843","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet","tag-announcement","tag-bcl","tag-nuget","tag-portable-class-libraries"],"acf":[],"blog_post_summary":"
As promised, we’ve just pushed the RTM version of HttpClient 2.2 to NuGet. This version adds support for automatic decompression. As announced here, this doesn’t require a dependency on Microsoft.Bcl.Compression. This allowed us to support automatic decompression on more platforms and without forcing your projects to change the CPU architecture. It’s worth noting that we […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/843","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/335"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=843"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/843\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/58792"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=843"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=843"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=843"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}