CN104301443B - 一种在web页面上调用端能力接口的方法和系统 - Google Patents

Abstract

本发明提供了一种在web页面上调用端能力接口的方法和系统，其中方法包括：native应用中内嵌有http通信模块，web页面上的js接口模块向所述http通信模块的相应网络端口发送包含端能力接口调用信息的http请求；所述http通信模块接收到所述http请求后，根据所述端能力接口调用信息调用相应的端能力接口，并将调用结果数据包含在http响应中返回给所述js接口模块；所述js接口模块获取所述http响应中的调用结果数据。通过本发明能够提高移动web应用对端能力接口的调用能力。

Description

一种在web页面上调用端能力接口的方法和系统

【技术领域】

本发明涉及计算机应用技术领域，特别涉及一种在web页面上调用端能力接口的方法和系统。

【背景技术】

随着移动互联网的不断发展，native应用(又称本地应用)的劣势开始不断显露，诸如开发成本高，导致越来越多的移动开发者开始尝试或转向移动web应用的开发。其中native应用是一种基于智能手机本地操作系统并使用原生程式编写运行的第三方应用程序；web应用是运行于网络和标准浏览器上，基于网页技术开发实现特定功能的应用。

但移动web应用有个很致命的弱点，就是其对终端设备的端能力接口的调用能力很差，这一弱点对移动web应用的能力和发展带来了极大的限制。所谓端能力接口指的是终端设备中系统或应用暴露的接口，端能力接口是非JS接口，非网络接口，通过对端能力接口的调用能够实现访问设备的硬件接口、读取用户通讯录、访问本地文件、获取设备网络连接状况等功能。

【发明内容】

有鉴于此，本发明提供了一种在web页面上调用端能力接口的方法和系统，以便于提高移动web应用对端能力接口的调用能力。

具体技术方案如下：

本发明提供了一种在web页面上调用端能力接口的方法，native应用中内嵌有http(超文本传输协议)通信模块，该方法包括：

web页面上的js接口模块向所述http通信模块的相应网络端口发送包含端能力接口调用信息的http请求；

所述http通信模块接收到所述http请求后，根据所述端能力接口调用信息调用相应的端能力接口，并将调用结果数据包含在http响应中返回给所述js接口模块；

所述js接口模块获取所述http响应中的调用结果数据。

根据本发明一优选实施方式，所述native应用启动后，所述http通信模块开始侦听预设的一个或多个相应网络端口。

根据本发明一优选实施方式，所述http请求为JSONP(JSON with Padding)请求，所述http响应为JSONP响应；或者，

所述http请求为AJAX(Asynchronous Javascript And XML，基于XML的异步JavaScript)请求，所述http响应为AJAX响应；或者，

所述http请求为websocket(网页套接字)请求，所述http响应为websocket响应。

根据本发明一优选实施方式，当所述http请求为JSONP请求，所述http响应为JSONP响应时，所述将调用结果数据包含在http响应中返回给所述js接口模块具体包括：将所述调用结果数据以javascript代码的形式包含在响应中返回给所述js接口模块；

所述js接口模块获取所述http响应中的调用结果数据具体包括：所述js接口模块接收到所述响应后，执行所述javascript代码。

根据本发明一优选实施方式，所述JSONP请求包含：预设的所述http通信模块的相应网络端口号、要调用的端能力接口的标识信息以及js回调函数名称；

所述JSONP响应包含：根据调用结果数据和js回调函数名称生成的javascript代码。

根据本发明一优选实施方式，根据所述端能力接口调用信息调用相应的端能力接口包括：

如果所述端能力接口是所述http通信模块所在的native应用提供的接口，则通过直接的代码调用或者进程内通信机制调用相应的端能力接口；

如果所述端能力接口是所述http通信模块所在的native应用之外的其他应用提供的接口，则通过进程间通信机制调用相应的端能力接口。

本发明还提供了一种在web页面上调用端能力接口的系统，该系统包括：内嵌在native应用中的http通信模块以及web页面上的js接口模块；

所述js接口模块，用于向所述http通信模块的相应网络端口发送包含端能力接口调用信息的http请求；获取所述http通信模块返回的http响应包含的调用结果数据；

所述http通信模块，用于接收到所述http请求后，根据所述端能力接口调用信息调用相应的端能力接口，并将调用结果数据包含在http响应中返回给所述js接口模块。

根据本发明一优选实施方式，所述http通信模块在所述native应用启动后，开始侦听预设的一个或多个相应网络端口。

根据本发明一优选实施方式，所述http请求为JSONP请求，所述http响应为JSONP响应；或者，

所述http请求为AJAX请求，所述http响应为AJAX响应；或者，

所述http请求为websocket请求，所述http响应为websocket响应。

根据本发明一优选实施方式，当所述http请求为JSONP请求，所述http响应为JSONP响应时，所述将调用结果数据包含在http响应中返回给所述js接口模块具体包括：将所述调用结果数据以javascript代码的形式包含在响应中返回给所述js接口模块；

所述js接口模块获取所述http响应中的调用结果数据具体包括：所述js接口模块接收到所述响应后，执行所述javascript代码。

根据本发明一优选实施方式，所述JSONP请求包含：预设的所述http通信模块的相应网络端口号、要调用的端能力接口的标识信息以及js回调函数名称；

所述JSONP响应包含：根据调用结果数据和js回调函数名称生成的javascript代码。

根据本发明一优选实施方式，所述http通信模块，具体用于：

如果所述端能力接口是所述http通信模块所在的native应用提供的接口，则通过直接的代码调用或者进程内通信机制调用相应的端能力接口；

如果所述端能力接口是所述http通信模块所在的native应用之外的其他应用提供的接口，则通过进程间通信机制调用相应的端能力接口。

由以上技术方案可以看出，通过本发明只要在终端设备上安装了内嵌http通信模块的native应用，能够在web页面上方便地调用本地的端能力接口，从而提高移动web应用对端能力接口的调用能力。

【附图说明】

图1为本发明实施例提供的系统结构图；

图2为本发明实施例提供的方法流程图。

【具体实施方式】

为了使本发明的目的、技术方案和优点更加清楚，下面结合附图和具体实施例对本发明进行详细描述。

本发明提供的系统主要由如图1中所示的web页面的js接口模块和内嵌在native应用中的http通信模块组成。

其中，在终端设备中预先设置一个或多个本地的网络端口作为native应用中内嵌的http通信模块的相应网络端口。native应用被安装并启动后，native应用中内嵌的http通信模块开始侦听相应网络端口，从而接收来自本终端设备上其他应用或该native应用的其他模块发送的网络请求，该网络请求基于http协议。

web页面上的js接口模块具备以下功能：

1)向http通信模块的相应网络端口发送包含端能力接口调用信息的http请求。

2)接收到http通信模块返回的http响应后，从http响应中获取调用结果数据。

内嵌在native应用中的http通信模块具备以下功能：

1)从相应网络端口监听网络请求。

2)监听到js接口模块发送的http请求后，根据该http请求中包含的端能力接口调用信息调用相应的端能力接口。

3)将调用结果数据包含在http响应中返回给js接口模块。

基于上述系统，本发明提供的端能力接口的调用方法可以按照如图2中所示的流程执行：

当web页面需要用到相应的本地端能力时，在201中，web页面上的js接口模块向http通信模块的相应网络端口发送包含端能力接口调用信息的http请求。具体地，发送的http请求可以是JSONP请求，JSONP是资料格式JSON的一种使用模式，可以让网页从别的网域获取资料，当然除了JSONP之外，也可以采用其他的跨域交互的格式，本发明实施例中均以JSONP为例进行描述。js接口模块可以向预先配置的http通信模块的相应网络端口发送url为如下格式的JSONP请求：

http://127.0.0.1:{port}/{path}？{query_string}

其中，127.0.0.1为回送地址，指本地机的内部IP地址，主要用于网络软件测试以及本地机进程间通信，在本发明实施例中该地址用于js接口模块向http通信模块发送请求。

{port}表示预先配置的http通信模块的相应网络端口号。

{path}？{query_string}用于描述端能力接口调用信息，即web页面要调用的端能力接口的相关信息，包括端能力接口的标识信息以及js回调函数名称，还可能进一步包括端能力接口的输入参数的参数值。其中{query_string}可以至少包含一个表示js回调函数名称的GET参数，{path}可以为空。

在202中，http通信模块接收到上述http请求后，根据其中的端能力接口调用信息调用相应的端能力接口。

具体地，http通信模块接收到上述JSONP请求后，对该JSONP请求进行解析得到端能力接口的标识信息以及js回调函数名称(从{path}？{query_string}部分得到)，还可能得到端能力接口的输入参数的参数值，然后根据端能力接口的标识信息(还可能进一步结合端能力接口的输入参数的参数值)完成相应的端能力接口调用，并获取调用结果数据。

这里在进行端能力接口调用时，存在以下两种情况：

如果要调用的端能力接口是上述http通信模块所在的native应用所提供的接口，那么http通信模块通过直接的代码调用或操作系统提供的进程内通信机制来调用相应的端能力接口。具体地，http通信模块可以向相应端能力接口的实现模块发送接口调用请求，完成接口调用后端能力接口的实现模块会向http通信模块返回接口调用响应。其中，端能力接口的实现模块是现有技术中的已有模块，负责对相应的端能力接口执行相应端能力接口的具体调用。

如果要调用的端能力接口是上述http通信模块所在的native应用之外的其他应用所提供的接口，那么http通信模块可以通过操作系统提供的进程间通信机制来调用相应的端能力接口。进程间通信机制例如android系统中的后台服务调用机制、广播机制等。具体地，http通信模块可以与相应端能力接口的实现模块进行进程间通信发送接口调用请求，完成接口调用后端能力接口的实现模块会与http通信模块进行进程间通信返回接口调用响应。

在203中，http通信模块将调用结果数据包含在http响应中返回给js接口模块。具体地，http通信模块利用调用结果数据和js回调函数生成javascript代码，将该javascript代码以JSONP格式返回给http通信模块，即返回包含javascript代码的JSONP响应。

在204中，js接口模块接收到http通信模块返回的http响应后，获取http响应中的调用结果数据，具体地，执行JSONP响应中的javascript代码从而完成对调用结果数据的处理。

在此举一个例子，假设要实现在web页面上获取当前手机连接的网络状态，假设预先设置的http通信模块的相应网络端口号为7777，那么手机浏览器打开web页面后，通过在web页面上进行功能操作(例如点击获取当前手机连接的网络状态的按钮)可以触发web页面上的js接口模块发送如下JSONP请求：

http://127.0.0.1:7777/getnetworkstatus？callback＝onnetworkstatus

http通信模块预先被配置了从网络端口号为7777的网络端口监听其他native应用或者http通信模块所在native应用的其他模块发送来的请求。http通信模块从该网络端口监听到该JSONP请求后，确定要调用的端能力接口标识为getnetworkstatus，向对应的实现模块发送接口调用请求，getnetworkstatus的实现模块完成getnetworkstatus所标识的端能力接口的调用后，向http通信模块返回接口调用响应，该接口调用响应中包含调用结果数据。

http通信模块利用调用结果数据和js回调函数生成javascript代码，假设调用响应端能力接口后得到网络类型为3G，连接状态为已连接，则可以生成如下javascript代码：

onnetworkstatus({is_connected:1,net_type:’3G’})

然后将该javascript代码包含在JSONP响应中返回给js接口模块，这样js接口模块就能够执行该javascript代码，从而获知当前手机连接的网络状态。

由于http通信模块对外暴露的是一个http接口，因此在任何客户端(包括各种手机浏览器和各种native应用)内加载的web页面都可以通过JSONP请求的方式调用该http接口来实现web页面上的js与native代码层的通信，从而通过native代码层来实现对端能力接口的调用。

另外，除了上述JSONP格式之外，还可以采用其他跨域交互的格式，例如：如果http通信模块支持html5中定义的CORS(Cross Origin Resourse-Sharing，跨来源资源共享)协议，则web页面的js接口模块可以基于CORS协议发送AJAX请求，该AJAX请求中包含端能力接口调用信息。相应地，http通信模块将调用结果数据包含在AJAX响应中返回给js接口模块。

再例如：如果http通信模块支持html5中定义的websocket协议，则web页面的js接口模块可以基于websocket向http通信模块发送websocket请求，该websocket请求中包含端能力接口调用信息。相应地，http通信模块将调用结果数据包含在websocket响应中返回给js接口模块。

这两种格式与JSONP不同的是，AJAX响应和websocket响应中的调用结果数据可以是任意格式，不一定局限于javascript代码，也就是说，在AJAX请求和websocket请求中至少包含http通信模块的相应网络端口号和端能力接口的标识信息，但不一定包含js回调函数信息，相应地，在返回响应时，也不一定生成javascript代码。

由以上描述可以看出，本发明实施例提供的方法和装置具备以下优点：

1)本发明能够在web页面上方便地调用本地的端能力接口，就像普通的native应用调用本地的端能力接口一样，只要终端设备上安装了内嵌http通信模块的native应用，web页面就可以在任何native应用(包括普通手机浏览器)调用本地的端能力接口。

2)http通信模块利用调用结果数据和js回调函数生成javascript代码后提供给js接口模块，使得js接口模块可以执行javascript代码从而完成对调用结果数据的处理，这种方式响应较快，js接口模块的实现也比较简单。

在本发明所提供的几个实施例中，应该理解到，所揭露的系统，装置和方法，可以通过其它的方式实现。例如，以上所描述的装置实施例仅仅是示意性的，例如，所述单元的划分，仅仅为一种逻辑功能划分，实际实现时可以有另外的划分方式。

所述作为分离部件说明的单元可以是或者也可以不是物理上分开的，作为单元显示的部件可以是或者也可以不是物理单元，即可以位于一个地方，或者也可以分布到多个网络单元上。可以根据实际的需要选择其中的部分或者全部单元来实现本实施例方案的目的。

另外，在本发明各个实施例中的各功能单元可以集成在一个处理单元中，也可以是各个单元单独物理存在，也可以两个或两个以上单元集成在一个单元中。上述集成的单元既可以采用硬件的形式实现，也可以采用硬件加软件功能单元的形式实现。

上述以软件功能单元的形式实现的集成的单元，可以存储在一个计算机可读取存储介质中。上述软件功能单元存储在一个存储介质中，包括若干指令用以使得一台计算机设备(可以是个人计算机，服务器，或者网络设备等)或处理器(processor)执行本发明各个实施例所述方法的部分步骤。而前述的存储介质包括：U盘、移动硬盘、只读存储器(Read-Only Memory，ROM)、随机存取存储器(Random Access Memory，RAM)、磁碟或者光盘等各种可以存储程序代码的介质。

以上所述仅为本发明的较佳实施例而已，并不用以限制本发明，凡在本发明的精神和原则之内，所做的任何修改、等同替换、改进等，均应包含在本发明保护的范围之内。

Claims (10)

1.一种在web页面上调用端能力接口的方法，其特征在于，本地native应用中内嵌有超文本传输协议http通信模块，该方法包括：

web页面上的js接口模块向所述http通信模块的相应网络端口发送包含端能力接口调用信息的http请求；

所述http通信模块接收到所述http请求后，根据所述端能力接口调用信息调用相应的端能力接口，并将调用结果数据包含在http响应中返回给所述js接口模块；

所述js接口模块获取所述http响应中的调用结果数据；

其中，根据所述端能力接口调用信息调用相应的端能力接口包括：

如果所述端能力接口是所述http通信模块所在的native应用提供的接口，则通过直接的代码调用或者进程内通信机制调用相应的端能力接口；

如果所述端能力接口是所述http通信模块所在的native应用之外的其他应用提供的接口，则通过进程间通信机制调用相应的端能力接口。

2.根据权利要求1所述的方法，其特征在于，所述native应用启动后，所述http通信模块开始侦听预设的一个或多个相应网络端口。

3.根据权利要求1所述的方法，其特征在于，所述http请求为JSONP请求，所述http响应为JSONP响应；或者，

所述http请求为AJAX请求，所述http响应为AJAX响应；或者，

所述http请求为网页套接字websocket请求，所述http响应为websocket响应。

4.根据权利要求3所述的方法，其特征在于，当所述http请求为JSONP请求，所述http响应为JSONP响应时，所述将调用结果数据包含在http响应中返回给所述js接口模块具体包括：将所述调用结果数据以javascript代码的形式包含在响应中返回给所述js接口模块；

所述js接口模块获取所述http响应中的调用结果数据具体包括：所述js接口模块接收到所述响应后，执行所述javascript代码。

5.根据权利要求4所述的方法，其特征在于，所述JSONP请求包含：预设的所述http通信模块的相应网络端口号、要调用的端能力接口的标识信息以及js回调函数名称；

所述JSONP响应包含：根据调用结果数据和js回调函数名称生成的javascript代码。

6.一种在web页面上调用端能力接口的系统，其特征在于，该系统包括：内嵌在native应用中的http通信模块以及web页面上的js接口模块；

所述js接口模块，用于向所述http通信模块的相应网络端口发送包含端能力接口调用信息的http请求；获取所述http通信模块返回的http响应包含的调用结果数据；

所述http通信模块，用于接收到所述http请求后，根据所述端能力接口调用信息调用相应的端能力接口，并将调用结果数据包含在http响应中返回给所述js接口模块；

其中，所述js接口模块在根据所述端能力接口调用信息调用相应的端能力接口时，具体执行：

如果所述端能力接口是所述http通信模块所在的native应用提供的接口，则通过直接的代码调用或者进程内通信机制调用相应的端能力接口；

如果所述端能力接口是所述http通信模块所在的native应用之外的其他应用提供的接口，则通过进程间通信机制调用相应的端能力接口。

7.根据权利要求6所述的系统，其特征在于，所述http通信模块在所述native应用启动后，开始侦听预设的一个或多个相应网络端口。

8.根据权利要求6所述的系统，其特征在于，所述http请求为JSONP请求，所述http响应为JSONP响应；或者，

所述http请求为AJAX请求，所述http响应为AJAX响应；或者，

所述http请求为websocket请求，所述http响应为websocket响应。

9.根据权利要求8所述的系统，其特征在于，当所述http请求为JSONP请求，所述http响应为JSONP响应时，所述将调用结果数据包含在http响应中返回给所述js接口模块具体包括：将所述调用结果数据以javascript代码的形式包含在响应中返回给所述js接口模块；

所述js接口模块获取所述http响应中的调用结果数据具体包括：所述js接口模块接收到所述响应后，执行所述javascript代码。

10.根据权利要求9所述的系统，其特征在于，所述JSONP请求包含：预设的所述http通信模块的相应网络端口号、要调用的端能力接口的标识信息以及js回调函数名称；

所述JSONP响应包含：根据调用结果数据和js回调函数名称生成的javascript代码。