暂时更改一部分Skill
This commit is contained in:
1 parent
84b28f9672
commit
6d4629e4ac
53 files changed
+5293
-10
No files matched your search
@@ -0,0 +1,97 @@
|
||||
---
|
||||
name: add-service
|
||||
description: >-
|
||||
在 PipeReviewReport 客户端中新建一个带接口的 Service,并通过 AutoFac 自动注册。
|
||||
当用户需要添加新的业务服务、数据服务、或状态管理服务时使用。
|
||||
disable-model-invocation: false
|
||||
---
|
||||
|
||||
# 新建客户端 Service
|
||||
|
||||
## 根据生命周期选择模式
|
||||
|
||||
| 需求 | 实现接口 |
|
||||
|------|---------|
|
||||
| 单例,无需初始化 | `ISingletonDependency` |
|
||||
| 单例,需要异步启动初始化 | `ISingletonDependency` + `IAppInitializeAsync` |
|
||||
| 单例,需要同步启动初始化 | `ISingletonDependency` + `IAppInitialize` |
|
||||
| 单例,需要在应用关闭时清理 | + `IAppClosedHandler` |
|
||||
|
||||
## 模板
|
||||
|
||||
### 最简单的单例 Service
|
||||
|
||||
```csharp
|
||||
using MAX.Core.DependencyInjections;
|
||||
|
||||
namespace PipeReviewReport.<模块名>.Services;
|
||||
|
||||
public interface IXxxService
|
||||
{
|
||||
void DoSomething();
|
||||
}
|
||||
|
||||
internal class XxxService : IXxxService, ISingletonDependency
|
||||
{
|
||||
public void DoSomething() { }
|
||||
}
|
||||
```
|
||||
|
||||
### 需要启动初始化的 Service
|
||||
|
||||
```csharp
|
||||
using MAX.Core.DependencyInjections;
|
||||
using MAX.Core.Interfaces;
|
||||
|
||||
namespace PipeReviewReport.<模块名>.Services;
|
||||
|
||||
public interface IXxxService { }
|
||||
|
||||
internal class XxxService(IGrpcService grpcService) : IXxxService, IAppInitializeAsync
|
||||
{
|
||||
string IAppInitializeAsync.Description { get; } = "初始化 Xxx 中";
|
||||
int IPriority.Priority { get; } = IntPriority.Normal;
|
||||
|
||||
async Task IAppInitializeAsync.AppInitializeAsync(IStatusReport statusReport)
|
||||
{
|
||||
// 异步初始化逻辑
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 需要初始化 + 关闭清理的 Service
|
||||
|
||||
```csharp
|
||||
internal class XxxService(IGrpcService grpcService) : IXxxService, IAppInitializeAsync, IAppClosedHandler
|
||||
{
|
||||
string IAppInitializeAsync.Description { get; } = "初始化 Xxx 中";
|
||||
int IPriority.Priority { get; } = IntPriority.Normal;
|
||||
|
||||
int IAppClosedHandler.Priority { get; } = IntPriority.Normal;
|
||||
string IAppClosedHandler.Description { get; } = "关闭 Xxx 中";
|
||||
|
||||
async Task IAppInitializeAsync.AppInitializeAsync(IStatusReport statusReport)
|
||||
{
|
||||
// 初始化
|
||||
}
|
||||
|
||||
void IAppClosedHandler.AppClosed(AppCloseParameter parameter)
|
||||
{
|
||||
// 清理资源
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 实现 `ISingletonDependency` 后 AutoFac **自动注册为单例**,无需手动注册
|
||||
- 实现 `IAppInitializeAsync` / `IAppInitialize` 时必须同时实现 `IPriority`(提供 `Priority` 属性)
|
||||
- 接口定义 `public`,实现类 `internal`
|
||||
- 优先级使用 `IntPriority` 常量(`VeryHigh`、`High`、`Normal`、`Lower`、`VeryLow`)
|
||||
|
||||
## 检查清单
|
||||
|
||||
- [ ] 接口 `public`,实现类 `internal`
|
||||
- [ ] 根据需要选择了正确的生命周期接口组合
|
||||
- [ ] 有初始化/关闭逻辑时实现了 `Description` 和 `Priority`
|
||||
- [ ] 使用 Primary Constructor 注入依赖
|
||||
Reference in new issue
Block a user