class/System.XML/System.Xml/XmlResolver.cs

   1 //
   2 // System.Xml.XmlResolver.cs
   3 //
   4 // Author:
   5 //   Jason Diamond (jason@injektilo.org)
   6 //   Atsushi Enomoto (atsushi@ximian.com)
   7 //
   8 // (C) 2001 Jason Diamond  http://injektilo.org/
   9 // Copyright (C) 2004,2009 Novell, Inc (http://www.novell.com)
  10 //
  11
  12 //
  13 // Permission is hereby granted, free of charge, to any person obtaining
  14 // a copy of this software and associated documentation files (the
  15 // "Software"), to deal in the Software without restriction, including
  16 // without limitation the rights to use, copy, modify, merge, publish,
  17 // distribute, sublicense, and/or sell copies of the Software, and to
  18 // permit persons to whom the Software is furnished to do so, subject to
  19 // the following conditions:
  20 //
  21 // The above copyright notice and this permission notice shall be
  22 // included in all copies or substantial portions of the Software.
  23 //
  24 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  25 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  26 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  27 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  28 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  29 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  30 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  31 //
  32
  33 using System.IO;
  34 using System.Net;
  35 using System.Security.Permissions;
  36
  37 namespace System.Xml
  38 {
  39         public abstract class XmlResolver
  40         {
  41 #if !NET_2_1 || MONOTOUCH
  42                 public abstract ICredentials Credentials { set; }
  43 #endif
  44
  45                 public abstract object GetEntity (
  46                         Uri absoluteUri,
  47                         string role,
  48                         Type type);
  49
  50                 [PermissionSet (SecurityAction.InheritanceDemand, Unrestricted = true)]
  51                 public virtual Uri ResolveUri (Uri baseUri, string relativeUri)
  52                 {
  53                         if (baseUri == null) {
  54                                 if (relativeUri == null)
  55                                         throw new ArgumentNullException ("Either baseUri or relativeUri are required.");
  56 #if NET_2_1 && !MONOTOUCH
  57                                 return new Uri (relativeUri, UriKind.RelativeOrAbsolute);
  58 #else
  59                                 // Don't ignore such case that relativeUri is in fact absolute uri (e.g. ResolveUri (null, "http://foo.com")).
  60                                 if (relativeUri.StartsWith ("http:") ||
  61                                         relativeUri.StartsWith ("https:") ||
  62                                         relativeUri.StartsWith ("ftp:") ||
  63                                         relativeUri.StartsWith ("file:"))
  64                                         return new Uri (relativeUri);
  65                                 else
  66                                         return new Uri (Path.GetFullPath (relativeUri));
  67 #endif
  68                         }
  69
  70                         if (relativeUri == null)
  71                                 return baseUri;
  72
  73                         return new Uri (baseUri, EscapeRelativeUriBody (relativeUri));
  74                 }
  75
  76                 // see also XmlUrlResolver.UnescapeRelativeUriBody().
  77                 private string EscapeRelativeUriBody (string src)
  78                 {
  79                         return src.Replace ("<", "%3C")
  80                                 .Replace (">", "%3E")
  81                                 .Replace ("#", "%23")
  82                                 .Replace ("%", "%25")
  83                                 .Replace ("\"", "%22");
  84                 }
  85 #if NET_2_1 && !MONOTOUCH
  86                 public virtual bool SupportsType (Uri absoluteUri, Type type)
  87                 {
  88                         if (absoluteUri == null)
  89                                 throw new ArgumentNullException ("absoluteUri");
  90                         return ((type == null) || (type == typeof (Stream)));
  91                 }
  92 #endif
  93         }
  94 }