Spring技术内幕之Restful(01)-Restful风格

谁践踏了优雅 2022-07-24 07:19 222阅读 0赞

**Restful  
REST概述:  
一种软件架构风格，设计风格而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。  
  
  
REST创始人：Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格  
  
  
  
  
REST使用程度：  
目前在三种主流的Web服务实现方案中，因为REST模式的Web服务与复杂的SOAP和XML-RPC对比来讲明显的更加简洁，越来越多的web服务开始采用REST风格设计和实现。例如，Amazon.com提供接近REST风格的Web服务进行图书查找；雅虎提供的Web服务也是REST风格的  
  
  
REST目的：  
REST 从资源的角度来观察整个网络，分布在各处的资源由URL确定，而客户端的应用通过URL来获取资源的表征。获得这些表征使这些应用程序转变了其状态。随着不断获取资源的表征，客户端应用不断地在转变着其状态，所谓表述性状态转移（Representational State Transfer）。  
这一观点不是凭空臆造的，而是通过观察当前Web互联网的运作方式而抽象出来的。  
Roy Fielding 认为，  
“设计良好的网络应用表现为一系列的网页，这些网页可以看作的虚拟的状态机，用户选择这些链接导致下一网页传输到用户端展现给使用的人，而这正代表了状态的转变”  
  
  
Rest标准  
需要注意的是，REST是设计风格而不是标准。REST通常基于使用HTTP，URL，和XML以及HTML这些现有的广泛流行的协议和标准。  
1.资源是由URL来指定。  
2.对资源的操作包括获取、创建、修改和删除资源，这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE方法。  
3.通过操作资源的表现形式来操作资源。  
4.资源的表现形式则是XML或者HTML，取决于读者是机器还是人，是消费web服务的客户软件还是web浏览器。当然也可以是任何其他的格式。  
  
  
Rest的要求  
1.客户端和服务器结构  
2.连接协议具有无状态性  
3.能够利用Cache机制增进性能  
4.层次化的系统  
  
  
  
  
REST状态  
应该注意区别应用的状态和连接协议的状态。REST对于连接的无状态性实际上要求每次经过无状态的连接协议传送的信息必须包含应用中所有的状态信息。  
  
  
RESTful Web 服务  
RESTful Web 服务（也称为 RESTful Web API）是一个使用HTTP并遵循REST原则的Web服务。它从以下三个方面资源进行定义：  
1.URL，比如：http://example.com/resources/。  
2.Web服务接受与返回的互联网媒体类型，比如：JSON，XML ，YAML 等。  
3.Web服务在该资源上所支持的一系列请求方法（比如：POST，GET，PUT或DELETE）。  
  
  
Rest的优势  
1.可以利用缓存Cache来提高响应速度  
2.通讯本身的无状态性可以让不同的服务器的处理一系列请求中的不同请求，提高服务器的扩展性  
3.浏览器即可作为客户端，简化软件需求  
4.相对于其他叠加在HTTP协议之上的机制，REST的软件依赖性更小  
5.不需要额外的资源发现机制  
6.在软件技术演进中的长期的兼容性更好  
  
  
Rest例子：**

/user/1　HTTP　GET　=>　　得到id　=　1的user
    /user/1　HTTP　DELETE　=>　删除　id　=　1的user
    /user/1　HTTP　PUT　=>　　更新id　=　1的user
    /user　　HTTP　POST　=>　　新增user

**Spring 构建Rest的DEMO:**

@Controller
    @RequestMapping("/user")
    public class SysUserController {
    	
    
    
    	//查看------>/user/1
    	@RequestMapping(value = "/{id}", method = RequestMethod.GET)
    	public @ResponseBody DemoUser view(@PathVariable String id){
    		return demoUserService.findById(id);
    	}
    
    
    	//新增------>/user
    	@RequestMapping(method = RequestMethod.POST)
    	public @ResponseBody Message create(DemoUser demoUser){
    		demoUser.setProcessState(ProcessBizEngineService.PROCESS_NEW_STATE);
    		demoUserService.save(demoUser);
    		return MessageUtil.message("demoUser.create.success");
    	}
    	
    	//更新----->/user/1
    	@RequestMapping(value = "/{id}", method = RequestMethod.PUT)
    	public @ResponseBody Message create(@PathVariable String id, DemoUser demoUser){
    		demoUser.setId(id);
    		demoUserService.update(demoUser);
    		return MessageUtil.message("demoUser.update.success");
    	}
    	
    	
    	//删除---->/user/1
    	@RequestMapping(value = "/{id}", method = RequestMethod.DELETE)
    	public @ResponseBody Message delete(@PathVariable String id){
    		demoUserService.deleteById(id);
    		return MessageUtil.message("demoUser.delete.success");
    	}
    	
    	//批量删除---->/user/1
    	@RequestMapping(method = RequestMethod.DELETE)
    	public @ResponseBody Message batchDelete(@RequestParam("ids[]") String[] ids){
    		demoUserService.deleteById(ids);
    		return MessageUtil.message("demoUser.delete.success");
    	}
    	
    	//查询全部数据
    	@RequestMapping(value = "/all", method = RequestMethod.GET)
    	public @ResponseBody List<DemoUser> getAll(){
    		return demoUserService.findAll(new Sort(Direction.DESC, "createDate"));
    	}
    	
    	
    }