Managing WSDLs
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 WSDLMediaTypeHandler
, ZipWSDLMediaTypeHandler
, and ServiceMediaTypeHandler
support this. For more information on how to configure handlers please read Handler Configuration Details.
Users can upload WSDL files from users local file system as a Governance Archive (See Creating a Governance Archive) or import them from a given URL.
During the importing WSDL is validated and put into the registry. If the given WSDL requires any other WSDL imports, these WSDLs also going 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.
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.
Adding a WSDL
Follow the instructions below to add a new WSDL to the Governance Registry.
- Sign in. Enter your user name and password to log on to the Management Console.
- Click the Main button to access the Metadata menu. From the left navigation menu, under Add, in the Metadata menu, select WSDL.
- Select whether to import the WSDL from a URL or upload it from a file. If Import WSDL from url is selected, specify the URL of the WSDL, its name and version.
If Upload WSDL from file was selected, you can upload a single WSDL file or a ZIP file (in .zip or .gar extension) containing set of WSDL/schema files. See Creating a Governance Archive. Use the Browse button to upload a file. - Click on the Add button.
To update an existing WSDL, either delete and add it again or use the Resource Browser.
WSDL Validation
WSO2 Governance Registry validates each WSDL file during the first addition. It will also validate any WSDL imports such as XML Schemas.
Validation of each WSDL file as it is being added can become an expensive operation. WSDL validation can be disabled by setting the disableWSDLValidation
property to true
in the respective handler configurations. The WSDLMediaTypeHandler
, ZipWSDLMediaTypeHandler
, and ServiceMediaTypeHandler
support this configuration. For more information on how to configure handlers please read Handler Configuration Details. Please note that the registry will not accept WSDL files with structural imperfections. Even with validation disabled, such WSDL files will be rejected by the handler. If you want to add such WSDL files, you will have to extend the respective handlers with your own implementations.
The WSO2 Governance Registry uses the WSDL Validator from the Eclipse WTP project. This validator supports:
- WS-I Basic Profile (BP)
- WS-I Simple Soap Binding Profile (SSBP)
- WS-I Attachments Profile (AP)
- WS-I Basic Security Profile (BSP)
Listing WSDLs
- All the added WSDLs can be viewed under List > WSDLs.
Information such as WSDL Name, WSDL Namespace, Life Cycle status,Actions and Dependency tree are displayed about WSDLs.
When filtering the data using more than one value in the search field, use comma separated values with quotation marks to distinguish the values. E.g., if there are two entries with the words Connector and Resource, the search string would be: "Connector", "Resource".
- A WSDL can be selected by the name of the WSDL.
- The visualize view provides a custom UI to that particular WSDL, which would illustrate information about the content of the WSDL.