Axis : The Next Generation of Java Soap

by Irani, Romin; Basha, S. Jeelani

• ISBN13: 9781861007155
• ISBN10: 1861007159
• Format: Trade Paper
• Copyright: 2002-05-01
• Publisher: Springer-Verlag New York Inc

Summary

This book will provide the first in-depth look at AXIS, which is the new name for Apache SOAP the most widely used Java implementation of SOAP. The rapid uptake of SOAP based web services has lead to the continuous and rapid development of the SOAP specification putting pressure on the various implementations to keep up. AXIS will address the performance issues inherent in Apache-SOAP and create a new architecture, which will be more extensible.

The book starts with an introduction to AXIS and web services, highlighting the goals of the Apache AXIS project and its current status. The key to exploiting the power of AXIS is in understanding its architecture and how to extend it. This book will show you how to do this by writing your own custom message handlers. Then it moves on to using the new parts of the SOAP specification AXIS implements and Java 2 Enterprise Edition integration. All this builds towards a full case study based around a supply chain application for a car manufacturer and its dealers.

Table of Contents

Introduction	1	(1)
Who Is This Book For?	1	(1)
What Does This Book Cover?	1	(1)
What Do You Need?	2	(3)
Servlet Container	2	(1)
Apache AXIS	3	(1)
Additional Software	3	(2)
Introduction to AXIS	5	(28)
SOAP and Web Services	5	(14)
Introducing SOAP	6	(1)
Introducing Web Services	6	(2)
SOAP	8	(1)
SOAP Message	9	(1)
SOAP Header	10	(2)
SOAP Transport Protocol Bindings	12	(2)
SOAP Data Encoding Rules	14	(1)
SOAP Fault Handling	15	(1)
WSDL	16	(2)
UDDI	18	(1)
Publication	19	(1)
Discovery	19	(1)
From Apache SOAP to AXIS	19	(3)
AXIS Beta 1 Features	20	(2)
Installing AXIS	22	(1)
Software Requirements	22	(2)
Verifying the Basic Setup	24	(1)
Our First AXIS Web Service	25	(4)
Hello World	25	(1)
HelloWorld Web Service (HelloWorld.java)	25	(1)
Deploying Hello World Web Service	26	(1)
HelloWorld Web Service Client (HelloWorldClient.java)	26	(2)
Executing the Hello World Web Service Client	28	(1)
SOAP Request	28	(1)
SOAP Response	29	(1)
Summary	29	(4)
Getting Started with Axis	33	(34)
The AXIS Web Deployment Descriptor (WSDD)	33	(2)
An RPC-based Service	35	(2)
AXIS-Deployment Process	37	(7)
Creating a Client for SparePartPrice	39	(2)
Parameter Types and Return Types	41	(3)
WSDL Support In AXIS	44	(10)
Java2WSDL	45	(2)
Generating Client Stubs with WSDL2Java	47	(2)
Using The Client Stubs	49	(1)
Generating Server-side Skeleton Code with WSDL2Java	50	(2)
Server-side Skeleton Classes	52	(1)
Client-side Stub Classes	53	(1)
Message-based Services	54	(9)
Writing the Message-based Web Service Client	56	(3)
Writing the CatalogPublisher Web Service	59	(3)
Deploying the CatalogPublisher Web Service	62	(1)
Undeploying a Web Service in AXIS	63	(4)
Architecture	67	(40)
Overview of the AXIS System	67	(1)
Introduction to AXIS Message Processing	68	(8)
Handlers, Chains, and Message flow	69	(2)
Server-side Message Processing	71	(2)
Client-side Message Processing System	73	(2)
Other Message Patterns	75	(1)
One-way Input Message	75	(1)
One-way Outbound Message	76	(1)
Core AXIS Components	76	(19)
MessageContext	77	(1)
Handier Lifecycle	78	(3)
Chains	81	(1)
The TargetedChain Interface	82	(1)
Transports	83	(1)
Transport Sender	84	(1)
Transport Listener	84	(1)
Serializers and Deserializers	85	(2)
Type Mapping	87	(2)
Fault Handling	89	(3)
Scope	92	(3)
Configuration and Deployment	95	(12)
Web Service Deployment Descriptor (WSDD)	95	(2)
Flow	97	(1)
Providers	98	(3)
WSDDDeployment	101	(2)
Admin Service and Admin Client	103	(4)
Custom Handlers in AXIS	107	(34)
AXIS Handlers	107	(5)
AXIS Handlers - WSDD Details	112	(5)
AXIS Handlers - Sample Configuration	115	(1)
A Service Request Handler	115	(1)
A Service Request and Service Response Handler	116	(1)
SparePartInfo web Service	117	(2)
Deploying and invoking the SparePartInfo Web Service	119	(1)
SOAP Request Logger	119	(5)
Deploying and invoking the SparePartInfo Web Service	123	(1)
Performance Monitoring Logger	124	(6)
Deploying and invoking the SparePartInfo Web Service	129	(1)
Fault Handling	130	(11)
Request Handler - Handler1	133	(1)
Request Handler - Handler2	134	(1)
Response Handler - Handler3	135	(1)
FaultService Client	136	(1)
Deploying and Invoking the FaultService	137	(4)
Advanced AXIS Features	141	(46)
Custom Data Types	141	(9)
Client Applications	146	(1)
Client 1	146	(2)
Client 2	148	(1)
Running the Clients	149	(1)
Using Attachments	150	(4)
Deployment Descriptor	151	(3)
JMS Transport Handler	154	(13)
Defining JMS Administered Objects in WebLogic 6.1	155	(1)
Utility Class	156	(1)
The Message Sender	157	(2)
The Message Listener	159	(4)
The Transport	163	(1)
The Deployment Descriptor	164	(1)
The Client	164	(3)
Custom Serialization	167	(8)
Deserializer Factory	169	(1)
Serializer	169	(2)
Deserializer	171	(2)
Client	173	(2)
Security	175	(12)
HTTP Basic Authentication	175	(3)
One-way authentication	178	(3)
SSL Client	181	(2)
Two-way authentication	183	(2)
Summary	185	(2)
Interoperability	187	(16)
Achieving interoperability	188	(1)
Using a Microsoft .NET Service from an AXIS Client	189	(4)
Generating Stub Classes	191	(2)
Using a GLUE Service from an AXIS Client	193	(2)
Using AXIS Services from .NET Clients	195	(8)
Accessing an AXIS Service from a C# Client	198	(5)
Future Directions for AXIS	203	(12)
XML Protocol (XMLP)	203	(2)
Transport Protocols	205	(1)
Security	205	(2)
XML Signatures	205	(2)
XML Key Management Specification (XKMS)	207	(1)
Java API for XML Messaging (JAXM)	207	(2)
JAXM	208	(1)
JAXM Message Model	208	(1)
Why AXIS should Support JAXM	209	(1)
SOAP Intermediaries	209	(1)
Administration and Monitoring	210	(1)
Exception Handling	211	(1)
Versioning	211	(1)
Providers	211	(1)
Support for Multidimensional and Sparse Array	212	(3)
Case Study	215	(32)
UMW Case Study Description	215	(6)
Current Implementation	216	(1)
Dealer	216	(1)
UMW	217	(1)
Moving Forward	218	(3)
UMW Application Functionality	221	(1)
Dealer Application	221	(1)
UMW Application	221	(1)
Case Study Development	222	(1)
Design	222	(12)
Database Design	222	(3)
Dealer Java classes	225	(1)
Spare Part Inventory Application and Web Service	226	(8)
Case Study Application Setup	234	(6)
Software Requirements	235	(1)
Source Code structure	235	(2)
Tomcat Setup	237	(1)
Dealer 1 Setup	238	(1)
Create Database	238	(1)
Deploy the Application	238	(1)
Dealer 2 Setup	239	(1)
Create Database	239	(1)
Deploy the Application	239	(1)
UMW Setup	239	(1)
Create Database	239	(1)
Deploy the Application	240	(1)
Running the Application	240	(7)
Spare Part Inventory	240	(1)
Spare Part Ordering	241	(2)
Car Appointment Service Reservation	243	(4)
Appendix A: AXIS TCP Monitor	247	(6)
Redirecting SOAP Messages	250	(3)
Appendix B: J2EE Integration	253	(14)
J2EE Servers and AXIS	254	(1)
SparePartPrice EJB	255	(4)
SparePartPrice EJB Development	255	(1)
SparePartPrice Home Interface	256	(1)
Remote Interface	256	(1)
Bean Implementation	256	(2)
Deployment Descriptor	258	(1)
JBOSS 2.4.4	259	(5)
JBOSS-specific Deployment Descriptor	259	(1)
Deploying the SparePartPrice Session EJB in JBOSS	260	(1)
WSDD for the SparePartPrice Session Bean	261	(2)
SOAP Client	263	(1)
Conclusion	264	(3)
Appendix C: JAX-RPC	267	(6)
Introduction to JAX-RPC	267	(1)
API for Invoking a Service	268	(2)
Relation between JAX-RPC and AXIS	270	(3)
Appendix D: Support and Code Download	273	(1)
Downloading the Code for this Book	273	(1)
Errata	273	(1)
Email Support	273	(1)
p2p.wwx.com	274	(1)
The Early Adopters Page	275