通过用js文件映射服务端的WebAPI,最终实现的效果就是在VS编辑器中直接可以“点”出方法名、参数。
var API = new Object();
/**
* @method _Ajax 异步请求方法
* @param {String} [_type] 请求类型(GET/POST/PUT/DELETE)
* @param {String} [_url] 请求的资源地址
* @param {Object} [_data] 请求时传入的数据为JSON对象
* @param {Function} [_okCall] 请求成功后的回调
* @param {Function} [_errorCall] 请求失败后的回调
*/
API._Ajax = function (_type, _url, _data, _okCall, _errorCall) {
$.ajax({
type: _type,
url: _url,
data: _data,
dataType: "json",
error: function (e) { if (_errorCall != undefined) _errorCall(e); else console.log(JSON.stringify(e)); },
success: function (data) { if (_okCall != undefined) _okCall(data); else console.log(JSON.stringify(data)); },
beforeSend: function (request) {
request.setRequestHeader("Custom-Auth-Name", window.localStorage.getItem("User-Account"));
request.setRequestHeader("Custom-Auth-Key", API._AuthenKey(_url));
},
});
}
/**
* @method _AuthenKey 生成请求密钥
* @param {String} [_resourceUri] 请求的资源地址
*/
API._AuthenKey = function (_resourceUri) {
/*生成guid*/
var Guid = function () {
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
var r = Math.random() * 16 | 0, v = c == 'x' ? r : (r & 0x3 | 0x8);
return v.toString(16);
});
};
/*MD5加密*/
var Md5 = function (_content, _md5Count) {
if (_md5Count == undefined) { _md5Count = 1; }
for (i = 0; i < _md5Count; i++) {
_content = CryptoJS.MD5(_content).toString().toUpperCase();
}
return _content;
};
/*用户的会话令牌*/
var Token = function () {
/*需要从数据库读取*/
var _userToken = window.localStorage.getItem("User-Token");
/*把token进行2次MD5加密,然后根据服务器格式截取前8位*/
var token = Md5(_userToken, 2).substr(0, 8);
/*转换成加密需要的格式*/
return CryptoJS.enc.Utf8.parse(token);
}
/*请求的资源地址*/
var ResourceUrl = function () {
/*生成GUID*/
var guid = Guid();
if (APP.Debug) {
console.log("guid:" + guid);
}
/*获取资源前缀*/
var BasePsotion = _resourceUri.indexOf("/api/");
/*将请求的资源地址去掉前缀*/
var ResourceUrl = _resourceUri.substr(BasePsotion);
if (APP.Debug) {
console.log("ResourceUrl:" + ResourceUrl);
}
/*把资源和guid做md5,然后在加空格和guid*/
var strToEncrypt = Md5(ResourceUrl + guid) + " " + guid;
if (APP.Debug) {
console.log("strToEncrypt:" + strToEncrypt);
}
/*转换成加密需要的格式*/
return CryptoJS.enc.Utf8.parse(strToEncrypt);
}
/*服务器加密IV*/
var IV = function () { return CryptoJS.enc.Utf8.parse("12345678"); }
/*生成验证密钥*/
var AuthKey = CryptoJS.DES.encrypt(ResourceUrl(), Token(), { iv: IV() });
if (APP.Debug) {
console.log("AuthKey:" + AuthKey);
}
/*返回*/
return AuthKey;
}
/**
* @class API._Method Http请求方法枚举
*/
API._Method = {
/**
* @property Post POST
*/
Post: "POST",
/**
* @property Get GET
*/
Get: "GET",
/**
* @property Put PUT
*/
Put: "PUT",
/**
* @property Delete DELETE
*/
Delete: "DELETE"
};
/**
* @method _Initialise 初始化内部的API方法
*/
API._Initialise = function () {
var APIAgrements = function (_APIUrl) {
var reg = new RegExp(/\{[a-zA-Z0-9_]{1,}\}/g);
var args = _APIUrl.match(reg)
var result = new Array();
if (args != null && args.length > 0) {
for (var i = 0; i < args.length; i++) {
result.push(args[i].substr(1, args[i].length - 2));
}
}
return result;
}
for (var i = 0; i < API._Controller.length; i++) {
var ctrl = API._Controller[i];
/*当前API需要的参数集合*/
var args = APIAgrements(ctrl.Url);
/*拼接API调用时需要传入的参数*/
var apiArgs = args.length > 0 ? (args.join(",") + ",") : "";
var apiUrl = "'";
if (args.length > 0) {
var urlFormat = new Array();
for (var q = 0; q < args.length; q++) {
urlFormat.push('"' + args[q] + '":' + args[q] + '');
}
apiUrl += ".format({" + urlFormat.join(",") + "})";
}
var api = "API." + ctrl.Name + " = function (" + apiArgs + "_data,_okCall,_errorCall) {" +
"var type='" + (ctrl.Method == undefined ? API._Method.Get : ctrl.Method) + "';" +
"var url ='" + ctrl.Url + apiUrl + ";" +
"API._Ajax(type,url,_data,_okCall,_errorCall);" +
"}";
eval("(" + api + ")");
}
}
/**
* @class API._Controller API映射
* 所有配置在这里写
* 【API配置示例】
* 说明:映射License控制器的_CheckLicenseCode方法
* 代码:{ Name: "License", Url: "http://localhost:45617/api/Licenses",Method:API._Method.Post },
* 【API调用示例】
* API.License({ LicenseCode: "FZYF-YDBG" });
* 【其他说明】
* 1,配置API时,Method字段不是必需定义的,默认请求方式是GET
* 2,调用API时,如果不传成功/失败回调方法,框架自动在控制台打印响应内容(测试用)
*/
API._Controller = [
/**
* @property License 授权信息
* @param {String} [DeviceMac] 设备物理地址
* @param {String} [DeviceOS] 设备操作系统信息
* @param {String} [PhoneNumber] 设备注册使用的手机号
* @param {String} [LicenseCode] 录入的验证码
*/
{ Name: "License", Url: "http://192.168.0.111:8866/api/Licenses", Method: API._Method.Post },
/**
* @property NewsCatalog 新闻分类
*/
{ Name: "NewsCatalog", Url: "http://192.168.0.111:8866/api/NewsCatalogs" },
/**
* @property News 新闻列表
* @param {String} [id] 新闻分类的id
*/
{ Name: "News", Url: "http://192.168.0.111:8866/api/TextNews/{id}/News" },
/**
* @property News_Detal 新闻详情
* @param {String} [subid] 新闻id
*/
{ Name: "News_Detal", Url: "http://192.168.0.111:8866/api/TextNews/{NewsID}/Content" },
/**
* @property Logo 图片
*/
{ Name: "Logo", Url: "http://192.168.0.111:8866/api/Corps/{id}/Logo" },
/**
* @property UserAccount账号信息
* @param {String} [UserName] 设备物理地址
* @param {String} [Account] 设备操作系统信息
* @param {String} [Password] 设备注册使用的手机号
* @param {String} [Token] 录入的验证码
* @param {String} [OwnerDept] 录入的验证码
* @param {String} [OwnerDeptID] 当前部门ID
*/
{ Name: "UserAccount", Url: "http://192.168.0.111:8866/api/UserAccounts" },
];
API._Initialise();
备注:以上代码是项目中的,实际还需要修改一下。 这样的话直接在VS编辑器中引入这个文件,就能点出来了