mcs/class/System.Net.Http/System.Net.Http.Headers/WarningHeaderValue.cs

   1 //
   2 // WarningHeaderValue.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.Globalization;
  30 using System.Collections.Generic;
  31
  32 namespace System.Net.Http.Headers
  33 {
  34         public class WarningHeaderValue : ICloneable
  35         {
  36                 public WarningHeaderValue (int code, string agent, string text)
  37                 {
  38                         if (!IsCodeValid (code))
  39                                 throw new ArgumentOutOfRangeException ("code");
  40
  41                         Parser.Uri.Check (agent);
  42                         Parser.Token.CheckQuotedString (text);
  43
  44                         Code = code;
  45                         Agent = agent;
  46                         Text = text;
  47                 }
  48
  49                 public WarningHeaderValue (int code, string agent, string text, DateTimeOffset date)
  50                         : this (code, agent, text)
  51                 {
  52                         Date = date;
  53                 }
  54
  55                 private WarningHeaderValue ()
  56                 {
  57                 }
  58
  59                 public string Agent { get; private set; }
  60                 public int Code { get; private set; }
  61                 public DateTimeOffset? Date { get; private set; }
  62                 public string Text { get; private set; }
  63
  64                 static bool IsCodeValid (int code)
  65                 {
  66                         return code >= 0 && code < 1000;
  67                 }
  68
  69                 object ICloneable.Clone ()
  70                 {
  71                         return MemberwiseClone ();
  72                 }
  73
  74                 public override bool Equals (object obj)
  75                 {
  76                         var source = obj as WarningHeaderValue;
  77                         if (source == null)
  78                                 return false;
  79
  80                         return Code == source.Code &&
  81                                 string.Equals (source.Agent, Agent, StringComparison.OrdinalIgnoreCase) &&
  82                                 Text == source.Text &&
  83                                 Date == source.Date;
  84                 }
  85
  86                 public override int GetHashCode ()
  87                 {
  88                         int hc = Code.GetHashCode ();
  89                         hc ^= Agent.ToLowerInvariant ().GetHashCode ();
  90                         hc ^= Text.GetHashCode ();
  91                         hc ^= Date.GetHashCode ();
  92
  93                         return hc;
  94                 }
  95
  96                 public static WarningHeaderValue Parse (string input)
  97                 {
  98                         WarningHeaderValue value;
  99                         if (TryParse (input, out value))
 100                                 return value;
 101
 102                         throw new FormatException (input);
 103                 }
 104
 105                 public static bool TryParse (string input, out WarningHeaderValue parsedValue)
 106                 {
 107                         var lexer = new Lexer (input);
 108                         Token token;
 109                         if (TryParseElement (lexer, out parsedValue, out token) && token == Token.Type.End)
 110                                 return true;
 111
 112                         parsedValue = null;
 113                         return false;
 114                 }
 115
 116                 internal static bool TryParse (string input, int minimalCount, out List<WarningHeaderValue> result)
 117                 {
 118                         return CollectionParser.TryParse (input, minimalCount, TryParseElement, out result);
 119                 }
 120
 121                 static bool TryParseElement (Lexer lexer, out WarningHeaderValue parsedValue, out Token t)
 122                 {
 123                         parsedValue = null;
 124
 125                         t = lexer.Scan ();
 126
 127                         if (t != Token.Type.Token)
 128                                 return false;
 129
 130                         int code;
 131                         if (!lexer.TryGetNumericValue (t, out code) || !IsCodeValid (code))
 132                                 return false;
 133
 134                         t = lexer.Scan ();
 135                         if (t != Token.Type.Token)
 136                                 return false;
 137
 138                         var next = t;
 139                         if (lexer.PeekChar () == ':') {
 140                                 lexer.EatChar ();
 141
 142                                 next = lexer.Scan ();
 143                                 if (next != Token.Type.Token)
 144                                         return false;
 145                         }
 146
 147                         var value = new WarningHeaderValue ();
 148                         value.Code = code;
 149                         value.Agent = lexer.GetStringValue (t, next);
 150
 151                         t = lexer.Scan ();
 152                         if (t != Token.Type.QuotedString)
 153                                 return false;
 154
 155                         value.Text = lexer.GetStringValue (t);
 156
 157                         t = lexer.Scan ();
 158                         if (t == Token.Type.QuotedString) {
 159                                 DateTimeOffset date;
 160                                 if (!lexer.TryGetDateValue (t, out date))
 161                                         return false;
 162
 163                                 value.Date = date;
 164                                 t = lexer.Scan ();
 165                         }
 166
 167                         parsedValue = value;
 168                         return true;
 169                 }
 170
 171                 public override string ToString ()
 172                 {
 173                         string s = Code.ToString ("000") + " " + Agent + " " + Text;
 174                         if (Date.HasValue)
 175                                 s = s + " \"" + Date.Value.ToString ("r", CultureInfo.InvariantCulture) + "\"";
 176
 177                         return s;
 178                 }
 179         }
 180 }