Resty 1.1.0-SNAPSHOT 版,极简 restful 框架,快速接入 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和部分代码重构优化

文章转载自 开源中国社区[https://www.oschina.net]

上一篇:Python面对对象编程


下一篇:【Spark Summit EU 2016】SparkOscope:优化Spark的跨栈监控与可视化框架