mcs/class/System/System/UriBuilder.cs

   1 //\r
   2 // System.UriBuilder\r
   3 //\r
   4 // Author:\r
   5 //   Lawrence Pit (loz@cable.a2000.nl)\r
   6 //\r
   7
   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 \r
  29 using System;\r
  30 using System.Collections;\r
  31 using System.Runtime.Serialization;\r
  32 using System.Text;\r
  33 \r
  34 // See RFC 2396 for more info on URI's.\r
  35 \r
  36 namespace System \r
  37 {\r
  38         public class UriBuilder\r
  39         {\r
  40                 private string scheme;\r
  41                 private string host;\r
  42                 private int port;\r
  43                 private string path;\r
  44                 private string query;\r
  45                 private string fragment;\r
  46                 private string username;\r
  47                 private string password;\r
  48                 \r
  49                 private Uri uri;\r
  50                 private bool modified;\r
  51                 \r
  52                 \r
  53                 // Constructors         \r
  54                 \r
  55                 public UriBuilder () : this (Uri.UriSchemeHttp, "loopback")\r
  56                 {               \r
  57                 }\r
  58 \r
  59                 public UriBuilder (string uri) : this (new Uri (uri))\r
  60                 {\r
  61                 }\r
  62                 \r
  63                 public UriBuilder (Uri uri)\r
  64                 {\r
  65                         scheme = uri.Scheme;\r
  66                         host = uri.Host;\r
  67                         port = uri.Port;\r
  68                         path = uri.AbsolutePath;\r
  69                         query = uri.Query;\r
  70                         fragment = uri.Fragment;\r
  71                         username = uri.UserInfo;\r
  72                         int pos = username.IndexOf (':');\r
  73                         if (pos != -1) {\r
  74                                 password = username.Substring (pos + 1);\r
  75                                 username = username.Substring (0, pos);\r
  76                         }\r
  77                         modified = true;\r
  78                 }\r
  79                 \r
  80                 public UriBuilder (string schemeName, string hostName) \r
  81                 {\r
  82                         Scheme = schemeName;\r
  83                         Host = hostName;\r
  84                         port = -1;\r
  85                         Path = String.Empty;   // dependent on scheme it may set path to "/"\r
  86                         query = String.Empty;\r
  87                         fragment = String.Empty;\r
  88                         username = String.Empty;\r
  89                         password = String.Empty;\r
  90                         modified = true;\r
  91                 }\r
  92                 \r
  93                 public UriBuilder (string scheme, string host, int portNumber) \r
  94                         : this (scheme, host)\r
  95                 {\r
  96                         Port = portNumber;\r
  97                 }\r
  98                 \r
  99                 public UriBuilder (string scheme, string host, int port, string pathValue)\r
 100                         : this (scheme, host, port)\r
 101                 {\r
 102                         Path = pathValue;\r
 103                 }\r
 104 \r
 105                 public UriBuilder (string scheme, string host, int port, string pathValue, string extraValue)\r
 106                         : this (scheme, host, port, pathValue)\r
 107                 {\r
 108                         if (extraValue == null || extraValue.Length == 0)\r
 109                                 return;\r
 110                                 \r
 111                         if (extraValue [0] == '#') \r
 112                                 Fragment = extraValue.Remove (0, 1);\r
 113                         else if (extraValue [0] == '?') \r
 114                                 Query = extraValue.Remove (0, 1);\r
 115                         else \r
 116                                 throw new ArgumentException ("extraValue");\r
 117                 }\r
 118 \r
 119                 \r
 120                 // Properties\r
 121                 \r
 122                 public string Fragment {\r
 123                         get { return fragment; }\r
 124                         set {\r
 125                                 fragment = value;\r
 126                                 if (fragment == null)\r
 127                                         fragment = String.Empty;\r
 128                                 else if (fragment.Length > 0)\r
 129 //                                      fragment = "#" + EncodeUtf8 (value.Replace ("%23", "#"));\r
 130                                         fragment = "#" + value.Replace ("%23", "#");\r
 131                                 query = String.Empty;                           \r
 132                                 modified = true;\r
 133                         }\r
 134                 }\r
 135 \r
 136                 public string Host {\r
 137                         get { return host; }\r
 138                         set {\r
 139                                 host = (value == null) ? String.Empty : value;;\r
 140                                 modified = true;\r
 141                         }\r
 142                 }\r
 143 \r
 144                 public string Password {\r
 145                         get { return password; }\r
 146                         set {\r
 147                                 password = (value == null) ? String.Empty : value;;\r
 148                                 modified = true;\r
 149                         }\r
 150                 }\r
 151                 \r
 152                 public string Path {\r
 153                         get { return path; }\r
 154                         set {\r
 155                                 if (value == null || value.Length == 0) {\r
 156                                         path = "/";\r
 157                                 } else {\r
 158                                         path = Uri.EscapeString (value.Replace ('\\', '/'), false, true, true);\r
 159                                 }\r
 160                                 modified = true;\r
 161                         }\r
 162                 }\r
 163                 \r
 164                 public int Port {\r
 165                         get { return port; }\r
 166                         set {\r
 167                                 if (value < 0)\r
 168                                         throw new ArgumentOutOfRangeException ("value");\r
 169                                 // apparently it is\r
 170                                 port = value;\r
 171                                 modified = true;\r
 172                         }\r
 173                 }\r
 174                 \r
 175                 public string Query {\r
 176                         get { return query; }\r
 177                         set {\r
 178                                 // LAMESPEC: it doesn't say to always prepend a \r
 179                                 // question mark to the value.. it does say this \r
 180                                 // for fragment.\r
 181                                 if (value == null || value == "")\r
 182                                         query = String.Empty;\r
 183                                 else\r
 184 //                                      query = "?" + EncodeUtf8 (value);\r
 185                                         query = "?" + value;\r
 186                                 fragment = String.Empty;\r
 187                                 modified = true;\r
 188                         }\r
 189                 }\r
 190                 \r
 191                 public string Scheme {\r
 192                         get { return scheme; }\r
 193                         set {\r
 194                                 if (value == null)\r
 195                                         value = String.Empty;\r
 196                                 int colonPos = value.IndexOf (':');\r
 197                                 if (colonPos != -1)\r
 198                                         value = value.Substring (0, colonPos);\r
 199                                 scheme = value.ToLower ();\r
 200                                 modified = true;\r
 201                         }\r
 202                 }\r
 203                 \r
 204                 public Uri Uri {\r
 205                         get {\r
 206                                 if (!modified) \r
 207                                         return uri;\r
 208                                 uri = new Uri (ToString (), true);\r
 209                                 modified = false;\r
 210                                 return uri;\r
 211                         }\r
 212                 }\r
 213                 \r
 214                 public string UserName {\r
 215                         get { return username; }\r
 216                         set {\r
 217                                 username = (value == null) ? String.Empty : value;;\r
 218                                 modified = true;\r
 219                         }\r
 220                 }               \r
 221 \r
 222                 // Methods\r
 223                 \r
 224                 public override bool Equals (object rparam) \r
 225                 {\r
 226                         return (rparam == null) ? false : this.Uri.Equals (rparam.ToString ());\r
 227                 }\r
 228                 \r
 229                 public override int GetHashCode ()\r
 230                 {\r
 231                         return this.Uri.GetHashCode ();\r
 232                 }\r
 233                 \r
 234                 public override string ToString ()\r
 235                 {\r
 236                         StringBuilder builder = new StringBuilder ();\r
 237 \r
 238                         builder.Append (scheme);\r
 239                         builder.Append ("://");\r
 240 \r
 241                         if (username != String.Empty) {\r
 242                                 builder.Append (username);\r
 243                                 if (password != String.Empty)\r
 244                                         builder.Append (":" + password);\r
 245                                 builder.Append ('@');\r
 246                         }\r
 247 \r
 248                         builder.Append (host);\r
 249                         if (port > 0)\r
 250                                 builder.Append (":" + port);\r
 251 \r
 252                         if (path != String.Empty)\r
 253                                 builder.Append ('/');\r
 254                         builder.Append (path);\r
 255                         builder.Append (query);\r
 256 \r
 257                         return builder.ToString ();\r
 258                 }\r
 259         } \r
 260 } \r
 261 \r