mcs/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 #if NET_4_5
  37 using System.Threading.Tasks;
  38 #endif
  39
  40 namespace System.Xml
  41 {
  42         public abstract class XmlResolver
  43         {
  44 #if !MOONLIGHT
  45 #if NET_4_5
  46                 public virtual ICredentials Credentials {
  47                         set { throw new NotImplementedException (); }
  48                 }
  49 #else
  50                 public abstract ICredentials Credentials { set; }
  51 #endif
  52 #endif
  53
  54                 public abstract object GetEntity (Uri absoluteUri, string role, Type ofObjectToReturn);
  55
  56                 [PermissionSet (SecurityAction.InheritanceDemand, Unrestricted = true)]
  57                 public virtual Uri ResolveUri (Uri baseUri, string relativeUri)
  58                 {
  59                         if (baseUri == null) {
  60                                 if (relativeUri == null)
  61                                         throw new ArgumentNullException ("Either baseUri or relativeUri are required.");
  62 #if MOONLIGHT
  63                                 return new Uri (relativeUri, UriKind.RelativeOrAbsolute);
  64 #else
  65                                 // Don't ignore such case that relativeUri is in fact absolute uri (e.g. ResolveUri (null, "http://foo.com")).
  66                                 int idx = relativeUri.IndexOf (':');
  67                                 if (idx > 0 && Uri.CheckSchemeName (relativeUri.Substring (0, idx)))
  68                                         return new Uri (relativeUri);
  69                                 else
  70                                         return new Uri (Path.GetFullPath (relativeUri));
  71 #endif
  72                         }
  73
  74                         if (relativeUri == null)
  75                                 return baseUri;
  76
  77                         return new Uri (baseUri, EscapeRelativeUriBody (relativeUri));
  78                 }
  79
  80                 // see also XmlUrlResolver.UnescapeRelativeUriBody().
  81                 private string EscapeRelativeUriBody (string src)
  82                 {
  83                         return src.Replace ("<", "%3C")
  84                                 .Replace (">", "%3E")
  85                                 .Replace ("#", "%23")
  86                                 .Replace ("%", "%25")
  87                                 .Replace ("\"", "%22");
  88                 }
  89 #if MOONLIGHT || NET_4_5
  90                 public virtual bool SupportsType (Uri absoluteUri, Type type)
  91                 {
  92                         if (absoluteUri == null)
  93                                 throw new ArgumentNullException ("absoluteUri");
  94                         return ((type == null) || (type == typeof (Stream)));
  95                 }
  96 #endif
  97
  98 #if NET_4_5
  99                 public virtual Task<object> GetEntityAsync (Uri absoluteUri, string role, Type ofObjectToReturn)
 100                 {
 101                         throw new NotImplementedException ();
 102                 }
 103 #endif
 104         }
 105 }