Oct 2006 Use the Web Services Invocation Framework Samples to explore the Web Services Gateway. This new feature in Version 5 lets clients from outside your firewall use Web services that are inside your enterprise, enabling you to share your resources selectively with your business partners and customers. This feature requires WebSphere Application Server Network Deployment Version 5.0.
The two Web Services Invocation Framework (WSIF) Samples can also be used with the Web Services Gateway to illustrate how the gateway bridges the gap between Internet and intranet environments during Web service invocations. The Web Services Gateway builds upon the Web Services Description Language (WSDL) and WSIF for deployment and invocation. You can use the gateway to make your internal Web services available externally, and to make external Web services available to your internal systems. There are two samples:
- The Stock Quote Sample illustrates a simple Web service that retrieves real stock quotes from WebserviceX.NET.
- The Address Book Sample illustrates a simple Web service that allows the storage and retrieval of names and addresses.
Hardware requirements
The hardware requirements for this sample are the same as for WebSphere Application Server Versions 5.x.
Software requirements
- WebSphere Application Server Network Deployment Version
5.x, and any prerequisite software that it requires
- The Web Services Gateway component of WebSphere Application Server Network Deployment Version 5.x
- Web browser: Internet Explorer 5.x or Netscape 4.79 or higher
Supported operating systems
These samples run on all operating systems that are supported by WebSphere Application Server Version 5.x. They have been tested on Windows® 2000 and SuSE Linux 7.3.
Installation instructions
The
WebSphere Application Server Network Deployment InfoCenter contains information and instructions
on installing and using the gateway. In the InfoCenter's All topics by feature navigation view, select Servers
=> Web services servers => Enabling Web services through the IBM Web Services Gateway.
Before you run the WSIF Samples through the Web Services Gateway, check that they run successfully without the gateway. To install the WSIF Samples, download the ZIP file and unarchive it to a directory of your choice, preserving the directory structure. After unarchiving, open the readme.html file. This gives instructions on how to install, configure, and run these sample Web services outside of the gateway.
To run the WSIF samples through the Web Services Gateway, complete the following additional steps:
- After installing the WSIFSamples.ear file,
use the WebSphere Application Server administrative console
to regenerate and update the Web server plug-in. For more information see
the
WebSphere Application Server Network Deployment InfoCenter.
In the InfoCenter's All topics by feature navigation view, select Environment
=> Web servers => Configuring Web server plug-ins..
- Copy AddressBookCode.jar from the unzip_location/jars
directory to the was_root/lib/ext directory,
then restart the server.
- Deploy each sample Web service to the gateway. Specify
the following deployment details, and accept the default
values for all other deployment fields.
-
Gateway Service Name: StockQuoteSample
-
Message part representation: Generic classes (this is the default)
-
Channels: ApacheSOAPChannel1
-
WSDL Location: http://your_host:80/wsif/samples/stockquote/soap/wsdl/StockQuoteSample.wsdl
-
Gateway Service Name: AddressBookSample
-
Message part representation: Deployed Java classes
-
Channels: ApacheSOAPChannel1
-
WSDL Location: http://your_host:80/wsif/samples/addressbook/soap/wsdl/AddressBookSample.wsdl
- Run each sample Web service using the launchClient
command as described in the WSIF Samples documentation,
but use the -W option to get the WSDL from
the gateway. For example:
launchClient /mySamples/WSIFSamples.ear -CCjar=StockQuoteClient.jar
-W=http://your_host:80/wsgw/ServiceDefinition?name=StockQuoteSample
-S=IBM
launchClient /mySamples/WSIFSamples.ear -CCjar=AddressBookClient.jar
-W=http://your_host:80/wsgw/ServiceDefinition?name=AddressBookSample
Download | Description | Name | Size | Download method |
|---|
| Web Services Invocation Framework Samples | WSIFSamples.zip | 7.5 MB | FTP |HTTP |
|---|
Rate this content
| 
