资讯专栏INFORMATION COLUMN

EasyBridge:一种简单的js-bridge设计方案

xcold / 2821人阅读

摘要:以这个工具库作为依赖,只需要编写实际通讯接口目前混合开发的方案包括就是一种简单的解决方案。基于接口粒度的安全控制策略每一个实例也都会持有一个的实例,用于针对具体的开发接口设置安全检查规则。

EasyBridge是一个简单易用的js-bridge的工具库,提供了日常开发中,JavaScript与Java之间通讯的能力,与其他常见的js-bridge工具库实现方案不同,EasyBridge具备以下几个特点:

基于Android WebViewaddJavascriptInterface特性实现

提供了基于接口粒度的安全管理接口

轻量级,并且简单易用。以这个工具库作为依赖,只需要编写实际通讯接口

Principle

目前混合开发的方案包括:

JSBridge

Cordova

React Native

Flutter

EasyBridge就是一种简单的JSBridge解决方案。在众多的解决方案中,基本都是在利用系统的WebView所开放的接口,打开Java与JavaScript通讯的渠道,这些方案的实现原理分别包括:

拦截onJsPrompt()方法

WebView中的页面调用了JavaScript当中的window.prompt()方法的时候,这个方法会被回调。而且这个方法不仅能获取到JavaScript传递过来的string字符串内容,同时也能返回一段string字符串内容被JavaScript接收到,是一个相当适合构建bridge的入口方法。

拦截shouldOverrideUrlLoading()方法

当页面重新load URL或者页面的iframe元素重新加载新的URL的时候,这个方法被回调。

addJavascriptInterface()接口

这个接口简单却强大,通过这个接口,我们能够直接把Java中定义的对象在JavaScript中映射出一个对应的对象,使其直接调用Java当中的方法,但是,在android 4.1及之前的版本存在着严重的漏洞,所以一直被忽视。

EasyBridge在众多的解决方案中,最终了选择了addJavascriptInterface()接口作为方案的基础,主要基于以下几点考量:

目前Android版本已经到了9.0版本,市面上Android4.4之前的版本手机占有率已经很低,很多业务都已经把最低兼容版本定在了4.2以上,在这种情况下可以不考量4.1以下存在的漏洞问题;

addJavascriptInterface()能够提供最简单的同步调用

addJavascriptInterface()evaluateJavascript()/loadUrl结合,能够带来更加简单的异步调用的解决方案

方案结构

EasyBridge的方案结构如下图所示:

EasyBridge总共会向页面中注入两个JavaScript对象,:

easyBridge

在页面加载到25%以上的时候(onProgressChanged()),通过执行工具库中的一个js文件注入的。这个对象主要的作用是定义了业务页面的JavaScript代码调用native的Java代码的规范入口,对象中定义的一个最关键的函数就是callHandler(handlerName, args, callback),这就是桥梁的入口。实际上在这个方法的内部,最终就是通过下面的_easybridge对象进入到Java代码层。

_easybridge

通过addJavascriptInterface()映射和注入的一个对象,这个对象提供了实质的入口方法enqueue(),在这个方法当中代码的路线从JavaScript层进入到了Java层,开启了两者的交互。

接口分发

实际上,我们可以通过@JavascriptInterface注解开放很多的接口给JavaScript层调用,也可以通过addJavascriptInterface()映射多个Java对象到JavaScript层,但是为了维护简单和通讯方便,EasyBridge的设计只提供了一个入口和一个出口。所有需要开放给JavaScript层的功能,都是通过构建接口实例进行处理。

接口的定义如下:

public interface BridgeHandler {

    String getHandlerName();

    void onCall(String parameters, ResultCallBack callBack);

    SecurityPolicyChecker securityPolicyChecker();
}

实际的工作流程如下图所示:

最开始初始化的时候需要注册所有可以被JavaScript层调用的业务接口。在运行的过程中,enqueue()入口当中会根据协议定义,通过接口名称找到对应的处理接口实例,并触发接口响应。并且最终的接口响应都在入口处进行回传。因此,实际上,_easybridge对象(在Java层中,其实是EasyBridge的实例)就是一个枢纽站,做任务的分派和结果的传递。

安全控制

EasyBridge的安全检查通过实现下面的接口对象来完成:

public interface SecurityPolicyChecker {
    boolean check(String url, String parameters);
}

内部提供了两级的安全控制策略,分别对应全局的安全控制策略和基于接口粒度的安全控制策略:

全局安全控制策略

EasyBridgeWebView对象当中,持有SecurityPolicyChecker用于进行全局的安全检查。全局的安全检查在EasyBridge的内部发生在以下两个时机:

Java注入bridge的时候

根据当前加载的页面url和参数信息,判断是否需要在页面中注入bridge。如果被安全规则拦截,则之前通过addJavaScriptInterface()注入的对象会被移除,也不会向页面中注入bridge对象,确保安全。

JavaScript调用具体的Java接口的时候

在执行具体的Java开放的接口方法之前, 也会先触发全局的安全检查规则。

基于接口粒度的安全控制策略

每一个BridgeHandler实例也都会持有一个SecurityPolicyChecker的实例,用于针对具体的开发接口设置安全检查规则。每一个接口在接收到分派的指令之前,会先调用其安全控制策略,根据当前加载的页面地址以及传入的指令参数判断是否需要进行指令的分派,否则将会直接命令安全受限,错误返回,结果调用。

Feture

✔️ 注入jsbridge重试机制

✔️ 使用apt技术注册handler

✔️ JavaScript调用Java功能

✔️ Java调用JavaScript功能

✔️ 安全控制策略

关于EasyBridge的feature的详细说明以及整个工具库的使用,可以参考我的GitHub仓库中的说明。

整个工具库比较简单和小巧,欢迎大家对这种实现方案存在的问题提出改进的意见,谢谢

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/69010.html

相关文章

  • TIC主视觉为例:围绕一个理念做设计全过程

    摘要:在此次大会中,全面阐释了极简产品背后蕴涵极深的技术,首次系统表达了自己的产品理念,而大会主视觉也始终紧贴着这一理念进行设计。视觉方向的探索本次大会最初的关键词是简和深,我们首先要做的是根据大会的主题关键词,来提取出能表述大致画面的视觉方向。2018年11月25日,UCloud用户大会暨Think in Cloud 2018在上海如期召开。在此次大会中,UCloud全面阐释了极简产品背后蕴涵极...

    rottengeek 评论0 收藏0
  • 模式系统与最简单Node.js MVC Web Server设计

    摘要:模式记录了已得到充分证明的既有设计经验。模式有助于创建具有指定特征的软件。每个模式都说明了运行阶段的行为。应用设计模式不会影响软件系统的基本架构,但可能严重影响子系统的架构。成例如何解决特定的设计问题。 学了这么久的设计模式,最近一直在看Node.js的设计模式,一直纳闷为何会有模式这一类东西的存在,那么模式究竟是什么东西?后面在看了《面向模式的软件架构》之后才慢慢知道有了一些系统的概...

    codercao 评论0 收藏0
  • 重构改善既有代码设计(重构原则)

    摘要:难以通过重构手法完成设计的改动先想像重构的情况。何时不该重构现有代码根本不能正常运作。现在,我可以修改这个子类而不必承担午一中影响另一处的风险。 重构:对软件内部结构的一种调整,目的是再不改变软件的可观察行为的前提下,提高其可理解性,降低其修改成本。 两顶帽子 添加新功能 添加新功能时不应该修改既有代码,只管添加新功能,通过测试重构 重构时你就不能再添加功能,只管改进程序结构,此时...

    XUI 评论0 收藏0
  • 一名【合格】前端工程师自检清单

    摘要:在他的重学前端课程中提到到现在为止,前端工程师已经成为研发体系中的重要岗位之一。大部分前端工程师的知识,其实都是来自于实践和工作中零散的学习。一基础前端工程师吃饭的家伙,深度广度一样都不能差。 开篇 前端开发是一个非常特殊的行业,它的历史实际上不是很长,但是知识之繁杂,技术迭代速度之快是其他技术所不能比拟的。 winter在他的《重学前端》课程中提到: 到现在为止,前端工程师已经成为研...

    罗志环 评论0 收藏0
  • 一名【合格】前端工程师自检清单

    摘要:在他的重学前端课程中提到到现在为止,前端工程师已经成为研发体系中的重要岗位之一。大部分前端工程师的知识,其实都是来自于实践和工作中零散的学习。一基础前端工程师吃饭的家伙,深度广度一样都不能差。开篇 前端开发是一个非常特殊的行业,它的历史实际上不是很长,但是知识之繁杂,技术迭代速度之快是其他技术所不能比拟的。 winter在他的《重学前端》课程中提到: 到现在为止,前端工程师已经成为研发体系...

    isaced 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<