Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

WSDL is one of many asset models supported by the WSO2 Governance Registry. For more information on a complete list of asset models supported by WSO2 Governance Registry, see Supported APIs & Standards.

Note

Governance Registry does not support the WSDL 2.0 standard out-of-the-box. However, if you need this support to be available, you can extend the WSDLMediaTypeHandlerZipWSDLMediaTypeHandler, and ServiceMediaTypeHandler support this. For more information on how to configure handlers, see Handler Configuration Details.

You can upload WSDL files from the local file system as a Governance Archive, or import them from a given URL. For instructions, see Adding a SOAP Service.

During the importing, WSDL is validated and put into the Registry. If the given WSDL requires any other WSDL imports, these WSDLs also go through the same process, and are imported into the Registry. All the Schema/Policy imports are also downloaded into the Registry and put into the location where all the Schemas/Policies are stored.

The WSDL can have a number of Endpoints. The Governance Registry creates new resources for these Endpoints and puts them into a general location where all the Endpoints are saved.

A single WSDL can have a number of dependent resources at the end of import process, and the WSDL resource will have associations and dependencies for those resources according to the relationship.

Info

The registry creates service resources for all the WSDL imports by default, and adds some of the useful data into the service resources by parsing the WSDL. For example, name, namespace, WSDL URL (this is the location of WSDL stored in the registry) and endpoints if available in the WSDL.

Validating WSDLs Offline

Users can upload WSDL files to the WSO2 Governance Registry. During the uploading process, the Governance Registry validates each WSDL file during its first addition. However, in order to do that, there should be an active internet connection on the machine which is running the Governance Registry. This page explains the process to follow in order to add and validate WSDLs using Governance Registry on a machine without having an internet connection.

...

There can be problems and delays in validating WSDL, if the machine doesn't have an active internet connection at the moment. So, as a workaround for this issue, the following sections explain how to host those required resources locally and validate WSDLs using those locally hosted resources without using an internet connection:

Table of Contents

Install and run Apache Web Server

If you are not havenot already installed the Apache web Web server, please refer to this see download page to download the latest version of the Apache web Web server.

Info

For Windows installations, you should download the Windows version of Apache (the file with the .msi extension). For Linux based environments, binary releases are not often up-to-date. Therefore you can , build Apache web Web server from its source in order to get the latest version. See here for For a more detailed explanation on how to build the Apache web server from its source for Linux based environments, go to Compiling and Installing.

To install and run, please refer For information on installing and running, go to the relevant section on Apache Web Server official documentation. For Windows installations please refer , go to the Apache Windows Installations documentation.

At the time when writing this article, the latest Apache web Web server version is 2.4. Therefore, the instructions and references used in this article are related to the latest Apache server documentation version (2.4).

...

Your browser displays content related to Apache web Web server. If not, you may have to check the error logs of the Apache web Web server and resolve issues.

Publish files on Apache Server

Please refer the Apache documentation to locate For information on locating the "web site publish directory" of the Apache server, go to Apache documentation.

E.g., for Linux it is "/var/www" and for Windows it can be "C:\Program Files (x86)\Apache Group\Apache2\htdocs".

As mentioned earlier in this page, WSO2 Governance Registry connects to ws-i.org to download resources (two XML files). Manually download these resources (XML files) and publish them on the Apache web Web server.

To do soHence, download the following XML files from a computer, which is having an internet connection. When we you are adding WSDL through Governance Registry to complete the validation , Governance Registry needs these XML files to complete the validation.

Panel

http://ws-i.org/Testing/Tools/2004/12/AP10_BP11_SSBP10_TAD.xml

http://ws-i.org/Testing/Tools/2005/01/SSBP10_BP11_TAD_1-0.xml

...

The above links display the content of the TAD XML files in the browser.

Editing the hosts file

Hosts file is a text file that contains entries to map host names to IP addresses. By editing this file it is possible to redirect requests (by the WSO2 Governance Registry) requesting ws-i.org site resources to out locally hosted Apache web server resources. In Linux environment, the hosts file is located at:

...

Info

It is always best to take a backup of the host file before modifying it. In this page we assume that Apache web server and WSO2 Governance Registry is installed on the same machine. However, if required, you can install Apache web server on another machine with appropriate changes to the host file (which is in the machine which runs the WSO2 Governance Registry). You can point to the Apache web server machine using the host file.

Verifying the steps

To verify these steps, locate the following link on your browser (on the machine which is not having an internet connection),

...