Java SOA Cookbook

Name: Java SOA Cookbook | SOA Implementation Recipes, Tips, and Techniques
Brand: O'Reilly
Price: 41.99 EUR
Availability: OnlineOnly

SOA Implementation Recipes, Tips, and Techniques

Eben Hewitt(Author)

O'Reilly (Publisher)

1st Edition

Published on 17. March 2009

742 pages

E-Book

PDF with Adobe-DRM

System requirements

978-0-596-55106-3 (ISBN)

€41.99incl. 7% vat

System requirements

for PDF with Adobe-DRM

E-Book Single Licence

Available for download

Description

More details

Other editions

Content

Intro
Table of Contents
Preface
Overview
Intended Audience
What This Book Covers
Part I, SOA Fundamentals
Part II, Web Services
Part III, Business Processes
Part IV, Interoperability and Quality of Service
How to Read This Book
Using Code Examples
Hang in There!
Conventions Used in This Book
Safari® Books Online
How to Contact Us
Dedication
Acknowledgments
Part I. SOA Fundamentals
Chapter 1. Introduction to SOA
1.0 Introduction
1.1 Defining a Service
Problem
Solution
Discussion
Platform-independent interface
Available across a network
Operates on business objects
Decoratable
Other considerations
1.2 Defining SOA
Problem
Solution
SOA is a kind of architecture
SOA is built with services
SOA facilitates integration
SOA facilitates reuse through loose coupling
Invoking services
Other considerations
1.3 Identifying Service Candidates
Problem
Solution
Discussion
Top-down or bottom-up approach
See Also
1.4 Identifying Different Kinds of Services
Problem
Solution
Discussion
1.5 Modeling Services
Problem
Solution
Discussion
Service documentation
1.6 Making a Service Composable
Problem
Solution
Discussion
1.7 Supporting Your SOA Efforts
Problem
Solution
Discussion
Aims of the reference architecture
Reference architecture site
Conclusion
1.8 Selecting a Pilot Project
Problem
Solution
Discussion
Does the project create business value?
Does the project have limited scope?
Would the project make a good service?
Do the team members have a good understanding of the problem domain?
Is the project useful but not mission critical?
The second pilot
1.9 Establishing Governance
Problem
Solution
Discussion
Common pitfalls governance helps you avoid
Resume padding
Bunny services
Summary
Chapter 2. XML Schema and the SOA Data Model
2.0 Introduction
2.1 Designing Schema for SOA
Problem
Solution
Russian Doll
Salami Slice
Venetian Blind
See Also
Garden of Eden
2.2 Creating Canonical Data Model
Problem
Solution
Discussion
Defining the canonical data model
Recommendations
Updating the canonical data model
See Also
2.3 Using Chameleon Namespace Design
Problem
Solution
2.4 Versioning Schemas
Problem
Solution
Discussion
Use the version attribute
Hack the root element
Change the name or URI of the schema document
Use the namespace and document name
2.5 Reference Schemas
Problem
Solution
2.6 Common Schema Types
Problem
Solution
Person's name
U.S. phone number
Email address
U.S. postal code
Social Security number
Canadian postal code
Canadian provinces
URL
IP address
2.7 Validating an XML Document Against a Schema
Problem
Solution
2.8 Validating an XML Document Against Multiple Schemas
Problem
Solution
2.9 Restricting Schema Types with Regular Expressions
Problem
Solution
See Also
2.10 Using Schema Enumerations
Problem
Solution
2.11 Generating Java Classes from Schema
Problem
Solution
Working with JAXB
JAXB Annotations
XMLRootElement
Conclusion
2.12 Generating a Schema from Java
Problem
Solution
Using schemagen
Using SchemaOutputResolver
2.13 Generating Java Source Files from XML Schema in Ant
Problem
Solution
Discussion
2.14 Generating an XML Document Instance from a Schema
Problem
Solution
Relaxer
2.15 Customizing How a Java Class Is Generated from Schema
Problem
Solution
Using Inline Annotations
Using an External File (schemalet)
2.16 Validating Against a Schema During Marshaling and Unmarshaling
Problem
Solution
See Also
2.17 Collecting Schema Validation Events During Marshaling and Unmarshaling
Problem
Solution
ValidationEventCollector
Summary
Chapter 3. Working with XML and Java
3.0 Introduction
3.1 Reading an XML Data Stream
Problem
Solution
Discussion
Using the StAX cursor model: XMLStreamReader
Using the StAX iterator model
3.2 Writing XML Data Streams
Problem
Solution
3.3 Filtering Data in an XML Stream
Problem
Solution
3.4 Selecting Values from an XML Document
Problem
Solution
Discussion
3.5 Updating a Value in an XML Document
Problem
Solution
3.6 Converting a Java Object into an XML Document Instance
Problem
Solution
3.7 Converting an XML Document Instance into a Java Object
Problem
Solution
3.8 Generating a Schema from an XML Document
Problem
Solution
Discussion
Generating a set of schemas from a single XML document
See Also
3.9 Converting XML to Java Without JAXB
Problem
Solution
3.10 Customizing Code Generation in JAXB
Problem
Solution
3.11 Finding the JAR That Contains a Given Class on Linux
Problem
Solution
Discussion
3.12 Transparently Substituting XML Files
Problem
Solution
Discussion
XML catalog entities
Using XML Catalogs in wsimport
See Also
Summary
Part II. Web Services
Chapter 4. Getting Started
4.0 Introduction
4.1 Using Publicly Available Web Services to Test Against
Problem
Solution
Discussion
4.2 Installing Metro
Problem
Solution
Discussion
Using Metro 1.3 in Maven
4.3 Installing Oracle WebLogic
Problem
Solution
Starting the server console
See Also
4.4 Creating and Deploying the Simplest Web Service
Problem
Solution
See Also
4.5 Creating and Deploying a Service to WebLogic
Problem
Solution
Create a web service project
Create the web service
Deploy the web service
Test the service using the built-in test client
4.6 Setting Up a Maven 2 Service and Client Project
Problem
Solution
Discussion
Creating the service project
Creating the client project
Creating the parent project
4.7 Understanding WSDL
Problem
Solution
Discussion
Types
Messages
Binding
Service
4.8 Using References in NetBeans to Generate Web Service Clients
Problem
Solution
Discussion
4.9 Monitoring SOAP Traffic with Metro
Problem
Solution
Discussion
Dumping during a Maven unit test run
Transport-independent logging
See Also
4.10 Monitoring SOAP Traffic with TCPMon
Problem
Solution
Discussion
Running TCPMon
Chapter 5. Web Services with SAAJ
5.0 Introduction
Relation to JAX-M
SAAJ and JAX-WS
SAAJ Packages and Classes
5.1 Creating a SOAP Element with a Qualified Name
Problem
Solution
Discussion
URIs, URLs, and URNs in namespaces
See Also
5.2 Creating a Complete SOAP Message
Problem
Solution
5.3 Writing a SOAP Response to an Output Stream
Problem
Solution
Discussion
5.4 Creating a Web Service Client Based on an Existing SOAP Envelope
Problem
Solution
Discussion
5.5 Extracting Content from a SOAP Message
Problem
Solution
5.6 Creating a Web Service Client Using Raw XML Source and DOM
Problem
Solution
5.7 Adding a MIME Header
Problem
Solution
Discussion
5.8 Adding Namespace Declarations
Problem
Solution
Discussion
5.9 Specifying SOAPAction
Problem
Solution
Discussion
5.10 Adding an Attribute to an Element
Problem
Solution
Discussion
5.11 Removing a Header from a SOAP Message
Problem
Solution
Discussion
5.12 Adding Headers to a SOAP Request
Problem
Solution
Discussion
Creating the web service
Examining the WSDL
Examining the schema
Building the client program
Assessing the results
See Also
5.13 Accessing All SOAP Header Elements
Problem
Solution
Discussion
5.14 Adding an Attachment to an Outbound SOAP Message
Problem
Solution
Discussion
See Also
5.15 Accessing Inbound Attachment Data
Problem
Solution
Discussion
See Also
5.16 Connecting to a SAAJ Endpoint Without a WSDL
Problem
Solution
Discussion
5.17 Working with SOAP Actors
Problem
Solution
Discussion
5.18 Asynchronous Invocation with Dispatch
Problem
Solution
Discussion
See Also
5.19 Validating Your Payload Against a Schema on the Client
Problem
Solution
Discussion
5.20 Providing a Web Service with SAAJ
Problem
Solution
Discussion
5.21 Sending and Receiving SOAP Faults
Problem
Solution
Discussion
Sending a fault
Getting fault information
Getting fault details
See Also
Summary
Chapter 6. Creating Web Service Applications with JAX-WS
6.0 Introduction
JAX-WS in Relation to Other APIs
Three Approaches
Annotations
Service Endpoints
Packages and Classes
6.1 Calling a Web Service from the Command Line
Problem
Solution
Discussion
Verifying wsimport
Generating client code
Creating the client class
Compiling the client
Running the client
6.2 Using JAX-WS Annotation Name Properties
Problem
Solution
Discussion
WebService.targetNamespace
WebService.name
WebService.serviceName
WebService.portName
Service Ref with dependency injection
6.3 Invoking the Simplest Web Service
Problem
Solution
See Also
6.4 Creating a Client Proxy
Problem
Solution
Discussion
The generated Service class
The generated Port class
6.5 Consuming a Web Service from a Servlet or EJB
Problem
Solution
Discussion
WebServiceRefs
6.6 Consuming a Web Service from a JSP
Problem
Solution
Discussion
6.7 Using a JAXB-Annotated Instance in a SOAP Message
Problem
Solution
Discussion
6.8 Using wsimport in a Maven Project
Problem
Solution
Discussion
Using a variable for the WSDL location
6.9 Dealing with Version Errors in wsgen and wsimport
Problem
Solution
Discussion
Using endorsed directories
Using with Ant
6.10 Adding Headers to a SOAP Request
Problem
Solution
Discussion
Using Holder&T&
Using Headers.create and JAXB
Additional workarounds
See Also
6.11 Intercepting the Request to Perform Protocol-Specific Work
Problem
Solution
Discussion
Implementing a simple handler
See Also
6.12 Intercepting the Request to Perform Work on Your Payload
Problem
Solution
Discussion
6.13 Sharing Data Between Handler Invocations
Problem
Solution
Discussion
MessageContext properties
SOAPMessageContext
LogicalMessageContext
6.14 Passing Binary Data in a Request
Problem
Solution
See Also
6.15 Using Binary Data in a SOAP Message
Problem
Solution
Discussion
See Also
6.16 Enabling Binary Optimization on the Client
Problem
Solution
See Also
6.17 Validating a SOAP Payload Against a Schema with Metro
Problem
Solution
Discussion
Adding Metro to the client in Maven
6.18 Making Asynchronous Calls with a JAX-WS Client
Problem
Solution
Using Asynchronous Polling
Using Asynchronous Callbacks
Writing the callback handler
6.19 Overriding the Endpoint Address in an SEI
Problem
Solution
Discussion
Summary
Chapter 7. Providing SOAP-Based Web Services
7.0 Introduction
7.1 Assembling a Service for Deployment
Problem
Solution
Discussion
Web service or provider
Interfaces
Packaging WSDL
Deployment descriptors
7.2 Determining a Service Development Model
Problem
Solution
Discussion
Start from Code (Java)
Start from contract (WSDL)
Start from Java and WSDL
Start from Schema
7.3 Choosing Encoding, Use, and Parameter Styles
Problem
Solution
Discussion
Style
Use
Style and use combinations
RPC/encoded
RPC/literal
Document/literal
Document/encoded
Using parameter styles
Summary
7.4 Generating a WSDL and Portable Artifacts Based on a Java Service Endpoint Implementation
Problem
Solution
Discussion
Using the wsgen Ant task
Using wsgen in Maven 2
7.5 Creating a Basic Web Service
Problem
Solution
Discussion
Package and types
Class and service
Class and PortType
Method and binding
7.6 Specifying Namespaces
Problem
Solution
Discussion
7.7 Creating a Web Service Operation
Problem
Solution
Discussion
7.8 Specifying a Web Service Message Part
Problem
Solution
Discussion
7.9 Specifying an Operation Return Value
Problem
Solution
Discussion
7.10 Defining Zero-Argument Operations
Problem
Solution
7.11 Defining Operations with Void Return Type
Problem
Solution
Discussion
7.12 Creating a Web Service That Uses Complex Types Based on Custom WSDL and a Custom Schema
Problem
Solution
Discussion
Schema
WSDL
Service implementation
JAXB generated types
Build file
See Also
7.13 Specifying the SOAP Binding Style, Use, and Parameter Style
Problem
Solution
7.14 Configuring Standard Custom Bindings
Problem
Solution
Discussion
Using the external binding file
Using inline elements
See Also
7.15 Excluding a Public Method from a Service
Problem
Solution
Discussion
7.16 Creating a Service Provider with an XML View
Problem
Solution
Discussion
Creating a Provider&T&
Testing the provider
7.17 Implementing Server-Side Handler Chains
Problem
Solution
7.18 Providing Stateful Services
Problem
Solution
Discussion
Using WebServiceContext
7.19 Adding a Header with a Method Parameter
Problem
Solution
Discussion
7.20 Accessing Incoming Header Parameters in a Service
Problem
Solution
Discussion
7.21 Providing a Value for SOAP Action or WS-Addressing Action
Problem
Solution
Discussion
Using BindingProvider
7.22 Optimizing Transmission of Binary Content on the Server
Problem
Solution
Discussion
See Also
7.23 Getting and Sharing Data About Users and the Request
Problem
Solution
Discussion
7.24 Using Header References with Holder&T&
Problem
Solution
Discussion
Summary
Chapter 8. RESTful Web Services
8.0 Introduction
The Principles of REST
REST services are stateless
REST services have a uniform interface
Resources are manipulated through representations
Messages are self-describing
RESTful architectures are built with resources
Hypermedia as the engine of application state
Other Tenets of REST
Advantages of REST
REST Versus SOAP
Restlet
JAX-RS
Jersey
RESTEasy
RESTpack
REST in Java
Non-Java REST Resources
Coming Up
8.1 Creating a POX over HTTP Service with Servlets
Problem
Solution
Discussion
See Also
8.2 A RESTful Service with JAX-WS
Problem
Solution
Discussion
8.3 Creating a Client for a RESTful Service Using Sockets
Problem
Solution
Discussion
8.4 Application: Using SSL, Atom Publishing, and the Google Finance REST API
Before You Start
Documentation and clients
About Atom
Creating the Client
8.5 Setting Up the Jersey JAX-RS Implementation
Problem
Solution
Discussion
Dependencies
Modifying the web.xml file
8.6 Creating a Jersey Project with Eclipse and Tomcat
Problem
Solution
See Also
8.7 Creating Hello World with Jersey
Problem
Solution
Discussion
Resource methods
8.8 Creating a Single Path for Variable Resources of the Same Type
Problem
Solution
Discussion
8.9 Restricting the Structure of Values in a Path Template
Problem
Solution
Discussion
8.10 Accessing Query Parameters
Problem
Solution
Discussion
8.11 Marshaling a Custom Type to XML in a Response
Problem
Solution
Discussion
8.12 Offering Different Representations of the Same Resource
Problem
Solution
Discussion
8.13 Creating a Resource
Problem
Solution
Discussion
8.14 Working with Forms and URIs
Problem
Solution
Discussion
8.15 Using SAAJ to Access a RESTful Service
Problem
Solution
Discussion
8.16 Setting Metadata on Representations
Problem
Solution
Discussion
8.17 Deleting a Resource
Problem
Solution
Discussion
8.18 Redirecting to Another Service
Problem
Solution
Discussion
Redirecting based on class
8.19 Accessing HTTP Headers
Problem
Solution
Discussion
Using @HeaderParam
8.20 Working with Cookies
Problem
Solution
Discussion
Using HttpHeaders to access cookies
8.21 Working with Exceptions and Response Status Codes
Problem
Solution
Discussion
Using exception mappers
8.22 Working with WADL
Problem
Solution
Discussion
8.23 Interacting with a Resource Using a Custom Reader and Writer
Problem
Solution
Discussion
Summary
Part III. Business Processes
Chapter 9. Service Orchestrations with BPEL
9.0 Introduction
Benefits of BPEL
BPEL Engine and Designer Implementations
Overview
9.1 Determining a Process Design Method
Problem
Solution
Discussion
The Top-Down approach
The Bottom-Up approach
The Meet in the Middle approach
9.2 Selecting a Business Process Language
Problem
Solution
Discussion
BPMN
jPDL
BPEL
9.3 Getting Apache ODE BPEL Engine
Problem
Solution
Discussion
9.4 Deploying a Process to Apache ODE
Problem
Solution
Discussion
Running the HelloWorld2 example
9.5 Understanding BPEL Process Basics
Problem
Solution
Discussion
The &process& element
The &import& element
The &sequence& activity
The &receive& activity
The &assign& activity
The &reply& activity
9.6 Using a Free Graphical Designer to Create BPEL Processes
Problem
Solution
Discussion
9.7 Creating a BPEL Process That Invokes a Partner
Problem
Solution
Discussion
Creating a simple partner web service
Creating a new BPEL process project
Importing the web service WSDL
Creating a partner link for the web service
Creating the process
Adding a partner to the process
Creating a process WSDL
Completed WSDL
Adding external WSDL to the process
Creating the &receive& activity
Creating the &invoke& activity
Creating the &reply& activity
Creating the inbound assignment
Creating the outbound assignment
Check the source code
Build the BPEL project
See Also
9.8 Deploying a BPEL Process to OpenESB's BPEL Service Engine
Problem
Solution
Discussion
Creating a new CASA project
Adding the BPEL project to the assembly
Building the assembly
Deploying the assembly to the BPEL service engine
See Also
9.9 Testing a Deployed BPEL Process
Problem
Solution
Discussion
Creating the test
Executing the test
Load testing
9.10 Installing Active Endpoints BPEL Designer
Problem
Solution
Discussion
See Also
9.11 Installing Active Endpoints BPEL Engine
Problem
Solution
Discussion
See Also
9.12 Creating a BPEL Process in Active Endpoints Designer
Problem
Solution
Discussion
Creating a new process
9.13 Deploying a Process to Active Endpoints Server
Problem
Solution
9.14 Using Web Service Partners
Problem
Solution
Discussion
9.15 Invoking a Partner Service from a BPEL Process
Problem
Solution
Discussion
9.16 Manipulating Data with BPEL Variables
Problem
Solution
Discussion
Creating variables
Referencing variables
In-scope namespaces
Comparing variables
Validating variables
9.17 Using Literals
Problem
Solution
Discussion
9.18 Concatenating Values
Problem
Solution
Discussion
9.19 Choosing an Activity to Execute Based on Runtime Conditions
Problem
Solution
Discussion
&elseif& and &else&
9.20 Executing Multiple Activities in a Sequence
Problem
Solution
Discussion
See Also
9.21 Using Logical Divisions to Group Activities
Problem
Solution
Discussion
Summary
Chapter 10. Advanced Orchestrations with BPEL
10.0 Introduction
10.1 Executing Activities in Parallel
Problem
Solution
Discussion
See Also
10.2 Synchronizing Activities Executing in Parallel
Problem
Solution
Discussion
See Also
10.3 Doing Nothing
Problem
Solution
Discussion
10.4 Executing an Activity at a Specific Point in Time
Problem
Solution
Discussion
10.5 Executing an Activity After a Specific Delay
Problem
Solution
Discussion
10.6 Selective Event Processing
Problem
Solution
Discussion
Using alarms
10.7 Handling Faults
Problem
Solution
Discussion
Default fault handling
10.8 Explicitly Throwing a Fault
Problem
Solution
Discussion
10.9 Stopping a Process
Problem
Solution
Discussion
10.10 Performing an XSL Transformation on BPEL Message Data
Problem
Solution
Discussion
10.11 Validating Inbound Message Data
Problem
Solution
Discussion
10.12 Correlation Sets
Problem
Solution
Discussion
Creating message properties and aliases
Creating correlation sets
Initiating the conversation
Correlating the messages
10.13 Looping
Problem
Solution
Discussion
while loop
repeatUntil loop
forEach loop
Preventing some children from executing
10.14 Adding Human Tasks to a Business Process
Problem
Solution
Discussion
Implementations
10.15 Invoking a RESTful Web Service from BPEL
Problem
Solution
Discussion
Summary
Chapter 11. SOA Governance
11.0 Introduction
11.1 Assigning Roles
Problem
Solution
Discussion
11.2 Creating a SOA Roadmap
Problem
Solution
Discussion
11.3 Keeping Track of Your Services
Problem
Solution
Discussion
11.4 Determining a Data Ownership Scheme for Services
Problem
Solution
Discussion
Timed caches and distributed caches
Messaging
11.5 Handling Legacy Programs and Heterogeneity Within Your SOA
Problem
Solution
Discussion
11.6 Documenting Services
Problem
Solution
Discussion
11.7 Setting Up a Service Registry
Problem
Solution
Discussion
UDDI
Getting jUDDI
Deploying jUDDI on Tomcat
Setting up the jUDDI JDBC connection
See Also
11.8 Packaging Related Services
Problem
Solution
Discussion
11.9 Retiring a Service
Problem
Solution
11.10 Browsing a UDDI Registry
Problem
Solution
11.11 Querying a UDDI Registry Programmatically
Problem
Solution
Discussion
Overview
Testing the client
See Also
11.12 Understanding SOA ROI
Problem
Solution
Discussion
ROI in traditional software projects
ROI in SOA
ROI implications of building out services within traditional projects
There's no ROI in SOA
Part IV. Interoperability and Quality of Service
Chapter 12. Web Service Interoperability
12.0 Introduction
12.1 Dealing with Arrays
Problem
Solution
Discussion
12.2 Abstracting Addressing
Problem
Solution
Discussion
Endpoint references
Message information headers
Anonymous addressing
12.3 Using Addressing in a Java Service
Problem
Solution
Discussion
See Also
12.4 Explicitly Enabling Addressing on the Client
Problem
Solution
Discussion
12.5 Explicitly Disabling Addressing on the Client
Problem
Solution
Discussion
See Also
12.6 Abstracting Addressing in the Transport Layer from WSDL
Problem
Solution
12.7 Addressing Faults
Problem
Solution
Discussion
12.8 Creating a .NET Web Service Client in Visual Studio
Problem
Solution
Discussion
12.9 Creating a .NET Web Service Client in C#
Problem
Solution
Discussion
12.10 Creating a .NET Web Service
Problem
Solution
Discussion
12.11 Creating a Ruby Client for a Web Service
Problem
Solution
Discussion
12.12 Creating a Ruby Client for a .NET Service
Problem
Solution
Discussion
Using Ruby in Eclipse
12.13 Conforming to the Basic Profile
Problem
Solution
Discussion
12.14 Automating Testing for Basic Profile Conformance
Problem
Solution
Discussion
12.15 Interoperability Best Practices
Problem
Solution
12.16 Using Modular WSDLs
Problem
Solution
Discussion
Chapter 13. Quality of Service
13.0 Introduction
Quality-of-Service Specifications
Reliability
Metadata
Transactions
WS-* Specifications and Vendor Implementations
13.1 Understanding Reliable Messaging
Problem
Solution
Source and destination
The WS-ReliableMessaging protocol
WS-ReliableMessaging and WS-Addressing exchange
13.2 Configuring a Java Web Service with Reliable Messaging
Problem
Solution
Discussion
See Also
13.3 Configuring a Java Client with Reliable Messaging
Problem
Solution
See Also
13.4 Configuring a Java Web Service with Reliable Messaging on WebLogic
Problem
Solution
Discussion
13.5 Using a WebLogic Reliable Messaging Error Handler
Problem
Solution
Chapter 14. Enterprise Service Bus
14.0 Introduction
Focus of This Chapter
14.1 What Is ESB?
Features of an ESB
Web services support
Adapters
Invocation
Mediation and protocol independence
Routing
Transformation
Orchestration
Security
SOA Without an ESB
Benefits of ESB
14.2 ESB As a Set of Patterns
14.3 JBI
The JBI Architecture
Service engines
Binding components
Normalized message router
JBI runtime environment
The Case Against JBI
14.4 Commercial ESBs
Oracle Service Bus
OSB differentiating features
Monitoring and service-level agreements
Reporting
Security
Supported specifications
Software AG/webMethods ESB
Differentiating features
Supported specifications
TIBCO ActiveMatrix and BusinessWorks
Event framework
Grid-based architecture
Supported specifications
14.5 Open Source ESBs
Mule
Basic usage
MuleForge
Supported transports
Deployment options
Mule IDE
SOA governance and management with Mule
Apache ServiceMix
Extensibility
Deployment in ServiceMix
OpenESB
Monitoring OpenESB
Project Fuji
Summary
Index

System requirements

Save as PDF Copy link into clipboard

Schweitzer Fachinformationen

Java SOA Cookbook

Description

More details

Other editions

Additional editions

Content

System requirements