Java极简 restful 框架,Resty 1.1.0-SNAPSHOT 版,快速接入 Spring
Resty从最初开发到现在已经经历了近10个月时间,在github的star数即将进入400,在没有任何推广的情况,目前的情况还是比较可观的,主要感谢关注restful发展的人们。
对于不理解restful的人其实就是一个url地址的规范,但我从来不这么认为,我一直觉得rest是一种理念,就行java教你面向对象一样,rest教你面向资源,不再以功能来实现接口,以对资源的操作方式来实现接口,目前就我自己使用的情况来说,大多是比较好的反响:
1.接口真的是简单到了极致(而且非常),比如:
登录:
curl -X POST http://users.api.demo.com/sessions \ -H "Content-Type: application/json" \ -d '{"username": "admin","password":"111111","rememberMe":"false"}'
退出登录:
curl -X DELETE http://users.api.demo.com/sessions
获取当前登录用户:
curl -X GET http://users.api.demo.com/sessions
等等,接口使用者觉得非常简洁优雅,利于管理
2.当你开源预测接口的行为时,你可以做更多的全局性处理,比如在实际情况中:针对某种资源做权限,根据GET,POST,DELETE,PUT等操作做ETag和缓存处理,GET使用缓存,POST,DELETE,PUT更新缓存,及时接口分布在不同的项目缓存也具有即时性,等等
3.直面http,不需要你做额外的设计,http已经为你准备好了,快来进入restful的世界吧
扯淡完了,说说Resty Maven的快照版1.1.0-SNAPSHOT的更新内容:
1.快速接入Spring
导入spring的包:
<dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>${spring-context.version}</version> </dependency>
编写Spring的启动配置(默认使用注解的方式,使用xml的同学请查阅@ImportResource注解),配置Spring扫描路径,支持多个
@Configuration @ComponentScan(basePackages = {"cn.dreampie.service"}) public class HelloApp { }
在Resty的AppConfig中配置SpringPlugin
public void configPlugin(PluginLoader pluginLoader) { pluginLoader.add(new SpringPlugin(HelloApp.class)); }
然后编写你的Spring class吧
//接口 public interface HelloService { public String hello(); } @Component public class HelloServiceImpl implements HelloService { public String hello() { return "hello"; } }
在Resource中使用,和原本Spring的方式无区别,你会以为这是一个纯Spring应用,但是route部分确比Spring mvc更简洁
@Autowired private HelloService helloService; @GET public String get() { return helloService.hello(); }
Spring集成就是这么简单,这么完美(什么Dubbo+zookeeper早已不在话下)。
2.resty-cache缓存添加过期时间,orm部分使用@Table(expired=10000)
3.resty-security的加密功能提供密钥
public class Encryptioner { public static String md5(String srcStr) { return encrypt("MD5", srcStr, null); } public static String md5(String srcStr, String salt) { return encrypt("MD5", srcStr, salt); } public static String sha1(String srcStr) { return encrypt("SHA-1", srcStr, null); } public static String sha1(String srcStr, String salt) { return encrypt("SHA-1", srcStr, salt); } public static String sha256(String srcStr) { return encrypt("SHA-256", srcStr, null); } public static String sha256(String srcStr, String salt) { return encrypt("SHA-256", srcStr, salt); } public static String sha384(String srcStr) { return encrypt("SHA-384", srcStr, null); } public static String sha384(String srcStr, String salt) { return encrypt("SHA-384", srcStr, salt); } public static String sha512(String srcStr) { return encrypt("SHA-512", srcStr, null); } public static String sha512(String srcStr, String salt) { return encrypt("SHA-512", srcStr, salt); } }
4.添加Headers参数获取所有的header
@GET("/headers") public Headers headers(Headers headers) { return headers; }
5.添加XForwardedSupports,add config in application.properties
app.xForwardedSupports=* 或者确定的ip地址 app.xForwardedSupports=127.0.0.1,127.0.0.2
6.修复其他一般性bug和部分代码重构优化