CN105743955A - 一种扩展JavaScript对象方法 - Google Patents

Abstract

一种扩展JavaScript对象的方法，所述方法包括：页面调用JavaScript对象，并将调用请求通过JavaScript层的自定义对象，Java层的对象，JNI的对象传递到C++层的对象；C++层的对象根据请求调用本地组件进行异步处理；处理结束之后，返回回调消息；C++层对象将回调的消息内容封装为JSON格式，通过socket客户端发送；在Java层，socket服务端接收消息，并把消息放在当前显示的WebView中的消息队列中；JavaScript层的自定义对象定时从消息队列中取出消息；触发JavaScript对象的事件，将消息以事件的形式通知页面。

Description

一种扩展JavaScript对象方法

技术领域

本发明涉及Android系统的Web应用领域，尤其涉及一种扩展JavaScript对象方法。

背景技术

随着HTML5的兴起，浏览器的功能逐渐丰富，可以实现一些本地化的功能，包括本地存储，视频播放等。以浏览器为载体的Web应用具有开发门槛低，容易移植等优点。为了丰富Web应用的功能，在构建Web应用的时候，一个重要的问题是需要将本地组件(一般为C/C++的动态库)的接口扩展为JavaScript(脚本，简写为JS)接口，供Web应用调用。

在现有技术中，如果要将本地组件扩展为JavaScript接口，需要在浏览器内核中将DOM(DocumentObjectModel，文档对象模型)模块扩展为DOM对象，然后将扩展的DOM对象注册给JavaScript引擎，扩展为对应的JavaScript对象。当JavaScript引擎解析JavaScript脚本时，调用JavaScript对象，然后通过DOM对象间接调用本地组件。

现有的在浏览器内核中扩展JavaScript对象的方法，需要编译Android系统的C++层浏览器内核源码，执行效率低；而且对于Android的不同版本，在浏览器内核中扩展的方案需要在不同的Android版本的源码中实现，通用性差，代码维护成本高。

发明内容

本发明的目的在于克服目前在Android系统浏览器内核中扩展JavaScript对象的方法中，存在的代码通用性差、维护成本高的缺陷，提供了一种扩展JavaScript对象的方法。

为了实现上述目的，本发明提供了一种扩展JavaScript对象的方法，包括：

步骤1)页面调用JavaScript对象，并将调用请求通过JavaScript层的自定义对象，Java层的对象，JNI的对象传递到C++层的对象；

步骤2)C++层的对象根据请求调用本地组件进行异步处理；

步骤3)当本地组件异步处理结束之后，返回回调消息；

步骤4)C++层对象将回调的消息内容封装为JSON格式，通过socket客户端发送；

步骤5)在Java层，socket服务端接收消息，并把消息放在当前显示的WebView中的消息队列中；

步骤6)JavaScript层的自定义对象定时从消息队列中取出消息；

步骤7)触发JavaScript对象的事件，将消息以事件的形式通知页面。

上述技术方案中，在所述步骤1)之前，对C++层，JNI层，Java层，JavaScript层的对象及其数据格式进行定义，包括：

步骤101)将C++层的对象封装为JSON格式；

步骤102)通过JNI将JSON格式的C++层的对象封装为Java对象；

步骤103)在WebView中基于Java对象注册自定义JavaScript对象；

步骤104)将JSON格式的自定义JavaScript对象转换为JavaScript对象。

上述技术方案中，所述步骤1)还包括：

在JavaScript对象中声明handlers属性，并实现addEventListener，removeEventListener和fireEvent这三个函数；将JavaScript对象事件命名为onPlay；页面调用JavaScript对象的addEventListener函数注册onPlay事件监听函数。

上述技术方案中，所述步骤5)中的消息队列为栈结构。

本发明的优点在于：

1、本发明的方法可以有效地解决本地组件和JavaScript对象之间的异步调用问题，相比于现有的在浏览器内核中扩展JavaScript对象的方法，本发明的方法不需要编译Android系统的C++层内核源码，提高了开发效率；

2、本发明的方法一次实现可以在多个Android版本中使用，通用性好。

附图说明

图1为本发明的扩展JavaScript对象的方法的示意图；

图2为本发明的各层对象的数据传递关系图；

图3为本发明的WebView和TVSEOTT的栈的示意图。

具体实施方式

在Android系统的应用开发框架中，为开发者提供了WebView组件。WebView是基于WebKit内核的浏览器组件，WebKit是用C++开发的浏览器内核，在Android系统中作为第三方库，WebKit是网页的布局和渲染引擎，将HTML/CSS/JavaScript脚本渲染为可见的页面，WebView是WebKit的Java层视图类。通过WebView组件，可以在Android应用程序中实现Web浏览功能，处理网络请求，显示页面。WebView提供了addJavascriptInterface接口，可以将Java对象注册到WebView中，在页面中可以通过JavaScript对象调用Java对象。但是如果要让JavaScript能够调用C++组件的接口，还需要完成Java和C++的相互调用。

在Android系统中，可以实现Java和C++的相互调用。AndroidNDK(NativeDevelopmentKit)是一套工具集合，允许使用C/C++语言实现应用程序的一部分，适用于开发的应中需要调用C++库这种情况。在Android的NDK开发中，需要通过JNI(JavaNativeInterface，Java本地接口)来实现Java和C++代码的互相调用。JNI支持Java和C/C++代码进行交互，并且有自己的原始数据类型和数据引用类型。

为了方便在C++层，Java层和JavaScript层之间测参数传递，在C++层做一层适配，将第三方库的返回结果封装为JSON(JavaScriptObjectNotation)字符串形式。JSON是一种轻量级的数据交换格式，用于描述数据结构，形式包括：对象，名称/值，值的有序列表，字符串，数值和布尔值。这种做法有如下两个好处，一是方便通过JNI的jstring类型传递参数；二是方便在JavaScript中通过eval函数来解析，还原为JavaScript对象。

在JavaScript层中，为了给Web开发者提供JavaScriptAPI，需要在JavaScript层将从Java层获取的JSON格式返回值转换为JavaScript对象，然后将对象的属性和方法进行封装，并提供事件机制。

实现本地组件和JavaScript对象的异步调用是一个难点，利用DOM事件模型，可以为JavaScript对象扩展自定义事件，实现与本地组件之间的异步调用。

DOM事件模型可以分为DOM0级别和DOM2级别两种类型。在DOM0级别的事件模型中，事件被注册为HTML元素的一个属性。例如button元素的onclick事件，假设btn是一个button元素，则通过代码：btn.onclick＝function()即可注册button的onclick事件，当按钮被鼠标单击时，就会调用监听函数，做出响应。DOM0级别的事件功能简单，使用方便。所有支持JavaScript的浏览器都支持DOM0级别的事件。

DOM2级别的事件模型，有两个主要的方法：addEventListener方法用于注册某个事件的监听函数，removeEventListener方法用于删除某个事件的监听函数，所有的DOM2节点都包含这两个方法。相比于DOM0级别的事件模型，DOM2级别事件模型功能强大，Chrome，Firefox，IE9等主流的浏览器都支持DOM2级别的DOM事件模型。

DOM中的事件模型是在浏览器内核中实现的，当JavaScript和DOM进行交互时，可以使用浏览器内部的事件处理机制，当JavaScript对象不是DOM元素时，需要在自定义的JavaScript对象中扩展事件机制。

本发明的方法基于AndroidNDK，将本地组件扩展为JavaScript接口，供上层页面调用。JavaScript调用本地组件时，可以通过同步调用和异步调用，在解决本地组件和JavaScript接口异步调用问题时，采用socket传递并在JavaScript层中定时取出消息，封装为JavaScript事件方式进行支持。

下面结合附图和具体实施例对本发明的方法做进一步的说明。

本实施例为：将本地C++动态库组件通过异步调用扩展为JavaScript对象，实现多源媒体聚合功能扩展。

如图1所示，一种扩展JavaScript对象的方法，包括：

步骤1)页面调用JavaScript对象，并将调用请求通过JavaScript层的自定义对象，Java层的对象，JNI的对象传递到C++层的对象；

如图2所示，在所述步骤1)之前，对C++层，JNI层，Java层，JavaScript层的对象及其数据格式进行定义，包括：

步骤101)将C++层的对象封装为JSON格式；

C++层的主要工作是对第三方库的返回结果做封装和适配，便于参数的传递和JavaScript层的处理。

将C++的对象定义为OTTVideo，对象OTTVideo可调用本地功能组件，通过开源库jsoncpp将第三方库的返回值封装为JSON格式，以字符串的形式返回，供JNI调用。

步骤102)通过JNI将JSON格式的C++层的对象封装为Java对象；

将Java层对象定义为TVSEOTT，将TVSEOTT对象调用的C++的方法声明为native方法。在JNI的OTTVideoJni.cpp中实现TVSEOTT.java中的native方法，这需要实现Java方法和native方法的映射表，注册给Java虚拟机(JVM)，这样JVM就可以通过函数映射表来调用相应的函数，Java与JNI通过JNINativeMethod(在jni.h中定义)的结构来建立联系。

在OTTVideoJni.cpp中调用OTTVideo中的方法，完成对第三方库的调用。将OTTVideoJni.cpp，OTTVideo和第三方库打包为动态库，在TVSEOTT中通过System.loadLibrary方法加载到内存中，这样通过JNI可以实现Java层的TVSEOTT到C++层的OTTVideo的调用。

步骤103)在WebView中基于Java对象注册自定义JavaScript对象；

在WebView中通过addJavascriptInterface方法，将TVSEOTT对象注册为自定义JavaScript对象，对象名为ottvideo_js，这样在JavaScript中可以使用ottvideo_js调用C++层代码。

步骤104)将JSON格式的自定义JavaScript对象转换为JavaScript对象；

自定义JavaScript对象ottvideo_js调用C++层代码，返回结果为JSON格式的字符串，不能直接使用；在JavaScript层将需要扩展的多源媒体聚合的JavaScript对象定义为ottvideo，它调用ottvideo_js获取结果，然后通过JavaScript层的eval函数将JSON格式的字符串转化为JavaScript对象。

在JavaScript对象ottvideo声明handlers属性，并实现addEventListener，removeEventListener和fireEvent这三个函数。将JavaScript对象事件命名为onPlay。

页面调用ottvideo对象的addEventListener函数注册onPlay事件监听函数。当页面请求视频的播放连接时，将请求依次通过JavaScript层中的ottvideo，ottvideo_js，Java层的TVSEOTT，JNI中的OTTVideoJni传递到C++层的OTTVideo。

步骤2)C++层的对象根据请求调用本地组件进行异步处理；

步骤3)当本地组件异步处理结束之后，返回回调消息；

步骤4)C++层对象将回调的消息内容封装为JSON格式，通过socket客户端发送；

在OTTVideo中，当被第三方库回调时，C++层的对象将回调的消息内容封装为JSON格式，通过socket客户端发送；

步骤5)在Java层，socket服务端接收消息，并把消息放在当前显示的WebView中的消息队列中；

如图3所示，在Java层实现socket服务端，接收C++层socket客户端发来的消息。在应用中，可能打开多个WebView窗口，每个WebView窗口都包含一个TVSEOTT的Java对象，所以要将底层C++传来的消息发送给优先级高的WebView中的TVSEOTT的对象，这就需要建立一个元素为<WebView,TVSEOTT>的栈，每次调用栈顶WebView的TVSEOTT对象的setMessage，将C++回调的消息传给当前显示的WebView的TVSEOTT对象，并在TVSEOTT内部维护消息队列，存放消息。

步骤6)JavaScript层的自定义对象定时从消息队列中取出消息；

在TVSEOTT中定义getMessage方法，返回JSON格式的消息；在ottvideo_js对象中通过setInterval方法，定时从TVSEOTT中通过调用其getMessage取出消息；

步骤7)触发JavaScript对象的事件，将消息以事件的形式通知页面。

在JavaScript层ottvideo对象调用ottvideo_js获取结果，然后通过JavaScript的eval函数将JSON格式的字符串转化为JavaScript对象。

调用函数fireEvent触发ottvideo中onPlay事件，并调用响应的监听函数做对onPlay事件的处理工作，将消息以事件的形式通知页面。

最后所应说明的是，以上实施例仅用以说明本发明的技术方案而非限制。尽管参照实施例对本发明进行了详细说明，本领域的普通技术人员应当理解，对本发明的技术方案进行修改或者等同替换，都不脱离本发明技术方案的精神和范围，其均应涵盖在本发明的权利要求范围当中。

Claims (4)

1.一种扩展JavaScript对象的方法，所述方法包括：

步骤1)页面调用JavaScript对象，并将调用请求通过JavaScript层的自定义对象，Java层的对象，JNI的对象传递到C++层的对象；

步骤2)C++层的对象根据请求调用本地组件进行异步处理；

步骤3)当本地组件异步处理结束之后，返回回调消息；

步骤4)C++层对象将回调的消息内容封装为JSON格式，通过socket客户端发送；

步骤5)在Java层，socket服务端接收消息，并把消息放在当前显示的WebView中的消息队列中；

步骤6)JavaScript层的自定义对象定时从消息队列中取出消息；

步骤7)触发JavaScript对象的事件，将消息以事件的形式通知页面。

2.根据权利要求1所述的扩展JavaScript对象的方法，其特征在于，在所述步骤1)之前，对C++层，JNI层，Java层，JavaScript层的对象及其数据格式进行定义，包括：

步骤101)将C++层的对象封装为JSON格式；

步骤102)通过JNI将JSON格式的C++层的对象封装为Java对象；

步骤103)在WebView中基于Java对象注册自定义JavaScript对象；

步骤104)将JSON格式的自定义JavaScript对象转换为JavaScript对象。

3.根据权利要求1所述的扩展JavaScript对象的方法，其特征在于，所述步骤1)还包括：

在JavaScript对象中声明handlers属性，并实现addEventListener，removeEventListener和fireEvent这三个函数；将JavaScript对象事件命名为onPlay；页面调用JavaScript对象的addEventListener函数注册onPlay事件监听函数。

4.根据权利要求1所述的扩展JavaScript对象的方法，其特征在于，所述步骤5)中的消息队列为栈结构。