3 // Sebastien Pouliot <sebastien@xamarin.com>
5 // Copyright 2013 Xamarin Inc. http://www.xamarin.com
7 // Permission is hereby granted, free of charge, to any person obtaining
8 // a copy of this software and associated documentation files (the
9 // "Software"), to deal in the Software without restriction, including
10 // without limitation the rights to use, copy, modify, merge, publish,
11 // distribute, sublicense, and/or sell copies of the Software, and to
12 // permit persons to whom the Software is furnished to do so, subject to
13 // the following conditions:
15 // The above copyright notice and this permission notice shall be
16 // included in all copies or substantial portions of the Software.
18 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
21 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
22 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
23 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
24 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
28 using System.Collections.Generic;
29 using System.Reflection;
31 using System.Xml.Linq;
33 namespace Xamarin.ApiDiff {
35 public class PropertyComparer : MemberComparer {
37 public override string GroupName {
38 get { return "properties"; }
41 public override string ElementName {
42 get { return "property"; }
45 public override bool Find (XElement e)
49 // the same Item (indexer) property can have different parameters
50 return e.GetAttribute ("params") == Source.GetAttribute ("params");
53 void GetAccessors (XElement element, out XElement getter, out XElement setter)
55 var methods = element.Element ("methods");
63 foreach (var m in methods.Elements ("method")) {
64 var n = m.GetAttribute ("name");
65 if (n.StartsWith ("get_", StringComparison.Ordinal)) {
67 } else if (n.StartsWith ("set_", StringComparison.Ordinal)) {
73 MethodAttributes GetMethodAttributes (XElement getter, XElement setter)
76 return setter.GetMethodAttributes ();
77 else if (setter == null)
78 return getter.GetMethodAttributes ();
80 var gAttr = getter.GetMethodAttributes ();
81 var sAttr = setter.GetMethodAttributes ();
82 var g = gAttr & MethodAttributes.MemberAccessMask;
83 var s = sAttr & MethodAttributes.MemberAccessMask;
84 // Visibility is ordered numerically (higher value = more visible).
85 // We want the most visible.
86 var visibility = (MethodAttributes) Math.Max ((int) g, (int) s);
87 // Do a bitwise or with the rest of the flags
88 var g_no_visibility = gAttr & ~MethodAttributes.MemberAccessMask;
89 var s_no_visibility = sAttr & ~MethodAttributes.MemberAccessMask;
90 return g_no_visibility | s_no_visibility | visibility;
93 void RenderPropertyType (XElement source, XElement target, ApiChange change)
95 var srcType = source.GetTypeName ("ptype");
96 var tgtType = target.GetTypeName ("ptype");
98 if (srcType == tgtType) {
99 change.Append (tgtType);
101 change.AppendModified (srcType, tgtType, true);
106 void RenderAccessors (XElement srcGetter, XElement tgtGetter, XElement srcSetter, XElement tgtSetter, ApiChange change)
108 // FIXME: this doesn't render changes in the accessor visibility (a protected setter can become public for instance).
109 change.Append (" {");
110 if (tgtGetter != null) {
111 if (srcGetter != null) {
112 change.Append (" ").Append ("get;");
114 change.Append (" ").AppendAdded ("get;");
116 } else if (srcGetter != null) {
117 change.Append (" ").AppendRemoved ("get;");
120 if (tgtSetter != null) {
121 if (srcSetter != null) {
122 change.Append (" ").Append ("set;");
124 change.Append (" ").AppendAdded ("set;");
126 } else if (srcSetter != null) {
127 change.Append (" ").AppendRemoved ("set;");
130 change.Append (" }");
132 // Ignore added property setters if asked to
133 if (srcSetter == null && tgtSetter != null && State.IgnoreAddedPropertySetters && !change.Breaking) {
134 change.AnyChange = false;
135 change.HasIgnoredChanges = true;
139 public override bool Equals (XElement source, XElement target, ApiChanges changes)
141 if (base.Equals (source, target, changes))
144 XElement srcGetter, srcSetter;
145 XElement tgtGetter, tgtSetter;
146 GetAccessors (source, out srcGetter, out srcSetter);
147 GetAccessors (target, out tgtGetter, out tgtSetter);
149 var change = new ApiChange ();
150 change.Header = "Modified " + GroupName;
151 RenderMethodAttributes (GetMethodAttributes (srcGetter, srcSetter), GetMethodAttributes (tgtGetter, tgtSetter), change);
152 RenderPropertyType (source, target, change);
153 RenderName (source, target, change);
154 RenderGenericParameters (source, target, change);
155 RenderAccessors (srcGetter, tgtGetter, srcSetter, tgtSetter, change);
157 changes.Add (source, target, change);
162 void GetProperties (XElement e, out bool @virtual, out bool @override, out bool @static, out bool getter, out bool setter, out bool family)
164 @virtual = @override = @static = getter = setter = family = false;
166 var methods = e.Element ("methods");
167 if (methods != null) {
168 foreach (var m in methods.Elements ("method")) {
169 @virtual |= m.IsTrue ("virtual");
170 @static |= m.IsTrue ("static");
171 var n = m.GetAttribute ("name");
172 getter |= n.StartsWith ("get_", StringComparison.Ordinal);
173 setter |= n.StartsWith ("set_", StringComparison.Ordinal);
174 var attribs = (MethodAttributes) Int32.Parse (m.GetAttribute ("attrib"));
175 family = ((attribs & MethodAttributes.Public) != MethodAttributes.Public);
176 @override |= (attribs & MethodAttributes.NewSlot) == 0;
181 public override string GetDescription (XElement e)
183 string name = e.Attribute ("name").Value;
184 string ptype = e.GetTypeName ("ptype");
192 GetProperties (e, out virt, out over, out stat, out getter, out setter, out family);
194 var sb = new StringBuilder ();
196 sb.Append (family ? "protected " : "public ");
197 if (virt && !State.IgnoreVirtualChanges)
198 sb.Append (over ? "override " : "virtual ");
200 sb.Append ("static ");
201 sb.Append (ptype).Append (' ').Append (name).Append (" { ");
208 return sb.ToString ();