杨中科 ASP.NETCore WebAPI 控制器及返回值、参数问题

控制器及返回值

控制器类

1、ControllerBase与Controller

webapi的controller 继承自 ControllerBase

webmvc 继承自controller

controller 继承自controllerbase

2、控制器类可以不显式地继承自任何类

还是需要添加特性

运行:

Action方法的异步

1、Action方法既可以同步也可以异步。

2、异步Action方法的名字一般不需要以Async结尾。

3、Web API中Action方法的返回值如果是普通数据类型,那么返回值就会默认被序列化为Json格式。

4、Web API中的Action方法的返回值同样支持IActionResult类型,不包含类型信息,因此Swagger等无法推断出类型,所以推荐用ActionResult,它支持类型转换,从而用起来更简单。

示例:

运行结果:

普通类型 序列化为格式

首先创建一个Person类

运行结果:

普通抛出异常方式,会在客户端直接显示异常信息。这是很不友好的

运行结果:

希望返回404

将返回值改为IActionResult

运行结果:

也可添加泛型

【总结:】

如果你的返回类型只有一种类型,那么直接使用哪一种类型得返回类型即可,若有多种则可以使用IAcitonResult

Asp.Net Core Web API Action 方法参数

add 方法使用HTTPGET默认的是querystring的方式传递

思考如何手动指定数据来自于querystring 还是路径还是来自请求体

捕捉URL占位符

1、在HttpGet、HttpPost等中使用占位符,比如[schoolName},捕捉路径中的内容,从而供Action方法的参数使用。

Students/GetAll/school/MIT/class/A001

HttpGet("school/schoolNamel/class (classNol")

2、捕捉的值会被自动赋值给Action中同名的参数如果名字不一致,可以用FromRoute(Name="名字")

3、演示混用

运行结果:

名字不同时:

运行结果:

HttpPost 方式

运行结果

捕捉QUERYSTRING的值

1、使用FromQuery来获取QueryString中的值。如果名字一致,只要为参数添加FromQuery即可;而如果名字不一致FromQuery(Name = 名字)。

2、QueryString和Route可以混用

JSON 报文体

1、Web API的开发模式下,Json格式的请求体是主流

2、只要声明一个模型类和Json请求的格式一致即可。

3、也是可以把从URL获取参数、从请求报文体获取数据等这些混合使用。

HttpPost("classld/(classld)")

public ActionResult AddNew(long classldStudentModel s)

4、一定要设定请求头中的Content-Type为application/json,而且数据必须是合法的json格式

复杂参数类型,可以用类的方式

请求方式相对应即可(2声明一个模型类和Json请求的格式一致即可)

混合使用

运行结果:

一定要设定请求头中的Content-Type为application/json,而且数据必须是合法的json格式

其他方式

Web API中很少用的方式:

1、从Content-Type为multipart/form-data的请求中获取数据的FromForm

2、从请求报文头中获取值的FromHeader.




swagger的小问题,其实还是获取的浏览器端的 user_agent

相关推荐
打工仔折腾 AI39 分钟前
LLaMA 1 到 LLaMA 3 架构演进拆解:从 RoPE、GQA 到词表扩张
人工智能·后端·python·深度学习·langchain·llama
可乐鸡翅yeah_1 小时前
HLS 分片过期清理,直播旧 TS 分片磁盘爆满问题处理
java·后端·spring·m3u8·m3u8在线·音视频在线播放
张彦峰ZYF1 小时前
加了锁不等于扛得住争用:synchronized、显式锁与 CAS 的语义分层、争用代价账本与选型判据
后端·同步设施·内置锁的四种状态与单向升级·可重入的由来与四条硬边界·显式锁的状态字段与等待队列·读写锁与邮戳锁·一次同步的开销账本
专业程序开发源1 小时前
SSM校园拍摄交流服务平台36936-计算机课程设计、毕业设计
java·spring boot·后端·python·elasticsearch·php·课程设计
Gopher_HBo1 小时前
zap采样器与性能优化内幕
后端
变量探索SEQVEC1 小时前
我埋了 8 个假文件,看谁会上钩:12 天 502 次扫描实录
后端
llqbzllll2 小时前
HashMap 的核心结构:从一次 put 看到扩容、桶迁移与树化边界
后端
晚安code2 小时前
设计模式入门:吃透 SOLID 原则与迪米特法则,再学 5 个高频模式
后端·设计模式
专业程序开发源4 小时前
django新闻推荐系统70655-计算机课程设计、毕业设计
java·javascript·spring boot·后端·python·django·课程设计
打工仔折腾 AI4 小时前
把 AI Agent 托管到家里电脑:UU远程端口映射与CLI实测记录
人工智能·后端·python·langchain·电脑·ai agent 实战