| | | 1 | | // Copyright (c) NexusLabs. All rights reserved. |
| | | 2 | | // Licensed under the MIT License. |
| | | 3 | | |
| | | 4 | | using System.Linq; |
| | | 5 | | using System.Text; |
| | | 6 | | using NexusLabs.Needlr.Generators.Models; |
| | | 7 | | |
| | | 8 | | namespace NexusLabs.Needlr.Generators.CodeGen; |
| | | 9 | | |
| | | 10 | | /// <summary> |
| | | 11 | | /// Generates Provider classes for [Provider] attributed types. |
| | | 12 | | /// </summary> |
| | | 13 | | internal static class ProviderCodeGenerator |
| | | 14 | | { |
| | | 15 | | /// <summary> |
| | | 16 | | /// Generates provider implementation for an interface-based provider. |
| | | 17 | | /// </summary> |
| | | 18 | | internal static void GenerateProviderImplementation(StringBuilder builder, DiscoveredProvider provider, string gener |
| | | 19 | | { |
| | 12 | 20 | | var implName = provider.ImplementationTypeName; |
| | | 21 | | |
| | 12 | 22 | | builder.AppendLine("/// <summary>"); |
| | 12 | 23 | | builder.AppendLine($"/// Strongly-typed service provider implementing <see cref=\"{provider.TypeName}\"/>."); |
| | 12 | 24 | | builder.AppendLine("/// </summary>"); |
| | 12 | 25 | | builder.AppendLine("/// <remarks>"); |
| | 12 | 26 | | builder.AppendLine("/// <para>"); |
| | 12 | 27 | | builder.AppendLine("/// This provider is registered as a <b>Singleton</b>. All service properties are resolved") |
| | 12 | 28 | | builder.AppendLine("/// at construction time via constructor injection for fail-fast error detection."); |
| | 12 | 29 | | builder.AppendLine("/// </para>"); |
| | 12 | 30 | | builder.AppendLine("/// <para>"); |
| | 12 | 31 | | builder.AppendLine("/// To create new instances on demand, use factory properties instead of direct service refe |
| | 12 | 32 | | builder.AppendLine("/// </para>"); |
| | 12 | 33 | | builder.AppendLine("/// </remarks>"); |
| | 12 | 34 | | builder.AppendLine("[global::System.CodeDom.Compiler.GeneratedCodeAttribute(\"NexusLabs.Needlr.Generators\", \"1 |
| | 12 | 35 | | builder.AppendLine($"public sealed class {implName} : {provider.TypeName}"); |
| | 12 | 36 | | builder.AppendLine("{"); |
| | | 37 | | |
| | | 38 | | // Generate constructor with all properties (Required, Optional, Collection, Factory) |
| | | 39 | | // Optional parameters must come last in C# |
| | 12 | 40 | | var injectableProps = provider.Properties |
| | 5 | 41 | | .OrderBy(p => p.Kind == ProviderPropertyKind.Optional ? 1 : 0) |
| | 12 | 42 | | .ToList(); |
| | | 43 | | |
| | 12 | 44 | | var ctorParams = injectableProps.Select(p => |
| | 12 | 45 | | { |
| | 15 | 46 | | var paramName = GeneratorHelpers.ToCamelCase(p.PropertyName); |
| | 15 | 47 | | if (p.Kind == ProviderPropertyKind.Optional) |
| | 12 | 48 | | { |
| | 2 | 49 | | return $"{p.ServiceTypeName}? {paramName} = null"; |
| | 12 | 50 | | } |
| | 13 | 51 | | return $"{p.ServiceTypeName} {paramName}"; |
| | 12 | 52 | | }); |
| | | 53 | | |
| | 12 | 54 | | var ctorParamList = string.Join(", ", ctorParams); |
| | | 55 | | |
| | 12 | 56 | | builder.AppendLine($" /// <summary>"); |
| | 12 | 57 | | builder.AppendLine($" /// Creates a new instance of <see cref=\"{implName}\"/>."); |
| | 12 | 58 | | builder.AppendLine($" /// </summary>"); |
| | 12 | 59 | | builder.AppendLine($" public {implName}({ctorParamList})"); |
| | 12 | 60 | | builder.AppendLine(" {"); |
| | | 61 | | |
| | 54 | 62 | | foreach (var prop in injectableProps) |
| | | 63 | | { |
| | 15 | 64 | | var paramName = GeneratorHelpers.ToCamelCase(prop.PropertyName); |
| | 15 | 65 | | builder.AppendLine($" {prop.PropertyName} = {paramName};"); |
| | | 66 | | } |
| | | 67 | | |
| | 12 | 68 | | builder.AppendLine(" }"); |
| | 12 | 69 | | builder.AppendLine(); |
| | | 70 | | |
| | | 71 | | // Generate properties |
| | 54 | 72 | | foreach (var prop in provider.Properties) |
| | | 73 | | { |
| | 15 | 74 | | var propTypeName = prop.Kind == ProviderPropertyKind.Optional |
| | 15 | 75 | | ? $"{prop.ServiceTypeName}?" |
| | 15 | 76 | | : prop.ServiceTypeName; |
| | | 77 | | |
| | 15 | 78 | | builder.AppendLine($" /// <inheritdoc />"); |
| | 15 | 79 | | builder.AppendLine($" public {propTypeName} {prop.PropertyName} {{ get; }}"); |
| | | 80 | | } |
| | | 81 | | |
| | 12 | 82 | | builder.AppendLine("}"); |
| | 12 | 83 | | } |
| | | 84 | | |
| | | 85 | | /// <summary> |
| | | 86 | | /// Generates interface and partial class for shorthand [Provider(typeof(T))] on a class. |
| | | 87 | | /// </summary> |
| | | 88 | | internal static void GenerateProviderInterfaceAndPartialClass(StringBuilder builder, DiscoveredProvider provider, st |
| | | 89 | | { |
| | 6 | 90 | | var interfaceName = provider.InterfaceTypeName; |
| | 6 | 91 | | var className = provider.SimpleTypeName; |
| | | 92 | | |
| | | 93 | | // Generate interface |
| | 6 | 94 | | builder.AppendLine("/// <summary>"); |
| | 6 | 95 | | builder.AppendLine($"/// Interface for strongly-typed service provider generated from <see cref=\"{provider.Type |
| | 6 | 96 | | builder.AppendLine("/// </summary>"); |
| | 6 | 97 | | builder.AppendLine("[global::System.CodeDom.Compiler.GeneratedCodeAttribute(\"NexusLabs.Needlr.Generators\", \"1 |
| | 6 | 98 | | builder.AppendLine($"public interface {interfaceName}"); |
| | 6 | 99 | | builder.AppendLine("{"); |
| | | 100 | | |
| | 26 | 101 | | foreach (var prop in provider.Properties) |
| | | 102 | | { |
| | 7 | 103 | | var propTypeName = prop.Kind == ProviderPropertyKind.Optional |
| | 7 | 104 | | ? $"{prop.ServiceTypeName}?" |
| | 7 | 105 | | : prop.ServiceTypeName; |
| | | 106 | | |
| | 7 | 107 | | builder.AppendLine($" /// <summary>Gets the {prop.PropertyName} service.</summary>"); |
| | 7 | 108 | | builder.AppendLine($" {propTypeName} {prop.PropertyName} {{ get; }}"); |
| | | 109 | | } |
| | | 110 | | |
| | 6 | 111 | | builder.AppendLine("}"); |
| | 6 | 112 | | builder.AppendLine(); |
| | | 113 | | |
| | | 114 | | // Generate partial class implementation |
| | 6 | 115 | | builder.AppendLine("/// <summary>"); |
| | 6 | 116 | | builder.AppendLine("/// Strongly-typed service provider."); |
| | 6 | 117 | | builder.AppendLine("/// </summary>"); |
| | 6 | 118 | | builder.AppendLine("/// <remarks>"); |
| | 6 | 119 | | builder.AppendLine("/// <para>"); |
| | 6 | 120 | | builder.AppendLine("/// This provider is registered as a <b>Singleton</b>. All service properties are resolved") |
| | 6 | 121 | | builder.AppendLine("/// at construction time via constructor injection for fail-fast error detection."); |
| | 6 | 122 | | builder.AppendLine("/// </para>"); |
| | 6 | 123 | | builder.AppendLine("/// </remarks>"); |
| | 6 | 124 | | builder.AppendLine($"public partial class {className} : {interfaceName}"); |
| | 6 | 125 | | builder.AppendLine("{"); |
| | | 126 | | |
| | | 127 | | // Generate constructor with all properties (Required, Optional, Collection, Factory) |
| | | 128 | | // Optional parameters must come last in C# |
| | 6 | 129 | | var injectableProps = provider.Properties |
| | 2 | 130 | | .OrderBy(p => p.Kind == ProviderPropertyKind.Optional ? 1 : 0) |
| | 6 | 131 | | .ToList(); |
| | | 132 | | |
| | 6 | 133 | | var ctorParams = injectableProps.Select(p => |
| | 6 | 134 | | { |
| | 7 | 135 | | var paramName = GeneratorHelpers.ToCamelCase(p.PropertyName); |
| | 7 | 136 | | if (p.Kind == ProviderPropertyKind.Optional) |
| | 6 | 137 | | { |
| | 2 | 138 | | return $"{p.ServiceTypeName}? {paramName} = null"; |
| | 6 | 139 | | } |
| | 5 | 140 | | return $"{p.ServiceTypeName} {paramName}"; |
| | 6 | 141 | | }); |
| | | 142 | | |
| | 6 | 143 | | var ctorParamList = string.Join(", ", ctorParams); |
| | | 144 | | |
| | 6 | 145 | | builder.AppendLine($" /// <summary>"); |
| | 6 | 146 | | builder.AppendLine($" /// Creates a new instance of <see cref=\"{className}\"/>."); |
| | 6 | 147 | | builder.AppendLine($" /// </summary>"); |
| | 6 | 148 | | builder.AppendLine($" public {className}({ctorParamList})"); |
| | 6 | 149 | | builder.AppendLine(" {"); |
| | | 150 | | |
| | 26 | 151 | | foreach (var prop in injectableProps) |
| | | 152 | | { |
| | 7 | 153 | | var paramName = GeneratorHelpers.ToCamelCase(prop.PropertyName); |
| | 7 | 154 | | builder.AppendLine($" {prop.PropertyName} = {paramName};"); |
| | | 155 | | } |
| | | 156 | | |
| | 6 | 157 | | builder.AppendLine(" }"); |
| | 6 | 158 | | builder.AppendLine(); |
| | | 159 | | |
| | | 160 | | // Generate properties |
| | 26 | 161 | | foreach (var prop in provider.Properties) |
| | | 162 | | { |
| | 7 | 163 | | var propTypeName = prop.Kind == ProviderPropertyKind.Optional |
| | 7 | 164 | | ? $"{prop.ServiceTypeName}?" |
| | 7 | 165 | | : prop.ServiceTypeName; |
| | | 166 | | |
| | 7 | 167 | | builder.AppendLine($" /// <inheritdoc />"); |
| | 7 | 168 | | builder.AppendLine($" public {propTypeName} {prop.PropertyName} {{ get; }}"); |
| | | 169 | | } |
| | | 170 | | |
| | 6 | 171 | | builder.AppendLine("}"); |
| | 6 | 172 | | } |
| | | 173 | | |
| | | 174 | | /// <summary> |
| | | 175 | | /// Generates provider registration code for the TypeRegistry. |
| | | 176 | | /// </summary> |
| | | 177 | | internal static void GenerateProviderRegistration(StringBuilder builder, DiscoveredProvider provider, string generat |
| | | 178 | | { |
| | 0 | 179 | | var interfaceTypeName = provider.IsInterface |
| | 0 | 180 | | ? provider.TypeName |
| | 0 | 181 | | : $"global::{GetNamespace(provider.TypeName)}.{provider.InterfaceTypeName}"; |
| | | 182 | | |
| | 0 | 183 | | var implTypeName = provider.IsInterface |
| | 0 | 184 | | ? $"global::{generatedNamespace}.{provider.ImplementationTypeName}" |
| | 0 | 185 | | : provider.TypeName; |
| | | 186 | | |
| | 0 | 187 | | builder.AppendLine($" // Provider: {provider.SimpleTypeName}"); |
| | 0 | 188 | | builder.AppendLine($" services.AddSingleton<{interfaceTypeName}, {implTypeName}>();"); |
| | 0 | 189 | | } |
| | | 190 | | |
| | | 191 | | private static string GetNamespace(string fullyQualifiedName) |
| | | 192 | | { |
| | 0 | 193 | | if (fullyQualifiedName.StartsWith("global::")) |
| | | 194 | | { |
| | 0 | 195 | | fullyQualifiedName = fullyQualifiedName.Substring(8); |
| | | 196 | | } |
| | | 197 | | |
| | 0 | 198 | | var lastDot = fullyQualifiedName.LastIndexOf('.'); |
| | 0 | 199 | | return lastDot >= 0 ? fullyQualifiedName.Substring(0, lastDot) : string.Empty; |
| | | 200 | | } |
| | | 201 | | } |