Smart.WebAPI.Template 4.0.1

Smart.WebAPI.Template

基于ASP.NET Core 8/9平台的WebAPI快速开发框架，集成服务自动注册、模块化认证、生产级日志等企业级特性。

核心特性

基础架构

• 跨平台支持：兼容Windows/Linux/macOS
• 服务自动注册：基于Smart.Inject的自动依赖注入
• 高性能日志：NLog组件支持异步日志和结构化日志
• 编码扩展：内置GBK/GB2312中文编码支持

预置模块

快速开始

环境要求

• .NET SDK 8.0+
• Visual Studio 2022 或 JetBrains Rider
• PostgreSQL 14+ (或其他兼容数据库)

安装

bash
dotnet new install Smart.WebAPI.Template

创建项目

bash
dotnet new smart.api -n MyDemo

添加服务

csharp
// 实现 IHostedService
public class DemoService : BackgroundService
{
  protected override Task ExecuteAsync(CancellationToken stoppingToken)
  {
    // 你的业务逻辑
  }
}

// 通过特性自动注册
[Service(ServiceLifetime.Singleton, InjectScheme.OnlySelf)]
public class DataService
{
  // 你的业务逻辑
}

部署要求

必须使用「依赖框架」部署模式
项目发布时请使用以下命令配置（目标框架由您指定，此处为net8.0）：

bash
dotnet publish -c Release --self-contained false -f net8.0

推荐搭配 .NET 运行时安装脚本 部署

开发建议

服务注册约定

用户需要了解Smart.Inject框架的用法，访问Smart.Inject。

Developed by zenglei