mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 19:03:29 +08:00
- 将 LogAttribute 的 Category 属性改为可设置 - 添加了无参构造函数支持 - 移除了部分无效的诊断检查代码 - 为 LoggerGenerator 添加了可空引用类型支持 - 使用 switch 表达式简化参数解析逻辑 - 优化了命名参数获取方法的实现
161 lines
6.7 KiB
C#
161 lines
6.7 KiB
C#
#nullable enable
|
|
using System;
|
|
using System.Linq;
|
|
using System.Text;
|
|
using Microsoft.CodeAnalysis;
|
|
using Microsoft.CodeAnalysis.CSharp;
|
|
using Microsoft.CodeAnalysis.CSharp.Syntax;
|
|
using Microsoft.CodeAnalysis.Text;
|
|
|
|
namespace GFramework.Generator.generator.logging
|
|
{
|
|
[Generator]
|
|
public sealed class LoggerGenerator : IIncrementalGenerator
|
|
{
|
|
// 请确保这里的命名空间和类名与 Attributes 项目中定义的完全一致(注意大小写!)
|
|
private const string AttributeMetadataName = "GFramework.Generator.Attributes.generator.logging.LogAttribute";
|
|
private const string AttributeShortName = "LogAttribute";
|
|
private const string AttributeShortNameWithoutSuffix = "Log";
|
|
|
|
public void Initialize(IncrementalGeneratorInitializationContext context)
|
|
{
|
|
// 1. 语法过滤:快速筛选候选类
|
|
var targets = context.SyntaxProvider.CreateSyntaxProvider(
|
|
static (node, _) =>
|
|
{
|
|
if (node is not ClassDeclarationSyntax cls) return false;
|
|
// 只要包含 Log 字眼的 Attribute 就先放行
|
|
return cls.AttributeLists.SelectMany(a => a.Attributes).Any(a =>
|
|
{
|
|
var name = a.Name.ToString();
|
|
// 简单的字符串匹配,防止错过别名情况
|
|
return name.Contains(AttributeShortNameWithoutSuffix);
|
|
});
|
|
},
|
|
static (ctx, _) =>
|
|
{
|
|
var classDecl = (ClassDeclarationSyntax)ctx.Node;
|
|
var symbol = ctx.SemanticModel.GetDeclaredSymbol(classDecl);
|
|
return (ClassDecl: classDecl, Symbol: symbol);
|
|
})
|
|
.Where(x => x.Symbol is not null);
|
|
|
|
// 2. 生成代码
|
|
context.RegisterSourceOutput(targets, (spc, pair) =>
|
|
{
|
|
try
|
|
{
|
|
var classDecl = pair.ClassDecl;
|
|
var classSymbol = pair.Symbol!;
|
|
|
|
// 再次确认是否真的含有目标 Attribute (语义检查)
|
|
var attr = GetAttribute(classSymbol);
|
|
if (attr == null) return; // 可能是名字相似但不是我们要的 Attribute
|
|
|
|
// 检查 partial
|
|
if (!classDecl.Modifiers.Any(SyntaxKind.PartialKeyword))
|
|
{
|
|
spc.ReportDiagnostic(Diagnostic.Create(
|
|
Diagnostics.MustBePartial,
|
|
classDecl.Identifier.GetLocation(),
|
|
classSymbol.Name));
|
|
|
|
return;
|
|
}
|
|
|
|
var source = Generate(classSymbol, attr);
|
|
var hintName = $"{classSymbol.Name}.Logger.g.cs";
|
|
spc.AddSource(hintName, SourceText.From(source, Encoding.UTF8));
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
// === 关键修复:生成错误报告文件 ===
|
|
var errorSource = $"// source generator error: {ex.Message}\n// StackTrace:\n// {ex.StackTrace}";
|
|
// 替换非法字符以防文件名报错
|
|
var safeName = pair.Symbol?.Name ?? "Unknown";
|
|
spc.AddSource($"{safeName}.Logger.Error.g.cs", SourceText.From(errorSource, Encoding.UTF8));
|
|
}
|
|
});
|
|
}
|
|
|
|
private static AttributeData? GetAttribute(INamedTypeSymbol classSymbol)
|
|
{
|
|
return classSymbol.GetAttributes().FirstOrDefault(a =>
|
|
{
|
|
var cls = a.AttributeClass;
|
|
if (cls == null) return false;
|
|
|
|
// 宽松匹配:全名匹配 OR 名字匹配
|
|
return cls.ToDisplayString() == AttributeMetadataName ||
|
|
cls.Name == AttributeShortName;
|
|
});
|
|
}
|
|
|
|
private static string Generate(INamedTypeSymbol classSymbol, AttributeData attr)
|
|
{
|
|
var ns = classSymbol.ContainingNamespace.IsGlobalNamespace
|
|
? null
|
|
: classSymbol.ContainingNamespace.ToDisplayString();
|
|
|
|
var className = classSymbol.Name;
|
|
|
|
// === 解析 Category ===
|
|
var category = className; // 默认使用类名
|
|
|
|
// 检查是否有构造函数参数
|
|
if (attr.ConstructorArguments.Length > 0)
|
|
{
|
|
var argValue = attr.ConstructorArguments[0].Value;
|
|
|
|
category = argValue switch
|
|
{
|
|
// 情况 1: 参数存在,但值为 null (例如 [Log] 且构造函数有默认值 null)
|
|
null => className,
|
|
// 情况 2: 参数存在,且是有效的字符串 (例如 [Log("MyCategory")])
|
|
string s when !string.IsNullOrWhiteSpace(s) => s,
|
|
_ => $"{className}_InvalidArg"
|
|
};
|
|
}
|
|
|
|
// === 解析 Named Arguments (更加安全的获取方式) ===
|
|
var fieldName = GetNamedArg(attr, "FieldName")?.ToString() ?? "_log";
|
|
var access =
|
|
GetNamedArg(attr, "AccessModifier")?.ToString() ??
|
|
"private"; // 注意:如果你的 AccessModifier 是枚举,这里得到的可能是 int 或枚举名
|
|
|
|
// 处理 bool 类型
|
|
var isStaticObj = GetNamedArg(attr, "IsStatic");
|
|
var isStatic = isStaticObj is not bool b || b; // 默认为 true
|
|
|
|
var staticKeyword = isStatic ? "static " : "";
|
|
|
|
var sb = new StringBuilder();
|
|
sb.AppendLine("// <auto-generated />");
|
|
sb.AppendLine("using GFramework.Core.logging;"); // 确保这里引用了 ILog 和 Log 类
|
|
|
|
if (ns is not null)
|
|
{
|
|
sb.AppendLine($"namespace {ns}");
|
|
sb.AppendLine("{");
|
|
}
|
|
|
|
sb.AppendLine($" public partial class {className}");
|
|
sb.AppendLine(" {");
|
|
sb.AppendLine($" /// <summary>Auto-generated logger</summary>");
|
|
sb.AppendLine(
|
|
$" {access} {staticKeyword}readonly ILog {fieldName} = " +
|
|
$"Log.CreateLogger(\"{category}\");");
|
|
sb.AppendLine(" }");
|
|
|
|
if (ns is not null)
|
|
sb.AppendLine("}");
|
|
|
|
return sb.ToString();
|
|
}
|
|
|
|
private static object? GetNamedArg(AttributeData attr, string name)
|
|
{
|
|
return (from kv in attr.NamedArguments where kv.Key == name select kv.Value.Value).FirstOrDefault();
|
|
}
|
|
}
|
|
} |