CN102799629A - WSDL (Web Services Description Language) file quality ensuring system and realizing method thereof - Google Patents

Abstract

Translated fromChinese

本发明公开了一种WSDL文件质量保证系统及其实现方法，该系统包括三个模块：文件验证模块、文件解析模块和数据持久化模块，其中：文件验证模块用于对即将发布的WSDL文件进行验证；文件解析模块，对获取的Web Service详细信息进行解析；数据持久化模块，在文件解析模块的基础上，对Web Service详细信息进行存储。与现有技术相比，本发明可以在发布WSDL文档时就对文档的有效性进行验证，如文档中含有错误，则能够根据用户要求进行自动改正并提示用户错误信息及错误位置，从而能够保证文档的质量，方便了WSDL文档的发布者。

The invention discloses a WSDL file quality assurance system and its implementation method. The system includes three modules: a file verification module, a file parsing module and a data persistence module, wherein: the file verification module is used for performing Verification; the file analysis module analyzes the obtained detailed information of the Web Service; the data persistence module stores the detailed information of the Web Service on the basis of the file analysis module. Compared with the prior art, the present invention can verify the validity of the document when the WSDL document is released. If the document contains errors, it can automatically correct according to the user's requirements and prompt the user for error information and error location, thereby ensuring The quality of the document facilitates publishers of WSDL documents.

Description

Translated fromChinese

WSDL文件质量保证系统及其实现方法WSDL file quality assurance system and its realization method

技术领域technical field

本发明涉及基于Web Service的网络开发技术领域；特别是涉及一种对WSDL文件的侦错技术。The invention relates to the technical field of network development based on Web Service; in particular, it relates to a debugging technology for WSDL files.

背景技术Background technique

随着计算机网络的快速发展，为了达到Web服务跨平台应用，越来越多的Web服务都提供了以WSDL（Web Service Description Language,Web服务描述语言）文件存储的Web Service应用程序的接口，并且WSDL文件中包含了非常多的服务的具体信息。WSDL的概念模型如图1所示，该模型中包括服务接口和服务时限的元素及描述。因此，当服务提供者在发布Web服务时，提供有效并且能够被正确解析的WSDL文件就显的非常重要。通过在互联网上抓取大量的WSDL文件，并仔细研究其中出错的WSDL文件，可以发现WSDL文档出现的错误类型主要有以下几种：With the rapid development of computer networks, in order to achieve cross-platform application of Web services, more and more Web services provide interfaces of Web Service application programs stored in WSDL (Web Service Description Language, Web Service Description Language) files, and WSDL files contain a lot of specific information about services. The conceptual model of WSDL is shown in Figure 1, which includes elements and descriptions of service interfaces and service time limits. Therefore, when a service provider publishes a Web service, it is very important to provide an effective and correctly parsed WSDL file. By grabbing a large number of WSDL files on the Internet and carefully studying the WSDL files with errors, we can find that the main types of errors in WSDL documents are as follows:

1.文件的TargetNamespace属性值为空；1. The TargetNamespace attribute value of the file is empty;

2.Web服务的接口地址URL失效；2. The URL of the interface address of the Web service is invalid;

3.文件中缺失对某个元素的定义；3. The definition of an element is missing in the file;

4.WSDL文档中需要引用别的模式文件，但是此模式文件的地址无效或者不存在；4. Other schema files need to be referenced in the WSDL document, but the address of this schema file is invalid or does not exist;

5.文件中一些元素丢失了必要的命名前缀；5. Some elements in the file lost the necessary naming prefix;

6.需要导入的schema文件不存在；6. The schema file to be imported does not exist;

7.其他类型错误。7. Other types of errors.

因此Web服务提供者在发布WSDL文件时就应该对WSDL文件进行测试即验证、解析、存储，从而发现错误并改正以保证WSDL文件的质量。Therefore, when the Web service provider publishes the WSDL file, it should test the WSDL file, that is, verify, parse, and store it, so as to find errors and correct them to ensure the quality of the WSDL file.

发明内容Contents of the invention

基于上述现有技术存在的问题，本发明提出了一种WSDL文件质量保证系统及方法，主要目的是为Web服务提供者提供一个可靠的工具来保证其发布的WSDL文件的质量，使得Web服务能够被使用者顺利的调用和执行。Based on the problems existing in the above-mentioned prior art, the present invention proposes a WSDL file quality assurance system and method, the main purpose of which is to provide a reliable tool for Web service providers to ensure the quality of the WSDL files they publish, so that Web services can It is successfully called and executed by the user.

本发明提出了一种WSDL文件质量保证系统，其特征在于，该系统包括三个模块：文件验证模块、文件解析模块和数据持久化模块，其中：The present invention proposes a WSDL file quality assurance system, which is characterized in that the system includes three modules: a file verification module, a file parsing module and a data persistence module, wherein:

文件验证模块，用于对即将发布的WSDL文件进行验证，包括WSDL文件的基本格式验证和WSDL命名空间是否有效、服务的URL是否仍然存活、元素是否已经声明、<schema>标签下是否缺少必要的命名空间前缀、导入的文件的URL是否有效进行验证；The file verification module is used to verify the WSDL file to be released, including the basic format verification of the WSDL file and whether the WSDL namespace is valid, whether the URL of the service is still alive, whether the element has been declared, whether the <schema> tag is missing necessary Verify whether the namespace prefix and the URL of the imported file are valid;

文件解析模块，对获取的Web Service详细信息进行解析，验证WSDL文件所传递的服务基本信息、服务端口信息和端口类型信息、操作基本信息以及操作包含的message对象、message对象包含的part参数的基本信息是否正确；The file parsing module analyzes the obtained detailed information of the Web Service, and verifies the basic service information, service port information and port type information, basic operation information, message object contained in the operation, and part parameters contained in the message object transmitted by the WSDL file. whether the information is correct;

数据持久化模块，在文件解析模块的基础上，对Web Service详细信息进行存储；存储数据具体包括Web Service接口的基本服务信息数据、Web Service接口中含有的操作的基本信息数据、每一个操作中含有的参数的基本信息数据；以及定义对webService数据库操作的接口，实现数据操作。The data persistence module, based on the file parsing module, stores the detailed information of the Web Service; the stored data specifically includes the basic service information data of the Web Service interface, the basic information data of the operations contained in the Web Service interface, and the The basic information data of the parameters contained; and define the interface for webService database operation to realize data operation.

本发明还提出了一种WSDL文件质量保证实现方法，该方法包括以下步骤：The present invention also proposes a method for realizing quality assurance of WSDL files, the method comprising the following steps:

步骤一、验证WSDL文件格式：获取WSDL文件；首先验证WSDL文件的基本格式是否正确，验证处理具体包括：Step 1. Verify the WSDL file format: obtain the WSDL file; first verify whether the basic format of the WSDL file is correct, and the verification process specifically includes:

判断文件是否满足WSDL文档的概念模型；通过检查文件的命名空间属性的值来验证是否为空；通过访问Web服务地址URL是否失效并根据返回的页面状态信息判断Web服务的地址是否有效；在文档中按标签名查找某元素，根据查找结果检验文档中是否包含某元素的定义WSDL文件中是否缺失对某个元素的定义；验证<schema>标签下各元素及其子节点是否都含有必要的命名空间前缀；检验WSDL文件是否存在导入文件的语句即<import>标签；判断<import>标签中导入URL是否有效；检验Schema中是否缺少命名前缀；对于验证出的错误类型和位置进行显示或进行WSDL文件有效显示；Judging whether the file satisfies the conceptual model of the WSDL document; verifying whether it is empty by checking the value of the namespace attribute of the file; checking whether the URL of the Web service address is invalid and judging whether the address of the Web service is valid according to the returned page status information; in the document Search for an element according to the tag name, and check whether the definition of an element is included in the document according to the search result. Whether the definition of an element is missing in the WSDL file; verify whether each element and its child nodes under the <schema> tag contain the necessary names Space prefix; check whether the WSDL file has the statement of importing the file, that is, the <import> tag; judge whether the import URL in the <import> tag is valid; check whether the naming prefix is missing in the Schema; display or perform WSDL for the type and location of the verified error The file is effectively displayed;

步骤二、进行WSDL文件解析：获取WSDL文件及其Schema标签列表和服务Service列表，文件解析处理具体包括：Step 2. Perform WSDL file parsing: Obtain the WSDL file and its Schema tag list and service Service list. The file parsing process specifically includes:

在服务Service列表中获得当前服务包含的服务名称和URL名字、端口port类型；从上述服务所使用的协议以及绑定的端口中分别获得有关绑定操作的详细信息，包括操作名称和有关描述信息；根据标志位来判定是否为操作输入参数：若是操作输入参数，则获取输入的message对象、获取message对象中所有的part，对输入参数进行解析以及输出参数列表；若非操作输入参数，则获取输出的message对象、获取message对象中所有的part，对输出参数进行解析以及输入参数列表；在message标签中可以获取消息中所包含的part，基于RPC方式或者Document方式进行解析获得相应的信息；文件解析处理完成后，即执行数据持久化操作；Obtain the service name, URL name, and port port type contained in the current service in the service Service list; obtain detailed information about the binding operation from the protocol used by the above service and the bound port, including the operation name and related description information ; Determine whether it is an operation input parameter according to the flag bit: if it is an operation input parameter, obtain the input message object, obtain all parts in the message object, analyze the input parameter and output the parameter list; if it is not an operation input parameter, obtain the output The message object, get all the parts in the message object, analyze the output parameters and the input parameter list; in the message tag, you can get the part contained in the message, and analyze it based on the RPC method or the Document method to obtain the corresponding information; file analysis After the processing is completed, the data persistence operation is performed;

上述步骤二中所述对输入、输出参数进行解析的步骤，具体包括：The step of parsing the input and output parameters described in theabove step 2 specifically includes:

对每一个part对象获取其名字；Get its name for each part object;

基于RPC模式的解析过程：步骤602，获取服务和URL中类型名称所对应的数据类型；步骤判断该数据类型是否为简单数据类型；如是，获取服务和URL参数类型信息；如否，对复杂类型进行解析；The parsing process based on the RPC mode:step 602, obtain the data type corresponding to the type name in the service and the URL; the step judges whether the data type is a simple data type; if so, obtain the service and URL parameter type information; if not, for the complex type to analyze;

基于Document模式的解析过程：获取服务和URL中元素名称所对应的数据类型；判断该数据类型是否为简单数据类型；如是，获取服务和URL参数类型信息；如否，对复杂类型进行解析。Parsing process based on Document mode: Obtain the data type corresponding to the element name in the service and URL; judge whether the data type is a simple data type; if so, obtain service and URL parameter type information; if not, parse the complex type.

与现有技术相比，使用本发明可以在发布WSDL文档时就对文档的有效性进行验证，如文档中含有错误，则能够根据用户要求进行自动改正并提示用户错误信息及错误位置，从而能够保证文档的质量，方便了WSDL文档的发布者。Compared with the prior art, the present invention can verify the validity of the document when the WSDL document is released. If the document contains errors, it can automatically correct according to the user's requirements and prompt the user for error information and error location, thereby enabling It ensures the quality of documents and facilitates the publishers of WSDL documents.

附图说明Description of drawings

图1为WSDL文件描述模型示意图；Figure 1 is a schematic diagram of a WSDL file description model;

图2为本发明所提出的WSDL文件质量保证系统的系统结构示意图；Fig. 2 is the system structural representation of the WSDL file quality assurance system proposed by the present invention;

图3为本发明所提出的WSDL文件质量保证方法的实施流程图；Fig. 3 is the implementation flowchart of the WSDL file quality assurance method proposed by the present invention;

图4为本发明所提出的WSDL文件质量保证系统的文件验证模块流程图；Fig. 4 is the file verification module flowchart of the WSDL file quality assurance system proposed by the present invention;

图5为本发明所提出的WSDL文件质量保证系统的文件解析模块流程图；Fig. 5 is the file parsing module flowchart of the WSDL file quality assurance system proposed by the present invention;

图6为本发明所提出的WSDL文件质量保证系统的文件解析模块对参数进行解析的子流程图；Fig. 6 is the sub-flow chart that the file parsing module of the WSDL file quality assurance system proposed by the present invention parses the parameters;

图7为本发明所提出的WSDL文件质量保证系统的数据持久化模块中存储WebService基本信息表的数据结构图；Fig. 7 is the data structure diagram of storing the WebService basic information table in the data persistence module of the WSDL file quality assurance system proposed by the present invention;

图8为本发明所提出的WSDL文件质量保证系统的数据持久化模块中存储操作信息表的数据结构图；Fig. 8 is the data structure diagram of the storage operation information table in the data persistence module of the WSDL file quality assurance system proposed by the present invention;

图9为本发明所提出的WSDL文件质量保证系统的数据持久化模块中存储参数基本信息表的数据结构图；Fig. 9 is a data structure diagram of the storage parameter basic information table in the data persistence module of the WSDL file quality assurance system proposed by the present invention;

图10为本发明所提出的WSDL文件质量保证系统的的数据持久化模块中各张表的关联关系图。FIG. 10 is a relational diagram of tables in the data persistence module of the WSDL file quality assurance system proposed by the present invention.

具体实施方式Detailed ways

以下结合附图及较佳实施例，对依据本发明提供的具体实施方式、结构、特征及其功效，详细说明如下。The specific implementation, structure, features and effects provided by the present invention will be described in detail below in conjunction with the accompanying drawings and preferred embodiments.

本发明的系统框架如图2所示。The system framework of the present invention is shown in FIG. 2 .

如图2所示，本发明主要分为三个模块，分别是文件验证模块、文件解析模块和数据持久化模块。下面分别对各个模块的主要功能进行简要的介绍。As shown in Fig. 2, the present invention is mainly divided into three modules, namely a file verification module, a file parsing module and a data persistence module. The main functions of each module are briefly introduced below.

一、文件验证模块1. File Verification Module

该模块的主要功能是对即将发布的WSDL文件的格式进行验证。The main function of this module is to verify the format of the WSDL file to be published.

WSDL文件中出现的错误种类非常的多，经过大量分析互联网上的WSDL文件并对出错率较高的几种错误进行研究总结，文件验证模块依据此总结经验，对需要发布的WSDL文件逐条进行验证。如果文件有错误则显示出错误信息，包括错误类型与错误位置等，对于一些错误提供基于用户选择的自动修改方案，为方便用户查看验证WSDL文件，工具应该提示用户文件的错误信息、出错位置以及自动修改的方案。There are many types of errors in WSDL files. After a large number of analysis of WSDL files on the Internet and the research and summary of several errors with high error rates, the file verification module verifies the WSDL files that need to be released one by one based on this summary of experience. . If there is an error in the file, the error message will be displayed, including the error type and error location, etc. For some errors, an automatic modification scheme based on user selection is provided. To facilitate the user to view and verify the WSDL file, the tool should prompt the user for the error message, error location and Automatic modification of the scheme.

文件验证模块具体实现以下两方面的功能：The file verification module specifically implements the following two functions:

①验证WSDL文件的基本格式，如标签是否配对使用、是否包含<service>等必要的标签等；①Verify the basic format of the WSDL file, such as whether the tags are used in pairs, whether they contain necessary tags such as <service>, etc.;

②对WSDL文件中的命名空间是否有效、服务的URL是否仍然存活、元素是②Whether the namespace in the WSDL file is valid, whether the URL of the service is still alive, whether the element is

否已经声明、<schema>标签下是否缺少必要的命名空间前缀、导入的文件的URL是否有效等等；Whether it has been declared, whether the necessary namespace prefix is missing under the <schema> tag, whether the URL of the imported file is valid, etc.;

从文件验证模块的功能可知该模块仅仅是对WSDL文件简单错误的进行验证，对于其他错误，例如复杂元素导致的递归问题，元素未定义等更为复杂的错误则因为这些错误与文件解析关系密切，要想发现并改正这些错误，则需要对WSDL文件进行解析。另外如果要发现深层的参数依赖、消息绑定等方面的错误信息也必须对WSDL文件进行解析。本发明中的文件验证模块非常重要，成功的验证一个WSDL文件能够为在数据库中批量添加Web服务提供方便，同时也能避免文件解析做很多无用工作，节省时间。From the function of the file verification module, it can be known that this module only verifies simple errors in WSDL files. For other errors, such as recursion problems caused by complex elements, undefined elements and other more complex errors, these errors are closely related to file parsing. , in order to find and correct these errors, you need to analyze the WSDL file. In addition, if you want to find error messages about deep parameter dependencies and message binding, you must also parse the WSDL file. The file verification module in the present invention is very important, successfully verifying a WSDL file can provide convenience for adding Web services in batches in the database, and can also avoid a lot of useless work in file parsing and save time.

二、文件解析模块2. File parsing module

该模块的主要功能是利用获取的Web Service详细信息，验证WSDL所传递的信息是否正确：The main function of this module is to verify whether the information delivered by WSDL is correct by using the obtained detailed information of Web Service:

①服务的基本信息：Web服务名、Web服务地址、服务的namespace等等①Basic information of the service: Web service name, Web service address, service namespace, etc.

②操作的基本信息：操作名、操作输入输出参数、操作的描述信息等②Basic information of the operation: operation name, operation input and output parameters, description information of the operation, etc.

③参数的基本信息：参数名、参数类型、是否为ComplexType、ComplexType中包含的基本类型信息等③Basic information of parameters: parameter name, parameter type, whether it is ComplexType, basic type information contained in ComplexType, etc.

由于WSDL在binding时通常使用RPC和Document两种方式，因此在解析Web服务接口的参数信息时应该制定不同的解析方案：Since WSDL usually uses RPC and Document in binding, different resolution schemes should be formulated when parsing the parameter information of the Web service interface:

RPC方式：在<part../>标签中描述参数类型的时候，通过其属性type的值体现出参数类型信息；而在<types>标签中定义数据类型时，会使用<simpleType>、<complexType>等标签表示。RPC method: When describing the parameter type in the <part../> tag, the parameter type information is reflected through the value of its attribute type; while defining the data type in the <types> tag, <simpleType>, <complexType will be used > and other labels.

Document方式：与RPC方式不同的是，在此方式中是通过其属性element的值体现出参数类型信息，在<types>标签中也会使用<element>来定义<part>中提到的参数类型。Document method: Different from the RPC method, in this method, the parameter type information is reflected through the value of its attribute element, and <element> is also used in the <types> tag to define the parameter type mentioned in <part> .

所以在解析参数信息时，对特定的文档应该判定其使用的是何种方式并使用相应的类和方法来进行正确解析。Therefore, when parsing parameter information, it is necessary to determine which method is used for a specific document and use the corresponding class and method for correct parsing.

三、数据持久化模块3. Data Persistence Module

该模块的主要功能是在文件解析模块的基础上，对Web Service详细信息进行存储。涉及的操作分别为：The main function of this module is to store detailed information of the Web Service on the basis of the file parsing module. The operations involved are:

①设计一个数据表用于存放Web Service接口的基本服务信息；① Design a data table to store the basic service information of the Web Service interface;

②设计一个数据表用于存放Web Service接口中含有的操作的基本信息；② Design a data table to store the basic information of the operations contained in the Web Service interface;

③设计一个数据表用于存放每一个操作中含有的参数的基本信息；③ Design a data table to store the basic information of the parameters contained in each operation;

④定义对数据库操作的接口，实现基本的数据库操作。④ Define the interface to the database operation to realize the basic database operation.

如图3所示，为本发明的WSDL文件质量保证系统的实现流程，具体包括以下步骤：获取WSDL文件；验证文件格式；解析WSDL文件；为保证数据持久性，接入数据库操作接口将验证和解析数据按照数据结构进行存储。As shown in Figure 3, it is the implementation process of the WSDL file quality assurance system of the present invention, which specifically includes the following steps: obtaining the WSDL file; verifying the file format; parsing the WSDL file; in order to ensure data persistence, the access database operation interface will verify and Parsed data is stored according to the data structure.

如图4所示，文件验证模块的具体处理流程包括：As shown in Figure 4, the specific processing flow of the document verification module includes:

在该模块中，由于WSDL基于XML语言，因此可以用校验XML文件的方法来校验WSDL文件。文件验证的过程可以分为以下几个步骤：In this module, since WSDL is based on the XML language, the WSDL file can be verified by the method of verifying the XML file. The document verification process can be divided into the following steps:

步骤401、获取WSDL文件；Step 401, obtaining the WSDL file;

步骤402、验证WSDL文件的基本格式是否正确，具体为判断文件是否满足WSDL文档的概念模型；若正确，继续步骤403；否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；Step 402, verify whether the basic format of the WSDL file is correct, specifically to determine whether the file satisfies the conceptual model of the WSDL document; if correct, continue to step 403; otherwise, execute step 413, there is an error in the WSDL file, and an error message is displayed, and the verification procedure ends ;

步骤403、通过检查文件的命名空间属性的值来验证是否为空；若为空值，则继续步骤404；否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；Step 403, verify whether it is empty by checking the value of the namespace attribute of the file; if it is empty, then continue to step 404; otherwise, execute step 413, there is an error in the WSDL file, and an error message is displayed, and the verification program ends;

步骤404、通过访问Web服务地址URL是否失效并根据返回的页面状态信息判断Web服务的地址是否有效；若为有效，则继续步骤405；否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；Step 404, check whether the URL of the web service address is invalid and judge whether the address of the web service is valid according to the returned page status information; if it is valid, then continue to step 405; otherwise, execute step 413, there is an error in the WSDL file, and an error message is displayed , the verification procedure ends;

步骤405、在文档中按标签名查找某元素，根据查找结果检验文档中是否包含某元素的定义WSDL文件中是否缺失对某个元素的定义；若缺失，则继续步骤406；否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；；Step 405, search for a certain element by the tag name in the document, check whether the definition of a certain element is included in the document according to the search result, and whether the definition of a certain element is missing in the WSDL file; if missing, then continue to step 406; otherwise, execute step 413, There is an error in the WSDL file, and an error message is displayed, and the verification procedure ends;;

步骤406、验证<schema>标签下各元素及其子节点是否都含有必要的命名空间前缀，如有元素或其子节点缺少命名前缀，则继续步骤407；否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；Step 406, verify whether each element and its child nodes under the <schema> tag contain the necessary namespace prefix, if any element or its child node lacks the naming prefix, continue to step 407; otherwise, execute step 413, and there is an error in the WSDL file , and an error message is displayed, and the verification process ends;

步骤407、检验WSDL文件是否存在导入文件的语句即<import>标签，若含有则执行步骤408，否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；Step 407, check whether the WSDL file has the sentence of importing the file, that is, the <import> tag, if it contains, then execute step 408, otherwise execute step 413, there is an error in the WSDL file, and an error message is displayed, and the verification program ends;

步骤408；判断<import>标签中导入URL是否有效，如有效，则继续步骤409；否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；Step 408: Determine whether the imported URL in the <import> tag is valid, if valid, continue to step 409; otherwise, execute step 413, if there is an error in the WSDL file, an error message will be displayed, and the verification procedure ends;

步骤409；检验Schema中是否缺少命名前缀；如果否，则执行步骤412；如有缺失，执行步骤410；否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；Step 409: Check whether the naming prefix is missing in the Schema; if not, then execute step 412; if there is any missing, execute step 410; otherwise execute step 413, there is an error in the WSDL file, and an error message is displayed, and the verification procedure ends;

步骤410、判断是否需要对上述的Schema中缺少的命名前缀进行自动改正；如需要，则执行步骤411；否则执行步骤413，WSDL文件中有错，并显示错误信息，验证程序结束；Step 410, judging whether it is necessary to automatically correct the missing naming prefix in the above-mentioned Schema; if necessary, execute step 411; otherwise execute step 413, there is an error in the WSDL file, and an error message is displayed, and the verification procedure ends;

步骤411、将错误改正，并将出错类型、位置显示出来；Step 411, correct the error, and display the type and location of the error;

步骤412、WSDL文件有效。Step 412, the WSDL file is valid.

由于WSDL文件可能出现的错误种类繁多，不可能一一列举解决，虽然以上各步骤并不能保证所有通过文件验证模块的文件都是有效的，但是已经极大的提高了检测出错误WSDL文件的效率，能够检验出绝大多数的存在错误的WSDL文件。其他应该作为检验项，以保证所发布的WSDL文件质量的指标也应考虑在内，不限于上述流程的描述。Due to the wide variety of errors that may occur in WSDL files, it is impossible to list and solve them one by one. Although the above steps cannot guarantee that all files that pass the file verification module are valid, they have greatly improved the efficiency of detecting error WSDL files. , can detect the vast majority of WSDL files with errors. Other indicators that should be used as inspection items to ensure the quality of the published WSDL files should also be taken into consideration, not limited to the description of the above process.

如图5所示，本发明的WSDL文件质量保证系统的实现流程依序执行WSDL文件解析流程，由于WSDL文件是基于XML语言的，而且WSDL文档中各标签、父标签与子标签之间也都有很强的逻辑关系，文件的格式也相对固定，因此文件进行解析的时候可以按照标签service（服务）→port（端口，定义使用soap等协议进行传输所使用的端口类型）→binding（绑定，描述了传输时具体使用的协议细节）→portType（端口类型，描述了服务中绑定的操作的信息）→operation（操作，描述了操作中应有的输入输出消息）→message（定义了操作的交互方式，例如输入参数集合所构成的输入消息，输出参数集合所构成的输出消息）→part（定义了操作的消息中所含有的具体输入输出参数）的顺序依次进行解析获取相应的信息。例如在message标签下获取所有的part对象，根据每个part对象所含有的信息获取相应的输入输出参数类型、名称等。该流程具体包括以下步骤：As shown in Figure 5, the implementation process of the WSDL file quality assurance system of the present invention executes the WSDL file parsing process in sequence, because the WSDL file is based on the XML language, and there are also all tags, parent tags and sub-tags in the WSDL document. There is a strong logical relationship, and the format of the file is relatively fixed, so when parsing the file, you can follow the label service (service) → port (port, defining the port type used for transmission using protocols such as soap) → binding (binding , describes the details of the protocol used during transmission) → portType (port type, describes the information of the operation bound in the service) → operation (operation, describes the input and output messages that should be used in the operation) → message (defines the operation The interaction method, such as the input message composed of the input parameter set, the output message composed of the output parameter set) → part (the specific input and output parameters contained in the message that defines the operation) are analyzed in order to obtain the corresponding information. For example, obtain all part objects under the message tag, and obtain corresponding input and output parameter types, names, etc. according to the information contained in each part object. The process specifically includes the following steps:

通过步骤501获取待解析的WSDL文件，步骤502获取Schema标签列表；步骤503获取服务Service列表；Obtain the WSDL file to be parsed bystep 501, obtain the Schema tag list instep 502; obtain the service Service list instep 503;

步骤504，在服务Service列表中获得当前服务包含的port（即服务的名称和URL），在服务service标签中可以获取Web服务的名字及服务的URL；Step 504, obtain the port (that is, the name and URL of the service) contained in the current service in the service Service list, and obtain the name of the Web service and the URL of the service in the service service tag;

步骤505，在port标签下获得port的名字、类型以及和其关联的binding标签的名称；Step 505, obtain the name, type of port and the name of the binding label associated with it under the port label;

步骤506、步骤507，从上述端口绑定所使用的协议（例如soap或http）以及绑定的端口中分别获得有关操作（operation）绑定的详细信息，该详细内容包括操作名称和有关描述信息等；Step 506 andStep 507, respectively obtain detailed information about operation (operation) binding from the protocol (such as soap or http) used in the above port binding and the bound port, the detailed content includes operation name and related description information wait;

步骤508；根据标志位来判定是否为操作输入参数，如果是操作输入参数，则执行步骤509：获取输入的message对象、获取message对象中所有的part、对输入参数进行解析以及输出参数列表；如果判定结果为非操作输入参数，则执行步骤510；Step 508: Determine whether it is an operation input parameter according to the flag bit, if it is an operation input parameter, then perform step 509: obtain the input message object, obtain all parts in the message object, analyze the input parameter and output the parameter list; if If the determination result is a non-operational input parameter, then step 510 is performed;

步骤510、获取输出的message对象、获取message对象中所有的part，对输出参数捷星解析以及输入参数列表；Step 510, obtain the output message object, obtain all parts in the message object, analyze the output parameter Jetstar and input parameter list;

步骤509、510中，在message标签中可以获取消息中所包含的part名字，还有根据RPC或者Document方式的不同得到part的类型名或者元素名。Insteps 509 and 510, the name of the part contained in the message can be obtained from the message tag, and the type name or element name of the part can be obtained according to the different RPC or Document methods.

上述解析操作完成后，即执行数据持久化操作。After the above parsing operation is completed, the data persistence operation is performed.

另外，在part标签中，根据RPC或者Document方式获取参数的类型，如果参数是ComplexType类型则通过不断的迭代直至解析出最基本的类型。如图6所示，为文件解析模块对参数进行解析的子流程图。该子流程包括以下具体步骤：In addition, in the part tag, the type of the parameter is obtained according to the RPC or Document method. If the parameter is of the ComplexType type, iterates until the most basic type is resolved. As shown in FIG. 6 , it is a sub-flow chart of parsing parameters by the file parsing module. This sub-process includes the following specific steps:

步骤601，对每一个part对象获取其名字；Step 601, obtain its name for each part object;

以下分为RPC模式和Document模式两种模式进行part参数的解析：The following is divided into two modes: RPC mode and Document mode to analyze part parameters:

RPC模式的解析过程：步骤602，获取part中类型名称所对应的数据类型；步骤603判断该数据类型是否为简单数据类型（简单数据类型一般使用<simpleType>标签来定义，而且要求简单数据类型的定义不能包含属性，并且元素内容是简单类型值，它主要沿用了xml schema中所定义的基本数据类型，如string，int，double等等）；如是，步骤604，获取part参数类型信息；如否，对复杂类型进行解析（复杂类型一般使用<complexType>标签来对数据类型定义，在此标签下可以含有<sequence>、<choice>、<all>等子标签，以此来表示元素时否依次序部分或者全部出现，当然也可以将简单数据类型作为复杂数据类型的一个部分出现。例如<xsd:complexTypename="AuthHeader"><sequence><elementname="login"type="xsd:string"minOccurs="1″maxOccurs="1"/></sequence></xsd:complexType>就定义了一个比较简单的复杂数据类型）。The parsing process of the RPC mode:step 602, obtain the data type corresponding to the type name in the part; step 603 judge whether the data type is a simple data type (simple data types are generally defined using the <simpleType> tag, and simple data types are required The definition cannot contain attributes, and the content of the element is a simple type value, which mainly follows the basic data types defined in the xml schema, such as string, int, double, etc.); if yes,step 604, obtain the part parameter type information; if no , to analyze the complex type (the complex type generally uses the <complexType> tag to define the data type, and this tag can contain sub-tags such as <sequence>, <choice>, <all>, etc., to indicate whether the elements are sequential Part or all of the sequence, of course, the simple data type can also appear as a part of the complex data type. For example, <xsd:complexTypename="AuthHeader"><sequence><elementname="login"type="xsd:string"minOccurs= "1″maxOccurs="1"/></sequence></xsd:complexType> defines a relatively simple complex data type).

Document模式的解析过程：步骤612，获取part中元素名称所对应的数据类型；步骤613判断该数据类型是否为简单数据类型（使用<element name="stationId"type="xsd:string"/>语句就定义了一个简单的简单数据类型）；如是，步骤614，获取part中包含的参数类型信息；如否，对复杂数据类型进行解析（例如使用如下语句<elementname="Parameters 1"><complexType><sequence><elementname="stationId"type="xsd:string"/></sequence></complexType></element>就定义了一个Document模式下的复杂数据类型）。The parsing process of the Document mode:step 612, obtain the data type corresponding to the element name in part; step 613 judge whether the data type is a simple data type (using the <element name="stationId" type="xsd:string"/> statement Just define a simple simple data type); if yes,step 614, obtain the parameter type information contained in the part; if no, analyze the complex data type (for example, use the following statement <elementname="Parameters 1"><complexType> <sequence><elementname="stationId"type="xsd:string"/></sequence></complexType></element> defines a complex data type in Document mode).

如图7所示，为数据持久化模块中Web Service基本信息表（serviceinfo表）的数据结构图，用于存储Web Service接口基本信息的数据字段。serviceinfo表，主要包括服务名、命名空间、服务的id、WSDL文件的存储位置等Web服务接口基本信息字段。As shown in Figure 7, it is the data structure diagram of the Web Service basic information table (serviceinfo table) in the data persistence module, which is used to store the data fields of the basic information of the Web Service interface. The serviceinfo table mainly includes the basic information fields of the Web service interface such as the service name, namespace, service id, and storage location of the WSDL file.

如图8所示，为数据持久化模块中存储操作信息表（operationinfo表）的数据结构图，用于存储Web服务接口中操作的基本信息的数据字段。operationinfo表中主要包含操作名，WSDL文件中对操作的描述信息、服务id、操作的id等操作的基本信息字段。As shown in Figure 8, it is a data structure diagram of the storage operation information table (operationinfo table) in the data persistence module, which is used to store the data field of the basic information of the operation in the Web service interface. The operationinfo table mainly includes the operation name, the description information of the operation in the WSDL file, the service id, the id of the operation and other basic information fields of the operation.

如图9所示，为数据持久化模块中存储参数基本信息表（parameterinfo表）（此处的参数具体指对于服务中每个操作所含有的输入输出参数信息）的数据结构图用于存储操作中参数的基本信息的数据库字段。parameterinfo表包含了标识参数的输入或输出、参数名、参数的类型、参数的id、所属操作的id、是否为ComplexType类型等参数的基本信息字段。As shown in Figure 9, the data structure diagram for storing the basic parameter information table (parameterinfo table) in the data persistence module (parameters here specifically refers to the input and output parameter information contained in each operation in the service) is used for storage operations A database field for the basic information of the parameter in . The parameterinfo table includes the basic information fields identifying the input or output of the parameter, the parameter name, the type of the parameter, the id of the parameter, the id of the operation to which it belongs, and whether it is a ComplexType type or not.

如图10所示，为数据持久化模块中各张表的关联关系图，即上述serviceinfo表、operationinfo表、parameterinfo表三个表之间的关联关系。parameterinfo表与operationinfo表彼此间的信息相互关联，而operationinfo表与serviceinfo表彼此间的信息相互关联，serviceinfo表与parameterinfo表之间没有信息关联关系。As shown in FIG. 10 , it is an association relationship diagram of each table in the data persistence module, that is, the association relationship among the above-mentioned serviceinfo table, operationinfo table, and parameterinfo table. The information between the parameterinfo table and the operationinfo table is related to each other, and the information between the operationinfo table and the serviceinfo table is related to each other, and there is no information related relationship between the serviceinfo table and the parameterinfo table.

Claims (4)

Translated fromChinese

1.一种WSDL文件质量保证系统，其特征在于，该系统包括三个模块：文件验证模块、文件解析模块和数据持久化模块，其中：1. A WSDL file quality assurance system, characterized in that the system comprises three modules: a file verification module, a file parsing module and a data persistence module, wherein:文件验证模块，用于对即将发布的WSDL文件进行验证，包括WSDL文件的基本格式验证和WSDL命名空间是否有效、服务的URL是否仍然存活、元素是否已经声明、<schema>标签下是否缺少必要的命名空间前缀、导入的文件的URL是否有效进行验证；The file verification module is used to verify the WSDL file to be released, including the basic format verification of the WSDL file and whether the WSDL namespace is valid, whether the URL of the service is still alive, whether the element has been declared, whether the <schema> tag is missing necessary Verify whether the namespace prefix and the URL of the imported file are valid;文件解析模块，对获取的Web Service详细信息进行解析，验证WSDL文件所传递的服务基本信息、服务端口信息和端口类型信息、操作基本信息以及操作包含的message对象、message对象包含的part参数的基本信息是否正确；message表示操作的交互方式，part表示操作的消息中所含有的具体输入输出参数；The file parsing module analyzes the obtained detailed information of the Web Service, and verifies the basic service information, service port information and port type information, basic operation information, message object contained in the operation, and part parameters contained in the message object transmitted by the WSDL file. Whether the information is correct; message indicates the interactive mode of the operation, and part indicates the specific input and output parameters contained in the operation message;数据持久化模块，在文件解析模块的基础上，对Web Service详细信息进行存储；存储数据具体包括用于存储Web Service接口基本信息的Web Service基本信息表、用于存储Web服务接口中操作的基本信息的操作信息表以及；以及用于存储操作中参数的基本信息的参数基本信息表；并且，在模块中定义对web Service数据库操作的接口，实现数据操作。The data persistence module, based on the file parsing module, stores the detailed information of the Web Service; the stored data specifically includes the Web Service basic information table used to store the basic information of the Web Service interface, and the basic information table used to store the operation in the Web Service interface. The operation information table of the information; and the parameter basic information table used to store the basic information of the parameters in the operation; and, define the interface for the web Service database operation in the module to realize the data operation.2.如权利要求1所述的WSDL文件质量保证系统，其特征在于，所述Web Service基本信息表与操作信息表相互关联；操作的消息中所含有的具体输入输出参数基本信息表与操作信息表相互关联，Web Service基本信息表与操作的消息中所含有的具体输入输出参数基本信息表彼此不相关联。2. WSDL file quality assurance system as claimed in claim 1, is characterized in that, described Web Service basic information table and operation information table are interrelated; Concrete input and output parameter basic information table and operation information contained in the message of operation The tables are related to each other, and the basic information table of Web Service and the basic information table of specific input and output parameters contained in the operation message are not related to each other.3.一种WSDL文件质量保证实现方法，其特征在于，该方法包括以下步骤：3. A method for implementing quality assurance of WSDL files, characterized in that the method comprises the following steps:步骤一、验证WSDL文件格式：获取WSDL文件；首先验证WSDL文件的基本格式是否正确，验证处理具体包括：Step 1. Verify the WSDL file format: obtain the WSDL file; first verify whether the basic format of the WSDL file is correct, and the verification process specifically includes:判断文件是否满足WSDL文档的概念模型；通过检查文件的命名空间属性的值来验证是否为空；通过访问Web服务地址URL是否失效并根据返回的页面状态信息判断Web服务的地址是否有效；在文档中按标签名查找某元素，根据查找结果检验文档中是否包含某元素的定义WSDL文件中是否缺失对某个元素的定义；验证<schema>标签下各元素及其子节点是否都含有必要的命名空间前缀；检验WSDL文件是否存在导入文件的语句即<import>标签；判断<import>标签中导入URL是否有效；检验Schema中是否缺少命名前缀；对于验证出的错误类型和位置进行显示或进行WSDL文件有效显示；Judging whether the file satisfies the conceptual model of the WSDL document; verifying whether it is empty by checking the value of the namespace attribute of the file; checking whether the URL of the Web service address is invalid and judging whether the address of the Web service is valid according to the returned page status information; in the document Search for an element according to the tag name, and check whether the definition of an element is included in the document according to the search result. Whether the definition of an element is missing in the WSDL file; verify whether each element and its child nodes under the <schema> tag contain the necessary names Space prefix; check whether the WSDL file has the statement of importing the file, that is, the <import> tag; judge whether the import URL in the <import> tag is valid; check whether the naming prefix is missing in the Schema; display or perform WSDL for the type and location of the verified error The file is effectively displayed;步骤二、进行WSDL文件解析：获取WSDL文件及其Schema标签列表和服务Service列表，文件解析处理具体包括：Step 2. Perform WSDL file parsing: Obtain the WSDL file and its Schema tag list and service Service list. The file parsing process specifically includes:在服务Service列表中获得当前服务包含的服务名称和URL名字、端口port类型；从上述服务所使用的协议以及绑定的端口中分别获得有关绑定操作的详细信息，包括操作名称和有关描述信息；根据标志位来判定是否为操作输入参数：若是操作输入参数，则获取输入的message对象、获取message对象中所有的part，对输入参数进行解析以及输出参数列表；若非操作输入参数，则获取输出的message对象、获取message对象中所有的part，对输出参数进行解析以及输入参数列表；在message标签中可以获取消息中所包含的part，基于RPC方式或者Document方式进行解析获得相应的信息；Obtain the service name, URL name, and port port type contained in the current service in the service Service list; obtain detailed information about the binding operation from the protocol used by the above service and the bound port, including the operation name and related description information ; Determine whether it is an operation input parameter according to the flag bit: if it is an operation input parameter, obtain the input message object, obtain all parts in the message object, analyze the input parameter and output the parameter list; if it is not an operation input parameter, obtain the output The message object, get all the parts in the message object, analyze the output parameters and input parameter list; in the message tag, you can get the part contained in the message, and analyze it based on the RPC method or the Document method to obtain the corresponding information;上述步骤二中所述对操作的消息中所含有的具体输入输出参数进行解析的步骤，具体包括：The step of parsing the specific input and output parameters contained in the operation message described in the above step 2 specifically includes:对每一个part对象获取其名字；Get its name for each part object;基于RPC模式的解析过程：步骤602，获取服务和URL中类型名称所对应的数据类型；步骤判断该数据类型是否为简单数据类型；如是，获取服务和URL参数类型信息；如否，对复杂数据类型进行解析；The parsing process based on the RPC mode: step 602, obtain the data type corresponding to the type name in the service and URL; the step judges whether the data type is a simple data type; if so, obtain the service and URL parameter type information; if not, for complex data The type is parsed;基于Document模式的解析过程：获取服务和URL中元素名称所对应的数据类型；判断该数据类型是否为简单数据类型；如是，获取服务和URL参数类型信息；如否，对复杂数据类型进行解析。Parsing process based on Document mode: Obtain the data type corresponding to the element name in the service and URL; judge whether the data type is a simple data type; if so, obtain service and URL parameter type information; if not, analyze the complex data type.步骤三、上述步骤二的文件解析处理完成后，即执行数据持久化操作，具体处理包括：对Web Service详细信息进行存储；存储数据具体包括用于存储Web Service接口基本信息的Web Service基本信息表、用于存储Web服务接口中操作的基本信息的操作信息表以及；以及用于存储操作中参数的基本信息的参数基本信息表；并且，在模块中定义对web Service数据库操作的接口，实现数据操作。Step 3. After the file parsing and processing in the above step 2 are completed, the data persistence operation is performed. The specific processing includes: storing the detailed information of the Web Service; the stored data specifically includes the Web Service basic information table used to store the basic information of the Web Service interface , the operation information table used to store the basic information of the operation in the Web service interface; and the parameter basic information table used to store the basic information of the parameters in the operation; and, define the interface to the web Service database operation in the module to realize the data operate.4.如权利要求1所述的WSDL文件质量保证实现方法，其特征在于，所述WebService基本信息表与操作信息表相互关联；操作的消息中所含有的具体输入输出参数基本信息表与操作信息表相互关联，Web Service基本信息表与操作的消息中所含有的具体输入输出参数基本信息表彼此不相关联。4. The method for realizing WSDL file quality assurance as claimed in claim 1, characterized in that, the WebService basic information table and the operation information table are related to each other; the specific input and output parameter basic information table and operation information contained in the message of the operation The tables are related to each other, and the basic information table of Web Service and the basic information table of specific input and output parameters contained in the operation message are not related to each other.

Images