Java Web Services mit Apache Axis2

Transkript

1 Thilo Frotscher, Marc Teufel, Dapeng Wang Java Web Services mit Apache Axis2 jntwickier.press

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 AxisH 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 SO AP-Nachrichten 103 Apache TCPMon 103 SO AP erforschen und lernen mit TCPMon 106 SOAPMonitor AXIOM Einführung StAX Push vs. Pull Parsing StAX API XML parsen mit StAX ntwickier.press

4 5.3 AXIOM 122 AXIOM Architektur 123 AXIOM API 125 Caching Web Service-Implementierung mit AXIOM Client-API ServiceClient Aufrufmuster 144 Request-Response mit blockierendem API 146 Request-Response mit nicht-blockierendem API über eine Verbindung 147 Request-Response mit nicht-blockierendem API über zwei Verbindungen 149 Einweg-Aufruf 153 Zuverlässiger Einweg-Aufruf Clientseitige Konfiguration 155 JavaBean-Properties 155 Generische Properties 157 HTTP Properties OperationClient Contract First mit Axis Codegenerierung 169 Aufruf von WSDL2Java von der Kommandozeile 170 Axis2 Code-Generator-Wizard für Eclipse 177 Ant-Task Implementierung und Deployment von Services 183 Der Ordner resources 183 Generierter Code und Implementierung des Service 186 Paketierung und Deployment Implementierung von Service-Clients Einwegkommunikation Weiterführende Aspekte der Entwicklung Fehlerbehandlung 203 Definition von Fehlern in XML Schema und WSDL 205 Codegenerierung Lebenszyklus von Services Session-Verwaltung 216 Request-Session-Scope 219 SOAP-Session-Scope 220 Transport-Session-Scope 222 Java Web Services mit Apache Axis2 7

5 Application-Scope 223 Session-Verwaltung mit Client-Anwendungen 224 Codebeispiel REST 230 Einführung 230 SOAP oder REST? 231 REST in Axis2 konfigurieren 232 HTTP GET 233 HTTP POST 234 HTTP GET oder HTTP POST? Architektur und Konfiguration Interne Verarbeitung von SOAP-Nachrichten 246 Flows 246 Phasen 251 Dispatch-Mechanismus Interne Datenstrukturen: Description und Context 257 Description-Hierarchie 257 Context-Hierarchie 259 Beziehung zwischen Context- und Description-Hierarchien 261 Laden von Konfigurationen Globale Konfiguration 263 Parameter 264 Message Receiver 265 Transporte 265 Global eingeschaltete Module und Modulkonfigurationen 266 Standardmäßige Modulversion 266 Phasen 266 Target Resolver 267 Listeners/Observers Konfiguration von Services 270 Services und Service-Gruppen 270 Bestimmung der Namen von Services und Service-Gruppen 271 WSDL-Dokumente und automatische WSDL-Generierung 271 Elemente der Datei Services.xml 272 Service-Parameter Deployment von Services 279 Axis2 Web-Anwendung 279 Standalone-Server Zugriff eines Service auf Context und Konfiguration Zugriff auf Ressourcen im Service-Archiv Start von Axis2 mit entferntem Repository 282

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 Bindinq 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 9

7 12.6 ServiceObjectSupplier Spring Framework 385 Einführung 385 Axis2 und das Spring Framework 386 Der Bankleitzahlen-Service als Spring-Bean 388 SpringServletContextObjectSupplier 393 Erforderliche Spring-Bibliothken 395 SpringAppContextAwareObjectSupplier Die EJBUtil Implementierung MTOM & SwA Base64 & SwA Base64 SwA XOP & MTOM XOP MTOM SwA vs. MTOM MTOM in Axis2 OMText MTOM Web Service mit AXIOM-API MTOM Data Binding SwA in Axis Attachment-Caching Transportprotokolle Transportmechanismus 447 TransportListener 448 TransportSender Aktivierung von Transportprotokollen auf Service-Ebene HTTP 451 Transport Receiver für Standalone-Modus 451 SimpleHttpServer in eigene Applikationen einbetten 453 CommonsHTTPSender TCP Mail Transport (SMTP) 460 Konfiguration des Mail-Transports 461 Web Service über Mail JMS 471 Installation von ActiveMQ 471 Services mit JMS-Kommunikation 472 Client-Anwendungen mit JMS-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 fon Axis Hotels Java Web Services mit Apache Axis2 11