CherryRest Rest接口调用方式 项目简介
CherryRest一种非常优雅的Rest接口调用方式Features基于Restful风格接口设计的模块化接口url生成器集中管理接口url默认使用 fetch 作为接口加载器可以给模块单独设置 baseUrl支持 response formatter 配置、支持单个 module formatter内置默认 filter,当前只有一个 over,重载 response data filedInstallnpm install cherry-rest --saveUsageimport Cherry,{module as CherryModule,config as CherryConfig} from 'cherry-rest'基于业务Rest接口定义模块//方式一
CherryModule('name');
//方式二、定义多个模块、模块设置别名
CherryModule('module2|home,moudle3|user');
//方式三、复合继承模式
CherryModule([{
name:'module3',
alias:'about',
children:[{
name:'info',
},{
name:'concat'
}]
}]);调用Cherry.module3.info.query({query:{id:1}}).then(res=>res)
//fetch get /about/info?id=1;
Cherry.module3.info.create({body:{name:1}}).then(res=>res)
//fetch post /about/info {name:1};
Cherry.module3.info.update({query:{id:1}}).then(res=>res)
//fetch put /about/info?id=1;
Cherry.module3.info.remove({path:'1,2'}).then(res=>res)
//fetch delete /about/info/1/2;Testimport Cherry,{module as CherryModule,config as CherryConfig} from '../dist/index.js'
//http://ip.taobao.com/service/getIpInfo.php?ip=114.114.114.114
jest.setTimeout(1200000);
CherryConfig({
credentials:'include'
},{
baseUrl:'http://ip.taobao.com',
formatter:function(res){
return res.json()
}
})
CherryModule('ip|service',{
formatter:[function(data){
return data.data;
}],
filters:[{
name:'over',
options:['city_id|id']
}]
});
it('async & filters test', () => {
expect.assertions(1);
return Cherry.ip.query({path:'getIpInfo.php',query:{ip:'114.114.114.114'}}).then(data => {
expect(JSON.stringify(data)).toEqual(JSON.stringify({"id":"320100"}))
});
});DemoBaseAPI Example:get http://www.baidu.com/mock/v1/userget http://www.baidu.com/mock/v1/user?id=${userId}get http://www.baidu.com/mock/v1/user/${userId}/blogsget http://www.baidu.com/mock/v1/bookspost http://www.baidu.com/mock/v1/user {name:'hello'}put http://www.baidu.com/mock/v1/user/{userId} {name:'world'}//import
import Cherry,{module as CherryModule,config as CherryConfig} from 'cherry-rest'
//基于rest业务接口定义模块
//配置baseUrl
CherryConfig({
//默认使用fetch请求数据、这里可以配置fetch
fetch:{},
common:{
baseUrl:'http://www.baidu.com'
}
})
//定义模块
CherryModule([{
name:'app',
alias:'mock',
children:[{
name:'version',
alias:'v1',
children:[{
name:'user'
},{
name:'books'
}]
}]
}])
let User=Cherry.app.version.user;
let Book=Cherry.app.version.app;
//GET http://www.baidu.com/mock/v1/user
User.query()
//GET http://www.baidu.com/mock/v1/user?id=123
User.query({query:{id:'123'}})
//POST http://www.baidu.com/mock/v1/user {name:'hello'}
User.create({body:{name:'hello'}})
//PUT http://www.baidu.com/mock/v1/user/123 {name:'world'}
User.update({path:'123',body:{name:'world'}})
//GET http://www.baidu.com/mock/v1/user/${userId}/blogs
User.query({path:['123','blogs'])
//DELETE http://www.baidu.com/mock/v1/user/123
User.remove({path:'123')
CherryModule('name');
//方式二、定义多个模块、模块设置别名
CherryModule('module2|home,moudle3|user');
//方式三、复合继承模式
CherryModule([{
name:'module3',
alias:'about',
children:[{
name:'info',
},{
name:'concat'
}]
}]);调用Cherry.module3.info.query({query:{id:1}}).then(res=>res)
//fetch get /about/info?id=1;
Cherry.module3.info.create({body:{name:1}}).then(res=>res)
//fetch post /about/info {name:1};
Cherry.module3.info.update({query:{id:1}}).then(res=>res)
//fetch put /about/info?id=1;
Cherry.module3.info.remove({path:'1,2'}).then(res=>res)
//fetch delete /about/info/1/2;Testimport Cherry,{module as CherryModule,config as CherryConfig} from '../dist/index.js'
//http://ip.taobao.com/service/getIpInfo.php?ip=114.114.114.114
jest.setTimeout(1200000);
CherryConfig({
credentials:'include'
},{
baseUrl:'http://ip.taobao.com',
formatter:function(res){
return res.json()
}
})
CherryModule('ip|service',{
formatter:[function(data){
return data.data;
}],
filters:[{
name:'over',
options:['city_id|id']
}]
});
it('async & filters test', () => {
expect.assertions(1);
return Cherry.ip.query({path:'getIpInfo.php',query:{ip:'114.114.114.114'}}).then(data => {
expect(JSON.stringify(data)).toEqual(JSON.stringify({"id":"320100"}))
});
});DemoBaseAPI Example:get http://www.baidu.com/mock/v1/userget http://www.baidu.com/mock/v1/user?id=${userId}get http://www.baidu.com/mock/v1/user/${userId}/blogsget http://www.baidu.com/mock/v1/bookspost http://www.baidu.com/mock/v1/user {name:'hello'}put http://www.baidu.com/mock/v1/user/{userId} {name:'world'}//import
import Cherry,{module as CherryModule,config as CherryConfig} from 'cherry-rest'
//基于rest业务接口定义模块
//配置baseUrl
CherryConfig({
//默认使用fetch请求数据、这里可以配置fetch
fetch:{},
common:{
baseUrl:'http://www.baidu.com'
}
})
//定义模块
CherryModule([{
name:'app',
alias:'mock',
children:[{
name:'version',
alias:'v1',
children:[{
name:'user'
},{
name:'books'
}]
}]
}])
let User=Cherry.app.version.user;
let Book=Cherry.app.version.app;
//GET http://www.baidu.com/mock/v1/user
User.query()
//GET http://www.baidu.com/mock/v1/user?id=123
User.query({query:{id:'123'}})
//POST http://www.baidu.com/mock/v1/user {name:'hello'}
User.create({body:{name:'hello'}})
//PUT http://www.baidu.com/mock/v1/user/123 {name:'world'}
User.update({path:'123',body:{name:'world'}})
//GET http://www.baidu.com/mock/v1/user/${userId}/blogs
User.query({path:['123','blogs'])
//DELETE http://www.baidu.com/mock/v1/user/123
User.remove({path:'123')