CN109885290B - 应用程序服务描述信息生成与发布方法、装置和存储介质 - Google Patents

Abstract

本发明涉及一种应用程序服务描述信息生成与发布方法、装置和存储介质，属于计算机技术领域，用于解决应用程序服务描述信息主要靠人工编写汇总，对服务的新增、修改、删除，响应不及时、描述不准确的问题；本发明在应用程序服务编码阶段，对应用程序服务描述信息的关键要素进行定义；在应用程序服务构建或服务部署阶段，对服务关键要素进行校验，通过校验后，抽取服务元数据模型；在应用程序发布阶段，在服务发布平台中对服务元数据进行可视化显示展现。本发明减少了手工书写服务描述信息造成的问题，强化了服务描述信息的准确性，并且能够轻松的掌握服务的数量及属性。

Description

应用程序服务描述信息生成与发布方法、装置和存储介质

技术领域

本发明涉及计算机技术领域，尤其涉及一种应用程序服务描述信息生成与发布方法、装置和存储介质。

背景技术

目前，常用的应用程序编程服务开发流程中存在以下问题：

A.应用程序服务开发内容与部署文档没有关联，依赖人工维护两者的关系，随着需求的变更，容易造成部署文档与服务开发的内容不一致，在程序升级时，容易造成部署错误。

B.应用程序服务描述信息与应用程序服务开发过程没有关联，依赖人工维护两者的关系，随着需求的变更，易造成服务描述文档与服务代码的内容不一致。在基于服务模式编程时，因服务文档的错误，而产生的程序功能性错误。

C.大型程序应用通常有很多应用服务，因存在A,B问题，使服务无法被有效的管理，具体表现为:不能准确的知道***发布了多少服务、无法准确统计服务的用途、无法准确的知道服务描述信息。

发明内容

鉴于上述的分析，本发明旨在提供一种应用程序服务描述信息生成与发布方法、装置和存储介质，解决应用程序服务描述信息主要靠人工编写汇总，对服务的新增、修改、删除，响应不及时、描述不准确的问题。

本发明的目的主要是通过以下技术方案实现的：

一种应用程序服务描述信息的自动生成与发布方法，包括：

在应用程序服务编码阶段，对应用程序服务描述信息的关键要素进行规范；

在应用程序服务构建或服务部署阶段，在服务源代码中对服务关键要素进行校验，通过校验后，构建服务元数据模型；

在应用程序发布阶段，在服务发布平台中，抽取服务元数据模型中的服务元数据进行可视化展现。

进一步地，在应用程序服务编码阶段，依照定义好的服务框架模板，在代码层对服务关键要素进行规范；所述规范的内容包括：

对服务输入进行规范，包括对服务输入的描述及结构进行格式化定义；

对服务输出进行规范，包括对服务输出的描述及结构进行格式化定义；

对服务依赖配置信息进行描述及结构的规范，所述服务依赖配置信息包含依赖服务、依赖参数和依赖业务；

对服务功能描述信息进行规范，所述服务功能描述信息包含在代码注释中或项目描述文件中。

进一步地，所述服务输入和服务输出的描述及结构进行格式化定义方式包括jaxb方式、schema方式或xml方式。

所述服务依赖配置信息，使用xml作为服务的配置载体，通过格式化描述手段进行定义。

进一步地，在应用程序服务构建或服务部署阶段，具体包括：

对应用程序服务的源代码进行应用程序构建；自动抽取服务的关键要素，构成服务描述元数据模型；

通过服务框架模板对所述服务描述的元数据模型进行完整性检验，如果具有完整性，则构建产生服务安装包；如果不具有完整性，则返回应用程序服务编码阶段，依照所述服务框架模板，重新对服务定义的关键要素进行规范。

进一步地，所述完整性检验包括：

服务编码：非空，符合服务编码格式定义、服务编码唯一性；

服务中文名：非空；

服务版本：非空，符合版本定义规则，版本号大于历史版本；

业务对象：非空，为***中已存在的业务对象；

交互方式:非空，同步或异步；

服务提供者：非空，包括具体的人、项目组或部门；

服务输入输出：非空，提供调用样例或可格式化的表述文件；

服务功能描述信息:非空；

服务依赖配置信息：若存在依赖配置，非空。

进一步地，在应用程序发布阶段，具体包括：

将服务安装包在服务运行平台中安装运行，完成相应服务配置，抽取服务元数据；

判断服务元数据是否满足服务发布前置条件；如果满足，则将服务元数据读取到服务发布平台中进行可视化显示；如果不满足则在服务构建或部署过程中提示失败信息；所述发布前置条件为完整性检验结果和服务配置结果正常。

进一步地，所述服务配置包括：对服务所需要的***参数、配置文件和业务进行配置。

进一步地，所述可视化显示的所有服务的信息包括：服务输入、服务输出、服务描述信息、服务运行状态和服务辅助信息。

一种电子装置，包括：

存储器，用于存储程序；

处理器；

当所述程序被所述处理器执行时，实现如上述任一所述的应用程序服务描述信息的自动生成与发布方法。

一种计算机可读存储介质，其上存储有计算机程序，所述计算机程序被执行时，实现如上述任一所述的应用程序服务描述信息的自动生成与发布方法。

本发明有益效果如下：

1.减少了手工书写服务描述信息造成的，填写信息不完整、服务更新不及时的问题。

2.强化服务描述信息的准确性，服务描述信息在代码层面上的保障，使开发人员只要编写完成代码后，服务描述信息将会自动的生成。

3.掌握***发布服务的详细信息。通过服务开发框架的服务构建机制，提供服务安装包的服务元数据，***能够轻松的掌握服务的数量及属性。

本发明的其他特征和优点将在随后的说明书中阐述，并且，部分的从说明书中变得显而易见，或者通过实施本发明而了解。本发明的目的和其他优点可通过在所写的说明书、权利要求书、以及附图中所特别指出的结构来实现和获得。

附图说明

附图仅用于示出具体实施例的目的，而并不认为是对本发明的限制，在整个附图中，相同的参考符号表示相同的部件。

图1为本发明实施例中的应用程序服务描述信息的自动生成与发布方法流程图；

图2为本发明实施例中的电子装置结构示意图。

具体实施方式

下面结合附图来具体描述本发明的优选实施例，其中，附图构成本申请一部分，并与本发明的实施例一起用于阐释本发明的原理。

实施例一、

本实施例公开了一种应用程序服务描述信息的自动生成与发布方法，应用于大型程序的服务管理，例如，某公司需要将其交易***的某类交易数据传递到财务***作为基础业务数据。单条交易数据包括交易流水码、交易帐号、交易人、交易时间、交易金额。交易数据等信息以XML的方式传递。财务***需要提供单据信息接收服务，因此，需要生成与发布应用程序服务描述信息。

具体的应用程序服务描述信息的自动生成与发布方法，如图1所示，包括以下步骤：

步骤S1、在应用程序服务编码阶段，依照定义好的服务框架模板，在代码层对服务关键要素进行规范；所述服务框架模板包括对以下关键要素进行定义：

·服务编码；

·服务中文名；

·服务版本；

·业务对象；

·服务提供者；

·服务输入的格式化描述信息或调用样例；

·服务输出的格式化描述信息或调用样例

·服务功能描述信息；

·服务依赖配置信息的格式化描述。

开发人员按照模板定义好的服务关键要素，在代码层对代码中包含的服务关键要素进行定义。得到应用程序服务的源代码；

例如，所述代码层为财务***的底层开发代码。

在服务框架模板中对以下服务定义要素进行代码层面的规范：

服务编码定义：符合服务编码规则的命名；

如：cw.hs.sycSAPVoucherInfo

具体的，所述服务编码定义信息包含在代码注释中或项目描述文件中。

服务中文名：服务的中文名称，如：同步SAP凭证信息；

具体的，所述服务中文名信息包含在代码注释中或项目描述文件中。

服务版本：服务版本信息，如：v1.0.0；

具体的，所述服务版本信息包含在代码注释中或项目描述文件中。

业务对象：服务所关系的业务领域，如voucher(凭证信息)；

具体的，所述业务对象信息包含在代码注释中或项目描述文件中。

服务提供者：服务提供方，可细化到：人、部门、公司、项目组等；

具体的，所述服务提供者信息包含在代码注释中或项目描述文件中。

服务输入定义：包括描述及结构的定义；

具体的，通过格式化描述手段进行定义；

优选的，定义方式包括jaxb方式、schema方式或xml方式。

服务输出定义：包括描述及结构的定义；

具体的，通过格式化描述手段进行定义；

优选的，定义方式包括jaxb方式、schema方式或xml方式。

服务功能描述信息：业务层面上的含义；

具体的，所述服务中描述信息包含在代码注释中或项目描述文件中。

服务依赖配置信息：包括描述及结构的定义；

具体的，所述服务依赖配置信息，使用xml做为服务的配置载体，通过格式化描述手段进行定义；

服务依赖配置包括依赖服务、依赖参数、依赖业务配置信息。

配置单据信息接收服务配置项(如:交易***的数据反馈地址、命名空间、依赖服务)等动态配置信息。

在具有应用中，依照服务框架模板在代码层对服务定义的关键要素进行规范后，形成服务业务逻辑代码(源代码)，完成服务的实际业务功能。

步骤S2、对应用程序服务的源代码进行应用程序构建；自动抽取服务的关键要素，构成服务描述元数据模型；

具体的，依照定义好的服务框架模板，将服务业务逻辑代码中包括的S1中定义的服务关键要素进行抽取，组成服务描述元数据模型。

步骤S3、通过服务框架模板对所述服务描述的元数据模型进行完整性检验，如果具有完整性，则构建产生服务安装包；如果不具有完整性，则依照S1中定义的服务要素，在代码层进行修改，完成后，返回S2；

具体的，服务定义关键性要素完整性检验内容包括：

·服务编码：非空，符合服务编码格式定义、服务编码唯一性。

·服务中文名：非空。

·服务版本：非空，符合版本定义规则，版本号大于历史版本。

·业务对象：非空，必须为***中已存在的业务对象。

·交互方式:非空，同步或异步

·服务提供者：非空，可以是具体的人、项目组、部门等。

·服务输入输出：非空，提供调用样例或可格式化的表述文件(例如：scheam,dtd)

·服务功能描述信息:非空。

·服务依赖配置信息：若存在依赖配置，非空。

步骤S4、将服务安装包在服务运行平台中安装运行，完成相应服务配置，根据所述服务元数据模型抽取得到服务元数据；

具体的，相应服务配置包括：

·服务所需要的***参数。

·服务所需要的配置文件。

·服务所需要的业务配置。

步骤S5、判断服务元数据是否满足服务发布前置条件；如果满足，则将服务元数据读取到服务发布平台中进行可视化显示；如果不满足，则在服务构建或部署过程中提示失败信息。

具体的，服务发布前置条件为服务配置和完整性检验结果正常，判断服务元数据是否满足服务发布前置条件即，判断是否通过S3步骤的服务描述元数据模型的完整性检验，及是否通过S4步骤中的服务配置。

可视化显示的所有服务的信息包括：

服务输入：包括已经定义好的描述及结构；

服务输出：包括已经定义好的描述及结构；

服务描述信息：业务层面上的含义；

服务运行状态：包括调用次数、数流量等监控信息；

服务辅助信息：服务安装时间、版本信息、安装用户等。

本实施例的应用程序服务描述信息的自动生成与发布方法，还包括，应用程序服务的更新与删除；

其中，所述应用程序服务的更新：服务发生更新，则重新建构安装包，在服务运行平台中安装，服务运行平台更新服务相关信息。

应用程序服务的更新与删除：服务运行平台中卸载服务，完成服务删除，同时其描述等内容也一并删除。

实施例二、

本实施例还公开了一种电子装置，如图2所示，包括：存储器、处理器及存储在存储器上并可在处理器上运行的计算机程序。

处理器执行所述程序时实现上述实施例中提供的应用程序服务描述信息的自动生成与发布方法。

存储器，用于存放可在处理器上运行的计算机程序，所述计算机程序执行上述应用程序服务描述信息的自动生成与发布方法。

进一步地，所述电子装置还包括：通信接口，用于存储器和处理器之间的通信；

进一步地，所述电子装置还包括：显示器，用于主数据融合可视化显示。

具体的，存储器可能包含高速RAM存储器，也可能还包括非易失性存储器(non-volatile memory)，例如至少一个磁盘存储器。

如果存储器、处理器、显示器和通信接口独立实现，则通信接口、显示器、存储器和处理器可以通过总线相互连接并完成相互间的通信。所述总线可以是工业标准体系结构(Industry Standard Architecture，简称为ISA)总线、外部设备互连(PeripheralComponent，简称为PCI)总线或扩展工业标准体系结(Extended Industry StandardArchitecture，简称为EISA)总线等。所述总线可以分为地址总线、数据总线、控制总线等。为便于表示，图2中仅用一条粗线表示，但并不表示仅有一根总线或一种类型的总线。

可选的，在具体实现上，如果存储器、处理器及通信接口，集成在一块芯片上实现，则存储器、处理器及通信接口可以通过内部接口完成相互间的通信。

处理器可能是一个中央处理器(Central Processing Unit，简称为CPU)，或者是特定集成电路(Application Specific Integrated Circuit，简称为ASIC)，或者是被配置成实施本发明实施例的一个或多个集成电路。

实施例三、

本实施例提供一种计算机可读存储介质，其上存储有计算机程序，该程序被处理器执行时实现上述任一实施例的应用程序服务描述信息的自动生成与发布方法。

以上所述，仅为本发明较佳的具体实施方式，但本发明的保护范围并不局限于此，任何熟悉本技术领域的技术人员在本发明揭露的技术范围内，可轻易想到的变化或替换，都应涵盖在本发明的保护范围之内。

Claims (7)

1.一种应用程序服务描述信息的自动生成与发布方法，其特征在于，包括：

在应用程序服务编码阶段，依照定义好的服务框架模板，在代码层对应用程序服务描述信息的关键要素进行规范，得到应用程序服务的源代码；

在服务框架模板中对服务定义要素进行代码层面的规范包括：

对包含在代码注释中或项目描述文件中的服务中文名、服务版本、业务对象和服务提供者进行规范；

对包含在代码注释中或项目描述文件中的服务功能描述信息进行业务层面上含义的规范；

对服务输入和服务输出进行包括描述及结构格式化定义的规范；

对服务依赖配置信息进行描述及结构的规范，所述服务依赖配置信息包含依赖服务、依赖参数和依赖业务；

在应用程序服务构建或服务部署阶段，在服务源代码中对服务关键要素进行校验，通过校验后，构建服务元数据模型；

在应用程序服务构建或服务部署阶段，具体包括：

对应用程序服务的源代码进行应用程序构建；依照定义好的服务框架模板，将服务业务逻辑代码中包括的服务关键要素进行抽取，组成服务描述元数据模型；

通过服务框架模板对所述服务描述的元数据模型进行完整性检验，如果具有完整性，则构建产生服务安装包；如果不具有完整性，则返回应用程序服务编码阶段，在代码层进行修改，依照所述服务框架模板，重新对服务定义的关键要素进行规范，完成后再进行应用程序构建；

在应用程序发布阶段，在服务发布平台中，抽取服务元数据模型中的服务元数据进行可视化展现；

在应用程序发布阶段，具体包括：

将服务安装包在服务运行平台中安装运行，完成相应服务配置，抽取服务元数据；

判断服务元数据是否满足服务发布前置条件；如果满足，则将服务元数据读取到服务发布平台中进行可视化显示；如果不满足则在服务构建或部署过程中提示失败信息；

所述发布前置条件为完整性检验结果和服务配置结果正常。

2.根据权利要求1所述的自动生成与发布方法，其特征在于，所述服务输入和服务输出的描述及结构进行格式化定义方式包括jaxb方式、schema方式或xml方式；

所述服务依赖配置信息，使用xml作为服务的配置载体，通过格式化描述手段进行定义。

3.根据权利要求1所述的自动生成与发布方法，其特征在于，所述完整性检验包括：

服务编码：非空，符合服务编码格式定义、服务编码唯一性；

服务中文名：非空；

服务版本：非空，符合版本定义规则，版本号大于历史版本；

业务对象：非空，为***中已存在的业务对象；

交互方式:非空，同步或异步；

服务提供者：非空，包括具体的人、项目组或部门；

服务输入输出：非空，提供调用样例或可格式化的表述文件；

服务功能描述信息:非空；

服务依赖配置信息：若存在依赖配置，非空。

4.根据权利要求1所述的自动生成与发布方法，其特征在于，所述服务配置包括：对服务所需要的***参数、配置文件和业务进行配置。

5.根据权利要求1所述的自动生成与发布方法，其特征在于，所述可视化显示的所有服务的信息包括：服务输入、服务输出、服务描述信息、服务运行状态和服务辅助信息。

6.一种电子装置，其特征在于，包括：

存储器，用于存储程序；

处理器；

当所述程序被所述处理器执行时，实现如权利要求1-5中任一项所述的应用程序服务描述信息的自动生成与发布方法。

7.一种计算机可读存储介质，其上存储有计算机程序，其特征在于，所述计算机程序被执行时，实现如权利要求1-5中任一项所述的应用程序服务描述信息的自动生成与发布方法。

Images