using Microsoft.AspNetCore.Mvc;
?
// 簡(jiǎn)單示例
namespace test_vs_api.Controllers
{
    [Route("/[controller]/[action]")] // 路由為類名加方法名
    [ApiController] // api控制器
    public class TestController : Controller
    {
        [HttpGet("/[action]")] // 方法及路徑 使用方法名做路徑 如果以上使用了action 此處可以省略
        public string GetMessage()
        {
            return "123";
        }
    }
}

 "ConnectionStrings": {
    "MySQLConnection": "server=localhost;port=3306;uid=root;pwd=123456;database=yourdatabaase"
  },

// 注冊(cè)數(shù)據(jù)庫(kù)上下文
builder.Services.AddDbContext<DataContext>(options =>
{
    options.UseMySQL(builder.Configuration.GetConnectionString("DefaultConnection")!);
});

using Microsoft.EntityFrameworkCore;
using test_vs_api.Entities;
?
namespace test_vs_api.Data
{
    public class DataContext : DbContext
    {
        public DataContext(DbContextOptions<DataContext> options) : base(options) 
        { 
?
        }
?
        public DbSet<數(shù)據(jù)庫(kù)表名> 表名{  get; set; }
    }
}

// 引用數(shù)據(jù)庫(kù)上下文
private readonly DataContext _context;
public StaffController(DataContext context)
{
    _context = context;
}

public async Task<IActionResult> GetAllStaff()
    {
        var staffList = new List<Staff>
        {
            new Staff
            {
                id = 1,
                name = "張三",
                department = "研發(fā)部",
                sex = "男",
                CreateTime = "2024-2-4 16:45:50"
            }
        };
?
        return Ok(staffList);
    }

public async Task<ActionResult<List<Staff>>> GetAllStaff()
{
    var staffList = new List<Staff>
{
    new Staff
    {
        id = 1,
        name = "張三",
        department = "研發(fā)部",
        sex = "男",
        CreateTime = "2024-2-4 16:45:50"
    }
};
?
    return Ok(staffList);
}

[HttpGet] // 方法及路徑
public async Task<ActionResult<List<Staff>>> GetAllStaff()
{
    var staffList = await _context.Staff.ToListAsync();
?
    return Ok(staffList);
}

[HttpGet("{id}")] // 如果需要傳參則需要添加該參數(shù)，表示參數(shù)為必需
public async Task<ActionResult<List<Staff>>> GetStaff(int id)
{
    var staff = await _context.Staff.FindAsync(id); // 找到id相同的數(shù)據(jù)
?
    if(staff is null) 
        return NotFound("找不到該員工。");
?
    return Ok(staff);
}

// 分頁(yè)所需的數(shù)據(jù) 如果有多個(gè)接口需要使用，可以新建模型類以公用
public class PaginatedResult<T>
{
    public required List<T> Data { get; set; }
    public int TotalCount { get; set; }
    public int TotalPages { get; set; }
    public int CurrentPage { get; set; }
    public int PageSize { get; set; }
}
?
[HttpGet] // 方法及路徑
public async Task<ActionResult<List<Staff>>> GetAllStaff(int page = 1, int size = 10)
{
?
    // 驗(yàn)證頁(yè)碼和每頁(yè)大小是否合法  
    if (page < 1) page = 1;
    if (size < 1) size = 10;
?
    // 計(jì)算總記錄數(shù)和總頁(yè)數(shù)  
    var totalCount = await _context.Staff.CountAsync();
    var totalPages = (int)Math.Ceiling(totalCount / (double)size);
?
    // 使用Skip和Take方法進(jìn)行分頁(yè)查詢  
    var staffList = await _context.Staff
        .OrderBy(s => s.id) // 假設(shè)我們按ID排序，你可以根據(jù)需要修改排序條件  
        .Skip((page - 1) * size)
        .Take(size)
        .ToListAsync();
?
    if (page > totalPages)
        return BadRequest("沒(méi)有更多數(shù)據(jù)！");
?
    // 創(chuàng)建分頁(yè)結(jié)果對(duì)象  
    var paginatedResult = new PaginatedResult<Staff>
    {
        Data = staffList,
        TotalCount = totalCount,
        TotalPages = totalPages,
        CurrentPage = page,
        PageSize = size
    };
?
    return Ok(paginatedResult);
}

[HttpPost] // 如果需要傳參則需要添加該參數(shù)，表示參數(shù)為必需
public async Task<IActionResult> AddStaff(Staff staff)
{
?
    if (ModelState.IsValid)
    {
        staff.CreateTime = DateTime.Now.ToLocalTime(); // 將UTC時(shí)間格式轉(zhuǎn)換為本地時(shí)間格式
        _context.Staff.Add(staff); // 通過(guò)數(shù)據(jù)庫(kù)上下文添加數(shù)據(jù)模型類的構(gòu)造函數(shù)
        await _context.SaveChangesAsync(); // 異步等待（async await）保存新數(shù)據(jù)值數(shù)據(jù)庫(kù)
?
        // 返回成功消息  
        return Content("添加成功！", "text/plain");
    }
    else
    {
        // 如果模型狀態(tài)無(wú)效，返回錯(cuò)誤消息  
        return BadRequest("無(wú)效的請(qǐng)求數(shù)據(jù)。");
    }
}

[HttpPut]
public async Task<IActionResult> UpdateStaff(Staff UpdateStaff)
{
    if (ModelState.IsValid)
    {
        var staff_form = await _context.Staff.FindAsync(UpdateStaff.id); // 找到id相同的數(shù)據(jù)
?
        if (staff_form is null)
            return NotFound("找不到該員工。");
?
        // 依次更改數(shù)據(jù)字段
        staff_form.name = UpdateStaff.name;
        staff_form.department = UpdateStaff.department;
        staff_form.sex = UpdateStaff.sex;
?
        await _context.SaveChangesAsync();
?
        return Ok("修改成功！");
    }
    else
    {
        // 如果模型狀態(tài)無(wú)效，返回錯(cuò)誤消息  
        return BadRequest("無(wú)效的請(qǐng)求數(shù)據(jù)。");
    }
}

[HttpDelete]
public async Task<IActionResult> DelStaff(int id)
{
    var staff = await _context.Staff.FindAsync(id); // 找到id相同的數(shù)據(jù)
?
    if (staff is null)
        return NotFound("找不到該員工。");
?
    _context.Staff.Remove(staff);
?
    await _context.SaveChangesAsync();
?
    return Ok("刪除成功！");
}

// 解決時(shí)間格式 ISO 8601 帶T的問(wèn)題
builder.Services.AddControllers().AddJsonOptions(configure =>
{
    configure.JsonSerializerOptions.Converters.Add(new DatetimeJsonConverter()); // 使用一個(gè)新類更改ISO 8601時(shí)間格式
});

var builder = WebApplication.CreateBuilder(args);  
// 添加CORS服務(wù)  
builder.Services.AddCors(options =>  
{  
    options.AddPolicy("MyCorsPolicy", builder =>  
    {  
        builder.WithOrigins("http://localhost:你的前端端口號(hào)",  
                           // ...其他源  
                           )  
               .AllowAnyHeader()  
               .AllowAnyMethod();  
    });  
});  
var app = builder.Build();  
// 使用CORS中間件  
app.UseCors("MyCorsPolicy");  
// 其他中間件和終端配置...  
app.Run();

using System.ComponentModel.DataAnnotations;
?
namespace test_vs_api.Entities
{
    public class User
    {
        public int id { get; set; }
        public required string  UserName { get; set; }
        public required string Password { get; set; }
?
        [RegularExpression(@"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$", ErrorMessage = "請(qǐng)輸入有效的郵箱地址。")] // 像這樣
        public required string Email { get; set; }
        public required string NickName { get; set; }
        public required DateTime CreateTime { get; set; }
    }
}

dotnet your_api.dll // 使用dotnet運(yùn)行
./your_api // 獨(dú)立運(yùn)行
nohup dotnet yourapi.dll & // 在后臺(tái)持續(xù)運(yùn)行

// 如果在訪問(wèn)接口時(shí)，遇到了http請(qǐng)求被重定向到https的問(wèn)題，可以刪掉https的配置
"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://*:5000"
    },
    "Https": {
      "Url": "https://*:5001"
    }
  }
}