RESTFul API设计指南及使用说明

RESTFul API设计指南及使用说明

一、 协议
API与用户的通信协议，使用HTTP协议。

二、 域名
应尽量将API部署在专用域名之下（http://api.example.com）
也可以将API放在主域名下（http://example.com/api）

三、 版本
应该将API的版本号放入URL（http://example.com/api/v1.0）

四、 路径与映射
REST的关键原则与将你的API分割成逻辑资源紧密相关。使用HTTP请求控制这些资源，

RESTFul原则提供了HTTP methods映射作为策略来处理CRUD actions，

需要继承Resource父类如下：

@API()：类注解，括号类为类请求路径，如@API("/api/v1.0")

@GET()：方法注解，查询，括号内为方法请求路径，如GET("/user")，如果通过API直接访问，括号可不加
@GET("/:id")：方法注解，根据ID查询,括号内表示可根据ID直接查询结果
@POST()：方法注解，新增，括号内为方法请求路径，如果通过API直接访问，括号可不加
@PUT()：方法注解，修改，括号内为方法请求路径，如果通过API直接访问，括号可不加
@DELETE()：方法注解，删除，括号内为方法请求路径，如果通过API直接访问，括号可不加


五、 资源(Model)常用方法，需要继承Model父类
1：findBy(String where,Object... params)：根据条件查询

public List<M> findBy(String username,String password){
Model modelDao = new Model();
List<M> list = modelDao.findBy("username=? AND password=?",username,password);
return list;
}

2：findById(Object id)：根据ID查询

public Model findById(Object id){
Model modelDao = new Model();
Model model = modelDao.findById(id);
return model;
}

3: findFirstBy(String where,Object... params)：根据条件查询，返回第一条数据

public Model findFirstBy(String username,String password){
Model modelDao = new Model();
Model model = modelDao.findFirstBy("username=? AND password=?",username,password);
return model;
}

4: findAll()：查询所有

public List<M> findAll(){
Model modelDao = new Model();
List<M> list = modelDao.findAll();
return list;
}

5：findColsBy(String colums, String where, Object... params)：查询相关列信息

public List<M> findColsBy(String username,String password){
Model modelDao = new Model();
List<M> list = modelDao.findColsBy("id,username,password","username=? AND password=?",username,password)
return list;
}

6: save()：添加

public boolean save(){
Model model = new Model();
model.set("username","test");
model.set("password","123456");
boolean flag = model.save();
return flag;
}

7：save(Model model)：添加

public boolean save(Model model){
Model modelDao = new Model();
boolean flag = modelDao.save(model);
return flag;
}

8：save(List<M> list)：批量添加

public boolean save(List<M> list){
Model modelDao = new Model();
boolean flag = modelDao.save(list);
return flag;
}

9：update()：更新

public boolean update(){
Model model = new Model();
model.set("id",1);
model.set("username","test");
model.set("password","123456");
boolean flag = model.update();
return flag;
}

10：update(String sql,Object... params)：更新或删除 sql为更新语句时更新，为删除语句时删除

public boolean update(String username,String password,int id){
Model modelDao = new Model();
String sql = "update user set username=?,password=? where id=?";
boolean flag = modelDao.update(sql,username,password,id);
return flag;
}

11：delete()：删除

public boolean delete(){
Model model = new Model();
model.set("id",1);
boolean flag = model.delete();
return flag;
}

12：deleteBy(String where,Object... params)：根据条件删除

public boolean deleteBy(String username,String password){
Model modelDao = new Model();
boolean flag = modelDao.deleteBy("username=? AND password=?",username,password);
return flag;
}

13：deleteById(Object id)：根据ID删除

public boolean deleteById(int id){
Model modelDao = new Model();
boolean flag = modelDao.deleteById(id);
return flag;
}

14：fullPaginate(int pageNumber, int pageSize, String sql, Object... params)：分页查询

public FullPage<M> fullPaginate(int pageNumber, int pageSize,String username,String password) {
Model modelDao = new Model();
String sql = "select * from user where username=? AND password=?";
FullPage<M> fullPage = modelDao.fullPage(pageNumber,pageSize,sql,username,password);
return fullPage;
}

//注：fullPage.getList()获取查询结果 fullPage.getTotalRow()获取总条数