CN104852939A - 一种部署能力接口的方法和系统 - Google Patents

Abstract

本发明公开了一种部署能力接口的方法和系统。包括：能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，并根据该调用请求调用能力平台的至少一个内部接口；从能力平台获取与调用请求对应的调用结果后，返回给应用。本发明提供了统一的、标准化、规范化的接口，以及快速灵活部署能力接口的手段。

Description

一种部署能力接口的方法和系统

技术领域

本发明涉及移动互联网领域，尤其涉及一种部署能力接口的方法和系统。

背景技术

移动互联网的方式决定了现在通过开放平台的API来吸引用户使用相关平台，目前电信业界也逐渐开放各类业务系统的能力接口供外部使用。其中，能力接口的风格统一性、调用方式的标准化和规范化性、快捷的部署能力是衡量能力开放系统的一个主要标准，开发者在使用这些API时往往期望能够使用到简单高效、风格统一的API。因此，整体的能力接口部署进度受到各能力平台的多类接口标准扩展性制约，无法快速且有效的推进。

发明内容

本发明的发明人发现上述现有技术中存在问题，并因此针对所述问题中的至少一个问题提出了一种新的技术方案。

根据本发明一方面，提出一种部署能力接口的系统，包括能力接口网关以及能力平台，其中：

能力平台提供至少一个内部接口；

能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，并根据该调用请求调用能力平台的至少一个内部接口；从能力平台获取与调用请求对应的调用结果后，返回给应用。

进一步，能力接口网关包括接口调用接入模块、插件调度管理模块、标准处理转换模块、调用转换模块、以及上下文状态管理模块，其中：

接口调用接入模块对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，判断该调用请求是转换请求还是代理请求，如果是转换请求，则将该调用请求转发给插件调度管理模块；

插件调度管理模块将调用请求分发给标准处理转换模块和调用转换模块进行处理；

标准处理转换模块进行格式处理，处理后返回给上下文状态管理模块；

调用转换模块按照设置的业务处理顺序依次调用能力平台的内部接口，将能力平台返回的处理结果保存在上下文状态管理模块；

上下文状态管理模块将标准处理转换模块和能力平台返回的处理结果合成后，得到与调用请求对应的获取地址，将该获取地址返回给插件调度管理模块，由插件调度管理模块返回给接口调用接入模块，由接口调用接入模块返回给应用。

进一步，能力接口网关还包括逆向代理模块，其中：

接口调用接入模块判断该调用请求是代理请求，则将该请求转发给逆向代理模块；

逆向代理模块调用能力平台的内部接口，接收能力平台返回的与调用请求对应的获取地址，并将该获取地址返回给接口调用接入模块，由接口调用接入模块返回给应用。

进一步，调用请求为http请求，根据该http请求中的URL判断该调用请求是转换请求还是代理请求。

进一步，转换请求是指向外提供统一的外部接口，其内部实现为至少一次内部接口调用；代理请求是指将接收的调用请求直接转发给内部接口。

根据本发明另一方面，还提出一种部署能力接口的方法，包括：

能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，并根据该调用请求调用能力平台的至少一个内部接口；

从能力平台获取与调用请求对应的调用结果，返回给应用。

进一步，通过该外部接口接收应用的调用请求的操作，包括：

判断该调用请求是代理请求还是转换请求，如果是转换请求，则将该调用请求按照设置的业务处理顺序依次调用能力平台的内部接口，并接收能力平台返回的处理结果；

将格式处理的结果与能力平台返回的处理结果合成后，得到与调用请求对应的获取地址，将该获取地址返回给应用。

进一步，通过该外部接口接收应用的调用请求的操作，包括：

判断该调用请求是转换请求还是代理请求，如果是代理请求，能力接口网关调用能力平台的至少一个内部接口；

接收能力平台返回的与调用请求对应的获取地址，将该获取地址返回给应用。

进一步，调用请求为http请求，根据该http请求中的URL判断该调用请求是转换请求还是代理请求。

进一步，转换请求是指向外提供统一的外部接口，其内部实现为至少一次内部接口调用；代理请求是指将接收的调用请求直接转发给内部接口。

由于对内部接口进行了封装，对外呈现统一的外部接口，因此，屏蔽了各个内部接口的差异，不仅提供了统一的、标准化、规范化的接口，而且降低了对开发者的要求，提供了快速灵活部署能力接口的手段。此外，即使对封装的内部接口进行修改或者变更，也不会影响应用对外部接口的调用，可以做到使用者对内部接口变化的无感知，并且，也方便于对内部接口进行扩展，增加了内部接口的扩展性，提供了可层级式扩展的能力接口格式。

通过以下参照附图对本发明的示例性实施例的详细描述，本发明的其它特征及其优点将会变得清楚。

附图说明

构成说明书的一部分的附图描述了本发明的实施例，并且连同说明书一起用于解释本发明的原理。

参照附图，根据下面的详细描述，可以更加清楚地理解本发明，其中：

图1所示为本发明实施例中的一种部署能力接口的系统的结构示意图。

图2所示为本发明实施例中的一种部署能力接口的方法的流程示意图。

图3所示为本发明处理代理请求的操作流程示意图。

图4所示为本发明处理转换请求的操作流程示意图。

具体实施方式

现在将参照附图来详细描述本发明的各种示例性实施例。应注意到：除非另外具体说明，否则在这些实施例中阐述的部件和步骤的相对布置、数字表达式和数值不限制本发明的范围。

同时，应当明白，为了便于描述，附图中所示出的各个部分的尺寸并不是按照实际的比例关系绘制的。

以下对至少一个示例性实施例的描述实际上仅仅是说明性的，决不作为对本发明及其应用或使用的任何限制。

对于相关领域普通技术人员已知的技术、方法和设备可能不作详细讨论，但在适当情况下，所述技术、方法和设备应当被视为授权说明书的一部分。

在这里示出和讨论的所有示例中，任何具体值应被解释为仅仅是示例性的，而不是作为限制。因此，示例性实施例的其它示例可以具有不同的值。

应注意到：相似的标号和字母在下面的附图中表示类似项，因此，一旦某一项在一个附图中被定义，则在随后的附图中不需要对其进行进一步讨论。

图1所示为本发明实施例中的一种部署能力接口的系统的结构示意图。该系统包括：应用、能力接口网关以及能力平台。其中：

能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，并根据该调用请求调用能力平台的至少一个内部接口。从能力平台获取与调用请求对应的调用结果后，返回给应用。

为使本发明的目的、技术方案和优点更加清楚明白，以下结合具体实施例，并参照附图，对本发明进一步详细说明。

如图1所示，能力接口网关包括：接口调用接入模块、插件调度管理模块、标准处理转换模块、调用转换模块、以及上下文状态管理模块。在本发明的另一实施例中，还如图1所示，该能力接口网关还可以包括逆向代理模块、K/V内存高速缓冲模块、和/或数据库。下面将结合附图和实施例，对上述各个模块进行详细说明。

接口调用接入模块对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，判断该调用请求是转换请求还是代理请求，如果是转换请求，则将该调用请求转发给插件调度管理模块，如果是代理请求，则将该请求转发给逆向代理模块。接口调用接入模块还进行异常情况的核对处理，比如最终反馈结果的正确性核对和异常数据比对，如数据合法性、长度是否符合接口字段长度等。

转换请求是指向外提供统一的外部接口，其内部实现为至少一次内部接口调用。比如内部接口会有A、B、C三个接口实现不同功能，但是封装为对外接口D时，能力接口网关会把A、B、C三个接口按照设定的逻辑顺序进行多次调用。

代理请求是指将接收的调用请求直接转发给内部接口。比如内部接口会有A、B、C三个接口，对外封装提供直接就是A、B、C接口，这样能力接口网关其实是透明的，只是单纯接收-转发的功能，不做任何逻辑处理。

其中，接口调用接入模块可以设置哪些调用请求是直接透传给能力平台，哪些调用请求是需要进行转换处理后再转发给能力平台。在设置时，可以通过URL进行标识，例如，设置接收到调用百度URL的请求时，直接将该调用请求转发给能力平台，由百度将调用结果返回给应用。又例如，设置接收到访问照片、音乐以及视频的调用请求时，则对该调用请求进行处理后再转发给能力平台。即，调用请求为http请求，根据该http请求中的URL可以判断该调用请求是转换请求还是代理请求。

逆向代理模块调用能力平台的内部接口，接收能力平台返回的与调用请求对应的获取地址，并将该获取地址返回给接口调用接入模块，由接口调用接入模块返回给应用。当然，如果处理异常，则可能返回异常码。

插件调度管理模块将调用请求分发给标准处理转换模块和调用转换模块进行处理。其中，插件调度管理模块还实现模块的动态增删、状况监控及生命周期管理等功能。

标准处理转换模块进行格式处理，处理后返回给上下文状态管理模块。其中，标准处理转换模块还进行例如集中鉴权、参数格式转换、能力调用统计、OpenID转换、能力调用SLA策略处理等。标准处理转换模块可供多个并发的接口调用转换过程所复用，须具有可重入性，且稳定性要求较高。由于是公用处理插件，因此标准处理转换模块对性能要求较高，必须保障其与接口调用接入模块之间的访存调用效率。并且，进行标准化处理时需要获取已保存的信息，例如，鉴权信息，由于其所涉及的上下文（如鉴权信息、OpenID等）多数为全局系统级信息，因此宜存储于Key/Value内存高速缓冲模块中，以保障访问效率。

调用转换模块按照设置的业务处理顺序依次调用能力平台的内部接口，将能力平台返回的处理结果保存在上下文状态管理模块，由上下文状态管理模块将能力平台返回的处理结果合成后，返回给插件调度管理模块，由插件调度管理模块返回给接口调用接入模块，由接口调用接入模块返回给应用。如果流程正常，则能力平台返回的处理结果是与调用请求对应的获取地址，将该获取地址通过插件调度管理模块返回给接口调用接入模块，由接口调用接入模块返回给应用。如果流程异常，则能力平台返回的处理结果是异常码（这个在接口定义中可以事前定义，开发者在调用前就获悉的），比如要求输入参数范围在1-5，如果开发者使用了8，那么就会返回错误码。这里所说的处理顺序也涉及了对内部接口的调用次数，比如1个外部接口会涉及到5个内部接口的对应处理关系，如果传入参数为1，那么可能会转换5个内部接口各1次，如果传入参数为2，那么可能会转换5个内部接口各3次。

其中，调用转换模块还可以进行其他逻辑处理，例如异常处理、编程模式中if A=B，then A=C，else A=D之类的处理过程。调用转换模块可以实现将一次外部接口调用转换为多次内部接口调用的逻辑过程封装，从而提供更高的逻辑处理封装灵活性。其对调用转换状态信息的访存方式也可以更加灵活，可以在自身模块范围内临时保存局部上下文信息、灵活访存K/V高速内存缓冲当中的全局系统信息、和/或数据库模块中保存的其他相关信息。

上下文状态管理模块将标准处理转换模块和能力平台返回的处理结果合成后，得到与调用请求对应的获取地址，将该获取地址返回给插件调度管理模块，由插件调度管理模块返回给接口调用接入模块，由接口调用接入模块返回给应用。上下文状态管理模块还用于判断逻辑处理方式（比如是采用IF-THEN-ELSE模式或者CASE模式），实现单次外部接口调用转换过程中所涉及到上下文访存管理、多次外部接口调用过程中所涉及到的上下文信息维护、K/V内存高速缓冲策略管理、高速内存缓冲及数据库信息同步策略管理、和/或高速内存缓冲及数据库模块各自的负载均衡等功能。其为插件模块提供通用的抽象数据访存接口界面，以提升模块部件的数据访存效率。

K/V内存高速缓冲模块保存需全局访问的关键系统信息，如鉴权信息、OpenID等，或者缓存需要跨插件访存交互的临时上下文状态信息，并承担相应的数据Cache功能，以提升插件系统数据访存效率。该模块在上下文状态管理模块的管理下，实现与数据库模块的信息同步。

数据库模块保存较低访问频率的数据信息，其在上下文状态管理模块的管理下，实现与K/V高速内存缓冲的冷热数据同步。

在该实施例中，由于对内部接口进行了封装，对外呈现统一的外部接口，因此，屏蔽了各个内部接口的差异，不仅提供了统一的、标准化、规范化的接口，而且降低了对开发者的要求，提供了快速灵活部署能力接口的手段。此外，即使对封装的内部接口进行修改或者变更，也不会影响应用对外部接口的调用，可以做到使用者对内部接口变化的无感知，并且，也方便于对内部接口进行扩展，增加了内部接口的扩展性，提供了可层级式扩展的能力接口格式。

下面将通过具体实施例，对代理请求和转换请求的实施例分别进行说明。

第一实施例

代理请求为获取天气预报信息。

接口调用接入模块通过外部接口接收应用的该调用请求，根据请求中携带的参数可知该请求是获取上海（参数021）的天气预报，将该请求转发给逆向代理模块。

逆向代理模块调用能力平台的内部接口，即天气信息平台，接收天气信息平台返回的天气预报信息，并将该天气预报信息返回给接口调用接入模块，由接口调用接入模块返回给应用。

该实施例中的调用请求为代理请求，对于该类请求，可以直接透传给能力平台的内部接口，无需进行任何中间处理，增加了对此类代理请求的响应速度。

第二实施例

转换请求为输入照片和音乐信息获得一段音乐视频。该转换请求包括照片数据获取地址、音乐信息获取地址、图片排列顺序、以及视频格式等数据。

接口调用接入模块通过外部接口接收应用的该调用请求，判断是转换请求还是代理请求，经判断为转换请求，将该调用请求转发给插件调度管理模块。插件调度管理模块判断哪些数据送给标准处理转换模块，哪些数据送给调用转换模块，该实施例中，照片格式处理、音乐信息格式处理送给标准处理转换模块，标准处理转换模块处理后返回给上下文状态管理模块，视频合成工作送给调用转换模块。

调用转换模块根据照片数据获取地址和音乐信息获取地址依次调用能力平台的内部接口，由各个能力平台进行处理，并将处理结果保存在上下文状态管理模块。这里所说的处理是指对能力平台的功能调用，处理结果指的是调用结果（如调用结果码）和一部分相关信息（如文件信息相关的大小，地址等）。即，上下文状态模块收到的是关于图片和音乐这些数据的处理结果和相关信息。

上下文状态管理模块根据照片数据和音乐信息的排列顺序，进行照片与音乐的视频封装，将视频数据获取地址返回给插件调度管理模块，由插件调度管理模块返回给接口调用接入模块，由接口调用接入模块返回给应用。

该实施例中的调用请求为转换请求，该类请求需调用多个内部接口，但是对于使用者来说，由于屏蔽了内部接口的差异，所以，使用者无需了解各个接口的标准，降低了对使用者的要求，方便使用者的操作。此外，通过对内部接口进行排列组合以及调用次数的设定，可以设定出远超过内部接口功能的各类接口功能，因此体现了转换方式的灵活性。例如，现有3个内部接口，经过排列组合和次数的设定，可以设定出远超过3个接口的接口功能。

图2所示为本发明实施例中的一种部署能力接口的方法的流程示意图。该方法包括以下步骤：

在步骤21，能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，并根据该调用请求调用能力平台的至少一个内部接口。

在步骤22，从能力平台获取与调用请求对应的调用结果，返回给应用。

其中，能力接口网关通过该外部接口接收应用的调用请求，还判断该调用请求是转换请求还是代理请求，如果是代理请求，则其具体流程如图3所示。如果是转换请求，其具体流程如图4所示。其中，调用请求可以为http请求，根据该http请求中的URL可以判断该调用请求是转换请求还是代理请求。

转换请求是指向外提供统一的外部接口，其内部实现为至少一次内部接口调用。比如内部接口会有A、B、C三个接口实现不同功能，但是封装为对外接口D时，能力接口网关会把A、B、C三个接口按照设定的逻辑顺序进行多次调用。

代理请求是指将接收的调用请求直接转发给内部接口。比如内部接口会有A、B、C三个接口，对外封装提供直接就是A、B、C接口，这样能力接口网关其实是透明的，只是单纯接收-转发的功能，不做任何逻辑处理。

在该实施例中，由于对内部接口进行了封装，对外呈现统一的外部接口，因此，屏蔽了各个内部接口的差异，不仅提供了统一的、标准化、规范化的接口，而且降低了对开发者的要求，提供了快速灵活部署能力接口的手段。此外，即使对封装的内部接口进行修改或者变更，也不会影响应用对外部接口的调用，可以做到使用者对内部接口变化的无感知，并且，也方便于对内部接口进行扩展，增加了内部接口的扩展性，提供了可层级式扩展的能力接口格式。

图3所示为本发明处理代理请求的操作流程示意图。

在步骤31，能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求。

在步骤32，能力接口网关判断该调用请求是代理请求还是转换请求，经判断为代理请求，能力接口网关调用能力平台的至少一个内部接口。

在步骤33，接收能力平台返回的与调用请求对应的获取地址，将该获取地址返回给应用。

该实施例中的调用请求为代理请求，对于该类请求，可以直接透传给能力平台的内部接口，无需进行任何中间处理，增加了对此类代理请求的响应速度。

图4所示为本发明处理转换请求的操作流程示意图。

在步骤41，能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求。

在步骤42，能力接口网关判断该调用请求是代理请求还是转换请求，经判断为转换请求，则将该调用请求按照设置的业务处理顺序依次调用能力平台的内部接口，并接收能力平台返回的处理结果。

在该步骤中，还可以根据调用请求进行格式处理，还可以进行例如，集中鉴权、参数格式转换、能力调用统计、OpenID转换、能力调用SLA策略处理等。这里所说的处理顺序也涉及了对内部接口的调用次数，比如1个外部接口会涉及到5个内部接口的对应处理关系，如果传入参数为1，那么可能会转换5个内部接口各1次，如果传入参数为2，那么可能会转换5个内部接口各3次。

在步骤43，将格式处理的结果与能力平台返回的处理结果合成后，得到与调用请求对应的获取地址，将该获取地址返回给应用。

该实施例中的调用请求为转换请求，该类请求需调用多个内部接口，但是对于使用者来说，由于屏蔽了内部接口的差异，所以，使用者无需了解各个接口的标准，降低了对使用者的要求，方便使用者的操作。此外，通过对内部接口进行排列组合以及调用次数的设定，可以设定出远超过内部接口功能的各类接口功能，因此体现了转换方式的灵活性。例如，现有3个内部接口，经过排列组合和次数的设定，可以设定出远超过3个接口的接口功能。

至此，已经详细描述了本发明。为了避免遮蔽本发明的构思，没有描述本领域所公知的一些细节。本领域技术人员根据上面的描述，完全可以明白如何实施这里公开的技术方案。

可能以许多方式来实现本发明的方法以及装置。例如，可通过软件、硬件、固件或者软件、硬件、固件的任何组合来实现本发明的方法以及装置。用于所述方法的步骤的上述顺序仅是为了进行说明，本发明的方法的步骤不限于以上具体描述的顺序，除非以其它方式特别说明。此外，在一些实施例中，还可将本发明实施为记录在记录介质中的程序，这些程序包括用于实现根据本发明的方法的机器可读指令。因而，本发明还覆盖存储用于执行根据本发明的方法的程序的记录介质。

虽然已经通过示例对本发明的一些特定实施例进行了详细说明，但是本领域的技术人员应该理解，以上示例仅是为了进行说明，而不是为了限制本发明的范围。本领域的技术人员应该理解，可在不脱离本发明的范围和精神的情况下，对以上实施例进行修改。本发明的范围由所附权利要求来限定。

Claims (10)

1.一种部署能力接口的系统，其特征在于，包括能力接口网关以及能力平台，其中：

能力平台提供至少一个内部接口；

能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，并根据该调用请求调用能力平台的至少一个内部接口；从能力平台获取与调用请求对应的调用结果后，返回给应用。

2.根据权利要求1所述部署能力接口的系统，其特征在于，能力接口网关包括接口调用接入模块、插件调度管理模块、标准处理转换模块、调用转换模块、以及上下文状态管理模块，其中：

接口调用接入模块对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，判断该调用请求是转换请求还是代理请求，如果是转换请求，则将该调用请求转发给插件调度管理模块；

插件调度管理模块将调用请求分发给标准处理转换模块和调用转换模块进行处理；

标准处理转换模块进行格式处理，处理后返回给上下文状态管理模块；

调用转换模块按照设置的业务处理顺序依次调用能力平台的内部接口，将能力平台返回的处理结果保存在上下文状态管理模块；

上下文状态管理模块将标准处理转换模块和能力平台返回的处理结果合成后，得到与调用请求对应的获取地址，将该获取地址返回给插件调度管理模块，由插件调度管理模块返回给接口调用接入模块，由接口调用接入模块返回给应用。

3.根据权利要求2所述部署能力接口的系统，其特征在于，能力接口网关还包括逆向代理模块，其中：

接口调用接入模块判断该调用请求是代理请求，则将该请求转发给逆向代理模块；

逆向代理模块调用能力平台的内部接口，接收能力平台返回的与调用请求对应的获取地址，并将该获取地址返回给接口调用接入模块，由接口调用接入模块返回给应用。

4.根据权利要求2或3所述部署能力接口的系统，其特征在于：

调用请求为http请求，根据该http请求中的URL判断该调用请求是转换请求还是代理请求。

5.根据权利要求2或3所述部署能力接口的系统，其特征在于：

转换请求是指向外提供统一的外部接口，其内部实现为至少一次内部接口调用；

代理请求是指将接收的调用请求直接转发给内部接口。

6.一种部署能力接口的方法，其特征在于，包括：

能力接口网关对能力平台的至少一个内部接口进行封装，并向应用提供统一的外部接口，通过该外部接口接收应用的调用请求，并根据该调用请求调用能力平台的至少一个内部接口；

从能力平台获取与调用请求对应的调用结果，返回给应用。

7.根据权利要求6所述部署能力接口的方法，其特征在于，通过该外部接口接收应用的调用请求的操作，包括：

判断该调用请求是代理请求还是转换请求，如果是转换请求，则将该调用请求按照设置的业务处理顺序依次调用能力平台的内部接口，并接收能力平台返回的处理结果；

将格式处理的结果与能力平台返回的处理结果合成后，得到与调用请求对应的获取地址，将该获取地址返回给应用。

8.根据权利要求7所述部署能力接口的方法，其特征在于，通过该外部接口接收应用的调用请求的操作，包括：

判断该调用请求是转换请求还是代理请求，如果是代理请求，能力接口网关调用能力平台的至少一个内部接口；

接收能力平台返回的与调用请求对应的获取地址，将该获取地址返回给应用。

9.根据权利要求7或8所述部署能力接口的方法，其特征在于：

调用请求为http请求，根据该http请求中的URL判断该调用请求是转换请求还是代理请求。

10.根据权利要求7或8所述部署能力接口的方法，其特征在于：

转换请求是指向外提供统一的外部接口，其内部实现为至少一次内部接口调用；

代理请求是指将接收的调用请求直接转发给内部接口。