springboot RESTful以及参数注解的使用方式
springboot RESTful及参数注解使用
RESTful
Spring的复杂性不是来自于它处理的对象,而是来自于自身,不断演进发展的Spring会带来时间维度上复杂性,比如SpringMVC以前版本的@RequestMapping,到了新版本被下面新注释替代,相当于增加的选项:
@GetMapping @PostMapping @PutMapping @DeleteMapping @PatchMapping
说明
1、@GetMapping
@RequestMapping(method = RequestMethod.GET)的简写
作用:对应查询,表明是一个查询URL映射
2、@PostMapping
@RequestMapping(method = RequestMethod.POST)的简写
作用:对应增加,表明是一个增加URL映射
3、@PutMapping
@RequestMapping(method = RequestMethod.PUT)的简写
作用:对应更新,表明是一个更新URL映射
4、@DeleteMapping
@RequestMapping(method = RequestMethod.DELETE)的简写
作用:对应删除,表明是一个删除URL映射
5、@PatchMapping
Patch方式是对put方式的一种补充;
put方式是可以更新.但是更新的是整体.patch是对局部更新;
参数注解的使用
@PathVariable @RequestParam @RequestBody @ModelAttribute
说明
1. @PathVariable
获取路径参数。即url/{id}这种形式
@PathVariable绑定URI模板变量值
@PathVariable是用来获得请求url中的动态参数的
@PathVariable用于将请求URL中的模板变量映射到功能处理方法的参数上。//配置url和方法的一个关系@RequestMapping(“item/{itemId}”)
2.@RequestParam
获取查询参数。即url?name=这种形式
@RequestParam注解主要有哪些参数:
value
:参数名字,即入参的请求参数名字,如username表示请求的参数区中的名字为username的参数的值将传入;required
:是否必须,默认是true,表示请求中一定要有相应的参数,否则将报404错误码;defaultValue
:默认值,表示如果请求中没有同名参数时的默认值,例如:
public List getItemTreeNode(@RequestParam(value=“id”,defaultValue=“0”)long parentId)
3.@RequestBody
@requestBody注解常用来处理content-type不是默认的application/x-www-form-urlcoded编码的内容,比如说:application/json或者是application/xml等。一般情况下来说常用其来处理application/json类型。
通过@requestBody可以将请求体中的JSON字符串绑定到相应的bean上,当然,也可以将其分别绑定到对应的字符串上。
4.@ModelAttribute
在使用RESTful风格时,使用get请求,又想使用对象接收参数,就可以使用这个注解
不光适用于get请求,同样也适用于put和delete请求
springboot Restful使用记录
创建项目
通过spring官网创建项目
https://start.spring.io/
- 项目名称取为studyRest
- 项目依赖WEB
Rest组件使用
使用@RestController标记类为提供Restful服务的Contoller
@GetMapping为资源定位一部分,也就是url,对应http://localhost:8080/test
@RestController public class MyRestContoller1 { @GetMapping("/test") public Map<String, String> getData() { Map<String, String> data = new HashMap<String, String>(); data.put("id", "111"); data.put("name", "zhangsan"); return data; } }
测试(这里使用浏览器测试,后续使用Postman工具)
@GetMapping关键字对应GET请求,也就是查询,请求还可以有参数,对应@PathVariable与@RequestParam注解
@GetMapping("/test/{id}") public Map<String, String> getData2(@PathVariable String id, @RequestParam(required = false) String name) { Map<String, String> data = new HashMap<String, String>(); data.put("id", id); data.put("name", name); return data; }
测试,返回值为入参传入参数
Post类型,新增操作
新增使用@PostMapping描述URL
新增一般都会带有大量数据,一般都是使用@RequestBody注解封装参数
@PostMapping("/test2/add") public Map<String, String> addData(@RequestBody Map<String, String> data) { return data; }
测试
注意两点,不正确都会报错
- 请求类型必须是POST
- Content-type必须要设置为application/json,因为入参形式为JSON格式
更新与删除操作
使用上与Post一致,只是不同类型需要使用对应的主机
PUT
:@PutMappingDELETE
:@DeleteMapping
@PutMapping("/test2/update") public Map<String, String> updateData(@RequestBody Map<String, String> data) { return data; } @DeleteMapping("/test2/delete") public Map<String, String> deleteData(@RequestBody Map<String, String> data) { return data; }
RequestMapping使用
RequestMapping是一个通用注解,包含上述所有操作
@RestController @RequestMapping(value = "/parent") public class RequestRestContoller { @RequestMapping(value = "/get", method = RequestMethod.GET) public Map<String, String> get() { Map<String, String> data = new HashMap<String, String>(); data.put("id", "111"); data.put("name", "zhangsan"); return data; } @RequestMapping(value = "/add", method = RequestMethod.POST) public Map<String, String> add() { Map<String, String> data = new HashMap<String, String>(); data.put("id", "111"); data.put("name", "zhangsan"); return data; } @RequestMapping(value = "/update", method = RequestMethod.PUT) public Map<String, String> update() { Map<String, String> data = new HashMap<String, String>(); data.put("id", "111"); data.put("name", "zhangsan"); return data; } @RequestMapping(value = "/delete", method = RequestMethod.DELETE) public Map<String, String> delete() { Map<String, String> data = new HashMap<String, String>(); data.put("id", "111"); data.put("name", "zhangsan"); return data; } }
上述还有贴在class上面的注解:@RequestMapping(value = "/parent"),如果是class上面的注解,那么方法上面的url需要加上class上面的注解
如:http://localhost:8080/parent/get或http://localhost:8080/parent/add
其中可以属于请求参数和响应数据类型
@RequestMapping(value = "/parent", consumes = MediaType.APPLICATION_JSON_VALUE, produces = MediaType.APPLICATION_JSON_VALUE)
其中consumes 约束入参类型,produces 约束响应数据类型
测试Content-Type:text/plain报错,由于设置了JSON格式
支持哪些格式参考Media定义
org.springframework.http.MediaType
XML格式数据支持
这里扩展一下,返回XML格式数据
引入XML依赖包
<dependency> <groupId>com.fasterxml.jackson.dataformat</groupId> <artifactId>jackson-dataformat-xml</artifactId> </dependency>
测试类
@RestController public class DataRestContoller { @RequestMapping(value = "/addJsonResponseXml", consumes = MediaType.APPLICATION_JSON_VALUE, produces = MediaType.APPLICATION_XML_VALUE) public Map<String, String> add(@RequestBody Map<String, String> data) { return data; } }
测试
以上为个人经验,希望能给大家一个参考,也希望大家多多支持猪先飞。
相关文章
解决springboot使用logback日志出现LOG_PATH_IS_UNDEFINED文件夹的问题
这篇文章主要介绍了解决springboot使用logback日志出现LOG_PATH_IS_UNDEFINED文件夹的问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-04-28- 这篇文章主要介绍了Swagger中@ApiIgnore注解的使用,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-10-21
- 这篇文章主要为大家详细介绍了SpringBoot实现excel文件生成和下载,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...2021-02-09
- 这篇文章主要给大家介绍了关于Nest.js参数校验和自定义返回数据格式的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-03-28
校验非空的注解@NotNull如何取得自定义的message
这篇文章主要介绍了校验非空的注解@NotNull如何取得自定义的message,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-29- 这篇文章主要介绍了详解springBoot启动时找不到或无法加载主类解决办法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-09-16
- 这篇文章主要介绍了SpringBoot集成Redis实现消息队列的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-02-10
- 这篇文章主要介绍了解决Springboot get请求是参数过长的情况,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-09-17
PHP中empty和isset对于参数结构的判断及empty()和isset()的区别
废话不多说了,直接给大家贴代码了。<?php class test{} $a1 = null; $a2 = ""; //$a3 = $a4 = 0; $a5 = '0'; $a6 = false; $a7 = array(); //var $a8; $a9 = new test(); for ($i=1; $i <=9 ; $i++) {...2015-11-24- 这篇文章主要介绍了java正则表达式判断前端参数修改表中另一个字段的值,需要的朋友可以参考下...2021-05-07
- mysql安装成功后有几个默认的配置模板,列表如下: my-huge.cnf : 用于高端产品服务器,包括1到2GB RAM,主要运行mysql my-innodb-heavy-4G.ini : 用于只有innodb的安装,最多有4GB RAM,支持大的查询和低流量 my-large.cnf : 用于...2015-03-15
Spring Boot项目@RestController使用重定向redirect方式
这篇文章主要介绍了Spring Boot项目@RestController使用重定向redirect方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-02- 这篇文章主要介绍了Springboot+TCP监听服务器搭建过程,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-10-28
- 这篇文章主要介绍了C#泛型的类型参数约束的相关资料,文中讲解非常细致,帮助大家更好的理解和学习c#,感兴趣的朋友可以了解下...2020-07-31
- 这篇文章主要介绍了springBoot 项目排除数据库启动方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-10
- @Autowired 注解的主要功能就是完成自动注入,使用也非常简单,但这篇文章主要给大家介绍了关于Spring为什么不推荐使用@Autowired注解的相关资料,需要的朋友可以参考下...2021-11-03
- 这篇文章主要给大家介绍了关于C#中out参数、ref参数与值参数的用法及区别的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-06-25
Java中lombok的@Builder注解的解析与简单使用详解
这篇文章主要介绍了Java中lombok的@Builder注解的解析与简单使用,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-01-06- 这篇文章主要介绍了Java线程池中的各个参数如何合理设置操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-06-19
- 这篇文章主要介绍了vue+axios全局添加请求头和参数操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-07-24