领有jfinal/activejdbc相通的activerecord的纰漏策画，使用更浅易的restful框架。

restful的api策画，是手脚restful的事业端***选拔（使用场景：客户端和事业端解藕，用于对静态的html客户端（mvvm等），ios，andriod等提供事业端的api接口）

一、特别优点：

1.极简的route策画:

  @GET("/users/:name")  //在旅途中自界说贯通的参数 要是有其他顺应 也不错用 /users/{name}  // 参数名即是措施变量名  除旅途参数以外的参数也不错放在措施参数里  传递口头 user={json字符串}  public Map find(String name,User user) {    // return Lister.of(name);    return Maper.of("k1", "v1,name:" + name, "k2", "v2");//复返什么数据径直return，透彻融入平凡措施的口头  } 

2.极简的activerecord策画，数据操作只需短短的一转 ，支援批量保存对象

//批量保存  User u1 = new User().set("username", "test").set("providername", "test").set("password", "123456");  User u2 = new User().set("username", "test").set("providername", "test").set("password", "123456");  User.dao.save(u1,u2);     //平凡保存  User u = new User().set("username", "test").set("providername", "test").set("password", "123456");  u.save();     //更新  u.update();  //要求更新  User.dao.updateBy(where,paras);  User.dao.updateAll(columns,where,paras);     //删除  u.deleted();  //要求删除  User.dao.deleteBy(where,paras);  User.dao.deleteAll();     //查询  User.dao.findById(id);  User.dao.findBy(where,paras);  User.dao.findAll();     //分页  User.dao.paginateBy(pageNumber,pageSize,where,paras);  User.dao.paginateAll(pageNumber,pageSize); 

3.极简的客户端策画，支援各式申请，文献上传和文献下载（支援断点续传）

Client client=null;//创建客户端对象  //启动resty-example神志，即可测试客户端  String apiUrl = "http://localhost:8081/api/v1.0";  //要是不需要 使用账号登陆  //client = new Client(apiUrl);  //要是有账号权限截止  需要登陆  client = new Client(apiUrl, "/tests/login", "u", "123");     //该申请必须  登陆之后才能打听  未登录时复返 401  未认证  ClientRequest authRequest = new ClientRequest("/users", HttpMethod.GET);  ResponseData authResult = client.build(authRequest).ask();  System.out.println(authResult.getData());     //get  ClientRequest getRequest = new ClientRequest("/tests", HttpMethod.GET);  ResponseData getResult = client.build(getRequest).ask();  System.out.println(getResult.getData());     //post  ClientRequest postRequest = new ClientRequest("/tests", HttpMethod.POST);  postRequest.addParameter("test", Jsoner.toJSONString(Maper.of("a", "谔谔")));  ResponseData postResult = client.build(postRequest).ask();  System.out.println(postResult.getData());     //put  ClientRequest putRequest = new ClientRequest("/tests/x", HttpMethod.PUT);  ResponseData putResult = client.build(putRequest).ask();  System.out.println(putResult.getData());        //delete  ClientRequest deleteRequest = new ClientRequest("/tests/a", HttpMethod.DELETE);  ResponseData deleteResult = client.build(deleteRequest).ask();  System.out.println(deleteResult.getData());        //upload  ClientRequest uploadRequest = new ClientRequest("/tests/resty", HttpMethod.POST);  uploadRequest.addUploadFiles("resty", ClientTest.class.getResource("/resty.jar").getFile());  uploadRequest.addParameter("des", "test file  paras  测试笔");  ResponseData uploadResult = client.build(uploadRequest).ask();  System.out.println(uploadResult.getData());        //download  支援断点续传  ClientRequest downloadRequest = new ClientRequest("/tests/file", HttpMethod.GET);  downloadRequest.setDownloadFile(ClientTest.class.getResource("/resty.jar").getFile().replace(".jar", "x.jar"));  ResponseData downloadResult = client.build(downloadRequest).ask();  System.out.println(downloadResult.getData()); 

4.支援多量据源和嵌套事务（使用场景：需要打听多个数据库的垄断，大略手脚公司里面的数据中间件向客户端提供数据打听api等）5.极简的权限策画，你只需要已毕一个浅易接口和添加一个遏制器，即可已毕基于url的权限策画

// 在resource里使用事务,也即是controller里，rest的寰球以为是以的申请皆示意资源，是以这儿叫resource  @GET("/users")  @Transaction(name = {DS.DEFAULT_DS_NAME, "demo"}) //多量据源的事务，要是你惟有一个数据库  径直@Transaction 不需要参数  public User transaction() {  //TODO 用model现实数据库的操作  只消有操作抛出额外  两个数据源 皆会回滚  固然不是漫衍式事务  也能保证代码块的数据现实安全  }     // 要是你需要在service里已毕事务，通过java动态代理（必须使用接口，jdk策画即是这么）  public interface UserService {    @Transaction(name = {DS.DEFAULT_DS_NAME, "demo"})//service里添增多量据源的事务，要是你惟有一个数据库  径直@Transaction 不需要参数    public User save(User u);  }  // 在resource里使用service层的 事务  // @Transaction(name = {DS.DEFAULT_DS_NAME, "demo"})的注解需要写在service的接口上  // 矜重java的自动代理必须存在接口  // TransactionAspect 是事务切面 ，你也不错已毕我方的切面比如日记的Aspect，已毕Aspect接口  // 再private UserService userService = AspectFactory.newInstance(new UserServiceImpl(), new TransactionAspect(),new LogAspect());  private UserService userService = AspectFactory.newInstance(new UserServiceImpl(), new TransactionAspect()); 

5.极简的权限策画，你只需要已毕一个浅易接口和添加一个遏制器，即可已毕基于url的权限策画

public void configInterceptor(InterceptorLoader interceptorLoader) {  //权限遏制器 放在***位 ***时代判断 幸免现实无谓要的代码    interceptorLoader.add(new SecurityInterceptor(new MyAuthenticateService()));  }  //已毕接口  public class MyAuthenticateService implements AuthenticateService {    //登陆时 通过name取得用户的密码和权限信息    public Principal findByName(String name) {      DefaultPasswordService defaultPasswordService = new DefaultPasswordService();         Principal principal = new Principal(name, defaultPasswordService.hash("123"), new HashSet<String>() {{        add("api");      }});          return principal;    }      //基础的权限总表  是以的url权限皆放在这儿  你不错通过 文献大略数据库大略径直代码 来开导系数权限    public Set<Permission> loadAllPermissions() {      Set<Permission> permissions = new HashSet<Permission>();      permissions.add(new Permission("GET", "/api/transactions**", "api"));          return permissions;    }  } 

6.极简的缓存策画，可彭胀，相配浅易即可启用model的自动缓存功能7.下载文献，只需要径直return file

public void configConstant(ConstantLoader constantLoader) {    //启用缓存并在要自动使用缓存的model上  开启缓存@Table(name = "sec_user", cached = true)    constantLoader.setCacheEnable(true);  }     @Table(name = "sec_user", cached = true)  public class User extends Model<User> {    public static User dao = new User();     } 

7.下载文献，只需要径直return file

@GET("/files")  public File file() {    return new File(path);  } 

8.上传文献，通过getFiles，getFile把文献写到事业器

@POST("/files")  public UploadedFile file() {    //Hashtable<String, UploadedFile> uploadedFiles=getFiles();    return getFile(name);  } 

9.天然亦然支援传统的web开发，你不错我方已毕数据贯通，在config里添加自界说的贯通模板

public void configConstant(ConstantLoader constantLoader) {    // 通事后缀来复返不同的数据类型  你不错自界说我方的  render  如：FreemarkerRender    // constantLoader.addRender("json", new JsonRender());    //默许已添加json和text的支援，只需要把自界说的Render add即可  } 

二、脱手example示例：

1.脱手根目次下的pom.xml->install （把干系的插件装配到土产货，功能完善之后发布到maven就不需要这么了）

2.在土产货mysql数据库里创建demo,example数据库，对应application.properties的数据库树立

3.脱手resty-example下的pom.xml->flyway-maven-plugin:migration，自动根具resources下db目次下的数据库文献生成数据库表结构

4.脱手resty-example下的pom.xml->tomcat7-maven-plugin:run,启动example才气

辅导:推选idea手脚开发ide，使用分模块的多module开发。

源码齐集：OSC -> Resty   Github -> Resty

本文出自：http://my.oschina.net/wangrenhui1990/blog/365310