首页 资讯中心 文章详情

Web API C# (Furion版）

发布时间：2026/7/31 11:27:31
Web API C# (Furion版） 這是官網https://furion.net/docs/category/appendix主要做的是一個後端API接口程序給前端訪問。用C#ASP .net開發框架用了FurionFurion EFCore 脚手架安装下载Furiondotnet new install Furion.Template.Api::4.9.5.21不带版本号总是安装最新的版本根据需要来创建项目# 命令模板如下dotnet new 关键词 -n 项目名称 -f .NET版本# EFCore支持创建 .NET5-8 版本D:\Projects\VS\TestWebdotnet new furionapi -n EmployeeApi -f net7範本「Furion Api」已成功建立。範本套件 Furion.Template.Api4.9.5.21 有可用的更新。若要更新套件請使用:dotnet new install Furion.Template.Api4.9.9.45D:\Projects\VS\TestWeb运行demo创建完就能用vs打开了注意这边有很多项目都是一个解决方案。把EmployeeApi.Web.Entry设置成启动程序。就能运行项目了里面有一个demo项目结构Application 放业务逻辑就是servicedtoCore 放modelsDatabse.Migrations 数据库迁移 EF coreEntityFramework.core 放DbContextweb.core web组件Entry 程序入口Program.cs Controllers创建模型Employee.csusing Furion.DatabaseAccessor; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace EmployeeApi.Core.Models { public class Employee : Entity { //Entity //无需定义 Id 属性 // 并自动添加 CreatedTimeUpdatedTime 属性 public string Name { get; set; } public int Age { get; set; } public string Dept { get; set; } } }数据库配置数据库上下文EmployeeDbContext.csusing EmployeeApi.Core.Models; using Furion.DatabaseAccessor; using Microsoft.EntityFrameworkCore; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace EmployeeApi.EntityFramework.Core.DbContexts { [AppDbContext(MyDb, DbProvider.Sqlite)] public class EmployeeDbContext : AppDbContextEmployeeDbContext { public EmployeeDbContext(DbContextOptionsEmployeeDbContext options) : base(options) { } public DbSetEmployee employees { get; set; } } }配置数据库链接参考SqliteData Source./Furion.dbMySqlData Sourcelocalhost;DatabaseFurion;User IDroot;Password000000;poolingtrue;port3306;sslmodenone;CharSetutf8;SqlServerServerlocalhost;DatabaseFurion;Usersa;Password000000;MultipleActiveResultSetsTrue;OracleUser Idorcl;Passwordorcl;Data Source(DESCRIPTION(ADDRESS_LIST(ADDRESS(PROTOCOLTCP)(HOST127.0.0.1)(PORT1521)))(CONNECT_DATA(SERVICE_NAMEorcl)))PostgreSQLPORT5432;DATABASEpostgres;HOST127.0.0.1;PASSWORDpostgres;USER IDpostgres;appsettings.json{ $schema: https://gitee.com/dotnetchina/Furion/raw/v4/schemas/v4/furion-schema.json, Logging: { LogLevel: { Default: Information, Microsoft.AspNetCore: Warning, Microsoft.EntityFrameworkCore: Information } }, AllowedHosts: *, ConnectionStrings: { MyDb: Data SourceD:\\Projects\\VS\\TestWeb\\EmployeeApi\\app.db } }注册该数据库上下文Startup.csusing EmployeeApi.EntityFramework.Core.DbContexts; using Furion; using Microsoft.Extensions.DependencyInjection; namespace EmployeeApi.EntityFramework.Core; public class Startup : AppStartup { public void ConfigureServices(IServiceCollection services) { services.AddDatabaseAccessor(options { options.AddDbPoolDefaultDbContext(); options.AddDbPoolEmployeeDbContext(); //注册数据库上下文 }, EmployeeApi.Database.Migrations); } }模型生成数据库code first方法一用cmd或者powershell用命令安装在\EmployeeApi.Database.Migrations项目下面dotnet add package Microsoft.EntityFrameworkCore.Sqlitedotnet add package Microsoft.EntityFrameworkCore.Designdotnet tool install --global dotnet-ef注意因为这边没有用最新的.net所以你用vs 界面去找对应版本dotnet tool install --global dotnet-ef --version 7.* 也要是对应版本运行下面命令要在EmployeeApi.Web.Entry启动项目下面运行dotnet ef database update --context EmployeeDbContext --project ../EmployeeApi.Database.Migrationsdotnet ef database update --context EmployeeDbContext --project ../EmployeeApi.Database.Migrations成功后app.db就有了参考dotnet ef migrations add InitialCreate_MyProject \--context MyProjectDbContext \ # 为这个 DbContext 生成迁移--output-dir Migrations \ # 生成的迁移文件放在 Migrations 文件夹下--project ../MyProject.Database.Migrations # 把整个 Migrations 文件夹放到这个项目里方法二执行Add-Migration -Context EmployeeDbContext v1.0.0Update-Database -Context EmployeeDbContextController准备dtoserviceDTO这边就写一个也可以写多个比如添加员工写一个更新写一个。EmployeeDto.csusing System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace EmployeeApi.Application.EmployeeManage.Dtos { public class EmployeeDto { public string Name { get; set; } public int Age { get; set; } public string Dept { get; set; } } }service以接口形式写方便以后拓展IEmployeeService.csusing EmployeeApi.Application.EmployeeManage.Dtos; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace EmployeeApi.Application.EmployeeManage.Services { public interface IEmployeeService { TaskListEmployeeDto GetEmoloyeesAsync(); TaskEmployeeDto GetEmployeeByIdAsync(int id); Taskint CreateEmployeeAsync(EmployeeDto employeeDto); Taskbool UpdateEmployeeAsync(EmployeeDto employeeDto); Taskbool DeleteEmployeeAsync(int id); } }注意ITransient一定要有。三种注册的生命周期一般就用这个EmployeeService.csusing EmployeeApi.Application.EmployeeManage.Dtos; using EmployeeApi.EntityFramework.Core.DbContexts; using EmployeeApi.Core.Models; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace EmployeeApi.Application.EmployeeManage.Services { public class EmployeeService : IEmployeeService, ITransient { private readonly EmployeeDbContext _employeeDbContext; public EmployeeService(EmployeeDbContext employeeDbContext) { _employeeDbContext employeeDbContext; } public async Taskint CreateEmployeeAsync(EmployeeDto employeeDto) { var employee new Employee { Name employeeDto.Name, Age employeeDto.Age, Dept employeeDto.Dept }; await _employeeDbContext.employees.AddAsync(employee); await _employeeDbContext.SaveChangesAsync(); return employee.Id; } public async Taskbool DeleteEmployeeAsync(int id) { var employee await _employeeDbContext.employees.FindAsync(id); if (employee null) { return false; } _employeeDbContext.employees.Remove(employee); await _employeeDbContext.SaveChangesAsync(); return true; } public async TaskListEmployeeDto GetEmoloyeesAsync() { return await _employeeDbContext.employees .Select(e new EmployeeDto { Name e.Name, Age e.Age, Dept e.Dept }) .ToListAsync(); } public async TaskEmployeeDto GetEmployeeByIdAsync(int id) { var employee await _employeeDbContext.employees.FindAsync(id); if (employee null) { return null; } var employeeDto new EmployeeDto { Name employee.Name, Age employee.Age, Dept employee.Dept }; return employeeDto; } public async Taskbool UpdateEmployeeAsync(UpdateEmployeeRequest request) { var employee await _employeeDbContext.employees.FindAsync(request.Id); if (employee null) { return false; } employee.Name request.Name; employee.Age request.Age; employee.Dept request.Dept; await _employeeDbContext.SaveChangesAsync(); return true; } } }controllerEmployeeController.csusing EmployeeApi.Application.EmployeeManage.Dtos; using EmployeeApi.Application.EmployeeManage.Services; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace EmployeeApi.Application.EmployeeManage { public class EmployeeController : IDynamicApiController { private readonly IEmployeeService _employeeService; public EmployeeController(IEmployeeService employeeService) { _employeeService employeeService; } [HttpPost] public async Taskint PostCreateEmployee(EmployeeDto employeeDto) { return await _employeeService.CreateEmployeeAsync(employeeDto); } [HttpGet] public async TaskListEmployeeDto GetAllEmployees() { return await _employeeService.GetEmoloyeesAsync(); } [HttpGet] public async TaskEmployeeDto GetEmployeeById(int id) { return await _employeeService.GetEmployeeByIdAsync(id); } [HttpPost] public async Taskbool UpdateEmployee(UpdateEmployeeRequest request) { return await _employeeService.UpdateEmployeeAsync(request); } [HttpPost] public async Taskbool DeleteEmployee(int id) { return await _employeeService.DeleteEmployeeAsync(id); } } }到这边就完成了运行项目就能测试了。进阶Mapster在过去我们需要将一个对象的值转换到另一个对象中我们需要这样做如var entity repository.Find(1); var dto new Dto(); dto.Id entity.Id; dto.Name entity.Name; dto.Age entity.Age; dto.Address entity.Address; dto.FullName entity.FirstName entity.LastName; dto.IdCard entity.IdCard.Replace(1234, ****);上面的例子似乎没有任何问题但是如果很多地方需要这样的赋值操作、或者相同的赋值操作在多个地方使用又或者一个类中含有非常多的属性或自定义赋值操作。那么这样的操作效率极低容易出错且代码非常臃肿和冗余。所以实现自动映射赋值和支持特殊配置的需求就有了。目前C#平台有两个优秀的对象映射工具Mapster和AutoMapper。在Furion框架中推荐使用MapsterMapster是一款极易使用且超高性能的对象映射框架。var dto employee.AdaptEmployeeDto();employee转EmployeeDto示例Employee → EmployeeDto字段完全一致如果两个类的字段名称完全一样不需要任何配置直接用 .Adapt() 就行。var dto employee.AdaptEmployeeDto(); // ✅ 字段名相同自动映射示例Employee → EmployeeDto字段名不同如果字段名不完全一致需要在 Mapper 中配置public class Employee { public int Id { get; set; } public string FullName { get; set; } // Model 里叫 FullName public int Age { get; set; } public string Department { get; set; } // Model 里叫 Department } public class EmployeeDto { public int Id { get; set; } public string Name { get; set; } // DTO 里叫 Name public int Age { get; set; } public string Dept { get; set; } // DTO 里叫 Dept }using Mapster; using EmployeeApi.Core.Models; using EmployeeApi.Application.EmployeeManage.Dtos; namespace EmployeeApi.Application; public class Mapper : IRegister { public void Register(TypeAdapterConfig config) { // 配置 Employee → EmployeeDto 的映射关系 config.NewConfigEmployee, EmployeeDto() .Map(dest dest.Name, src src.FullName) // FullName → Name .Map(dest dest.Dept, src src.Department); // Department → Dept // 配置 EmployeeDto → Employee反向映射用于创建/更新 config.NewConfigEmployeeDto, Employee() .Map(dest dest.FullName, src src.Name) .Map(dest dest.Department, src src.Dept); } }情况是否需要配置怎么做Model 字段比 DTO 多❌ 不需要直接.Adapt()多余的自动忽略Model 字段比 DTO 少❌ 不需要多余的 DTO 字段为null或默认值字段名相同❌ 不需要自动映射字段名不同✅ 需要在Mapper.cs中用.Map()配置需要忽略某个字段✅ 需要用.Ignore()明确忽略ProjectToTypeProjectToType 是 Mapster 提供的专门用于 EF Core 查询 的映射方法它的核心作用是在数据库层面执行映射只查询 DTO 需要的字段。参考例子using EmployeeApi.Application.EmployeeManage.Dtos; using EmployeeApi.EntityFramework.Core.DbContexts; using EmployeeApi.Core.Models; using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace EmployeeApi.Application.EmployeeManage.Services { public class EmployeeService : IEmployeeService, ITransient { private readonly EmployeeDbContext _employeeDbContext; public EmployeeService(EmployeeDbContext employeeDbContext) { _employeeDbContext employeeDbContext; } public async Taskint CreateEmployeeAsync(EmployeeDto employeeDto) { //var employee new Employee //{ // Name employeeDto.Name, // Age employeeDto.Age, // Dept employeeDto.Dept //}; var employee employeeDto.AdaptEmployee(); await _employeeDbContext.employees.AddAsync(employee); await _employeeDbContext.SaveChangesAsync(); return employee.Id; } public async Taskbool DeleteEmployeeAsync(int id) { var employee await _employeeDbContext.employees.FindAsync(id); if (employee null) { return false; } _employeeDbContext.employees.Remove(employee); await _employeeDbContext.SaveChangesAsync(); return true; } public async TaskListEmployeeDto GetEmoloyeesAsync() { //return await _employeeDbContext.employees // .Select(e new EmployeeDto // { // Name e.Name, // Age e.Age, // Dept e.Dept // }) // .ToListAsync(); return await _employeeDbContext.employees .ProjectToTypeEmployeeDto() .ToListAsync(); } public async TaskEmployeeDto GetEmployeeByIdAsync(int id) { var employee await _employeeDbContext.employees.FindAsync(id); if (employee null) { return null; } //var employeeDto new EmployeeDto //{ // Name employee.Name, // Age employee.Age, // Dept employee.Dept //}; var employeeDto employee.AdaptEmployeeDto(); return employeeDto; } public async Taskbool UpdateEmployeeAsync(UpdateEmployeeRequest request) { var employee await _employeeDbContext.employees.FindAsync(request.Id); if (employee null) { return false; } //employee.Name request.Name; //employee.Age request.Age; //employee.Dept request.Dept; request.AdaptEmployee(); await _employeeDbContext.SaveChangesAsync(); return true; } } }

相关新闻

QMCDecode：解密QQ音乐加密格式，实现音乐文件自由播放与备份

QMCDecode：解密QQ音乐加密格式，实现音乐文件自由播放与备份

2026/7/31 11:27:31

1. 项目概述：当音乐被“锁”在格式里 作为一个听歌超过十年的老用户，我经历过从MP3文件塞满硬盘，到流媒体平台一键播放的时代变迁。便利性提升的同时，一个老问题也以新的形式回来了：音乐的所有权。你花钱买了会员&…

188、手机影像全链路调优：从sensor到显示的色彩与细节一致性

188、手机影像全链路调优：从sensor到显示的色彩与细节一致性

2026/7/31 11:26:31

188、手机影像全链路调优：从sensor到显示的色彩与细节一致性 一、一个让我失眠三天的bug 去年Q2，某旗舰机项目，DVT阶段。产线抽检发现：同一批次机器，在标准光源下拍摄同一张色卡，屏幕显示出来的红色饱和度差异高达15%。更诡异的是——RAW图抓出来看，sensor输出完全一致…

电子产品开发服务商选择的7个关键维度与避坑指南

电子产品开发服务商选择的7个关键维度与避坑指南

2026/7/31 12:30:16

1. 电子产品开发服务商的选择困境 作为一个在电子行业摸爬滚打多年的老工程师，我见过太多企业在选择开发服务商时栽跟头。去年有个做智能家居的创业团队找我咨询，他们之前找的服务商报价比市场价低30%，结果交付的产品连基本的功能测试都没通过…

IP地址归属类型对风险控制的影响

IP地址归属类型对风险控制的影响

2026/7/31 12:30:16

在同一家电商平台下单，有人秒过，有人被弹出验证甚至直接拒绝访问。问题不出在账号，而出在IP。风险控制系统判断一个请求是否可信，先决依据不是账号历史，而是访问来源的网络环境。IP归属类型，就是这个环境的…

RustFS：国产高性能存储引擎的技术解析与实践

RustFS：国产高性能存储引擎的技术解析与实践

2026/7/31 12:30:16

1. 项目概述：RustFS为何能斩获23k Star？上周在技术社区第一次看到RustFS的推荐时，这个标着"国产开源存储"的项目已经悄然冲到了23k Star。作为长期关注分布式存储的技术从业者，我立刻下载了其v0.8.2版本进行实测。三天的…

大气层系统完整指南：5分钟学会Switch自制系统安装与优化

大气层系统完整指南：5分钟学会Switch自制系统安装与优化

2026/7/31 12:30:15

大气层系统完整指南：5分钟学会Switch自制系统安装与优化 【免费下载链接】Atmosphere-stable 大气层整合包系统稳定版 项目地址: https://gitcode.com/gh_mirrors/at/Atmosphere-stable 大气层系统（Atmosphere）是目前最稳定、最受欢迎…

UE4 PC端DebugGame模式高效调试：Rider配置与实战技巧全解析

UE4 PC端DebugGame模式高效调试：Rider配置与实战技巧全解析

2026/7/31 12:29:13

1. 项目概述：为什么UE4Rider是高效调试的黄金组合？ 如果你是一名使用虚幻引擎4（UE4）进行PC端游戏或应用开发的程序员，那么“调试”这两个字对你来说，可能意味着一段漫长的等待和不确定的煎熬。传统的Visual…

BilibiliDown：3分钟学会B站视频下载的终极指南

BilibiliDown：3分钟学会B站视频下载的终极指南

2026/7/31 0:00:14

BilibiliDown：3分钟学会B站视频下载的终极指南 【免费下载链接】BilibiliDown (GUI-多平台支持) B站 哔哩哔哩 视频下载器。支持稍后再看、收藏夹、UP主视频批量下载|Bilibili Video Downloader 😳 项目地址: https://gitcode.com/gh_mirrors/bi/Bilib…

有哪些游戏数据AI平台？游戏行业Data+AI融合方案盘点

有哪些游戏数据AI平台？游戏行业Data+AI融合方案盘点

2026/7/31 0:00:14

当前，游戏行业的“DataAI融合”已从概念验证进入价值落地阶段。根据IDC 2025年数据，中国AI游戏云市场规模已达18.6亿元；同时，游戏研发环节AI渗透率高达86%，生成式AI内容普及率超过50%。面对庞大的市场，游戏…

A2UI组件协议深度解析：如何构建下一代AI驱动的动态界面

A2UI组件协议深度解析：如何构建下一代AI驱动的动态界面

2026/7/31 0:00:14

A2UI组件协议深度解析：如何构建下一代AI驱动的动态界面 【免费下载链接】a2ui 项目地址: https://gitcode.com/GitHub_Trending/a2/a2ui 在当今AI应用爆炸式增长的时代，构建能够动态响应、实时更新的用户界面已成为开发者的核心挑战。A2UI&#…

AI短剧创作系统：从剧本生成到视频合成的全流程解析

AI短剧创作系统：从剧本生成到视频合成的全流程解析

2026/7/30 3:52:17

1. 项目背景与核心价值去年参与的一个短剧项目让我深刻体会到传统创作流程的痛点：编剧团队花了三周打磨剧本，角色设计反复修改了七版，最后成片时又因为演员档期问题不得不临时调整分镜。这种低效的创作模式在快节奏的内容行业越来越难以为继。…

数据分析师必学MySQL：从零构建电商销售分析实战

数据分析师必学MySQL：从零构建电商销售分析实战

2026/7/30 14:37:29

你是不是也遇到过这样的困惑：想学数据分析，看了很多Python、R语言的教程，结果发现第一步就被卡住了——数据从哪里来？怎么存？怎么查？怎么保证数据准确？很多数据分析教程都默认你已经有了一个干净…

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合

2026/7/30 4:49:32

HS2-HF Patch：3步实现HoneySelect2完美汉化与MOD整合 【免费下载链接】HS2-HF_Patch Automatically translate, uncensor and update HoneySelect2! 项目地址: https://gitcode.com/gh_mirrors/hs/HS2-HF_Patch HS2-HF Patch是专为HoneySelect2玩家设计的一站…