// Copyright (c) 2014 Daniel Grunwald // // 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.Threading; using ICSharpCode.NRefactory.CSharp; using ICSharpCode.NRefactory.CSharp.Refactoring; using ICSharpCode.NRefactory.TypeSystem; using Mono.Cecil; using ICSharpCode.Decompiler.CSharp.Transforms; using ICSharpCode.Decompiler.IL; using ICSharpCode.Decompiler.IL.ControlFlow; using ICSharpCode.Decompiler.IL.Transforms; namespace ICSharpCode.Decompiler.CSharp { /// /// Main class of the C# decompiler engine. /// /// /// Instances of this class are not thread-safe. Use separate instances to decompile multiple members in parallel. /// public class CSharpDecompiler { readonly DecompilerTypeSystem typeSystem; readonly DecompilerSettings settings; List ilTransforms = new List { new ControlFlowSimplification(), new LoopDetection(), new IntroduceExitPoints(), new ConditionDetection(), new ILInlining(), new TransformingVisitor(), new ExpressionTransforms(), new TransformArrayInitializers() }; List astTransforms = new List { //new PushNegation(), //new DelegateConstruction(context), //new PatternStatementTransform(context), new ReplaceMethodCallsWithOperators(), new IntroduceUnsafeModifier(), new AddCheckedBlocks(), //new DeclareVariables(context), // should run after most transforms that modify statements new ConvertConstructorCallIntoInitializer(), // must run after DeclareVariables new DecimalConstantTransform(), new IntroduceUsingDeclarations(), //new IntroduceExtensionMethods(context), // must run after IntroduceUsingDeclarations //new IntroduceQueryExpressions(context), // must run after IntroduceExtensionMethods //new CombineQueryExpressions(context), //new FlattenSwitchBlocks(), }; public CancellationToken CancellationToken { get; set; } /// /// IL transforms. /// public IList ILTransforms { get { return ilTransforms; } } /// /// C# AST transforms. /// public IList AstTransforms { get { return astTransforms; } } public CSharpDecompiler(ModuleDefinition module, DecompilerSettings settings) : this(new DecompilerTypeSystem(module), settings) { } public CSharpDecompiler(DecompilerTypeSystem typeSystem, DecompilerSettings settings) { if (typeSystem == null) throw new ArgumentNullException("typeSystem"); this.typeSystem = typeSystem; this.settings = settings; } #region MemberIsHidden public static bool MemberIsHidden(MemberReference member, DecompilerSettings settings) { MethodDefinition method = member as MethodDefinition; if (method != null) { if (method.IsGetter || method.IsSetter || method.IsAddOn || method.IsRemoveOn) return true; // if (settings.AnonymousMethods && method.HasGeneratedName() && method.IsCompilerGenerated()) // return true; } TypeDefinition type = member as TypeDefinition; if (type != null) { if (type.DeclaringType != null) { // if (settings.AnonymousMethods && IsClosureType(type)) // return true; // if (settings.YieldReturn && YieldReturnDecompiler.IsCompilerGeneratorEnumerator(type)) // return true; // if (settings.AsyncAwait && AsyncDecompiler.IsCompilerGeneratedStateMachine(type)) // return true; } else if (type.IsCompilerGenerated()) { // if (type.Name.StartsWith("", StringComparison.Ordinal)) // return true; // if (type.IsAnonymousType()) // return true; } } FieldDefinition field = member as FieldDefinition; if (field != null) { if (field.IsCompilerGenerated()) { // if (settings.AnonymousMethods && IsAnonymousMethodCacheField(field)) // return true; // if (settings.AutomaticProperties && IsAutomaticPropertyBackingField(field)) // return true; // if (settings.SwitchStatementOnString && IsSwitchOnStringCache(field)) // return true; } // event-fields are not [CompilerGenerated] // if (settings.AutomaticEvents && field.DeclaringType.Events.Any(ev => ev.Name == field.Name)) // return true; // HACK : only hide fields starting with '__StaticArrayInit' if (field.DeclaringType.Name.StartsWith("", StringComparison.Ordinal)) { if (field.Name.StartsWith("__StaticArrayInit", StringComparison.Ordinal)) return true; if (field.FieldType.Name.StartsWith("__StaticArrayInit", StringComparison.Ordinal)) return true; } } return false; } static bool IsSwitchOnStringCache(FieldDefinition field) { return field.Name.StartsWith("<>f__switch", StringComparison.Ordinal); } static bool IsAutomaticPropertyBackingField(FieldDefinition field) { return field.HasGeneratedName() && field.Name.EndsWith("BackingField", StringComparison.Ordinal); } static bool IsAnonymousMethodCacheField(FieldDefinition field) { return field.Name.StartsWith("CS$<>", StringComparison.Ordinal) || field.Name.StartsWith("<>f__am", StringComparison.Ordinal); } static bool IsClosureType(TypeDefinition type) { return type.HasGeneratedName() && type.IsCompilerGenerated() && (type.Name.Contains("DisplayClass") || type.Name.Contains("AnonStorey")); } #endregion TypeSystemAstBuilder CreateAstBuilder(ITypeResolveContext decompilationContext) { var typeSystemAstBuilder = new TypeSystemAstBuilder(); typeSystemAstBuilder.ShowAttributes = true; typeSystemAstBuilder.AlwaysUseShortTypeNames = true; typeSystemAstBuilder.AddResolveResultAnnotations = true; return typeSystemAstBuilder; } void RunTransforms(AstNode rootNode, ITypeResolveContext decompilationContext) { var typeSystemAstBuilder = CreateAstBuilder(decompilationContext); var context = new TransformContext(typeSystem, decompilationContext, typeSystemAstBuilder, CancellationToken); foreach (var transform in astTransforms) { CancellationToken.ThrowIfCancellationRequested(); transform.Run(rootNode, context); } rootNode.AcceptVisitor(new InsertParenthesesVisitor { InsertParenthesesForReadability = true }); } /// /// Decompile assembly and module attributes. /// public SyntaxTree DecompileModuleAndAssemblyAttributes() { var decompilationContext = new SimpleTypeResolveContext(typeSystem.MainAssembly); SyntaxTree syntaxTree = new SyntaxTree(); DoDecompileModuleAndAssemblyAttributes(decompilationContext, syntaxTree); RunTransforms(syntaxTree, decompilationContext); return syntaxTree; } void DoDecompileModuleAndAssemblyAttributes(ITypeResolveContext decompilationContext, SyntaxTree syntaxTree) { foreach (var a in typeSystem.Compilation.MainAssembly.AssemblyAttributes) { var astBuilder = CreateAstBuilder(decompilationContext); var attrSection = new AttributeSection(astBuilder.ConvertAttribute(a)); attrSection.AttributeTarget = "assembly"; syntaxTree.AddChild(attrSection, SyntaxTree.MemberRole); } } void DoDecompileTypes(IEnumerable types, ITypeResolveContext decompilationContext, SyntaxTree syntaxTree) { string currentNamespace = null; AstNode groupNode = null; foreach (var cecilType in types) { var typeDef = typeSystem.Resolve(cecilType).GetDefinition(); if (typeDef.Name == "" && typeDef.Members.Count == 0) continue; if (MemberIsHidden(cecilType, settings)) continue; if(string.IsNullOrEmpty(cecilType.Namespace)) { groupNode = syntaxTree; } else { if (currentNamespace != cecilType.Namespace) { groupNode = new NamespaceDeclaration(cecilType.Namespace); syntaxTree.AddChild(groupNode, SyntaxTree.MemberRole); } } currentNamespace = cecilType.Namespace; var typeDecl = DoDecompile(typeDef, decompilationContext.WithCurrentTypeDefinition(typeDef)); groupNode.AddChild(typeDecl, SyntaxTree.MemberRole); } } /// /// Decompiles the whole module into a single syntax tree. /// public SyntaxTree DecompileWholeModuleAsSingleFile() { var decompilationContext = new SimpleTypeResolveContext(typeSystem.MainAssembly); SyntaxTree syntaxTree = new SyntaxTree(); DoDecompileModuleAndAssemblyAttributes(decompilationContext, syntaxTree); DoDecompileTypes(typeSystem.ModuleDefinition.Types, decompilationContext, syntaxTree); RunTransforms(syntaxTree, decompilationContext); return syntaxTree; } /// /// Decompile the given types. /// /// /// Unlike Decompile(IMemberDefinition[]), this method will add namespace declarations around the type definitions. /// public SyntaxTree DecompileTypes(IEnumerable types) { if (types == null) throw new ArgumentNullException("types"); var decompilationContext = new SimpleTypeResolveContext(typeSystem.MainAssembly); SyntaxTree syntaxTree = new SyntaxTree(); DoDecompileTypes(types, decompilationContext, syntaxTree); RunTransforms(syntaxTree, decompilationContext); return syntaxTree; } /// /// Decompile the specified types and/or members. /// public SyntaxTree Decompile(params IMemberDefinition[] definitions) { if (definitions == null) throw new ArgumentNullException("definitions"); var syntaxTree = new SyntaxTree(); foreach (var def in definitions) { if (def == null) throw new ArgumentException("definitions contains null element"); var typeDefinition = def as TypeDefinition; var methodDefinition = def as MethodDefinition; var fieldDefinition = def as FieldDefinition; var propertyDefinition = def as PropertyDefinition; var eventDefinition = def as EventDefinition; if (typeDefinition != null) { ITypeDefinition typeDef = typeSystem.Resolve(typeDefinition).GetDefinition(); if (typeDef == null) throw new InvalidOperationException("Could not find type definition in NR type system"); syntaxTree.Members.Add(DoDecompile(typeDef, new SimpleTypeResolveContext(typeDef))); } else if (methodDefinition != null) { IMethod method = typeSystem.Resolve(methodDefinition); if (method == null) throw new InvalidOperationException("Could not find method definition in NR type system"); syntaxTree.Members.Add(DoDecompile(methodDefinition, method, new SimpleTypeResolveContext(method))); } else if (fieldDefinition != null) { IField field = typeSystem.Resolve(fieldDefinition); if (field == null) throw new InvalidOperationException("Could not find field definition in NR type system"); syntaxTree.Members.Add(DoDecompile(fieldDefinition, field, new SimpleTypeResolveContext(field))); } else if (propertyDefinition != null) { IProperty property = typeSystem.Resolve(propertyDefinition); if (property == null) throw new InvalidOperationException("Could not find field definition in NR type system"); syntaxTree.Members.Add(DoDecompile(propertyDefinition, property, new SimpleTypeResolveContext(property))); } else if (eventDefinition != null) { IEvent ev = typeSystem.Resolve(eventDefinition); if (ev == null) throw new InvalidOperationException("Could not find field definition in NR type system"); syntaxTree.Members.Add(DoDecompile(eventDefinition, ev, new SimpleTypeResolveContext(ev))); } else { throw new NotSupportedException(def.GetType().Name); } } RunTransforms(syntaxTree, new SimpleTypeResolveContext(typeSystem.MainAssembly)); return syntaxTree; } EntityDeclaration DoDecompile(ITypeDefinition typeDef, ITypeResolveContext decompilationContext) { Debug.Assert(decompilationContext.CurrentTypeDefinition == typeDef); var typeSystemAstBuilder = CreateAstBuilder(decompilationContext); var entityDecl = typeSystemAstBuilder.ConvertEntity(typeDef); var typeDecl = entityDecl as TypeDeclaration; if (typeDecl == null) { // e.g. DelegateDeclaration return entityDecl; } foreach (var type in typeDef.NestedTypes) { typeDecl.Members.Add(DoDecompile(type, decompilationContext.WithCurrentTypeDefinition(type))); } foreach (var field in typeDef.Fields) { var fieldDef = typeSystem.GetCecil(field) as FieldDefinition; if (fieldDef != null && !MemberIsHidden(fieldDef, settings)) { var memberDecl = DoDecompile(fieldDef, field, decompilationContext.WithCurrentMember(field)); typeDecl.Members.Add(memberDecl); } } foreach (var property in typeDef.Properties) { var propDef = typeSystem.GetCecil(property) as PropertyDefinition; if (propDef != null && !MemberIsHidden(propDef, settings)) { var propDecl = DoDecompile(propDef, property, decompilationContext.WithCurrentMember(property)); typeDecl.Members.Add(propDecl); } } foreach (var @event in typeDef.Events) { var eventDef = typeSystem.GetCecil(@event) as EventDefinition; if (eventDef != null && !MemberIsHidden(eventDef, settings)) { var eventDecl = DoDecompile(eventDef, @event, decompilationContext.WithCurrentMember(@event)); typeDecl.Members.Add(eventDecl); } } foreach (var method in typeDef.Methods) { var methodDef = typeSystem.GetCecil(method) as MethodDefinition; if (methodDef != null && !MemberIsHidden(methodDef, settings)) { var memberDecl = DoDecompile(methodDef, method, decompilationContext.WithCurrentMember(method)); typeDecl.Members.Add(memberDecl); } } if (typeDecl.Members.OfType().Any(idx => idx.PrivateImplementationType.IsNull)) { // Remove the [DefaultMember] attribute if the class contains indexers foreach (AttributeSection section in typeDecl.Attributes) { foreach (var attr in section.Attributes) { var tr = attr.Type.GetResolveResult().Type; if (tr.Name == "DefaultMemberAttribute" && tr.Namespace == "System.Reflection") { attr.Remove(); } } if (section.Attributes.Count == 0) section.Remove(); } } return typeDecl; } EntityDeclaration DoDecompile(MethodDefinition methodDefinition, IMethod method, ITypeResolveContext decompilationContext) { Debug.Assert(decompilationContext.CurrentMember == method); var typeSystemAstBuilder = CreateAstBuilder(decompilationContext); var entityDecl = typeSystemAstBuilder.ConvertEntity(method); if (methodDefinition.HasBody) { DecompileBody(methodDefinition, method, entityDecl, decompilationContext, typeSystemAstBuilder); } return entityDecl; } IDecompilerTypeSystem GetSpecializingTypeSystem(ITypeResolveContext decompilationContext) { IList classTypeParameters = null; IList methodTypeParameters = null; if (decompilationContext.CurrentTypeDefinition != null) classTypeParameters = decompilationContext.CurrentTypeDefinition.TypeArguments; IMethod method = decompilationContext.CurrentMember as IMethod; if (method != null) methodTypeParameters = method.TypeArguments; if ((classTypeParameters != null && classTypeParameters.Count > 0) || (methodTypeParameters != null && methodTypeParameters.Count > 0)) return new SpecializingDecompilerTypeSystem(typeSystem, new TypeParameterSubstitution(classTypeParameters, methodTypeParameters)); else return typeSystem; } void DecompileBody(MethodDefinition methodDefinition, IMethod method, EntityDeclaration entityDecl, ITypeResolveContext decompilationContext, TypeSystemAstBuilder typeSystemAstBuilder) { var specializingTypeSystem = GetSpecializingTypeSystem(decompilationContext); var ilReader = new ILReader(specializingTypeSystem); var function = ilReader.ReadIL(methodDefinition.Body, CancellationToken); function.CheckInvariant(); var context = new ILTransformContext { TypeSystem = specializingTypeSystem, CancellationToken = CancellationToken }; foreach (var transform in ilTransforms) { CancellationToken.ThrowIfCancellationRequested(); transform.Run(function, context); function.CheckInvariant(); } var statementBuilder = new StatementBuilder(decompilationContext, method); var body = statementBuilder.ConvertAsBlock(function.Body); // insert variables at start of body Statement prevVarDecl = null; foreach (var v in function.Variables) { if (v.LoadCount == 0 && v.StoreCount == 0 && v.AddressCount == 0) continue; if (v.Kind == VariableKind.Local || v.Kind == VariableKind.StackSlot) { var type = typeSystemAstBuilder.ConvertType(v.Type); var varDecl = new VariableDeclarationStatement(type, v.Name); body.Statements.InsertAfter(prevVarDecl, varDecl); prevVarDecl = varDecl; } } entityDecl.AddChild(body, Roles.Body); } EntityDeclaration DoDecompile(FieldDefinition fieldDefinition, IField field, ITypeResolveContext decompilationContext) { Debug.Assert(decompilationContext.CurrentMember == field); var typeSystemAstBuilder = CreateAstBuilder(decompilationContext); if (decompilationContext.CurrentTypeDefinition.Kind == TypeKind.Enum) { var enumDec = new EnumMemberDeclaration() { Name = field.Name, Initializer = typeSystemAstBuilder.ConvertConstantValue(decompilationContext.CurrentTypeDefinition.EnumUnderlyingType, field.ConstantValue), }; enumDec.Attributes.AddRange(field.Attributes.Select(a => new AttributeSection(typeSystemAstBuilder.ConvertAttribute(a)))); return enumDec; } return typeSystemAstBuilder.ConvertEntity(field); } EntityDeclaration DoDecompile(PropertyDefinition propertyDefinition, IProperty property, ITypeResolveContext decompilationContext) { Debug.Assert(decompilationContext.CurrentMember == property); var typeSystemAstBuilder = CreateAstBuilder(decompilationContext); EntityDeclaration entityDecl = typeSystemAstBuilder.ConvertEntity(property); Accessor getter, setter; if (entityDecl is PropertyDeclaration) { getter = ((PropertyDeclaration)entityDecl).Getter; setter = ((PropertyDeclaration)entityDecl).Setter; } else { getter = ((IndexerDeclaration)entityDecl).Getter; setter = ((IndexerDeclaration)entityDecl).Setter; } if (property.CanGet && property.Getter.HasBody) { DecompileBody(propertyDefinition.GetMethod, property.Getter, getter, decompilationContext, typeSystemAstBuilder); } if (property.CanSet && property.Setter.HasBody) { DecompileBody(propertyDefinition.SetMethod, property.Setter, setter, decompilationContext, typeSystemAstBuilder); } return entityDecl; } EntityDeclaration DoDecompile(EventDefinition propertyDefinition, IEvent ev, ITypeResolveContext decompilationContext) { Debug.Assert(decompilationContext.CurrentMember == ev); var typeSystemAstBuilder = CreateAstBuilder(decompilationContext); typeSystemAstBuilder.UseCustomEvents = true; var eventDecl = (CustomEventDeclaration)typeSystemAstBuilder.ConvertEntity(ev); if (propertyDefinition.AddMethod != null && propertyDefinition.AddMethod.HasBody) { DecompileBody(propertyDefinition.AddMethod, ev.AddAccessor, eventDecl.AddAccessor, decompilationContext, typeSystemAstBuilder); } if (propertyDefinition.RemoveMethod != null && propertyDefinition.RemoveMethod.HasBody) { DecompileBody(propertyDefinition.RemoveMethod, ev.RemoveAccessor, eventDecl.RemoveAccessor, decompilationContext, typeSystemAstBuilder); } return eventDecl; } } }