发布于 2015-12-08 10:26:00 | 262 次阅读 | 评论: 0 | 来源: 网友投递
Resty 极简的RESTful框架
restful的api设计，是作为restful的服务端最佳选择（使用场景：客户端和服务端解藕，用于对静态的html客户端（mvvm等），ios，andriod等提供服务端的api接口）
Resty目前积累到450 star，还有1个多月满一年了，在没有推广的情况下如果能积累到500 star，真是棒棒的，如果觉得不错可以给颗心(https://github.com/Dreampie/Resty)，希望大家多多鼓励，也希望有心的同学参与维护，开源说明它属于大家，无论你使用或者作为一个框架的基础学习还是从中得到灵感做出好用的东西 都希望你能和大家一起分享 开源希望大家互相帮助
本次更新说大不大说小不小，主要解决一下对api的控制问题：
1.使用header来控制api版本
最初设计的api控制方式主要基于url的版本控制，更新时要么提供一个基础的ApiResource，要么提供一个新的项目做为新版本接口，作为一个强迫症一直对此功能心怀不满，我一直以来对团队要求都是只要更新没有影响到整体返回的数据结构，是不允许升级接口的版本号的，兼容老版本非常重要，如果遇到重构和结构大规模变化，通过header来提供一个新的api并保留老api一段时间(我们为客户端提供了强制升级计划，一旦启动客户端必须升级到新版本)，后续会把老的api清理掉，理论上一个api最多存在两个版本，如果不是只能说明你设计的接口稳定性较弱，自由可控对强迫症来说非常重要，示例：
@GET(value = "/:get", headers = {"Accept: application/vnd.resty.v1+json"})//使用：来分割key和value
public WebResult<List<User>> get(String get, Date x, HttpResponse response) {
throw new WebException(HttpStatus.NO_CONTENT, "xxx");
}
2.读写分离的数据源支持，简单配置不需要考虑太多，同时提醒：如果本次请求的事务范围内即有读由有写，会根据你的@Transaction注解的事务来使用连接，比如需要写入库的连接，那么读取时也会使用写入库的连接，节省一次打开读取库连接的资源
//读写分离
DruidDataSourceProvider writeDsp = new DruidDataSourceProvider("write");
DruidDataSourceProvider readDsp = new DruidDataSourceProvider("read");
ActiveRecordPlugin activeRecordDdsp = new ActiveRecordPlugin("readwrite", writeDsp, readDsp);
activeRecordDdsp.addIncludePackages("cn.dreampie.resource");
pluginLoader.add(activeRecordDdsp);
另外一直对使用java代码的动态代理实现的aop感觉不好，如果有人能提供基于aspectj的嵌入代码来实现事务来提高代码的优化，那就非常感谢了，目前有个aspectj简单的例子：https://github.com/Dreampie/aspectj-demo