PRODUCTS

DOWNLOAD

BUY

LEARN

SUPPORT

COMPANY

Cart

Download a Free Trial >

See What's New >

Buy Now >

Web Services Tools

Play the video

Apache Axis

The Apache Web Services Project has produced Axis, an implementation of the W3C SOAP (Simple Object Access Protocol) standard.

Stylus Studio® uses Apache Axis in several ways:
• to query web services for exploring,
• to retrieve data through web services, and
• to generate code for web services.

Additionally, using the support of the XML Converters, web services through Axis can be built into your own applications, called and executed through XSLT and/or XQuery, and used in XML Pipelines and XML Reports.

Web Service Call Composer

Everything starts with the Web Service Call Composer. This lets you explore a UDDI Repository or WSDL file and see all of the operations that are exposed. Once we've identified a web service from here, we can save the call to it and reuse the output of that call anywhere we would normally use an XML document.

Web Service Demonstration

A more sophisticated demonstration of the Call Composer is available here, but for our purposes let's just use a simple call that fetches the weather from the United States National Oceanic & Atmospheric Administration (or NOAA).

Web services are described in structure by documents known as WSDL (Web Service Description Language) documents, and the URL for the NOAA weather WSDL document is http://www.webservicex.net/WeatherForecast.asmx?WSDL

In our copy of Stylus Studio® (evaluation version can be downloaded for free from here) we'll do File|New|Web Service Call, and in the "WSDL URL:" field we'll type the above URL. After pressing [Enter], the screen will look like this:

(click to enlarge)

In the Operations panel, each of the operations exposed by this web service are shown. We're going to use the GetWeatherByZipCode in a moment.

The Name/Type/Value columns list all of the input values that are required by the operation. Clicking in the Value column turns on an editor that allows you to type in a value. Bedford, Massachusetts is the home of Progress Software Corp., DataDirect Technologies' parent company, and we'll use their zip code in our demonstration.

Underneath that is a template for the actual SOAP request. Stylus Studio® uses the WSDL to create the request that would be sent to the SOAP service, typically through an HTTP "POST" or "GET". If you choose a different operation on the left, a new request XML document is created in that window, and above its approprate parameters are shown. As an alternative to entering the value in the top panel, you can actually modify the XML document in the window — it's live, so if I change <tns:ZipCode/> to <tns:ZipCode>01730</tns:ZipCode> the top panel will update as soon as I'm done typing. Similarly, when I change the top, the bottom document is updated.

WSDL Viewer

To look at the WSDL itself, click on the button illustrated here, or choose WebServiceCall|Open WSDL Document.

Axis Demonstration

To see an actual operation occur, choose the GetWeatherByZipCode operation in the left panel, and then fill in the tns:ZipCode with the value 01730, and press the Send SOAP Request to Apache AXIS button or choose WebServiceCall|Send Request. The output window will then show the results of the call.

The result, in this case, would look something like this:


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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <soap:Body>

    <GetWeatherByZipCodeResponse xmlns="http://www.webservicex.net">

      <GetWeatherByZipCodeResult>

        <Latitude>42.4842873</Latitude>

        <Longitude>71.2767944</Longitude>

        <AllocationFactor>0.002684</AllocationFactor>

        <FipsCode>25</FipsCode>

        <PlaceName>BEDFORD</PlaceName>

        <StateCode>MA</StateCode>

        <Details>

          <WeatherData>

            <Day>Tuesday, November 21, 2006</Day>

           <WeatherImage> http://www.nws.noaa.gov/weather/images/fcicons/nfew.jpg</WeatherImage>

            <MaxTemperatureF>49</MaxTemperatureF>

            <MinTemperatureF>21</MinTemperatureF>

            <MaxTemperatureC>9</MaxTemperatureC>

            <MinTemperatureC>-6</MinTemperatureC>

          </WeatherData>

...

Axis Generating Java

Apache Axis can be used to generate the Java source code to call this web service, including the code to build the XML DOM in memory and do the sending. To generate these classes, use the WebServiceCall|Generate Java Web Service Client option, and after choosing the target directory for the generated source, all of the necessary code will be written for you.

(click to enlarge)

Axis and XSLT

The XML Converters allow you to use converters anywhere you can use regular XML files. One of the special cases of this is that you can save the web service call from the first step above as a special file called a .wscc file, and then use it as input to XSLT or XQuery. As an example, instead of just retrieving the results, we can format them, all in one step. Or we can perform multiple operations using the XML Pipeline module.

Using the noaa.wscc we generated earlier and a little piece of XSLT code we'll call noaa.xslt (both of which can be downloaded by clicking on their names in this paragraph), we can reformat the results of the web service call so they look more attractive, like this:

BEDFORD, MA (42.4842873N, 71.2767944W)
Weather	Day	High	Low
	Tuesday, November 21, 2006	49°F (9°C)	21°F (-6°C)
	Wednesday, November 22, 2006	49°F (9°C)	37°F (3°C)
	Thursday, November 23, 2006	49°F (9°C)	34°F (1°C)
	Friday, November 24, 2006	46°F (8°C)	37°F (3°C)
	Saturday, November 25, 2006	50°F (10°C)	36°F (2°C)
	Sunday, November 26, 2006	47°F (8°C)	32°F (0°C)
	Monday, November 27, 2006	48°F (9°C)	34°F (1°C)

Axis and XQuery

Play the video

Just as Apache Axis web services can be used with XSLT, they can be used with XQuery.

But XQuery has another, direct way of calling web services. If you use the menu choice WebServiceCall|Copy XQuery Call to Clipboard, the actual source code for an XQuery call, using Apache Axis and either DataDirect XQuery or Saxon 8 XQuery, will be created — and it will look something like this:


(: This function requires the following items in the classpath if you are running on Java 1.5:)

(: axis-all.jar;xercesimpl.jar :)

(: If you are running on Java 1.4, you must also include xml-apis.jar :)



(: DataDirect XQuery function binding :)

declare namespace ws = "ddtekjava:com.stylusstudio.webservice.SOAPCall";

declare function ws:call($location as element(), $payload as element()) as document-node() external;



ws:call(

<location 

    address="http://www.webservicex.net/WeatherForecast.asmx"

    soapaction="http://www.webservicex.net/GetWeatherByZipCode"

    timeout="30000"/>,



<tns:GetWeatherByZipCode xmlns:tns="http://www.webservicex.net">

    <tns:ZipCode>01730</tns:ZipCode>

</tns:GetWeatherByZipCode>

)

Stylus Studio® is proud to be able to contribute to the Apache projects, and also to be part of a larger company that has a history of donating code to open source and helping to maintain it. DataDirect Technologies' sister division, Progress Sonic, is responsible for helping drive Axis forward (See Progress Sonic Standards Watch), and both organizations have committer rights on various Apache projects.

See the sweet results of open standards-based Web service development by downloading and evaluating today!

Prev: "WSDL Editor"

Download a 15 Day Free Trial Now >

See What's New in Stylus Studio® X16 XML >

Buy Stylus Studio Now >

Stylus Most Wanted

PURCHASE STYLUS STUDIO ONLINE TODAY!!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Try STYLUS Apache AXIS Tools

Download a free trial of our powerful tools for building Web service applications for Apache AXIS.

Attend a Live Webinar This Week!

Learn about Stylus Studio's unique features and benefits in just under an hour. Register for the Stylus Studio QuickStart Training WebCast!

Why Pay More for XML Tools?

With Stylus Studio® X16 XML Enterprise Suite, you get the most comprehensive XML tool suite at one incredibly low price. Value: it's just one of many reasons why smart XML developers are choosing Stylus Studio!