5 // Marek Safar <marek.safar@gmail.com>
7 // Copyright (C) 2011 Xamarin Inc (http://www.xamarin.com)
9 // Permission is hereby granted, free of charge, to any person obtaining
10 // a copy of this software and associated documentation files (the
11 // "Software"), to deal in the Software without restriction, including
12 // without limitation the rights to use, copy, modify, merge, publish,
13 // distribute, sublicense, and/or sell copies of the Software, and to
14 // permit persons to whom the Software is furnished to do so, subject to
15 // the following conditions:
17 // The above copyright notice and this permission notice shall be
18 // included in all copies or substantial portions of the Software.
20 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
21 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
23 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
24 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
25 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
26 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 using System.Threading;
30 using System.Net.Http.Headers;
31 using System.Threading.Tasks;
34 namespace System.Net.Http
36 public class HttpClient : IDisposable
38 static readonly TimeSpan TimeoutDefault = TimeSpan.FromSeconds (100);
41 CancellationTokenSource cancellation_token;
43 readonly HttpMessageHandler handler;
44 HttpRequestHeaders headers;
53 public HttpClient (HttpMessageHandler handler)
55 this.handler = handler ?? new HttpClientHandler ();
56 buffer_size = 0x10000;
57 timeout = TimeoutDefault;
60 public Uri BaseAddress {
69 public HttpRequestHeaders DefaultRequestHeaders {
71 return headers ?? (headers = new HttpRequestHeaders ());
75 public int MaxResponseContentBufferSize {
81 throw new ArgumentOutOfRangeException ();
87 public TimeSpan Timeout {
92 if (value != System.Threading.Timeout.InfiniteTimeSpan && value < TimeSpan.Zero)
93 throw new ArgumentOutOfRangeException ();
99 public void CancelPendingRequests ()
101 if (cancellation_token != null)
102 cancellation_token.Cancel ();
104 cancellation_token = new CancellationTokenSource ();
107 public void Dispose ()
112 protected virtual void Dispose (bool disposing)
114 if (disposing && !disposed) {
117 if (cancellation_token != null)
118 cancellation_token.Dispose ();
122 public Task<HttpResponseMessage> DeleteAsync (string requestUri)
124 return SendAsync (new HttpRequestMessage (HttpMethod.Delete, requestUri));
127 public Task<HttpResponseMessage> DeleteAsync (string requestUri, CancellationToken cancellationToken)
129 return SendAsync (new HttpRequestMessage (HttpMethod.Delete, requestUri), cancellationToken);
132 public Task<HttpResponseMessage> DeleteAsync (Uri requestUri)
134 return SendAsync (new HttpRequestMessage (HttpMethod.Delete, requestUri));
137 public Task<HttpResponseMessage> DeleteAsync (Uri requestUri, CancellationToken cancellationToken)
139 return SendAsync (new HttpRequestMessage (HttpMethod.Delete, requestUri), cancellationToken);
142 public Task<HttpResponseMessage> GetAsync (string requestUri)
144 return SendAsync (new HttpRequestMessage (HttpMethod.Get, requestUri));
147 public Task<HttpResponseMessage> GetAsync (string requestUri, CancellationToken cancellationToken)
149 return SendAsync (new HttpRequestMessage (HttpMethod.Get, requestUri));
152 public Task<HttpResponseMessage> GetAsync (string requestUri, HttpCompletionOption completionOption)
154 return SendAsync (new HttpRequestMessage (HttpMethod.Get, requestUri), completionOption);
157 public Task<HttpResponseMessage> GetAsync (string requestUri, HttpCompletionOption completionOption, CancellationToken cancellationToken)
159 return SendAsync (new HttpRequestMessage (HttpMethod.Get, requestUri), completionOption, cancellationToken);
162 public Task<HttpResponseMessage> GetAsync (Uri requestUri)
164 return SendAsync (new HttpRequestMessage (HttpMethod.Get, requestUri));
167 public Task<HttpResponseMessage> GetAsync (Uri requestUri, CancellationToken cancellationToken)
169 return SendAsync (new HttpRequestMessage (HttpMethod.Get, requestUri), cancellationToken);
172 public Task<HttpResponseMessage> GetAsync (Uri requestUri, HttpCompletionOption completionOption)
174 return SendAsync (new HttpRequestMessage (HttpMethod.Get, requestUri), completionOption);
177 public Task<HttpResponseMessage> GetAsync (Uri requestUri, HttpCompletionOption completionOption, CancellationToken cancellationToken)
179 return SendAsync (new HttpRequestMessage (HttpMethod.Get, requestUri), completionOption, cancellationToken);
182 public Task<HttpResponseMessage> PostAsync (string requestUri, HttpContent content)
184 return SendAsync (new HttpRequestMessage (HttpMethod.Post, requestUri) { Content = content });
187 public Task<HttpResponseMessage> PostAsync (string requestUri, HttpContent content, CancellationToken cancellationToken)
189 return SendAsync (new HttpRequestMessage (HttpMethod.Post, requestUri) { Content = content }, cancellationToken);
192 public Task<HttpResponseMessage> PostAsync (Uri requestUri, HttpContent content)
194 return SendAsync (new HttpRequestMessage (HttpMethod.Post, requestUri) { Content = content });
197 public Task<HttpResponseMessage> PostAsync (Uri requestUri, HttpContent content, CancellationToken cancellationToken)
199 return SendAsync (new HttpRequestMessage (HttpMethod.Post, requestUri) { Content = content }, cancellationToken);
202 public Task<HttpResponseMessage> PutAsync (Uri requestUri, HttpContent content)
204 return SendAsync (new HttpRequestMessage (HttpMethod.Put, requestUri) { Content = content });
207 public Task<HttpResponseMessage> PutAsync (Uri requestUri, HttpContent content, CancellationToken cancellationToken)
209 return SendAsync (new HttpRequestMessage (HttpMethod.Put, requestUri) { Content = content }, cancellationToken);
212 public Task<HttpResponseMessage> PutAsync (string requestUri, HttpContent content)
214 return SendAsync (new HttpRequestMessage (HttpMethod.Put, requestUri) { Content = content });
217 public Task<HttpResponseMessage> PutAsync (string requestUri, HttpContent content, CancellationToken cancellationToken)
219 return SendAsync (new HttpRequestMessage (HttpMethod.Put, requestUri) { Content = content }, cancellationToken);
222 public Task<HttpResponseMessage> SendAsync (HttpRequestMessage request)
224 return SendAsync (request, HttpCompletionOption.ResponseContentRead, CancellationToken.None);
227 public Task<HttpResponseMessage> SendAsync (HttpRequestMessage request, HttpCompletionOption completionOption)
229 return SendAsync (request, completionOption, CancellationToken.None);
232 public Task<HttpResponseMessage> SendAsync (HttpRequestMessage request, CancellationToken cancellationToken)
234 return SendAsync (request, HttpCompletionOption.ResponseContentRead, cancellationToken);
237 public Task<HttpResponseMessage> SendAsync (HttpRequestMessage request, HttpCompletionOption completionOption, CancellationToken cancellationToken)
240 throw new ArgumentNullException ("request");
242 if (request.SetIsUsed ())
243 throw new InvalidOperationException ("Cannot send the same request message multiple times");
245 if (request.RequestUri == null) {
246 if (base_address == null)
247 throw new InvalidOperationException ("The request URI must either be an absolute URI or BaseAddress must be set");
249 request.RequestUri = base_address;
252 if (headers != null) {
253 request.Headers.AddHeaders (headers);
256 return SendAsyncWorker (request, cancellationToken);
259 async Task<HttpResponseMessage> SendAsyncWorker (HttpRequestMessage request, CancellationToken cancellationToken)
262 if (cancellation_token == null)
263 cancellation_token = new CancellationTokenSource ();
265 using (var cts = CancellationTokenSource.CreateLinkedTokenSource (cancellation_token.Token, cancellationToken)) {
266 cts.CancelAfter (timeout);
268 var task = handler.SendAsync (request, cts.Token);
270 throw new InvalidOperationException ("Handler failed to return a value");
272 var response = await task.ConfigureAwait (false);
273 if (response == null)
274 throw new InvalidOperationException ("Handler failed to return a response");
279 cancellation_token.Dispose ();
280 cancellation_token = null;
284 public async Task<byte[]> GetByteArrayAsync (string requestUri)
286 var resp = await GetAsync (requestUri, HttpCompletionOption.ResponseContentRead).ConfigureAwait (false);
287 return await resp.Content.ReadAsByteArrayAsync ().ConfigureAwait (false);
290 public async Task<byte[]> GetByteArrayAsync (Uri requestUri)
292 var resp = await GetAsync (requestUri, HttpCompletionOption.ResponseContentRead).ConfigureAwait (false);
293 return await resp.Content.ReadAsByteArrayAsync ().ConfigureAwait (false);
296 public async Task<Stream> GetStreamAsync (string requestUri)
298 var resp = await GetAsync (requestUri, HttpCompletionOption.ResponseContentRead).ConfigureAwait (false);
299 return await resp.Content.ReadAsStreamAsync ().ConfigureAwait (false);
302 public async Task<Stream> GetStreamAsync (Uri requestUri)
304 var resp = await GetAsync (requestUri, HttpCompletionOption.ResponseContentRead).ConfigureAwait (false);
305 return await resp.Content.ReadAsStreamAsync ().ConfigureAwait (false);
308 public async Task<string> GetStringAsync (string requestUri)
310 var resp = await GetAsync (requestUri, HttpCompletionOption.ResponseContentRead).ConfigureAwait (false);
311 return await resp.Content.ReadAsStringAsync ().ConfigureAwait (false);
314 public async Task<string> GetStringAsync (Uri requestUri)
316 var resp = await GetAsync (requestUri, HttpCompletionOption.ResponseContentRead).ConfigureAwait (false);
317 return await resp.Content.ReadAsStringAsync ().ConfigureAwait (false);