RESTful入门指导（未完，继续更新）

• 三分钟彻底了解Restful最佳实践：https://blog.csdn.net/chenxiaochan/article/details/73716617
• 设计一套良好REST API:https://blog.csdn.net/u011001084/article/details/79524095
• =============================================================================================
• REST是一种分布式应用的架构风格。
• Java8的lambda表达式在大数据处理，尤其在Spark中是默认的语法表达式。
• 现在已经无法回去都部署war到Tomcat时代。哈哈哈............
• REST的6个特点分别是：客户端-服务器的、无状态的、可缓存的、统一接口、分层系统和按需编码。
• RESTful对应的中文是REST式的，RESTful Web Service的准确翻译应该是REST式的Web服务，通常简称为REST服务。
• RESTful Web Service是一种遵守REST式风格的Web服务。REST服务是一种ROA（面向资源的框架）应用。其主要特点是方法信息存在于HTTP协议的方法中（比如GET、PUT），作用域存在URL中。例如，在一个设别资源列表的GET请求中，方法信息是GET，作用域信息是URL中包含的对设备资源的过滤、分页和排序等条件。
• HTTP+URL+XML是REST的基本实现形式。
• JAX-RS是Java领域的REST式的Web服务的标准规范，是使用Java完成REST服务的基本约定。

 

• REST服务和RPC服务在接口定义上的区别是：REST使用HTTP协议的通用方法作为统一接口的标准词汇，REST服务所提供的方法信息都在HTTP方法里，而RPC服务所提供的方法信息在SOAP/HTTP信封里（其封装的格式通常是HTTP或SOAP）,每一个RPC式的Web服务都会公布一套符合自己商业逻辑的方法词汇。

 

• 每一种HTTP请求方法都需要从安全性和幂等性两方面考虑，安全性是指外系统对该接口的访问，不会是服务器端资源的状态发生改变；幂等性是指外系统对同一REST接口的多次访问，得到的资源状态是相应的。

 

• @QueryParam示例列表(注解定义查询参数)

1. 分页查询列表数据（接口描述）：/query-resource/yijings?start=24&size=10(资源地址)
2. 排序并分页查询列表数据：/query-resource/sorted-yijings?limit=5&sort=pronounce
3. 查询单项数据：/query-resource/yijings?id=8