大脑总是需要一些新鲜事物刺激才能变得更有活力,脱离.net好些年头了,最近就想着学学新东西,转换一下思维,便计划跟着微软官网来实践实践传神的ASP.NET Core 6.0
环境准备 我本机安装是:
.net core 6.0
VS2022(x64)
创建项目 文件
->新建
->项目
,找到并选中ASP.NET Core Web API
模板,然后点击下一步,弹出新建项目对话框,输入项目名
,点击下一步,
该界面建议选中[启用Docker],当然也可以不选,对于学习ASP.NET Core Web API
没什么影响。其他选项默即可,如果要创建Mini API
,则无需勾选[使用控制器],然后点击创建
因为我选择了启动Docker
,所以会提示安装Docker Desktop的对话框,这里我并不需要它,直接点击否
即可。
项目创建成功后,我们可以在Program.cs
类中看到,模板会默认启用Swagger
另外,模板会自动创建一个WeatherForecastController.cs
的示例类,在该类中我们可以看到该类继承于ControllerBase
,并有ApiController
和Route
两个特性,
现在直接运行起来看看效果
运行起来后,会自动打开浏览器并跳转至swagger
页面,这是项目生成时默认设置的,我们可以通过修改launchSettings.json
来设置默认启动页面和端口
新建WEB API接口 新建实体类 在项目目录中新建一个Models
文件夹用于存放实体类,新建一个名为Order
类
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 public class Order { public long Id { get; set; } /// <summary> /// 订单编号 /// </summary> public string OrderNo { get; set; } /// <summary> /// 订单金额 /// </summary> public decimal Amount { get; set; } /// <summary> /// 订单时间 /// </summary> public DateTime CreateTime { get; set; } }
创建数据库访问 首先通过NuGet安装Microsoft.EntityFrameworkCore.InMemory
,
新建一个名为DemoContext
的数据库上下文类并继承DbContext
类
1 2 3 4 5 6 public class DemoContext: DbContext { public DemoContext(DbContextOptions<DemoContext> options) : base(options) { } public DbSet<Order> Orders { get; set; }=null!; }
在Program.cs
中注册数据库上下文
1 builder.Services.AddDbContext<DemoContext>(opt => { opt.UseInMemoryDatabase("Demo"); }); //Demo为数据库名
新增接口 新建一个API控制器,在选中模型后,会安装一些依赖包,我们需要耐心的等待一下
VS会为我们生成比较全的CRUD
代码:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 [Route("api/[controller]")] [ApiController] public class OrdersController : ControllerBase { private readonly DemoContext _context; public OrdersController(DemoContext context) { _context = context; } // GET: api/Orders [HttpGet] public async Task<ActionResult<IEnumerable<Order>>> GetOrders() { return await _context.Orders.ToListAsync(); } // GET: api/Orders/5 [HttpGet("{id}")] public async Task<ActionResult<Order>> GetOrder(long id) { var order = await _context.Orders.FindAsync(id); if (order == null) { return NotFound(); } return order; } // PUT: api/Orders/5 // To protect from overposting attacks, see https://go.microsoft.com/fwlink/?linkid=2123754 [HttpPut("{id}")] public async Task<IActionResult> PutOrder(long id, Order order) { if (id != order.Id) { return BadRequest(); } _context.Entry(order).State = EntityState.Modified; try { await _context.SaveChangesAsync(); } catch (DbUpdateConcurrencyException) { if (!OrderExists(id)) { return NotFound(); } else { throw; } } return NoContent(); } // POST: api/Orders // To protect from overposting attacks, see https://go.microsoft.com/fwlink/?linkid=2123754 [HttpPost] public async Task<ActionResult<Order>> PostOrder(Order order) { _context.Orders.Add(order); await _context.SaveChangesAsync(); return CreatedAtAction("GetOrder", new { id = order.Id }, order); } // DELETE: api/Orders/5 [HttpDelete("{id}")] public async Task<IActionResult> DeleteOrder(long id) { var order = await _context.Orders.FindAsync(id); if (order == null) { return NotFound(); } _context.Orders.Remove(order); await _context.SaveChangesAsync(); return NoContent(); } private bool OrderExists(long id) { return _context.Orders.Any(e => e.Id == id); } }
代码中我们可以看到4种接口请求方式HttpGet(查询)
、HttpPut(修改)
、HttpPost(新增)
、HttpDelete(删除)
,Route
中也带有api
路径,我们的接口便在api
目录下,此时,我们运行起来便可在Swagger中看到刚才新增的接口
我们通过POST
请求api/Orders
来新增一条数据 再通过GET
请求api/Orders
来查询数据列表
这里只是跟着官方教程创建好一个项目以及如何创建新的WebApi
,示例中的数据是存储在内存中的,下一节,我们便跟着官方教程来学习如果用过EF Core 6
访问数据库