5 changed files with 283 additions and 17 deletions
@ -0,0 +1,244 @@
@@ -0,0 +1,244 @@
|
||||
// Copyright (c) 2011 AlphaSierraPapa for the SharpDevelop Team
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining a copy of this
|
||||
// software and associated documentation files (the "Software"), to deal in the Software
|
||||
// without restriction, including without limitation the rights to use, copy, modify, merge,
|
||||
// publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
|
||||
// to whom the Software is furnished to do so, subject to the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be included in all copies or
|
||||
// substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
|
||||
// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
|
||||
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
|
||||
// FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
|
||||
// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
||||
// DEALINGS IN THE SOFTWARE.
|
||||
|
||||
using System; |
||||
using System.Collections.Generic; |
||||
using System.Diagnostics; |
||||
using System.Linq; |
||||
using System.Text; |
||||
using Mono.Cecil; |
||||
|
||||
namespace ICSharpCode.Decompiler |
||||
{ |
||||
/// <summary>
|
||||
/// Provides XML documentation tags.
|
||||
/// </summary>
|
||||
public sealed class XmlDocKeyProvider |
||||
{ |
||||
#region GetKey
|
||||
public static string GetKey(MemberReference member) |
||||
{ |
||||
StringBuilder b = new StringBuilder(); |
||||
if (member is TypeReference) { |
||||
b.Append("T:"); |
||||
AppendTypeName(b, (TypeReference)member); |
||||
} else { |
||||
if (member is FieldReference) |
||||
b.Append("F:"); |
||||
else if (member is PropertyDefinition) |
||||
b.Append("P:"); |
||||
else if (member is EventDefinition) |
||||
b.Append("E:"); |
||||
else if (member is MethodReference) |
||||
b.Append("M:"); |
||||
AppendTypeName(b, member.DeclaringType); |
||||
b.Append('.'); |
||||
b.Append(member.Name.Replace('.', '#')); |
||||
IList<ParameterDefinition> parameters; |
||||
TypeReference explicitReturnType = null; |
||||
if (member is PropertyDefinition) { |
||||
parameters = ((PropertyDefinition)member).Parameters; |
||||
} else if (member is MethodReference) { |
||||
MethodReference mr = (MethodReference)member; |
||||
if (mr.HasGenericParameters) { |
||||
b.Append("``"); |
||||
b.Append(mr.GenericParameters.Count); |
||||
} |
||||
parameters = mr.Parameters; |
||||
if (mr.Name == "op_Implicit" || mr.Name == "op_Explicit") { |
||||
explicitReturnType = mr.ReturnType; |
||||
} |
||||
} else { |
||||
parameters = null; |
||||
} |
||||
if (parameters != null && parameters.Count > 0) { |
||||
b.Append('('); |
||||
for (int i = 0; i < parameters.Count; i++) { |
||||
if (i > 0) b.Append(','); |
||||
AppendTypeName(b, parameters[i].ParameterType); |
||||
} |
||||
b.Append(')'); |
||||
} |
||||
if (explicitReturnType != null) { |
||||
b.Append('~'); |
||||
AppendTypeName(b, explicitReturnType); |
||||
} |
||||
} |
||||
return b.ToString(); |
||||
} |
||||
|
||||
static void AppendTypeName(StringBuilder b, TypeReference type) |
||||
{ |
||||
if (type == null) { |
||||
// could happen when a TypeSpecification has no ElementType; e.g. function pointers in C++/CLI assemblies
|
||||
return; |
||||
} |
||||
if (type is GenericInstanceType) { |
||||
GenericInstanceType giType = (GenericInstanceType)type; |
||||
AppendTypeNameWithArguments(b, giType.ElementType, giType.GenericArguments); |
||||
} else if (type is TypeSpecification) { |
||||
AppendTypeName(b, ((TypeSpecification)type).ElementType); |
||||
ArrayType arrayType = type as ArrayType; |
||||
if (arrayType != null) { |
||||
b.Append('['); |
||||
for (int i = 0; i < arrayType.Dimensions.Count; i++) { |
||||
if (i > 0) |
||||
b.Append(','); |
||||
ArrayDimension ad = arrayType.Dimensions[i]; |
||||
if (ad.IsSized) { |
||||
b.Append(ad.LowerBound); |
||||
b.Append(':'); |
||||
b.Append(ad.UpperBound); |
||||
} |
||||
} |
||||
b.Append(']'); |
||||
} |
||||
ByReferenceType refType = type as ByReferenceType; |
||||
if (refType != null) { |
||||
b.Append('@'); |
||||
} |
||||
PointerType ptrType = type as PointerType; |
||||
if (ptrType != null) { |
||||
b.Append('*'); |
||||
} |
||||
} else { |
||||
GenericParameter gp = type as GenericParameter; |
||||
if (gp != null) { |
||||
b.Append('`'); |
||||
if (gp.Owner.GenericParameterType == GenericParameterType.Method) { |
||||
b.Append('`'); |
||||
} |
||||
b.Append(gp.Position); |
||||
} else if (type.DeclaringType != null) { |
||||
AppendTypeName(b, type.DeclaringType); |
||||
b.Append('.'); |
||||
b.Append(type.Name); |
||||
} else { |
||||
b.Append(type.FullName); |
||||
} |
||||
} |
||||
} |
||||
|
||||
static int AppendTypeNameWithArguments(StringBuilder b, TypeReference type, IList<TypeReference> genericArguments) |
||||
{ |
||||
int outerTypeParameterCount = 0; |
||||
if (type.DeclaringType != null) { |
||||
TypeReference declType = type.DeclaringType; |
||||
outerTypeParameterCount = AppendTypeNameWithArguments(b, declType, genericArguments); |
||||
b.Append('.'); |
||||
} else if (!string.IsNullOrEmpty(type.Namespace)) { |
||||
b.Append(type.Namespace); |
||||
b.Append('.'); |
||||
} |
||||
int localTypeParameterCount = 0; |
||||
b.Append(NRefactory.TypeSystem.ReflectionHelper.SplitTypeParameterCountFromReflectionName(type.Name, out localTypeParameterCount)); |
||||
|
||||
if (localTypeParameterCount > 0) { |
||||
int totalTypeParameterCount = outerTypeParameterCount + localTypeParameterCount; |
||||
b.Append('{'); |
||||
for (int i = outerTypeParameterCount; i < totalTypeParameterCount && i < genericArguments.Count; i++) { |
||||
if (i > outerTypeParameterCount) b.Append(','); |
||||
AppendTypeName(b, genericArguments[i]); |
||||
} |
||||
b.Append('}'); |
||||
} |
||||
return outerTypeParameterCount + localTypeParameterCount; |
||||
} |
||||
#endregion
|
||||
|
||||
#region FindMemberByKey
|
||||
public static MemberReference FindMemberByKey(ModuleDefinition module, string key) |
||||
{ |
||||
if (module == null) |
||||
throw new ArgumentNullException("module"); |
||||
if (key == null || key.Length < 2 || key[1] != ':') |
||||
return null; |
||||
switch (key[0]) { |
||||
case 'T': |
||||
return FindType(module, key.Substring(2)); |
||||
case 'F': |
||||
return FindMember(module, key, type => type.Fields); |
||||
case 'P': |
||||
return FindMember(module, key, type => type.Properties); |
||||
case 'E': |
||||
return FindMember(module, key, type => type.Events); |
||||
case 'M': |
||||
return FindMember(module, key, type => type.Methods); |
||||
default: |
||||
return null; |
||||
} |
||||
} |
||||
|
||||
static MemberReference FindMember(ModuleDefinition module, string key, Func<TypeDefinition, IEnumerable<MemberReference>> memberSelector) |
||||
{ |
||||
Debug.WriteLine("Looking for member " + key); |
||||
int parenPos = key.IndexOf('('); |
||||
int dotPos; |
||||
if (parenPos > 0) { |
||||
dotPos = key.LastIndexOf('.', parenPos - 1, parenPos); |
||||
} else { |
||||
dotPos = key.LastIndexOf('.'); |
||||
} |
||||
if (dotPos < 0) return null; |
||||
TypeDefinition type = FindType(module, key.Substring(2, dotPos - 2)); |
||||
if (type == null) |
||||
return null; |
||||
string shortName; |
||||
if (parenPos > 0) { |
||||
shortName = key.Substring(dotPos + 1, parenPos - (dotPos + 1)); |
||||
} else { |
||||
shortName = key.Substring(dotPos + 1); |
||||
} |
||||
Debug.WriteLine("Searching in type {0} for {1}", type.FullName, shortName); |
||||
MemberReference shortNameMatch = null; |
||||
foreach (MemberReference member in memberSelector(type)) { |
||||
string memberKey = GetKey(member); |
||||
Debug.WriteLine(memberKey); |
||||
if (memberKey == key) |
||||
return member; |
||||
if (shortName == member.Name.Replace('.', '#')) |
||||
shortNameMatch = member; |
||||
} |
||||
// if there's no match by ID string (key), return the match by name.
|
||||
return shortNameMatch; |
||||
} |
||||
|
||||
static TypeDefinition FindType(ModuleDefinition module, string name) |
||||
{ |
||||
int pos = name.LastIndexOf('.'); |
||||
string ns; |
||||
if (pos >= 0) { |
||||
ns = name.Substring(0, pos); |
||||
name = name.Substring(pos + 1); |
||||
} else { |
||||
ns = string.Empty; |
||||
} |
||||
if (string.IsNullOrEmpty(name)) return null; |
||||
TypeDefinition type = module.GetType(ns, name); |
||||
if (type == null && ns.Length > 0) { |
||||
// try if this is a nested type
|
||||
type = FindType(module, ns); |
||||
if (type != null) { |
||||
type = type.NestedTypes.FirstOrDefault(t => t.Name == name); |
||||
} |
||||
} |
||||
return type; |
||||
} |
||||
#endregion
|
||||
} |
||||
} |
Loading…
Reference in new issue