Restful 风格的 API 是一种软件架构风格,设计风格而不是标准,只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存等机制。
在 Restful 风格中,用户请求的 url 使用同一个 url 而用请求方式:get,post,delete,put...等方式对请求的处理方法进行区分,这样可以在前后台分离式的开发中使得前端开发人员不会对请求的资源地址产生混淆和大量的检查方法名的麻烦,形成一个统一的接口。
SpringMVC Restful 风格 url 配置实现的方式
SpringMVC 的 resturl 是通过 @RequestMapping 及 @PathVariable annotation 提供的,通过如 @RequestMapping(value="/blog /{id}",method=RequestMethod.DELETE) 即可处理 /blog/1 的 delete 请求。
GET(SELECT):从服务器查询,可以在服务器通过请求的参数区分查询的 方式。
POST(CREATE):在服务器端新建一个资源,调用 insert 操作。
PUT(UPDATE):在服务器端更新资源,调用 update 操作。
PATCH(UPDATE):在服务器端更新资源(客户端提供改变的属性)。(目前 jdk7 未实现,tomcat7 不支持)。
DELETE(DELETE):从服务器端删除资源,调用 delete 语句。
案例实操
Get 请求配置
/**
*restful-->get 请求 执行查询操作
* @param id
* @return
*/
@RequestMapping(value="queryAccountById02/{id}",method=RequestMethod.GET,produces=MediaType.APPLICATION_JSON_UTF8_VALUE)
@ResponseBody
publicMessageModelqueryAccountById(@PathVariableIntegerid){
MessageModelmessageModel=newMessageModel();
if(null==id){
messageModel.setCode(300);
messageModel.setMsg("参数非法!");
returnmessageModel;
}
messageModel.setResult(accountService.queryById(id));
returnmessageModel;
}
Post 请求配置
/**
* restful-->post 请求执行添加操作
* @param id
* @param aname
* @return
*/
@RequestMapping(value="saveAccount",method=RequestMethod.POST,produces=MediaType.APPLICATION_JSON_UTF8_VALUE)
@ResponseBody
publicMessageModelqueryAccountById04(@RequestBodyAccountaccount){
MessageModelmessageModel=newMessageModel();
try{
accountService.saveOrUpdateAccount(account);
}catch(ParamsExceptione) {e.printStackTrace();
messageModel.setCode(e.getErrorCode());
messageModel.setMsg(e.getErrorMsg());
}catch(Exceptione) {e.printStackTrace();
messageModel.setCode(300);
messageModel.setMsg("操作失败!");
}
returnmessageModel;
}
Put 请求配置
/**
* restful-->put 请求执行更新操作
* @param id
* @param account
* @return
*/
@RequestMapping(value="update/{id}",method=RequestMethod.PUT,produces=MediaType.APPLICATION_JSON_UTF8_VALUE)
@ResponseBody
publicMessageModelqueryAccountById04(@PathVariableIntegerid,@RequestBodyAccountaccount){
MessageModelmessageModel=newMessageModel();
try{
accountService.saveOrUpdateAccount(account);
}catch(ParamsExceptione) {e.printStackTrace();
messageModel.setCode(e.getErrorCode());
messageModel.setMsg(e.getErrorMsg());
}catch(Exceptione) {e.printStackTrace();
messageModel.setCode(300);
messageModel.setMsg("操作失败!");
}
returnmessageModel;
}
Delete 请求配置
/**
* restful-->delete 请求 执行删除操作
* @param id
* @return
*/
@RequestMapping(value="deleteAccountById/{id}",method=RequestMethod.DELETE,produces=MediaType.APPLICATION_JSON_UTF8_VALUE)
@ResponseBody
publicMessageModelqueryAccountById05(@PathVariableIntegerid){
MessageModelmessageModel=newMessageModel();
try{
accountService.deleteAccountById(id);
}catch(ParamsExceptione) {e.printStackTrace();
messageModel.setCode(e.getErrorCode());
messageModel.setMsg(e.getErrorMsg());
}catch(Exceptione) {e.printStackTrace();
messageModel.setCode(300);
messageModel.setMsg("操作失败!");
}
returnmessageModel;
}
扩展~REST
REST(英文:Representational State Transfer,简称REST)描述了一个架构样式的网络系统,比如 web 应用程序。它首次出现在 2000 年 Roy Fielding 的博士论文中,Roy Fielding是 HTTP 规范的主要编写者之一。在目前主流的三种Web服务交互方案中,REST相比于SOAP(Simple Object Access protocol,简单对象访问协议)以及XML-RPC更加简单明了,无论是对URL的处理还是对Payload的编码,REST都倾向于用更加简单轻量的方法设计和实现。值得注意的是REST并没有一个明确的标准,而更像是一种设计的风格。
REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。