mcs/class/System.Net.Http/System.Net.Http/HttpResponseMessage.cs

   1 //
   2 // HttpResponseMessage.cs
   3 //
   4 // Authors:
   5 //      Marek Safar  <marek.safar@gmail.com>
   6 //
   7 // Copyright (C) 2011 Xamarin Inc (http://www.xamarin.com)
   8 //
   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:
  16 //
  17 // The above copyright notice and this permission notice shall be
  18 // included in all copies or substantial portions of the Software.
  19 //
  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.
  27 //
  28
  29 using System.Net.Http.Headers;
  30
  31 namespace System.Net.Http
  32 {
  33         public class HttpResponseMessage : IDisposable
  34         {
  35                 HttpResponseHeaders headers;
  36                 string reasonPhrase;
  37                 HttpStatusCode statusCode;
  38                 Version version;
  39                 bool disposed;
  40
  41                 public HttpResponseMessage ()
  42                         : this (HttpStatusCode.OK)
  43                 {
  44                 }
  45
  46                 public HttpResponseMessage (HttpStatusCode statusCode)
  47                 {
  48                         StatusCode = statusCode;
  49                 }
  50
  51                 public HttpContent Content { get; set; }
  52
  53                 public HttpResponseHeaders Headers {
  54                         get {
  55                                 return headers ?? (headers = new HttpResponseHeaders ());
  56                         }
  57                 }
  58
  59                 public bool IsSuccessStatusCode {
  60                         get {
  61                                 // Successful codes are 2xx
  62                                 return statusCode >= HttpStatusCode.OK && statusCode < HttpStatusCode.MultipleChoices;
  63                         }
  64                 }
  65
  66                 public string ReasonPhrase {
  67                         get {
  68                                 return reasonPhrase ?? HttpListenerResponse.GetStatusDescription ((int) statusCode);
  69                         }
  70                         set {
  71                                 reasonPhrase = value;
  72                         }
  73                 }
  74
  75                 public HttpRequestMessage RequestMessage { get; set; }
  76
  77                 public HttpStatusCode StatusCode {
  78                         get {
  79                                 return statusCode;
  80                         }
  81                         set {
  82                                 if (value < 0)
  83                                         throw new ArgumentOutOfRangeException ();
  84
  85                                 statusCode = value;
  86                         }
  87                 }
  88
  89                 public Version Version {
  90                         get {
  91                                 return version ?? HttpVersion.Version11;
  92                         }
  93                         set {
  94                                 if (value == null)
  95                                         throw new ArgumentNullException ("Version");
  96
  97                                 version = value;
  98                         }
  99                 }
 100
 101                 public void Dispose ()
 102                 {
 103                         Dispose (true);
 104                 }
 105
 106                 protected virtual void Dispose (bool disposing)
 107                 {
 108                         if (disposing && !disposed) {
 109                                 disposed = true;
 110
 111                                 if (Content != null)
 112                                         Content.Dispose ();
 113                         }
 114                 }
 115
 116                 public HttpResponseMessage EnsureSuccessStatusCode ()
 117                 {
 118                         if (IsSuccessStatusCode)
 119                                 return this;
 120
 121                         throw new HttpRequestException (string.Format ("{0} ({1})", (int) statusCode, ReasonPhrase));
 122                 }
 123         }
 124 }