Ajax-Data-Model
ajax 数据请求模型封装。在 ajax 请求的生命周期过程中,实现基于项目约定的通用行为操作。
特性
- umd 支持
- memory/sessionStorage/localStorage 级数据缓存支持
- Promise thenable 风格的 API 调用
- 基于接口约定的通用回调处理支持(通用错误处理、loading 状态、通用参数、埋点上报<接口超时、接口错误、接口异常、数据埋点等>...)
快速开始
1. 下载安装
手动下载:到代码仓库下载 release 的 zip 包,取得 dist
目录内文件即可。
npm 方式:
npm i --save ajax-data-model
2. 使用
2.1 浏览器中直接引用使用
A. 引入 jquery.min.js
和 adm.jquery.min.js
<script src="lib/jquery/juqery.min.js"></script><script src="lib/ajax-data-model/adm.jquery.min.js"></script>
B. 使用
<script> var adm = windowadm; // 全局性设置 adm; // 使用 adm;</script>
2.2 ES6 方式使用
A. 全局性设置
// adm.js;; // 全局性设置adm; // 示例:注册添加 API 到 adm 上(方便引用)admrestapi = userlist: '/rest/user/list';// todo more... ;
具体可参考 src/common/settings.js
中的参数配置示例。
B. 使用
;// 使用示例adm;
更多详细用法示例:USEAGE.md
命令脚本与二次开发
npm start
:开启3131
端口 web 服务,进行测试开发。npm run dev
:开启开发监听模式,监听src
目录。npm test
:mocha + chai
测试(需先执行npm start
)。npm run build
:构建生产环境使用源码 (mini) 到lib
目录。npm run jsdoc
:生成jsdoc
风格的API
文档。
API
请参阅: API
License
ajax-data-model is released under the MIT license.
该插件由志文工作室开发和维护。