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()获取总条数