Organization of This Manual

The remainder of this chapter describes the HydraExpress resources available to design Web services.

The following summarizes the contents of this development guide:

• Chapter 1 (this chapter) includes a simple introduction to HydraExpress’s Web service development capabilities and a discussion of the code generator.

• Chapter 2, “Building Web Services with HydraExpress,” introduces the features available when building Web services.

• Chapter 3, “Creating a Web Service,” presents a simple example for creating a Web service based on a WSDL and an XML Schema, including code generation, implementation, compilation, and deployment.

• Chapter 4, “Extending Your Web Service,” extends the previous example by adding an alternate transport and security.

• Chapter 5, “Code Generator Basics,” provides very basic information about the code generator that parses WSDL and schema files to produce the generated APIs.

• Chapter 6, “Working with Data,” discusses how HydraExpress parses complex types in an XML Schema, and how this affects the client and server implementation code.

• Chapter 7, “Developing Clients,” uses the shipped example DayofWeek to illustrate the options available when designing clients to access Web services.

• Chapter 8, “Developing Services,” uses the same example DayofWeek to illustrate the options available when designing services.

• Chapter 9, “Introduction to Message Patterns,” discusses message pattern concepts, using the shipped example WeatherSummary as an example. It also details the library and generated classes that support the notification message pattern.

• Chapter 10, “Solicit-Response and Notification Services,” discusses the WeatherSummary example in detail and its implementation of the one-way and notification message patterns.

This section of the book offers information and procedures on expanding your applications to include functionality to support stable, dependable applications.

• Chapter 11, “Custom Transports and Listeners,” describes how to configure transports and listeners, switch dynamically among transports at runtime, and create a custom transport.

• Chapter 12, “Web Service Logging,” describes the configuration and use of the logging system, including sending logging information to multiple locations, and implementing a rotating logger.

• Chapter 13, “Asynchronous Messaging,” describes the asynchronous methods generated for each Web service operation, and how to make use of them.

• Chapter 14, “SOAP Message Handlers,” describes the rich world of message handlers, message handler chains, and custom handlers.

• Chapter 15, “SOAP and Transport Headers,” describes the API for dealing with SOAP and transport headers.

• Chapter 16, “Named Objects,” describes how to create, configure and use just about any C++ programming object in your clients and services.

• Chapter 17, “SOAP with Attachments,” describes SOAP with attachments conceptually, and presents the API for working with attachments.

• Chapter 18, “Sessions and State,” describes the support for sessions in the servlet container, and how to maintain and manipulate state information.

• Chapter 19, “Internationalizing Your Services,” discusses how HydraExpress performs character conversion in general, and how to customize character conversion in order to use or display custom character encodings in your applications.

This section offers a more detailed discussion and look at the code generator, its options and how to use them effectively, the architecture of the generated files, and the project file and code generation directory structure. It also covers options for compiling and deploying services.

• Chapter 20, “The HydraExpress Code Generator,” describes how to use the code generator with either a WSDL file or an XML Schema, the various options available when invoking the generator, and the expected outputs.

• Chapter 21, “The Project File and Directory Structure,” describes the code generation directory structure and the contents of the HydraExpress project file.

• Chapter 22, “Options for Compiling,” discusses the various options for makefile generation, how to use the generated makefiles, and how to build your applications.

• Chapter 23, “Options for Deploying Services,” discusses the various deployment options, configuration information for your service, the Agent, and the infrastructure that supports the Agent.

• Appendix A discusses the code-generated classes in detail.