This task topic describes how to generate a Web Services Description
Language (WSDL) document, which specifies the interface for a Web Service,
from a message set.
Before you start:
To complete this
task you must already have completed the following tasks:
Tip: You should replace any deprecated constructs
before generating WSDL representations of your message models.
- Switch to the Broker Application Development
perspective.
- In the Resource Navigator, right-click the message definition file
from which you want to generate a Web Service Definition.
- Open the New Message Set Web Service Definition wizard
by clicking New > Message Set Web Service Definition. Alternatively, open the wizard by right-clicking anywhere in the Resource
Navigator then clicking New > Message Set Web Service Definition on
the pop-up menu, or by clicking File > New > Message Set Web Service
Definition on the workbench menu.
- The message set that you selected is highlighted. If this is not
the message set from which you want to generate a Web Service Definition,
select the correct message set.
- Click Next.
Tip: You
do not need to continue to the final page before closing the wizard and generating
your Web Service Definition: you can break out of the wizard by clicking the Finish button
whenever it is active. If the Finish button and the Next button
are both active, you have the option of either closing the wizard from the
current page by clicking Finish, or of continuing on
to further pages of configuration options by clicking Next.
- Specify a destination folder for the Web Service Definition.
Tip: You can either select an existing folder or create
a new folder. If you want to use an existing folder, the folder that you select
must be within the project that contains the message set from which you are
generating the Web Service Definition. If you select an existing folder, the
previous contents are overwritten.
To create a new folder for the
Web Service Definition:
- Click the location for the new folder in the project hierarchy.
- Click Create New Folder and specify a
name for the new folder.
- Click OK.
- Type the Company Domain Name, Definition
Name, Port Type Name, and click the Operation
Type in the drop down list.
Note: These
fields are compulsory and cannot be left blank.
- Click Next.
- Select the message categories for which you want to create operations. To select all the displayed categories, click Select All.
(Note that clicking Deselect All deselects all your
previous selections.)
Tip: Only message categories which have their
role type set to WSDL are available for selection.
- Click Next.
- Specify at least one binding and port addressing option by selecting
one or more of the following check boxes:
- SOAP (over JMS) for sending SOAP messages over
the Java Messaging Service.
- SOAP (over HTTP) for sending SOAP messages over
the HTTP.
- JMS (TextMessage) for sending Text messages over
the Java Message Service.
- Click Next.
- Specify the binding and service properties for each binding and
port addressing option that you have selected. For each option,
there are two pages in the wizard, one for bindings and one for services.
When you have completed the information on each page, click Next.
Tip: The wizard completes some fields with default values, which you
can change if required. If a field contains a value that cannot be changed,
this field is unavailable for editing.
- When you have finished adding all the necessary details, click Finish to
generate your Web Service Definition.
- To view a generated WSDL file, use the Resource Navigator to
locate the destination directory that you specified in the New
Message Set Web Service Definition wizard. Right-click the WSDL file
that you want to view (*.wsdl file extension)
then click Open on the pop-up menu.