服务注册

Sharkable 支持两种自动依赖注入方式——属性 和 标记接口。两者都在启动时扫描，将类注册为其所有业务接口（如果没有基类则注册自身）。

可用属性

属性	生命周期	适用场景
[ScopedService]	Scoped	每次 HTTP 请求一个实例（DbContext、请求级缓存）
[TransientService]	Transient	每次注入一个新实例（轻量、无状态服务）
[SingletonService]	Singleton	整个应用生命周期一个实例（配置、缓存、线程安全服务）

标记接口（替代方式）

除了属性，也可以实现三个标记接口之一：

接口	生命周期
ISingleton	Singleton
IScoped	Scoped
ITransient	Transient

public class UserService : IUserService, IScoped
{
    public Task<User?> GetByIdAsync(int id) => /* ... */;
}

标记接口本身不会被注册为服务类型——只注册业务接口、基类或类自身。

每个类应实现恰好一个标记接口。如果实现了多个（如同时实现 IScoped + ISingleton），按优先级取第一个：ISingleton > IScoped > ITransient。

属性和标记接口可以在同一个项目中混用——两种风格独立扫描。

用法

直接在实现类上标记属性：

[ScopedService]
public class UserService
{
    public Task<User?> GetByIdAsync(int id) => /* ... */;
}

框架在 AddShark() 期间扫描所有注册的程序集，自动注册：

• 类实现的所有接口 → 每个接口解析到同一个实例（Scoped 生命周期）
• 类自身（如果没有任何接口，或基类是 object）
• 基类型（如果继承自非 object 基类）

// 自动注册——无需手动 builder.Services.Add*()
builder.Services.AddShark([typeof(Program).Assembly]);

配合接口使用

public interface IProductService
{
    Product? Get(int id);
}

[ScopedService]
public class ProductService : IProductService
{
    public Product? Get(int id) => /* ... */;
}

// 通过接口注入
public class MyEndpoint : ISharkEndpoint
{
    private readonly IProductService _products;
    public MyEndpoint(IProductService products) => _products = products;
}

自注册（无接口）

[SingletonService]
public class AppConfiguration
{
    public string StoragePath { get; set; } = "./data";
}

// 直接注入
public class MyEndpoint(IConfiguration config, AppConfiguration appConfig) : ISharkEndpoint;

基类型注册

public abstract class BaseRepository
{
    protected string ConnectionString { get; }
}

[ScopedService]
public class UserRepository : BaseRepository
{
    public User? Find(int id) => /* ... */;
}

// 同时注册了 BaseRepository 和 UserRepository 的接口
// 注入 BaseRepository 返回 UserRepository 实例

注册细节

服务注册在 AddShark() 期间的 AddCommon() 中完成：

1. Sharkable 收集的所有程序集被扫描，查找标记了 [ScopedService]、[TransientService] 或 [SingletonService] 的类型
2. 同时扫描实现了 ISingleton、IScoped 或 ITransient 的类
3. 对每个类型，扫描器查找所有可赋值的具体实现
4. 使用 TryAdd() 注册——如果在 AddShark() 之前手动注册了服务，则手动注册优先
5. 泛型类型定义自动解析——发现并注册具体的封闭泛型类型

验证

• 属性可应用于 Interface 或 Class 目标；标记接口只能在类上实现
• AllowMultiple 为 false——一个类只能有一个生命周期属性。同样，建议每个类只实现一个标记接口
• 每个生命周期组内的注册顺序是确定的，但不应该依赖此顺序