mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-23 03:04:29 +08:00
16d8cad4f3
- 修改 MicrosoftDiContainer 中 GetAllByPriority 方法的排序逻辑，使用 OrderBy 确保稳定排序 - 修正注释中的中文描述，明确优先级排序规则 - 将 PriorityUsageAnalyzer 中的硬编码诊断规则替换为统一的 PriorityDiagnostic - 在 PriorityGenerator 中添加对嵌套类的支持检查，报告 GF_Priority_005 错误 - 改进生成文件的命名策略，使用完整元数据名称避免冲突 - 更新 AnalyzerReleases.Unshipped.md 文档，添加新的诊断规则说明 - 移除 PriorityGeneratorSnapshotTests 中关于嵌套类的测试用例
89 lines
3.6 KiB
C#
89 lines
3.6 KiB
C#
using Microsoft.CodeAnalysis;
|
|
|
|
namespace GFramework.SourceGenerators.diagnostics;
|
|
|
|
/// <summary>
|
|
/// Priority 特性相关的诊断信息
|
|
/// </summary>
|
|
internal static class PriorityDiagnostic
|
|
{
|
|
private const string Category = "GFramework.Priority";
|
|
|
|
/// <summary>
|
|
/// GF_Priority_001: Priority 特性只能应用于类
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor OnlyApplyToClass = new(
|
|
id: "GF_Priority_001",
|
|
title: "Priority 特性只能应用于类",
|
|
messageFormat: "Priority 特性只能应用于类，不能应用于 '{0}'",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Error,
|
|
isEnabledByDefault: true,
|
|
description: "Priority 特性设计用于类级别的优先级标记，不支持其他类型。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_002: 类已手动实现 IPrioritized 接口
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor AlreadyImplemented = new(
|
|
id: "GF_Priority_002",
|
|
title: "类已实现 IPrioritized 接口",
|
|
messageFormat: "类 '{0}' 已手动实现 IPrioritized 接口，将跳过自动生成",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Warning,
|
|
isEnabledByDefault: true,
|
|
description: "当类已经手动实现 IPrioritized 接口时，源生成器将跳过代码生成以避免冲突。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_003: 类必须声明为 partial
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor MustBePartial = new(
|
|
id: "GF_Priority_003",
|
|
title: "类必须声明为 partial",
|
|
messageFormat: "类 '{0}' 使用了 Priority 特性，必须声明为 partial",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Error,
|
|
isEnabledByDefault: true,
|
|
description: "源生成器需要在 partial 类中生成 IPrioritized 接口实现。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_004: Priority 值缺失或无效
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor InvalidValue = new(
|
|
id: "GF_Priority_004",
|
|
title: "Priority 值无效",
|
|
messageFormat: "Priority 特性的值无效或缺失",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Error,
|
|
isEnabledByDefault: true,
|
|
description: "Priority 特性必须提供一个有效的整数值。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_005: Priority 不支持嵌套类
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor NestedClassNotSupported = new(
|
|
id: "GF_Priority_005",
|
|
title: "Priority 不支持嵌套类",
|
|
messageFormat: "Priority 特性不支持嵌套类 '{0}'，请将类移至顶层",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Error,
|
|
isEnabledByDefault: true,
|
|
description: "Priority 特性仅支持顶层类，不支持嵌套类。请将嵌套类移至命名空间级别。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_Usage_001: 建议使用 GetAllByPriority
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor SuggestGetAllByPriority = new(
|
|
id: "GF_Priority_Usage_001",
|
|
title: "建议使用 GetAllByPriority",
|
|
messageFormat: "类型 '{0}' 实现了 IPrioritized 接口，建议使用 GetAllByPriority<{0}>() 而非 GetAll<{0}>()",
|
|
category: "GFramework.Usage",
|
|
defaultSeverity: DiagnosticSeverity.Info,
|
|
isEnabledByDefault: true,
|
|
description: "当获取实现了 IPrioritized 接口的服务时，应使用 GetAllByPriority 方法以确保按优先级排序。"
|
|
);
|
|
} |