Java Web Services mit Apache Axis2

Transkript

1 Thilo Frotscher, Marc Teufel, Dapeng Wang Java Web Services mit Apache Axis2 ntwickier

2 Vorwort 13 Wer sollte dieses Buch lesen? 14 Aufbau 14 Wichtiger Hinweis zu den Listings 16 Feedback 16 Danksagung 16 Preface 19 1 Einleitung Entstehung Unterstützte Standards Was beinhaltet Axis2? Warum Axis2 einsetzen? 24 Bessere Performance durch StAX und AXIOM 24 Flexiblere Kommunikationsinfrastruktur 24 Einfacheres Deployment von Services 24 Bessere Unterstützung während der Entwicklung 24 Erweitertes Handler-Konzept 25 Bessere Unterstützung von aktuellen Standards Die Zukunft von Axis Web Service Grundlagen SOAP 27 Nachrichtenformat 28 Verarbeitungsmodell 31 SOAP-Fault 34 Nachrichtenaustausch 36 Protokoll-Binding * 39 SOAP 1.2 vs. SOAP WSDL 44 MEPs - Message Exchange Patterns 45 WSDL WSDL Code First vs. Contract First 54 Der Code-First-Ansatz 55 Der Contract-First-Ansatz 58 Einsatz von Contract First bei bereits bestehendem Code 61 Java Web Services mit Apache Axis2 5

3 3 Erste Schritte Axis2 Distributionen Installation von Axis2 64 Die Axis2 Web-Anwendung 64 Standard Distribution Zentrale Konzepte von Axis2 69 AXIOM 69 Service-Archive 69 Message Receiver 70 Repository Implementierung einfacher Web Services mit POJOs Deployment von Services in einem Standalone-Server Einsatz der Axis2 Web-Anwendung 81 Deployment von Web Services 81 Service-Administration Entwicklung eines Clients für den SimpleHotelService 85 Direkte Verwendung der Client-API von Axis2 85 Entwicklung von Clients mit Hilfe von Codegenerierung Geruhsame Nächte mit Axis Hotels 91 4 Entwicklung mit Axis Eclipse als Entwicklungsumgebung verwenden 93 Projekteinrichtung 93 Eclipse Web Tools Platform Axis2 Eclipse Plug-ins 96 Code-Generator-Wizard 96 Service Archiver Wizard Debugging Diving into the Sources 99 Den Axis2 Quelltext sichten und browsen 100 Axis2 Quelltext erforschen - Ein kleines Beispiel Werkzeuge für den Umgang mit SOAP-Nachrichten 103 Apache TCPMon 103 SOAP erforschen und lernen mit TCPMon 106 SOAPMonitor AXIOM Einführung StAX Push vs. Pull Parsing StAX API XML parsen mit StAX

4 5.3 AXIOM AXIOM Architektur AXIOM API Caching Web Service-Implementierung mit AXIOM Client-API ServiceClient Aufrufmuster Request-Response mit blockierendem API Request-Response mit nicht-blockierendem API über eine Verbindung Request-Response mit nicht-blockierendem API über zwei Verbindungen Einweg-Aufruf Zuverlässiger Einweg-Aufruf Clientseitige Konfiguration JavaBean-Properties Generische Properties HTTP Properties OperationClient ' Contract First mit Axis Codegenerierung Aufruf von WSDL2Java von der Kommandozeile Axis2 Code-Generator-Wizard für Eclipse Ant-Task Implementierung und Deployment von Services Der Ordner resources Generierter Code und Implementierung des Service Paketierung und Deployment Implementierung von Service-Clients Einwegkommunikation Weiterführende Aspekte der Entwicklung 203, Fehlerbehandlung Definition von Fehlern in XML Schema und WSDL Codegenerierung Lebenszyklus von Services Session-Verwaltung Request-Session-Scope SOAP-Session-Scope Transport-Session-Scope Java Web Services mit Apache Axis2

5 Application-Scope Session-Verwaltung mit Client-Anwendungen Codebeispiel REST Einführung SOAP oder REST? REST in Axis2 konfigurieren HTTP GET HTTP POST HTTP GET oder HTTP POST? Architektur und Konfiguration Interne Verarbeitung von SO AP-Nachrichten Flows Phasen Dispatch-Mechanismus Interne Datenstrukturen: Description und Context Description-Hierarchie Context-Hierarchie Beziehung zwischen Context- und Description-Hierarchien Laden von Konfigurationen Globale Konfiguration Parameter Message Receiver Transporte Global eingeschaltete Module und Modulkonfigurationen Standardmäßige Modulversion Phasen Target Resolver Listeners / Observers Konfiguration von Services Services und Service-Gruppen Bestimmung der Namen von Services und Service-Gruppen WSDL-Dokumente und automatische WSDL-Generierung Elemente der Datei services.xml Service-Parameter Deployment von Services Axis2 Web-Anwendung Standalone-Server Zugriff eines Service auf Context und Konfiguration Zugriff auf Ressourcen im Service-Archiv Start von Axis2 mit entferntem Reoositorv

6 10 Handler und Module Handler 286 Die Schnittstelle Handler 287 Implementierung von Handlern 289 Konfiguration von Handlern Module 292 Die Schnittstelle Module 293 Konfiguration von Modulen 294 Paketierung und Deployment 299 Engagement 302 Dynamisches Engagement zur Laufzeit Data Binding Grundlagen des XML Data Binding Code-Generator-Framework ADB - Axis Data Binding 318 ADB Schema-Compiler 318 ADB Integration in Axis2 322 Codegenerierung XMLBeans JiBX JAXBRI JAXME Zusammenfassung Message Receiver & ServiceObjectSupplier Einführung 357 Blick zurück: Provider in Axis 1.x 357 Blick nach vorne: Reise durch die Axis2 Engine Nachrichtenempfänger 359 Contract First 360 Message Receiver von Innen Axis2 und Groovy Message Receiver und WSDL Enterprise JavaBeans und Axis2 371 Einführung 371 Möglichkeiten, eine EJB zu integrieren 373 Der Bankleitzahlen-Service als EJB 374 Die Realisierung von EJBMessageReceiver 379 EJB als Web Service bereitstellen 380 Java Web Services mit Apache Axis2

7 12.6 ServiceObjectSupplier 12.7 Spring Framework Einführung Axis2 und das Spring Framework Der Bankleitzahlen-Service als Spring-Bean SpringServletContextObjectSupplier Erforderliche Spring-Bibliothken SpringAppContextAwareObjectSupplier 12.8 Die EJBUtil Implementierung 13 MTOM & SwA 13.1 Base64 & SwA Base64 SwA 13.2 XOP&MTOM XOP MTOM SwA vs. MTOM 13.3 MTOM in Axis2 OMText MTOM Web Service mit AXIOM-API MTOM Data Binding 13.4 SwA in Axis Attachment-Caching 14 Transportprotokolle 14.1 Transportmechanismus TransportListener TransportSender 14.2 Aktivierung von Transportprotokollen auf Service-Ebene 14.3 HTTP Transport Receiver für Standalone-Modus SimpleHttpServer in eigene Applikationen einbetten CommonsHTTPSender 14.4 TCP 14.5 Mail Transport (SMTP) Konfiguration des Mail-Transports Web Service über Mail 14.6 JMS Installation von ActiveMQ Services mit JMS-Kommunikation Client-Anwendungen mit TMS-Kommunikation

8 15 Module für WS-* Erweiterungen WS-Addressing 478 Grundlagen 478 WS-Addressing mit Axis WS-Policy 485 Grundlagen 485 Neethi: WS-Policy mit Axis WS-Security 490 Grundlagen 490 Rampart: WS-Security mit Axis2 494 Konfiguration mit WS-Policy WS-ReliableMessaging 537 Grundlagen 537 Sandesha2: WS-ReliableMessaging mit Axis2 542 A B B.l B.2 B.3 C C.l C.2 D XML Schema und WS WSDL2Java Kommandozeile Ant-Task Maven-Plug-in Java2WSDL Kommandozeile Maven-Plug-in Maven 2 AAR Plug-in Stichwortverzeichnis ron Axis Hotels Jtwi Web Servias mit Apache Axis2