Java Soa Cookbook

Table of Contents......Page 7
Overview......Page 15
Intended Audience......Page 18
Part I, SOA Fundamentals......Page 19
Part II, Web Services......Page 20
Part IV, Interoperability and Quality of Service......Page 21
Using Code Examples......Page 22
Hang in There!......Page 23
Safari® Books Online......Page 24
Acknowledgments......Page 25
Part I. SOA Fundamentals......Page 27
1.0  Introduction......Page 29
Problem......Page 30
Platform-independent interface......Page 31
Available across a network......Page 32
Operates on business objects......Page 33
Other considerations......Page 34
SOA is a kind of architecture......Page 35
SOA facilitates integration......Page 36
SOA facilitates reuse through loose coupling......Page 37
Problem......Page 38
Solution......Page 39
Discussion......Page 40
Top-down or bottom-up approach......Page 41
Solution......Page 42
Discussion......Page 43
Discussion......Page 44
Problem......Page 46
Discussion......Page 47
Solution......Page 49
Aims of the reference architecture......Page 50
Reference architecture site......Page 51
Conclusion......Page 55
Does the project create business value?......Page 56
Does the project have limited scope?......Page 57
Is the project useful but not mission critical?......Page 58
Problem......Page 59
Discussion......Page 60
Resume padding......Page 62
Summary......Page 63
2.0  Introduction......Page 65
Solution......Page 67
Russian Doll......Page 68
Salami Slice......Page 69
Venetian Blind......Page 71
Garden of Eden......Page 72
Discussion......Page 74
Defining the canonical data model......Page 75
Recommendations......Page 76
Problem......Page 78
Solution......Page 79
Discussion......Page 80
Change the name or URI of the schema document......Page 81
Use the namespace and document name......Page 82
Solution......Page 83
Email address......Page 84
Canadian postal code......Page 85
URL......Page 86
Solution......Page 87
Solution......Page 90
Solution......Page 91
Problem......Page 93
Working with JAXB......Page 94
XMLRootElement......Page 99
Solution......Page 101
Using schemagen......Page 102
Using SchemaOutputResolver......Page 105
Discussion......Page 106
Solution......Page 107
Relaxer......Page 108
Solution......Page 109
Using Inline Annotations......Page 110
Using an External File (schemalet)......Page 111
Solution......Page 114
See Also......Page 116
Solution......Page 117
Summary......Page 119
3.0  Introduction......Page 121
Discussion......Page 122
Using the StAX cursor model: XMLStreamReader......Page 123
Using the StAX iterator model......Page 127
Solution......Page 128
Solution......Page 130
Solution......Page 133
Discussion......Page 135
Solution......Page 138
Solution......Page 140
Solution......Page 144
Solution......Page 146
Discussion......Page 147
Solution......Page 148
Solution......Page 150
Solution......Page 151
Discussion......Page 152
Discussion......Page 153
XML catalog entities......Page 154
Summary......Page 156
Part II. Web Services......Page 157
4.0  Introduction......Page 159
Solution......Page 160
Discussion......Page 163
Discussion......Page 166
Solution......Page 169
Starting the server console......Page 170
Solution......Page 171
Create a web service project......Page 173
Test the service using the built-in test client......Page 174
Solution......Page 175
Discussion......Page 176
Creating the client project......Page 178
Creating the parent project......Page 180
Discussion......Page 181
Types......Page 182
Binding......Page 183
Discussion......Page 184
Solution......Page 187
Dumping during a Maven unit test run......Page 189
Running TCPMon......Page 190
5.0  Introduction......Page 195
SAAJ Packages and Classes......Page 198
Discussion......Page 199
URIs, URLs, and URNs in namespaces......Page 200
Solution......Page 201
Discussion......Page 204
Discussion......Page 206
Solution......Page 210
Solution......Page 212
Discussion......Page 215
Discussion......Page 216
Problem......Page 221
Discussion......Page 222
Discussion......Page 223
Creating the web service......Page 224
Examining the WSDL......Page 225
Examining the schema......Page 227
Building the client program......Page 228
Assessing the results......Page 230
See Also......Page 231
Discussion......Page 232
Discussion......Page 234
Discussion......Page 235
Discussion......Page 236
Problem......Page 237
Discussion......Page 238
Solution......Page 239
Discussion......Page 240
Discussion......Page 247
Discussion......Page 252
Getting fault information......Page 254
Summary......Page 255
JAX-WS in Relation to Other APIs......Page 257
Annotations......Page 258
Packages and Classes......Page 259
Solution......Page 260
Verifying wsimport......Page 261
Creating the client class......Page 262
Running the client......Page 263
WebService.name......Page 264
WebService.serviceName......Page 265
Service Ref with dependency injection......Page 266
Solution......Page 267
Discussion......Page 269
The generated Service class......Page 271
The generated Port class......Page 272
Solution......Page 275
Discussion......Page 278
Discussion......Page 279
Problem......Page 280
Discussion......Page 281
Discussion......Page 283
Using a variable for the WSDL location......Page 284
Discussion......Page 285
Using endorsed directories......Page 286
Discussion......Page 287
Using Holder......Page 289
Using Headers.create and JAXB......Page 291
See Also......Page 298
Discussion......Page 299
Implementing a simple handler......Page 301
Discussion......Page 306
Solution......Page 307
SOAPMessageContext......Page 311
Solution......Page 312
Discussion......Page 313
Solution......Page 316
Problem......Page 317
Discussion......Page 318
Adding Metro to the client in Maven......Page 319
Solution......Page 320
Using Asynchronous Polling......Page 322
Using Asynchronous Callbacks......Page 323
Writing the callback handler......Page 324
Solution......Page 326
Discussion......Page 327
Summary......Page 328
7.0  Introduction......Page 329
Web service or provider......Page 330
Packaging WSDL......Page 331
Problem......Page 332
Start from Code (Java)......Page 333
Start from contract (WSDL)......Page 335
Start from Java and WSDL......Page 337
Start from Schema......Page 338
Style......Page 340
RPC/literal......Page 342
Using parameter styles......Page 343
Problem......Page 345
Discussion......Page 346
Using the wsgen Ant task......Page 349
Solution......Page 350
Package and types......Page 351
Class and PortType......Page 352
Method and binding......Page 353
Solution......Page 354
Solution......Page 355
Discussion......Page 356
Solution......Page 357
Discussion......Page 358
Schema......Page 360
WSDL......Page 362
Service implementation......Page 364
JAXB generated types......Page 368
Build file......Page 369
See Also......Page 374
Solution......Page 375
Discussion......Page 376
Using inline elements......Page 377
Solution......Page 378
Discussion......Page 379
Creating a Provider......Page 380
Testing the provider......Page 385
Solution......Page 387
Solution......Page 390
Using WebServiceContext......Page 391
Discussion......Page 393
Problem......Page 395
Discussion......Page 396
Discussion......Page 397
Discussion......Page 398
Discussion......Page 399
Summary......Page 403
8.0  Introduction......Page 405
The Principles of REST......Page 406
Resources are manipulated through representations......Page 407
Hypermedia as the engine of application state......Page 408
Other Tenets of REST......Page 409
REST Versus SOAP......Page 410
Restlet......Page 413
RESTEasy......Page 414
Coming Up......Page 415
Discussion......Page 416
Discussion......Page 421
Discussion......Page 422
8.4  Application: Using SSL, Atom Publishing, and the Google Finance REST API......Page 424
Before You Start......Page 425
About Atom......Page 426
Creating the Client......Page 427
Problem......Page 435
Dependencies......Page 436
Modifying the web.xml file......Page 437
Solution......Page 438
Discussion......Page 439
Resource methods......Page 440
Discussion......Page 441
Discussion......Page 443
Discussion......Page 444
Solution......Page 445
Discussion......Page 446
Discussion......Page 448
Discussion......Page 456
Solution......Page 461
Discussion......Page 462
Discussion......Page 469
Problem......Page 471
Discussion......Page 472
Problem......Page 474
Discussion......Page 475
Solution......Page 477
Discussion......Page 478
Using @HeaderParam......Page 479
Discussion......Page 480
Using HttpHeaders to access cookies......Page 483
Discussion......Page 484
Using exception mappers......Page 485
Discussion......Page 488
Solution......Page 489
Discussion......Page 490
Summary......Page 498
Part III. Business Processes......Page 501
9.0  Introduction......Page 503
Benefits of BPEL......Page 505
BPEL Engine and Designer Implementations......Page 506
Discussion......Page 507
The Meet in the Middle approach......Page 508
jPDL......Page 509
BPEL......Page 510
Discussion......Page 511
Solution......Page 512
Running the HelloWorld2 example......Page 513
Discussion......Page 515
The  element......Page 517
The  element......Page 518
The  activity......Page 519
Discussion......Page 520
Discussion......Page 522
Creating a simple partner web service......Page 523
Importing the web service WSDL......Page 527
Adding a partner to the process......Page 528
Creating a process WSDL......Page 529
Completed WSDL......Page 532
Adding external WSDL to the process......Page 534
Creating the  activity......Page 535
Creating the  activity......Page 536
Creating the inbound assignment......Page 538
Creating the outbound assignment......Page 541
Check the source code......Page 542
Build the BPEL project......Page 544
Discussion......Page 545
Adding the BPEL project to the assembly......Page 546
See Also......Page 547
Discussion......Page 548
Executing the test......Page 549
Load testing......Page 550
Discussion......Page 551
Discussion......Page 552
Problem......Page 554
Creating a new process......Page 555
Problem......Page 556
Discussion......Page 557
Problem......Page 558
Discussion......Page 559
Solution......Page 560
Referencing variables......Page 561
In-scope namespaces......Page 562
Solution......Page 563
Discussion......Page 564
Discussion......Page 565
 and ......Page 566
Problem......Page 567
See Also......Page 568
Discussion......Page 569
Summary......Page 571
Discussion......Page 573
Solution......Page 574
Discussion......Page 575
Discussion......Page 576
Discussion......Page 577
Discussion......Page 578
Discussion......Page 579
Discussion......Page 580
Default fault handling......Page 582
Discussion......Page 583
Problem......Page 585
Discussion......Page 586
Discussion......Page 587
Discussion......Page 588
Creating message properties and aliases......Page 589
Creating correlation sets......Page 590
Initiating the conversation......Page 591
Correlating the messages......Page 592
while loop......Page 593
forEach loop......Page 594
Preventing some children from executing......Page 595
Solution......Page 596
Implementations......Page 597
Summary......Page 598
11.0  Introduction......Page 599
Discussion......Page 600
Discussion......Page 602
Solution......Page 606
Discussion......Page 607
Discussion......Page 608
Timed caches and distributed caches......Page 609
Messaging......Page 610
Discussion......Page 611
Discussion......Page 612
UDDI......Page 614
Deploying jUDDI on Tomcat......Page 615
Setting up the jUDDI JDBC connection......Page 616
See Also......Page 619
Discussion......Page 620
Solution......Page 621
Testing the client......Page 622
Solution......Page 624
ROI in traditional software projects......Page 625
ROI in SOA......Page 626
ROI implications of building out services within traditional projects......Page 628
There’s no ROI in SOA......Page 629
Part IV. Interoperability and Quality of Service......Page 631
12.0  Introduction......Page 633
Problem......Page 634
Discussion......Page 635
Discussion......Page 636
Message information headers......Page 637
Solution......Page 638
Discussion......Page 639
Discussion......Page 640
Solution......Page 643
Problem......Page 644
Discussion......Page 645
Discussion......Page 649
Discussion......Page 650
Discussion......Page 657
Discussion......Page 663
Discussion......Page 665
Using Ruby in Eclipse......Page 666
Discussion......Page 667
Discussion......Page 670
Solution......Page 671
Discussion......Page 672
Reliability......Page 675
Transactions......Page 676
Solution......Page 677
Source and destination......Page 678
WS-ReliableMessaging and WS-Addressing exchange......Page 679
Solution......Page 685
Solution......Page 686
Solution......Page 687
Discussion......Page 688
Solution......Page 689
Focus of This Chapter......Page 691
14.1  What Is ESB?......Page 692
Features of an ESB......Page 693
Web services support......Page 694
Mediation and protocol independence......Page 695
SOA Without an ESB......Page 696
14.2  ESB As a Set of Patterns......Page 698
14.3  JBI......Page 699
Service engines......Page 700
Normalized message router......Page 701
The Case Against JBI......Page 702
14.4  Commercial ESBs......Page 704
OSB differentiating features......Page 705
Supported specifications......Page 707
Differentiating features......Page 708
Supported specifications......Page 709
Supported specifications......Page 710
Basic usage......Page 711
Supported transports......Page 713
SOA governance and management with Mule......Page 714
Deployment in ServiceMix......Page 715
Monitoring OpenESB......Page 717
Summary......Page 718
Index......Page 719