RESTful 是什么
rest是一种设计风格。它不是一种标准,也不是一种软件,而是一种思想。
restful即是rest式,restful web service 是一种常见的rest应用,是准守rest风格的web服务。
REST 架构的主要原则
资源操作
REST接口定义
REST接口响应设计
指定响应的属性字段
http响应状态码
SpringMVC实现RESTful服务
springMVC原生支持Rest风格:注解:@RequestMapping、@ResponseBody、@PathVariable
以下以user作为资源为例:
1、查询资源
@RequestMapping("new/user")
@Controller
public class UserController{}
//PathVariable 获取上面的id
@RequestMapping(value = "{id}", method = RequestMethod.GET)
@ResponseBody
public ResponseEntity<User> queryUserById(@PathVariable("id") Long id) {
try {
User user = this.userService.queryUserById(id);
if (null == user) {
// 资源不存在,响应404
return ResponseEntity.status(HttpStatus.NOT_FOUND).body(null);
}
// 资源存在,响应200
// return ResponseEntity.status(HttpStatus.OK).body(user);
return ResponseEntity.ok(user);
} catch (Exception e) {
e.printStackTrace();
}
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
}
2、新增资源
/**
* 新增用户
*
* @param user
* @return
*/
@RequestMapping(method = RequestMethod.POST)
public ResponseEntity<Void> saveUser(User user) {
try {
Boolean bool = this.userService.saveUser(user);
if (bool) {
// 新增成功,响应201
return ResponseEntity.status(HttpStatus.CREATED).build();
}
} catch (Exception e) {
e.printStackTrace();
}
// 新增失败,响应500
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();
}
3、更新资源
/**
* 更新用户
* @param user
* @return
*/
@RequestMapping(method = RequestMethod.PUT)
public ResponseEntity<Void> updateUser(User user) {
try {
Boolean bool = this.userService.updateUser(user);
if (bool) {
// 更新成功,响应204
return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
}
} catch (Exception e) {
e.printStackTrace();
}
// 新增失败,响应500
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();
}
需要在web.xml中添加过滤器解决PUT请求无法提交表单数据的问题:
<!-- 解决PUT请求无法提交表单数据的问题 -->
<filter>
<filter-name>HttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HttpPutFormContentFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
4、删除资源
/**
* 删除用户
*
* @param id
* @return
*/
@RequestMapping(method = RequestMethod.DELETE)
public ResponseEntity<Void> deleteUser(@RequestParam(value = "id", defaultValue = "0") Long id) {
try {
if (id.longValue() == 0) {
// 没有传递参数,响应状态码400
return ResponseEntity.status(HttpStatus.BAD_REQUEST).build();
}
Boolean bool = this.userService.deleteUser(id);
if (bool) {
// 删除成功,响应204
return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
}
} catch (Exception e) {
e.printStackTrace();
}
// 删除失败,响应500
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();
}
delete请求在前台还是使用post,经过过滤器转化为 DELETE
<!--
将POST请求转化为DELETE或者是PUT
要用_method指定真正的请求方法
-->
<filter>
<filter-name>HiddenHttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HiddenHttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>