Spring MVC与RESTful
在Spring MVC框架中,接收请求参数的做法有:
- 将各请求参数声明为处理请求的方法的参数
- 将各请求参数封装到自定义的POJO类型中,并使用POJO类型作为处理请求的方法的参数
- 【见下文】在配置请求路径时使用占位符,并通过
@PathVariable
注解来接收请求参数的值
RESTful是一种设计软件的风格,其典型特征包括:将具有“唯一性”的请求参数值作为URL的一部分,例如:
https://blog.csdn.net/a6244353135_/article/details/1242675432835
Spring MVC框架很好的支持了RESTful,在使用@RequestMapping
系列注解配置请求路径时,可以使用{名称}
作为占位符来接收请求,例如配置为:
@PostMapping("/{id}/delete")
则以上路径中{id}
可以是任何值,均能匹配到以上路径!
在处理请求的方法上,仍使用Long id
来接收URL中的占位符对应的值,并且,此参数需要添加@PathVariable
注解,例如:
// http://localhost:9080/brands/3/delete
@PostMapping("/{id}/delete")
public String delete(@PathVariable Long id) {
}
在使用@PathVariable
注解时,如果请求参数的名称与占位符不一致时,可以通过注解参数进行配置,例如:
// http://localhost:9080/brands/3/delete
@PostMapping("/{id}/delete")
public String delete(@PathVariable("id") Long brandId) {
}
另外,在{}
占位符中,可以在自定义名称的右侧添加冒号(:
),并在冒号的右侧添加正则表达式,以实现按需匹配,例如:
// http://localhost:9080/brands/3/delete
@PostMapping("/{id:[0-9]+}/delete")
public String delete(@PathVariable Long id) {
}
在同一个项目中,多个使用了占位符、且正则表达式不冲突的URL,是允许共存的!例如:
// http://localhost:9080/brands/3/delete
@PostMapping("/{id:[0-9]+}/delete")
public String delete(@PathVariable Long id) {
}
// http://localhost:9080/brands/hello/delete
@PostMapping("/{id:[a-zA-Z]+}/delete")
public String delete(@PathVariable String id) {
}
另外,使用了占位符的URL,与不使用占位符的URL,也是允许共存的,例如:
// http://localhost:9080/brands/3/delete
@PostMapping("/{id:[0-9]+}/delete")
public String delete(@PathVariable Long id) {
}
// http://localhost:9080/brands/hello/delete
@PostMapping("/{name:[a-zA-Z]+}/delete")
public String delete(@PathVariable String name) {
}
// http://localhost:9080/brands/test/delete
@PostMapping("/test/delete")
public String delete() {
}
在RESTful的设计风格中,如果没有更好的选择,在设计URL时,可以:
/数据类型的复数
:表示获取某类型的数据的列表- 例如:
/brands
表示获取品牌列表
- 例如:
/数据类型的复数/{id}
:表示获取某类型的id=?的数据- 例如:
/brands/{id}
,实际请求路径可能是/brands/1
,则表示获取id=1的品牌数据
- 例如:
/数据类型的复数/{id}/命令
:表示针对某类型的id=?的数据进行某操作- 例如:
/brands/{id}/delete
,实际请求路径可能是/brands/1/delete
,则表示删除id=1的品牌数据
- 例如:
/数据类型的复数/{id}/属性/命令
:表示针对某类型的id=?的数据的某属性进行某操作- 其它
另外,RESTful思想建议针对不同的需求,使用不同的请求方式,如下:
GET
:获取数据POST
:增加数据PUT
:修改数据DELETE
:删除数据