CN111857675A

CN111857675A - 基于c++实现restful服务的方法及系统

Info

Publication number: CN111857675A
Application number: CN202010767705.1A
Authority: CN
Inventors: 蒋敏钟
Original assignee: Beijing Si Tech Information Technology Co Ltd
Current assignee: Beijing Si Tech Information Technology Co Ltd
Priority date: 2020-08-03
Filing date: 2020-08-03
Publication date: 2020-10-30
Anticipated expiration: 2040-08-03
Also published as: CN111857675B

Abstract

本发明公开了一种基于C++实现RESTFUL服务的方法及系统，涉及软件开发领域。该方法包括：将目标业务能力的C++代码封装成函数，并编译成动态库；将目标业务能力配置到RESTFUL服务端框架的配置文件中；启动RESTFUL服务端框架，通过读取配置文件中目标业务能力的配置信息实现目标业务能力的调用。本发明实现了将基于C++开放的服务更加快速的迁移成restful风格openAPI，大大降低了工程的开发成本，大大的降速了迁移风险与成本，保证了工程的进度，实现了更为快速的RESTFUL服务实现。

Description

基于C++实现RESTFUL服务的方法及系统

技术领域

本发明涉及软件开发领域，尤其涉及一种基于C++实现RESTFUL服务的方法及系统。

背景技术

REST风格是面向资源完成API接口设计，REST风格的接口通过HTTP的Method方法完成对资源的增、删、改、查等操作。

然而，实现RESTFUL服务一般是使用JAVA或者PYTHON，具有实现方便的优点，但是在实际的项目升级过程中，有些C++的业务想要迁移成java或者其他代码，工期较长，风险较高，因此，亟需一种基于C++开放的服务更加快速的迁移成RESTFUL风格openAPI的方法。

发明内容

本发明所要解决的技术问题是针对现有技术的不足，提供一种基于C++实现RESTFUL服务的方法及系统。

本发明解决上述技术问题的技术方案如下：

一种基于C++实现RESTFUL服务的方法，包括：

将目标业务能力的C++代码封装成函数，并编译成动态库；

将所述目标业务能力配置到RESTFUL服务端框架的配置文件中；

启动所述RESTFUL服务端框架，通过读取所述配置文件中所述目标业务能力的配置信息实现所述目标业务能力的调用。

本发明解决上述技术问题的另一种技术方案如下：

一种基于C++实现RESTFUL服务的系统，包括：

封装单元，用于将目标业务能力的C++代码封装成函数，并编译成动态库；

配置单元，用于将所述目标业务能力配置到RESTFUL服务端框架的配置文件中；

执行单元，用于启动所述RESTFUL服务端框架，通过读取所述配置文件中所述目标业务能力的配置信息实现所述目标业务能力的调用。

本发明的有益效果是：本发明通过将目标业务能力的C++代码进行封装，然后通过配置文件的方式进行目标业务能力的调用，实现了将基于C++开放的服务更加快速的迁移成restful风格openAPI，大大降低了工程的开发成本，并且使用该框架C++的业务代码基本上不需要太多的修改，大大的降速了迁移风险与成本，保证了工程的进度，实现了更为快速的RESTFUL服务实现。

本发明附加的方面的优点将在下面的描述中部分给出，部分将从下面的描述中变得明显，或通过本发明实践了解到。

附图说明

图1为本发明基于C++实现RESTFUL服务的方法的实施例提供的流程示意图；

图2为本发明基于C++实现RESTFUL服务的方法的其他实施例提供的流程示意图；

图3为本发明基于C++实现RESTFUL服务的系统的实施例提供的服务框架示意图；

图4为本发明基于C++实现RESTFUL服务的系统的实施例提供的结构框架示意图。

具体实施方式

以下结合附图对本发明的原理和特征进行描述，所举实施例只用于解释本发明，并非用于限定本发明的范围。

如图1所示，为本发明基于C++实现RESTFUL服务的方法的实施例提供的流程示意图，该方法基于C++实现RESTFUL服务，用于在C++编程语言环境中，提供一种框架，快速将原来基于socket提供的服务迁移成基于http1.1协议的RESTFUL风格的API，包括：

S1，将目标业务能力的C++代码封装成函数，并编译成动态库；

应理解，目标业务能力是为了实现一定功能的业务，例如，对于电信领域，业务能力可以为月资费计算、年资费计算、账户开通、套餐订购等，每种业务能力通过底层C++代码实现。

其中，以月资费计算为例，可以简单定义这个业务的内容为：根据输入的套餐标识，计算套餐的月租，可以对这个业务使用C语言或C++语言进行能力封装。

可选地，可以将业务能力的源码编译成动态库libCalc.so，通过g++编译器编译。

S2，将目标业务能力配置到RESTFUL服务端框架的配置文件中；

可选地，可以将需要开放的业务能力配置到框架的配置文件中RESTSRV.cfg中。

S3，启动RESTFUL服务端框架，通过读取配置文件中目标业务能力的配置信息实现目标业务能力的调用。

应理解，启动框架后，就能把业务能力以restful形式开放出去了，例如，服务器调用地址可以为:http://127.0.0.1:1984/resource/calc。

需要说明的是，REST风格的OpenAPI具备以下优点：

1、API基于资源设计接口，已完成了完整的开放数据定义，可以在不增加定义的情况下，由调用方实现新增的业务；

2、多个调用方可基于同一套资源API，各取所需，实现不同的业务；

3、遵守REST风格，可以做到资源无状态，能有效降低资源开放方的性能压力，无横向扩展限制，非常适合分布式架构；

4、计费域各中心的资源API，比计费的中心定义的粒度更小，没有跨中心的资源API设计。

可选地，本发明可以基于corvusoft开发的RESTBED框架上进行开发RESTFUL服务，这种方式最为简单，只需要引入RESTBED的库函数，只需要配置要开放的HTTP的URI、请求方法以及实现相应的请求所对应的回调函数就可以完美实现对外提供HTTP+RESTFUL格式的服务。

因为对RESTBED官方给出的简单示例进行分析，可以发现涉及到的对象只有三个：Resource，Settings和Service。

其中，Resource对象是用于配置HTTP请求行中的URI，例如：resource，请求方法，例如POST，以及对应处理请求的回调函数，例如post_method_handler。

Settings对象是用于配置服务端的端口号，以及HTTP消息中的属性值等，还有超时时间、连接数等。

Service对象是最重要的对象，用于发布服务，与监听请求且提供解析请求行，调用对象的回调函数进行处理。

而回调函数post_method_handler涉及了session对象，session对象是服务端接受到HTTP请求后将连接与请求消息抽象出来的对象，因此，通过源码分析，只需要实现回调函数中对请求包中的响应，并调用session的close函数，将返回的报文传入就实现一个服务的提供。

本实施例通过将目标业务能力的C++代码进行封装，然后通过配置文件的方式进行目标业务能力的调用，实现了将基于C++开放的服务更加快速的迁移成restful风格openAPI，大大降低了工程的开发成本，并且使用该框架C++的业务代码基本上不需要太多的修改，大大的降速了迁移风险与成本，保证了工程的进度，实现了更为快速的RESTFUL服务实现。

可选地，在一些可能的实施方式中，配置文件中配置有URI地址、能力编码、处理方式、调用方法、动态库名、类名和函数名中的至少一种。

下面给出一种示例性的配置文件结构：

##服务端端口

PORT＝"1984"

##并发线程数

THREADNUM＝"5"

##对外开放的能力配置

#服务能力:服务编码:处理方式[1,json；2,xml]:调用方式[1,动态库,2,代码集成]:动态库名/类名:函数名

SRV_NUM＝"1"

SRV_LIST00＝"/resource/calc:120007:1:1:libCalc.so:calcOfferFee"。

其中，处理方式用于设置消息头中的属性值，第一种处理方式为JSON，第二种处理方式为XML，本领域技术人员也可以根据实际需求选择其他的处理方式。

调用方式限定了函数的调用方式，例如，对于简单的能力直接调用动态库对应的函数，复杂的能力则调用服务端代码中对应的能力类对象对应的能力函数，动态库名和类名根据调用方式二者选其一。

可选地，在一些可能的实施方式中，如图2所示，给出了服务端的处理流程示意图，下面结合图2对本发明可能的实现方式作进一步说明。对于服务端而言，启动RESTFUL服务端框架，通过读取配置文件中目标业务能力的配置信息实现目标业务能力的调用，具体包括：

接收HTTP请求并解析，根据解析出的请求URI和请求方法查找对应的回调函数；

通过回调函数解析HTTP请求消息体中的能力编码，与配置文件中的能力编码进行匹配，查找对应的目标业务能力；

根据目标业务能力的调用方法判断调用动态库或代码集成；

执行调用方法，当调用动态库时，根据配置文件中的URI地址、动态库名和函数名调用动态库对应的函数；

当代码集成时，根据配置文件中的URI地址、类名和函数名调用服务端代码中对应的能力类对象对应的能力函数。

调用完成后，处理业务返回信息串，然后返回给发出HTTP请求的终端或服务器。

可选地，在一些可能的实施方式中，处理方式包括第一处理方式和第二处理方式，第一处理方式为JSON，第二处理方式为XML，处理方式用于设置HTTP请求消息头中的属性值。

可选地，在一些可能的实施方式中，如图2所示，接收HTTP请求并解析之后，还包括：

判断RESTFUL服务端框架是否支持请求URI和请求方法，如果不支持，则返回错误提示信息。

如果支持，则根据请求URI与请求方法路由查找对应的回调函数，然后指派空闲的处理线程调用回调函数，根据回调函数解析信息体中的能力编码，进行后续步骤。

如图3所示，给出了一种示例性的服务框架示意图，虚拟运营商、物联网电商等上层架构可以通过nginx进行负载均衡，然后分配给不同的RESTSRV，通过配置将动态库的调用方式配置上，通过RESTSRV拉起服务对外开放能力，将C++的业务代码封装成C的动态库放在最低层，图中最低层的动态库仅作展示用，不对本发明的内容作出任何限定。

可以理解，在一些实施例中，可以包含如上述各实施方式中的部分或全部。

如图4所示，为本发明基于C++实现RESTFUL服务的系统的实施例提供的结构框架示意图，该系统基于C++实现RESTFUL服务，包括：

封装单元1，用于将目标业务能力的C++代码封装成函数，并编译成动态库；

配置单元2，用于将目标业务能力配置到RESTFUL服务端框架的配置文件中；

执行单元3，用于启动RESTFUL服务端框架，通过读取配置文件中目标业务能力的配置信息实现目标业务能力的调用。

可选地，在一些可能的实施方式中，执行单元3具体用于接收HTTP请求并解析，根据解析出的请求URI和请求方法查找对应的回调函数；通过回调函数解析HTTP请求消息体中的能力编码，与配置文件中的能力编码进行匹配，查找对应的目标业务能力；根据目标业务能力的调用方法判断调用动态库或代码集成；执行调用方法，当调用动态库时，根据配置文件中的URI地址、动态库名和函数名调用动态库对应的函数；当代码集成时，根据配置文件中的URI地址、类名和函数名调用服务端代码中对应的能力类对象对应的能力函数。

可选地，在一些可能的实施方式中，还包括：判断单元，用于判断RESTFUL服务端框架是否支持请求URI和请求方法，如果不支持，则返回错误提示信息。

需要说明的是，上述各实施方式是与在先方法实施例对应的产品实施例，对于产品实施方式的说明可以参考上述各方法实施方式中的对应说明，在此不再赘述。

读者应理解，在本说明书的描述中，参考术语“一个实施例”、“一些实施例”、“示例”、“具体示例”、或“一些示例”等的描述意指结合该实施例或示例描述的具体特征、结构、材料或者特点包含于本发明的至少一个实施例或示例中。在本说明书中，对上述术语的示意性表述不必针对的是相同的实施例或示例。而且，描述的具体特征、结构、材料或者特点可以在任一个或多个实施例或示例中以合适的方式结合。此外，在不相互矛盾的情况下，本领域的技术人员可以将本说明书中描述的不同实施例或示例以及不同实施例或示例的特征进行结合和组合。

在本申请所提供的几个实施例中，应该理解到，所揭露的装置和方法，可以通过其它的方式实现。例如，以上所描述的方法实施例仅仅是示意性的，例如，步骤的划分，仅仅为一种逻辑功能划分，实际实现时可以有另外的划分方式，例如多个步骤可以结合或者可以集成到另一个步骤，或一些特征可以忽略，或不执行。

上述方法如果以软件功能单元的形式实现并作为独立的产品销售或使用时，可以存储在一个计算机可读取存储介质中。基于这样的理解，本发明的技术方案本质上或者说对现有技术做出贡献的部分，或者该技术方案的全部或部分可以以软件产品的形式体现出来，该计算机软件产品存储在一个存储介质中，包括若干指令用以使得一台计算机设备(可以是个人计算机，服务器，或者网络设备等)执行本发明各个实施例方法的全部或部分步骤。而前述的存储介质包括：U盘、移动硬盘、只读存储器(ROM，Read-OnlyMemory)、随机存取存储器(RAM，RandomAccessMemory)、磁碟或者光盘等各种可以存储程序代码的介质。

以上，仅为本发明的具体实施方式，但本发明的保护范围并不局限于此，任何熟悉本技术领域的技术人员在本发明揭露的技术范围内，可轻易想到各种等效的修改或替换，这些修改或替换都应涵盖在本发明的保护范围之内。因此，本发明的保护范围应以权利要求的保护范围为准。

Claims

1.一种基于C++实现RESTFUL服务的方法，其特征在于，包括：

将目标业务能力的C++代码封装成函数，并编译成动态库；

将所述目标业务能力配置到RESTFUL服务端框架的配置文件中；

2.根据权利要求1所述的基于C++实现RESTFUL服务的方法，其特征在于，所述配置文件中配置有URI地址、能力编码、处理方式、调用方法、动态库名、类名和函数名中的至少一种。

3.根据权利要求2所述的基于C++实现RESTFUL服务的方法，其特征在于，启动所述RESTFUL服务端框架，通过读取所述配置文件中所述目标业务能力的配置信息实现所述目标业务能力的调用，具体包括：

通过所述回调函数解析所述HTTP请求消息体中的能力编码，与所述配置文件中的能力编码进行匹配，查找对应的目标业务能力；

根据所述目标业务能力的调用方法判断调用动态库或代码集成；

执行所述调用方法，当调用动态库时，根据所述配置文件中的URI地址、动态库名和函数名调用动态库对应的函数；

当代码集成时，根据所述配置文件中的URI地址、类名和函数名调用服务端代码中对应的能力类对象对应的能力函数。

4.根据权利要求3所述的基于C++实现RESTFUL服务的方法，其特征在于，所述处理方式包括第一处理方式和第二处理方式，所述第一处理方式为JSON，所述第二处理方式为XML，所述处理方式用于设置所述HTTP请求消息头中的属性值。

5.根据权利要求3或4中所述的基于C++实现RESTFUL服务的方法，其特征在于，接收HTTP请求并解析之后，还包括：

判断所述RESTFUL服务端框架是否支持所述请求URI和所述请求方法，如果不支持，则返回错误提示信息。

6.一种基于C++实现RESTFUL服务的系统，其特征在于，包括：

7.根据权利要求6所述的基于C++实现RESTFUL服务的系统，其特征在于，所述配置文件中配置有URI地址、能力编码、处理方式、调用方法、动态库名、类名和函数名中的至少一种。

8.根据权利要求7所述的基于C++实现RESTFUL服务的系统，其特征在于，所述执行单元具体用于接收HTTP请求并解析，根据解析出的请求URI和请求方法查找对应的回调函数；通过所述回调函数解析所述HTTP请求消息体中的能力编码，与所述配置文件中的能力编码进行匹配，查找对应的目标业务能力；根据所述目标业务能力的调用方法判断调用动态库或代码集成；执行所述调用方法，当调用动态库时，根据所述配置文件中的URI地址、动态库名和函数名调用动态库对应的函数；当代码集成时，根据所述配置文件中的URI地址、类名和函数名调用服务端代码中对应的能力类对象对应的能力函数。

9.根据权利要求8所述的基于C++实现RESTFUL服务的系统，其特征在于，所述处理方式包括第一处理方式和第二处理方式，所述第一处理方式为JSON，所述第二处理方式为XML，所述处理方式用于设置所述HTTP请求消息头中的属性值。

10.根据权利要求8或9中所述的基于C++实现RESTFUL服务的系统，其特征在于，还包括：判断单元，用于判断所述RESTFUL服务端框架是否支持所述请求URI和所述请求方法，如果不支持，则返回错误提示信息。