Combine web services into one WSDL

gany1102 · March 15, 2007, 10:25am

Hi All,

How do we combine more than one web service (SOAP-MSG) into one WSDL file? What are procedures/tools that can be used? OR Do we have to do it manually? If so how? I have couple of web services that I wanted to bundle them into one WSDL file and distribute to other consumers.

Any ideas appreciated.

Thanks in advance.
Gany

wMusers.Com1 · March 15, 2007, 8:54pm

The ability to generate WSDL’s that describe multiple web service operations was requested 2-3 years ago, but is not yet in the product. A new web service descriptor node will be added in IS 7.1 (targeted for Summer 2007) that should address this.

Your only option (and actually not a bad one) is to use a tool such as XML Spy Enterprise Edition to create your WSDL. Other tools such as those in the Eclipse web development toolkit are also options.

Finally, a popular design and development approach for web services is called “WSDL first” in which the interface description is created before the services are coded. This allows proper emphasis on good XML schema design and good message design without undue influence by the physical implementation. After getting an early preview last year of the new web services descriptor node functionality, I requested that the design be modified to better support WSDL-first and from some slides that I saw at last year’s Integration World, I think it will be.

HTH,

Mark

gany1102 · March 15, 2007, 9:25pm

Thanks Mark !

Actually, I need to merge WSDL files created for web services in webMethods. I created WSDLs with wizard and manually combined them. I tried with Muse (wsdlmerge) but it’s assigning it’s own prefix etc., I did not feel comfortble. I wish webMethods comes up with an option generating WSDL file with multiple operations.

Thanks,
Gany

wMusers.Com1 · March 15, 2007, 9:40pm

Apache MUSE WSDLmerge tool looks interesting. Here’s some usage information:

Introduction

This utility exists because it is easier to develop WSDL files separately and then combine them before passing them to code generation. However, because of the way WSDL is currently defined, it is impossible to declare portTypes that combine operations from other portTypes. More specifically the tool will:

combine the portType element of each WSDL file into one portType (this will also incorporate all of the necessary messages and schema types).

combine the WS-RF Document schema from each WSDL (if present) into a one merged WS-RF Document schema.

create a binding based on the new portType using conventions needed for wsdl2java and Muse.

create a service element that attaches to the new binding and portType.

Usage

Run without any parameters the program will print the following usage message to standard out: [INDENT] Usage: wsdlmerge.[bat|sh] -uri URI -address URL -output FILE [OPTIONS] FILES[/b]

[bat|sh]The following arguments are required:
-uri URI The target namespace of the generated WSDL file
-address URL The address of the generated service
-output FILE The address of the generated service[/b]

[bat|sh]FILES must be at least one WSDL file[/b]

[bat|sh]The following arguments are optional:
-overwrite Overwrite files that exist
-help Display this message
[/INDENT]

-uri - the targetNamespace of the newly created WSDL

-address - the address at which to create the service element

-output - the file name of the new WSDL

-overwrite - tells the program to overwrite existing files

-help - prints the help message (same as running with no arguments)

For example a typical usage would be as follows:[INDENT] wsdlmerge
-address “http://localhost:8080/myEndpoint/services/myServiceName”
-uri “http://tempuri.og/myEndpoint.wsdl”
-output myEndpoint.wsdl
wsdl1.wsdl wsdl2.wsdl [/INDENT]The above should be executed on one line.

gany1102 · March 16, 2007, 5:58am

Mark,

That’s the tool I tried. Yes it merged wsdls. But it assigned it’s own prefix and some namespaces. I did not get a chance to verify completely but, It changed my original namespaces to something else. Probably, there might be some other options to retain my namespaces. I need to take a close look at it…

<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions
targetNamespace=“[URL=“http://www.abc.com/xyz/”]http://www.abc.com/xyz/[/URL]”
xmlns:pfx0=“[URL=“http://www.abc.com/xyz/”]http://www.abc.com/xyz/[/URL]”
xmlns:pfx1=“[URL=“http://docs.oasis-open.org/wsrf/rp-2”]http://docs.oasis-open.org/wsrf/rp-2[/URL]”
xmlns:pfx2=“[URL=“WS-Addressing 1.0 Namespace”]http://www.w3.org/2005/08/addressing[/URL]”
xmlns:pfx3=“[URL=“http://schemas.xmlsoap.org/soap/http”]http://schemas.xmlsoap.org/soap/http[/URL]”[COLOR=#ff0000][COLOR=#ff0000]
xmlns:wsdl="[URL=“http://schemas.xmlsoap.org/wsdl/”]http://schemas.xmlsoap.org/wsdl/[/color][/URL][COLOR=black]" >

[/COLOR]
[/COLOR]Thanks,
Gany

sandeeppotdar · October 24, 2007, 12:28pm

Hi,

I am not able to download the latest zip for Muse. http://www.apache.org/dist/ws/muse/2.2.0/bin/ when I download the zip and try to unzip it, it gives an error - Error with the file.

Rgds,
Sandeep

wMusers.Com1 · October 24, 2007, 7:47pm

Sorry, wMUsers is not the support forum for Muse. You’ll need to read up on the current state of that project and post a message on one of their forums.

Mark

sandeeppotdar · October 24, 2007, 9:34pm

Sorry about that, but I just want to know how to combine two WSDls as one (by combining operations)? That is apart from using MUSE?

Rgds,
Sandeep

wMusers.Com1 · October 25, 2007, 4:04am

You would need to use a WSDL editor such as XML Spy Enterprise or the Eclipse WSDL Editor that is part of the Web Development Toolkit (WDT).

Obviously, it will help if you understand how WSDL works. Thomas Erl’s SOA Concepts book is a good place to start for that objective.

Mark