8.1 Overview
This chapter presents the various options available for creating a service using HydraExpress. This tutorial complements Chapter 7, "Developing Clients," both of which are based on the provided example DayofWeek located in your <installdir>\tutorials\webservices\DayOfWeek directory.
Chapter 7 generates code to create both a client and server for the DayofWeek example, and discusses the client and options for creating a client. This chapter discusses the service, options for creating a service, and building and testing the service using the client.
The WSDL file DayOfWeek.wsdl defines a single operation, GetDayOfWeek. Since this tutorial focuses on the process of working with the generated components rather than designing an implementation, the service is deliberately simple. The operation receives a message containing an XML Schema date part. The operation returns a message containing an XML Schema string that holds the day of the week on the date provided.
For a basic discussion on generating code, see Section 3, "Creating a Web Service."
To create a service:
Invoke the generator (Section 8.2.1).
Implement the server (Section 8.2.2).
Compile the server implementation (Section 8.2.3).
Deploy the service (Section 8.2.4).
To test the service, use the client as described in Chapter 7. Section 8.3 describes additional considerations involved in creating a server suitable for production.
HydraExpress generates three server-side classes:
an abstract base class from which the concrete service implementation derives
a sample concrete service implementation
a SOAP message handling class
The generator overwrite-protects sample implementations, configuration files, and generated makefiles, meaning that subsequent code generations append .sample to the file if a file of the same name exists in the code generation directory. See Section 21.7, "Overwrite Protection."
If you modify a file with a .sample extension, be sure to remove the extension or rename the file before rerunning the code generator, or your changes will be overwritten.
©2004-2007 Copyright Quovadx, Inc. All Rights Reserved.
Quovadx and Rogue Wave are registered trademarks of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.