Spring MVC与RESTful

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：删除数据