J2EE Web Services

Cover......Page 1
Contents......Page 12
 Are Web Services Important?......Page 34
 What Does This Book Cover?......Page 35
 How Is This Book Organized?......Page 36
  Vendor-Specific Configuration and Administration......Page 38
  Other Web Service “Standards”......Page 39
Acknowledgments......Page 40
Chapter 1 An Overview of J2EE 1.4 Web Services......Page 42
 1.1 The J2EE Platform......Page 43
 1.2 The Technologies of Web Services......Page 44
  1.2.1 WS-I Basic Profile 1.0......Page 46
  1.2.2 XML......Page 47
  1.2.3 SOAP......Page 48
  1.2.5 UDDI......Page 50
  1.3.1 JAX-RPC......Page 51
  1.3.3 JAXR......Page 52
 1.4 Wrapping Up......Page 53
Part I: XML......Page 56
  2.1 XML Primer......Page 58
  2.2 XML Namespaces......Page 67
  2.3 Wrapping Up......Page 73
  3.1 XML Schema Basics......Page 74
  3.2 Advanced XML Schema......Page 98
  3.3 Wrapping Up......Page 118
Part II: SOAP and WSDL......Page 120
 Chapter 4 SOAP......Page 122
  4.1 The Basic Structure of SOAP......Page 125
  4.2 SOAP Namespaces......Page 129
  4.3 SOAP Headers......Page 136
  4.4 The SOAP Body......Page 147
  4.5 SOAP Messaging Modes......Page 148
  4.6 SOAP Faults......Page 152
  4.7 SOAP over HTTP......Page 161
  4.8 Wrapping Up......Page 165
 Chapter 5 WSDL......Page 168
  5.1 The Basic Structure of WSDL......Page 170
  5.2 WSDL Declarations: The definitions, types, and import Elements......Page 173
  5.3 The WSDL Abstract Interface: The message, portType, and operation Elements......Page 178
  5.4 WSDL Messaging Exchange Patterns......Page 186
  5.5 WSDL Implementation: The binding Element......Page 189
  5.6 WSDL Implementation: The service and port Elements......Page 201
  5.7 WS-I Conformance Claims......Page 202
  5.8 Wrapping Up......Page 203
Part III: UDDI......Page 204
 Chapter 6 The UDDI Data Structures......Page 206
  6.1 The businessEntity Structure......Page 209
  6.2 The businessService and bindingTemplate Structures......Page 221
  6.3 The tModel Structure......Page 226
  6.4 The publisherAssertion Structure......Page 239
  6.5 UUID Keys......Page 240
  6.7 Wrapping Up......Page 241
  7.1 General Information about UDDI SOAP Messaging......Page 242
  7.2 The Inquiry Operations......Page 245
  7.3 Wrapping Up......Page 273
 Chapter 8 The UDDI Publishing API......Page 274
  8.1 Operation Definitions and Payloads......Page 275
  8.2 Fault Messages......Page 305
  8.3 Wrapping Up......Page 309
Part IV: JAX-RPC......Page 312
 Chapter 9 JAX-RPC Overview......Page 314
  9.1 The Server-Side Programming Models......Page 315
  9.2 The Client-Side Programming Models......Page 318
  9.3 Other JAX-RPC Topics Covered......Page 322
  9.5 Wrapping Up......Page 323
  10.1 A Simple JSE Example......Page 324
  10.2 The JSE Runtime Environment......Page 325
  10.3 Multi-threading and JSEs......Page 343
  10.4 Wrapping Up......Page 344
  11.1 An Enterprise JavaBeans Primer......Page 346
  11.2 Enterprise JavaBeans Web Services......Page 356
  11.3 Wrapping Up......Page 367
  12.1 Generated Stubs......Page 368
  12.2 Dynamic Proxies......Page 379
  12.3 DII......Page 385
  12.4 Wrapping Up......Page 393
 Chapter 13 SAAJ......Page 394
  13.1 A Simple SAAJ Example......Page 396
  13.2 Creating a SOAP Message......Page 397
  13.3 Working with SOAP Documents......Page 404
  13.4 Working with SOAP Faults......Page 423
  13.5 Sending SOAP Messages with SAAJ......Page 429
  13.6 SAAJ 1.2 and DOM 2......Page 431
  13.7 Wrapping Up......Page 434
 Chapter 14 Message Handlers......Page 436
  14.1 A Simple Example......Page 437
  14.2 Handler Chains and Order of Processing......Page 447
  14.3 The Handler Runtime Environment......Page 457
  14.4 Wrapping Up......Page 466
 Chapter 15 Mapping Java to WSDL and XML......Page 468
  15.1 Mapping WSDL to Java......Page 469
  15.2 Mapping XML Schema to Java......Page 475
  15.3 Holders......Page 494
  15.4 Faults and Java Exceptions......Page 508
  15.5 Wrapping Up......Page 514
Part V: JAXR......Page 516
 Chapter 16 Getting Started with JAXR......Page 518
  16.1 Using a UDDI Test Registry......Page 519
  16.2 Connecting to a UDDI Registry......Page 520
  16.3 Using the RegistryService and BusinessLifeCycleManager......Page 528
  16.4 The BulkResponse Type......Page 537
  16.6 Wrapping Up......Page 539
 Chapter 17 The JAXR Business Objects......Page 540
  17.1 The RegistryObject Interface......Page 542
  17.2 The Organization Information Object......Page 545
  17.3 Wrapping Up......Page 585
  18.1 The Service and ServiceBinding Information Objects......Page 586
  18.2 The Concept Information Object......Page 594
  18.3 The SpecificationLink Information Object......Page 605
  18.4 The Association Information Object......Page 611
  18.5 Predefined Enumerations......Page 616
  18.6 Wrapping Up......Page 619
  19.1 Mapping JAXR to the UDDI Inquiry API......Page 622
  19.2 Mapping JAXR to the UDDI Publishing API......Page 640
  19.3 Wrapping Up......Page 642
Part VI: JAXP......Page 644
 Chapter 20 SAX2......Page 646
  20.1 Parsing with SAX: XMLReaderFactory and XMLReader......Page 647
  20.2 The ContentHandler and DefaultHandler Interfaces......Page 649
  20.3 Validating with W3C XML Schema......Page 664
  20.4 Wrapping Up......Page 665
 Chapter 21 DOM 2......Page 666
  21.1 Parsing with DOM: DocumentBuilderFactory and DocumentBuilder......Page 668
  21.2 Nodes......Page 669
  21.3 Building a DOM Document......Page 682
  21.4 Copying Nodes......Page 690
  21.5 Wrapping Up......Page 692
Part VII: Deployment......Page 694
  22.1 Overview of the J2EE Deployment Process......Page 696
  22.2 J2EE Web Services Deployment......Page 698
  22.3 Deploying JSEs......Page 704
  22.4 Deploying EJB Endpoints......Page 713
  22.5 Service References......Page 718
  22.6 Wrapping Up......Page 733
 Chapter 23 Web Service Descriptors......Page 734
  23.1 The wsdl-file and wsdl-port Elements......Page 735
  23.2 The port-component-name Element......Page 737
  23.3 The service-endpoint-interface Element......Page 738
  23.4 The service-impl-bean Element......Page 739
  23.5 The jaxrpc-mapping-file Element......Page 741
  23.6 The handler Element......Page 742
  23.7 Wrapping Up......Page 747
 Chapter 24 JAX-RPC Mapping Files......Page 750
  24.2 A Lightweight Example......Page 751
  24.3 A Heavyweight Example......Page 754
  24.4 Anatomy of a Mapping File......Page 757
  24.5 Wrapping Up......Page 776
Appendices: Introduction......Page 778
 Appendix A: XML DTDs......Page 780
 Appendix B: XML Schema Regular Expressions......Page 786
  B.2 Quantifiers......Page 787
  B.3 Other Meta-characters......Page 788
  B.4 Real-World Examples......Page 789
 Appendix C: Base64 Encoding......Page 792
 Appendix D: SOAP RPC/Encoded......Page 796
  D.2 The Operation Structs......Page 797
  D.3 Simple Types......Page 800
  D.4 Complex Types......Page 801
  D.5 Array Types......Page 802
  D.6 References......Page 808
  D.7 Wrapping Up......Page 811
 Appendix E: SOAP Messages with Attachments......Page 812
  E.1 Understanding MIME......Page 813
  E.2 Using MIME with SOAP......Page 816
  E.3 Wrapping Up......Page 819
 Appendix F: SAAJ Attachments......Page 822
  F.1 The Java Activation Framework......Page 823
  F.2 SAAJ and JAF: AttachmentPart......Page 834
  F.3 The SOAPPart......Page 844
  F.4 The SOAPEnvelope......Page 848
  F.5 Wrapping Up......Page 850
  G.1 JAF Revisited: DataContentHandler and DataSource Types......Page 852
  G.2 A Simple Example......Page 853
  G.3 Mapping MIME Types to Java......Page 857
  G.4 Using DataHandler and DataSource Types......Page 866
  G.5 Wrapping Up......Page 869
 Appendix H: Using JAX-RPC DII without a WSDL Document......Page 870
Bibliography......Page 878
 A......Page 884
 B......Page 885
 C......Page 887
 D......Page 890
 E......Page 892
 F......Page 894
 G......Page 895
 H......Page 897
 I......Page 898
 J......Page 900
 L......Page 905
 M......Page 906
 N......Page 908
 O......Page 909
 P......Page 910
 R......Page 912
 S......Page 913
 T......Page 920
 U......Page 921
 W......Page 923
 X......Page 926
 Z......Page 928