使用 ASP.NET Core MVC 创建 Web API(三)
使用 asp.net core mvc 创建 web api
使用 asp.net core mvc 创建 web api(一)
使用 asp.net core mvc 创建 web api(二)
十、添加 getbookitem 方法
1) 在visual studio 2017中的“解决方案资源管理器”中双击打开bookcontroller文件,添加get方法的api。代码如下。
// get: api/book [httpget] public async task<actionresult<ienumerable<book>>> getbookitems() { return await _context.book.tolistasync(); } // get: api/book/5 [httpget("{id}")] public async task<actionresult<book>> getbookitem(int id) { var bookitem = await _context.book.findasync(id); if (bookitem == null) { return notfound(); } return bookitem; }
2) 将上面的代码添加到bookcontroller文件中后,会在tolistasync方法下出现波浪线,
这时需要把using microsoft.entityframeworkcore;添加到文件开头。
3) 这两个方法实现两个 get 终结点:
get /api/book
get /api/book/{id}
4) 在visual studio 2017中按f5,运行应用程序。然后在浏览器中分别调用两个终结点来测试应用。
5) 在浏览器中输入“http://localhost:5000/api/book”查询所有书籍信息,如下图。
6) 在浏览器中输入“http://localhost:5000/api/book/8”查询指定有书籍信息,如下图。
十一、路由和 url 路径
[httpget]
属性表示响应 http get 请求的方法。 每个方法的 url 路径构造如下所示:
-
在控制器的
route
属性中以模板字符串开头:
namespace bookapi.controllers { [route("api/[controller]")] [apicontroller] public class bookcontroller : controller { private readonly bookcontext _context;
- 将
[controller]
替换为控制器的名称,按照惯例,在控制器类名称中去掉“controller”后缀。 对于此示例,控制器类名称为“book”控制器,因此控制器名称为“book”。 asp.net core 路由不区分大小写。 - 如果
[httpget]
属性具有路由模板(例如[httpget("products")]
),则将它追加到路径。 此示例不使用模板。
在下面的 getbookitem
方法中,"{id}"
是书籍信息的唯一标识符的占位符变量。 调用 getbookitem
时,url 中 "{id}"
的值会在 id
参数中提供给方法。
// get: api/book/5 [httpget("{id}")] public async task<actionresult<book>> getbookitem(int id) { var bookitem = await _context.book.findasync(id); if (bookitem == null) { return notfound(); } return bookitem; }
十二、测试 getbookitems 方法
本教程使用 rester 测试 web api。
1) 安装firefox的组件rester
2) 在visual studio 2017中启动 web 应用程序。
3) 打开rester。
4) 创建新请求,将 http 方法设置为“get”,将请求 url 设置为 http://localhost:5000/api/book/24。如下图。
5) 选择“send”。 返回结果,如下图。
上一篇: asp.net core系列 54 IS4用客户端凭据保护API
下一篇: C#相等性 - “==”
推荐阅读
-
或许是你应该了解的一些 ASP.NET Core Web API 使用小技巧
-
使用HTTP-REPL工具测试ASP.NET Core 2.2中的WEB API项目
-
ASP.NET Core Web API中使用Swagger
-
详解如何在ASP.NET Core Web API中以三种方式返回数据
-
ASP.NET Core Web API 集成测试中使用 Bearer Token
-
使用Rotativa在ASP.NET Core MVC中创建PDF
-
使用 ASP.NET Core MVC 创建 Web API——响应数据的内容协商(七)
-
使用 ASP.NET Core MVC 创建 Web API(六)
-
使用静态基类方案让 ASP.NET Core 实现遵循 HATEOAS Restful Web API
-
ASP.NET Core 实战:使用 ASP.NET Core Web API 和 Vue.js 搭建前后端分离项目