copied mono-api-diff.cs from mono-2-2 branch so new patch can be applied and history...
[mono.git] / 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
37 namespace System.Xml
38 {
39         public abstract class XmlResolver
40         {
41 #if !MOONLIGHT
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 MOONLIGHT
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 MOONLIGHT
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 }