最近公司在做一个项目，通过把我们自己的webview植入第三方app，然后我们的业务全部通过h5实现。至于为什么不直接用第三方app webview,主要是身处金融行业，需要做一些风控相关功能。
由于是hybrid app的性质，所以web与native的通信是无法避免的；而为什么我要封装jsbridge，主要在于下面两点：
公司app的jsbridge提供了数据的序列化和全局函数的注入，而我们这次由于包大小考虑，这一块需要h5自己来实现；
原生提供的接口协议太多，记住麻烦；
回调的写法不太人性化，期望promise;
由于本次项目只涉及到andriod，所以没有关于ios的处理，但我自认为他们只是协议的不同，web的处理可以相同。
原理浅谈
看上图的通信实现（图片来源于文章开头的文章），简单说一下通信过程；
webview加载时会将原生提供的jsbridge方法注入到window对象上，比如：window.jsbridge.getdeviceinfo就是原生提供的可以读取一些设备标识信息的接口；
h5通过window调用原生接口，基本都需要传参，比如这次处理成功或则处理失败的结果回调的，还有一些参数设置，拿上面给的方法来举例：
window.jsbridge.getdeviceinfo({
token: '*&^%$$#*',
onok(data) {
save(data);
}，
onerror(error) {
console.log(error.message);
}
});
原生响应h5的调用成功或失败后，就执行h5传递过来的回调函数；
过程结束；
看上面的通信过程，貌似很简单。但这里面存在一些协议的问题：
首先h5与原生端的通信消息，是只支持字符串的，如果要传js对象，那就先序列化；
序列化带来的后果又是，对象中的函数就无法传递；
而就算函数传过去了，也是存在问题的，由于安全的限制，webview和js的执行没有在一个容器中，回调这种局部函数是找不到的，所以是需要将回调函数注册到全局；
所以下面就来解决这些问题
一步一步的具体实现
接口协议封装
什么意思喃？看下面的图：
由于app端协议及分包问题, 存在多个bridge, 比如mbdevice、mbcontrol、mbfinance，上面列出来的只是一小部分，对于web来说记忆这些接口是一件很费事的事；还有就是以前我调app的jsbridge, 总有下面这样的代码：
window.jsbridge && window.jsbridge.getdeviceinfo && window.jsbridge.getdeviceinfo({ ... })
至于上面，所以加了一层封装，实现的核心就是proxy和map，具体实现看下面的伪代码：
const mbsdk = {
};
// sdk 提供的方法白名单
const whitelist = new map([
['setmaxtime', 'mbvideo'],
['getdeviceinfo', 'mbdevice.getinfo'],
['close', 'mbcontrol'],
['getfinaceinfo', 'mbfinance.getinfo'],
]);
const handler = {
get(target, key) {
if (!whitelist.has(key)) {
throw new error('方法不存在');
}
const parentkey = whitelist.get(key);
function callback() {
return [...parentkey.split('.'), key];
}
return new proxy(callback, applyhandler); // funchandler后面再展开
},
};
export default new proxy(mbsdk, handler);
基于上面的封装，调用时，代码就是下面这样
sdk.setmaxtime({
maxtime: 10,
}).then(() => {
console.log('设置成功');
}, () => {
window.alert('调用失败');
});
序列化与回调注册
上面已经列了为什么需要回调函数全局注册和序列化，这里主要说一下实现原理，总得来说分两步;
回调函数剥离，全局注册；
参数序列化；
回调函数剥离和参数序列化
其实很好实现，直接展开运算符搞定：
const { onok, onerror, ...others } = params; // 回调函数剥离
const str = json.stringify(others); // 参数序列化
函数全局注册
看了很多文章的一些实现，思路基本一致，比如下面这样
window.bridgecallbacks = {};
const callbacks = window.bridgecallbacks;
const { onok, onerror, ...others } = params; // 回调函数剥离const callbackid = generateid(); // 产生一个唯一的随机数id
callbacks[`success_${callbackid}`] = onok;
callbacks[`onerror${callbackid}`] = onerror;others.success = `window.bridgecallbacks.success_${callbackid}`
// ....
// 调用jdk代码
这是一种很容易想到的问题，但却存在一些问题，比如：
bridgecallbacks全局会注册很多属性，因为native调用并没有清理，而onok这种很多时候是一个闭包，由于有引用，最后导致的问题就是内存泄露；
就算处理了第一步的问题，webview无响应怎么办，那回调就会被一直挂起，确少超时响应逻辑
callbackid的唯一性不好保证;
基于以上考虑，我换了一个方案，采用回调队列，因为app端说过，回调是按顺序的，不会插队；
class callheap {
constructor() {
this.okqueue = [];
this.errorqueue = [];
}
success = (args) => {
// 成对弹出回调：成功时，不止要处理成功的回调，失败的也要同时弹出，
const target = this.okqueue.shift();
this.errorqueue.shift();
target && target(args);
}
error = (args) => {
const target = this.errorqueue.shift();
this.okqueue.shift();
target && target(args);
}
addqueue(onok = null, onerror = null) {
this.okqueue.push(onok);
this.errorqueue.push(onerror);
}
}
window.bridgecallbacks = {};
const callbacks = window.bridgecallbacks;
function applyhandler() {
const { onok, onerror, ...others } = params; // 回调函数剥离
if (onok || onerror) {
const callkey = transferkey || key; // transferkey || key后面会提到
// 如果全局未注册，则先注册对应的调用域
if (!callbacks[callkey]) {
callbacks[callkey] = new callheap();
}
// 添加回调
callbacks[callkey].addqueue(onok, onerror);
others.success = `callbacks.${callkey}.success`;
others.error = `callbacks.${callkey}.error`;
}
// 调用jdk代码
}
基于以上的实现，就可以保证发起多个native请求，并保证有序回调；如果成功，成功回调被响应时，响应的失败回调也会被弹出，因为回调函数式存在数组中的，所以执行完后，引用就不会再存在。
完整实现
看了上面的代码实现，但核心好像还没有提及，那就是调用参数的拦截。前面我们用proxy的get优雅的实现了sdk方法的拦截，这里会接着采用proxy的apply方法来拦截方法调用的传参，直接看代码吧：
// 结合最上面接口协议封装的代码一起看
const applyhandler = {
apply(target, object, args) {
// transferkey 用于getfinaceinfo与getdeviceinfo这种数据命名重复的
const [parentkey, key, transferkey] = target();
console.log('res', parentkey, key);
const func = (sdk[parentkey] || {})[key];
const { onok, onerror, ...params } = args[0] || {};
if (onok || onerror) {
const callkey = transferkey || key;
if (!callbacks[callkey]) {
callbacks[callkey] = new callheap();
}
callbacks[callkey].addqueue(onok, onerror);
others.success = `callbacks.${callkey}.success`;
others.error = `callbacks.${callkey}.error`;
}
return func && (window[parentkey][key])(json.stringify(params));;
}
};
promise 封装
前面吹过的牛逼还有两个没实现，比如：
promise支持
超时调用
首先来复习一下，怎么封装一个支持promise的settimeout函数：
function promisetimeout(time) {
return new promise((resolve, reject) => {
settimeout(resolve, time);
});
}
promisetimeout(1000).then(() => {
console.log('time is ready');
})
如果对上面这个封装不陌生，那基于回调函数的promise化就变得简单了
talk is cheap, show me your code
完整实现：
const mbsdk = {
};
// sdk 提供的方法白名单
const whitelist = new map([
['setmaxtime', 'mbvideo'],
['getdeviceinfo', 'mbdevice.getinfo'],
['close', 'mbcontrol'],
['getfinaceinfo', 'mbfinance.getinfo'],
]);
const applyhandler = {
apply(target, object, args) {
// transferkey 用于getfinaceinfo与getdeviceinfo这种数据命名重复的
const [parentkey, key, transferkey] = target();
// fyx 编程
const func = (window[parentkey] || {})[key];
// 设置一个默认的超时参数，支持配置
const { timeout = 5000, ...params } = args[0] || {};
return new promise((resolve, reject) => {
const callkey = transferkey || key;
if (!callbacks[callkey]) {
callbacks[callkey] = new callheap();
}
const timeoutid = settimeout(() => {
// 超时，主动发起错误回调
window.callbacks[callkey].error({ message: '请求超时' });
}, timeout);
callbacks[callkey].addqueue((data) => {
cleartimeout(timeoutid);
resolve(data);
}, (data) => {
cleartimeout(timeoutid);
reject(data);
});
params.success = `callbacks.${callkey}.success`;
params.error = `callbacks.${callkey}.error`;
func && (window[parentkey][key])(json.stringify(params));
}).catch((error) => {
console.log('error:', error.message);
});
}
};
const handler = {
get(target, key) {
if (!whitelist.has(key)) {
throw new error('方法不存在');
}
const parentkey = whitelist.get(key);
function callback() {
return [...parentkey.split('.'), key];
}
return new proxy(callback, applyhandler); // funchandler后面再展开
},
};
export default new proxy(mbsdk, handler);
而调用时，基本上，就可以这样玩了：
sdk.setmaxtime({
maxtime: 10,
}).then(() => {
console.log('设置成功');
}, () => {
window.alert('调用失败');
});
解惑
- func.call(null, json.stringify(params)) // 以前的
+ func && (window[parentkey][key])(json.stringify(params)); // 现在的
开始函数的调用是采用func.call来实现的，当时我本地mock过，没有问题。但在webview中就弹出了下面这样一个错误：
java bridge method can't be invoked on a non-injected object
经过各种goggle，百度，查到的都是一条关于andriod的注入漏洞。而至于我这里通过js的方式把bridge指向的函数地址，赋值给一个变量名，然后再通过变量名来调用就会报上面这个错误，我个人的猜测有两个：一是协议这样规定的；二是this指向问题。
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。
