Swordfish Documentation: registry interface

Managing WSDL's Resource

The entry point to manage WSDL's is the WSDL resource which has the URI

http://{registry host & port}/registry/wsdl

This resource allows to list the available WSDL, upload a WSDL, modify an existing one, and to delete a WSDL again.

Searching WSDL's

You can either query all the available WSDL's in the registry or a subset according to the following two criteria

• Retrieve all WSDL's that contain a portType element with a specific fully qualified name.
• Retrieve all WSDL's that contain a service, which implements a specific portType.

Query Syntax

To get all available WSDL's simply use the GET Method on the WSDL resource. So the following HTTP GET request will return a list of all WSDL's (assuming your registry is installled on example.com with port 80)

GET example.com/registry/wsdl

If only looking for WSDL's with a specific portType name use the following schema

GET example.com/wsdl?type=portType&targetNamespace={target namespace}&name={local name}

If looking for WSDL's that contain a service implementing a specific portType use use following schema

GET example.com/registry/wsdl?type=service&refPortTypeNamespace={target namespace}&refPortTypeName={fully qualified name}

Response

The response of the query is a list of links to WSDL's matching the criteria, which has the following format:

<wsdlList>
  <url>./sample_1.wsdl</url>
  <url>./sample_2.wsdl</url>
  ...
</wsdlList>

The URL's are relative to the URL of the document.

Creating / updating a WSDL

The registry interface offers two ways of creating / updating a WSDL. The preferred way is using PUT to create / update a

Deleting a WSDL

Improvements

• Make the query syntax more generic and allow combinations of query paramters
• Use the the Atom format to return the result set of the query

o return the result set of the query