Red Hat JBoss Fuse 6.1 Apache CXF Development Guide

659 Pages·2015·3.71 MB·English

Red Hat JBoss Fuse 6.1
Apache CXF Development Guide
Develop applications with Apache CXF Web services
Last Updated: 2017-10-12

Red Hat JBoss Fuse 6.1 Apache CXF Development Guide
Develop applications with Apache CXF Web services
JBoss A-MQ Docs Team
Content Services
[e-mail]
Legal Notice
Copyright © 2013 Red Hat.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons
Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is
available at
http://creativecommons.org/licenses/by-sa/3.0/
. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must
provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert,
Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity
logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other
countries.
Linux ® is the registered trademark of Linus Torvalds in the United States and other countries.
Java ® is a registered trademark of Oracle and/or its affiliates.
XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United
States and/or other countries.
MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and
other countries.
Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formally related
to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks
or trademarks/service marks of the OpenStack Foundation, in the United States and other
countries and are used with the OpenStack Foundation's permission. We are not affiliated with,
endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Abstract
REVISIT -
Table of Contents
Table of Contents
.P .A . .R . T. .I .. .W . R. .I .T .I .N . G. . W. .S . D. .L . .C .O . .N . T. R. .A . .C .T . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. . P. T. .E . R. . 1. .. I.N . T. .R . O. .D . U. .C . I.N . .G . W. . S. .D . L. .C . O. .N . .T .R . A. .C . T. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1. STRUCTURE OF A WSDL DOCUMENT 11
1.2. WSDL ELEMENTS 11
1.3. DESIGNING A CONTRACT 12
.C .H . A. . P. T. .E . R. . 2. .. D. . E. F. .I N. .I .N . G. . L. O. .G . I. C. .A . L. .D . A. .T . A. . U. .N . I. T. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.1. MAPPING DATA INTO LOGICAL DATA UNITS 13
2.2. ADDING DATA UNITS TO A CONTRACT 14
2.3. XML SCHEMA SIMPLE TYPES 15
2.4. DEFINING COMPLEX DATA TYPES 16
2.5. DEFINING ELEMENTS 24
.C .H . A. . P. T. .E . R. . 3. .. D. . E. F. .I N. .I .N . G. . L. O. .G . I. C. .A . L. .M . .E .S . S. .A . G. .E . S. .U . S. .E . D. . B. .Y . .A . .S . E. .R . V. .I C. .E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MESSAGES AND PARAMETER LISTS 25
MESSAGE DESIGN FOR INTEGRATING WITH LEGACY SYSTEMS 25
MESSAGE DESIGN FOR SOAP SERVICES 25
MESSAGE NAMING 26
MESSAGE PARTS 26
EXAMPLE 27
.C .H . A. . P. T. .E . R. . 4. .. .D . E. .F .I N. . I.N . G. . Y. .O . U. .R . .L . O. .G . I.C . A. .L . .I N. .T . E. .R . F. A. .C . E. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PROCESS 29
PORT TYPES 29
OPERATIONS 29
OPERATION MESSAGES 29
RETURN VALUES 31
EXAMPLE 31
.P .A . .R . T. .I .I .. W. . E. B. . S. .E . R. .V . I.C . E. .S . B. .I .N . D. .I N. . G. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. . P. T. .E . R. . 5. .. U. . N. .D . E. .R . S. T. .A . N. .D . I. N. .G . .B . I.N . D. .I .N . G. .S . .I N. . W. . S. D. . L. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 33
PORT TYPES AND BINDINGS 33
THE WSDL ELEMENTS 33
ADDING TO A CONTRACT 33
SUPPORTED BINDINGS 34
.C .H . A. . P. T. .E . R. . 6. .. U. . S. I. N. .G . .S .O . .A . P. . 1.. 1. .M . .E .S . S. .A . G. .E . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1. ADDING A SOAP 1.1 BINDING 35
6.2. ADDING SOAP HEADERS TO A SOAP 1.1 BINDING 37
.C .H . A. . P. T. .E . R. . 7. .. U. .S . I.N . .G . S. .O . A. .P . .1 .. 2. . M. .E . S. .S .A . G. .E . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1. ADDING A SOAP 1.2 BINDING TO A WSDL DOCUMENT 42
7.2. ADDING HEADERS TO A SOAP 1.2 MESSAGE 44
.C .H . A. . P. T. .E . R. . 8. .. .S .E . N. .D . I. N. .G . .B . I.N . A. .R . Y. . D. .A . .T .A . .U . .S .I .N . G. . S. O. . A. .P . .W . I. T. H. . A. . T. T. .A . C. .H . M. . E. N. .T . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 49
NAMESPACE 49
CHANGING THE MESSAGE BINDING 49
DESCRIBING A MIME MULTIPART MESSAGE 50
EXAMPLE 50
1
Red Hat JBoss Fuse 6.1 Apache CXF Development Guide
.C .H . A. . P. T. .E . R. . 9. .. S. .E . N. .D . I. N. .G . .B . I.N . A. .R . Y. . D. .A . .T .A . .W . .I T. .H . .S . O. .A . P. . M. . T. O. .M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1. ANNOTATING DATA TYPES TO USE MTOM 53
9.2. ENABLING MTOM 56
.C .H . A. . P. T. .E . R. . 1. 0. .. U. . S. I. N. .G . .X . M. .L . .D . O. .C . U. .M . E. .N . T. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
XML BINDING NAMESPACE 59
HAND EDITING 59
XML MESSAGES ON THE WIRE 60
OVERRIDING THE BINDING'S ROOTNODE ATTRIBUTE SETTING 61
.P .A . .R . T. .I .I I.. .W . .E . B. . S. E. .R . V. .I .C .E . S. . T. R. .A . .N . S. .P .O . .R . T. S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. . P. T. .E . R. . 1. 1.. .U . .N . D. .E .R . .S .T . A. .N . D. .I .N . G. . H. .O . W. . .E .N . .D . P. .O . I.N . T. .S . .A . R. .E . D. . E. F. .I N. .E . D. . I. N. . W. .S . D. .L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 64
ENDPOINTS AND SERVICES 64
THE WSDL ELEMENTS 64
ADDING ENDPOINTS TO A CONTRACT 64
SUPPORTED TRANSPORTS 64
.C .H . A. . P. T. .E . R. . 1. 2. .. U. .S . I.N . .G . .H . T. T. .P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12.1. ADDING A BASIC HTTP ENDPOINT 66
12.2. CONFIGURING A CONSUMER 68
12.3. CONFIGURING A SERVICE PROVIDER 75
12.4. CONFIGURING THE JETTY RUNTIME 81
12.5. CONFIGURING THE NETTY RUNTIME 84
12.6. USING THE HTTP TRANSPORT IN DECOUPLED MODE 89
.C .H . A. . P. T. .E . R. . 1. 3. .. U. .S . I.N . .G . S. .O . A. .P . .O . V. .E . R. . J. .M . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13.1. BASIC CONFIGURATION 94
13.2. JMS URIS 96
13.3. WSDL EXTENSIONS 98
.C .H . A. . P. T. .E . R. . 1. 4. .. U. . S. I. N. .G . .G . E. N. .E . R. .I .C . J. .M . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 0. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14.1. USING THE JMS CONFIGURATION BEAN 103
14.2. USING WSDL TO CONFIGURE JMS 109
14.3. USING A NAMED REPLY DESTINATION 114
.A . P. .P .E . N. .D . I. X. . A. .. .I N. .T . E. .G . R. .A . T. .I N. .G . .W . .I T. .H . .A . P. .A . C. .H . E. . A. .C . T. I. V. .E .M . .Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1 .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 115
THE INITIAL CONTEXT FACTORY 115
LOOKING UP THE CONNECTION FACTORY 115
SYNTAX FOR DYNAMIC DESTINATIONS 115
.A . P. .P .E . N. .D . I. X. . B. .. .C . O. .N . D. .U . I.T . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.1 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 117
CONDUIT LIFE-CYCLE 117
CONDUIT WEIGHT 117
.P .A . .R . T. .I .V . .. C. O. . N. .F .I .G .U . .R . I.N . G. . W. . E. .B . .S .E . R. .V . I.C . E. . E. .N . D. .P . O. .I N. .T . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .1 .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. . P. T. .E . R. . 1. 5. .. C. .O . N. .F . I.G . U. .R . I. N. .G . .J .A . X. .- .W . .S . .E .N . D. . P. O. . I.N . T. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .1 .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.1. CONFIGURING SERVICE PROVIDERS 119
15.2. CONFIGURING CONSUMER ENDPOINTS 128
.C .H . A. . P. T. .E . R. . 1. 6. .. A. .P . A. .C . H. .E . .C . X. .F . L. .O . G. .G . I.N . G. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 3. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.1. OVERVIEW OF APACHE CXF LOGGING 132
2
Table of Contents
16.2. SIMPLE EXAMPLE OF USING LOGGING 133
16.3. DEFAULT LOGGING CONFIGURATION FILE 134
16.4. ENABLING LOGGING AT THE COMMAND LINE 137
16.5. LOGGING FOR SUBSYSTEMS AND SERVICES 137
16.6. LOGGING MESSAGE CONTENT 139
.C .H . A. . P. T. .E . R. . 1. 7. .. D. .E . P. .L .O . Y. .I .N . G. . W. .S . -. A. .D . D. .R . E. .S . S. I. N. .G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 4. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.1. INTRODUCTION TO WS-ADDRESSING 142
17.2. WS-ADDRESSING INTERCEPTORS 142
17.3. ENABLING WS-ADDRESSING 143
17.4. CONFIGURING WS-ADDRESSING ATTRIBUTES 144
.C .H . A. . P. T. .E . R. . 1. 8. .. E. .N . A. .B . L. .I N. .G . .R . E. .L .I .A . B. .L . E. .M . .E .S . S. .A . G. .I N. . G. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 4. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18.1. INTRODUCTION TO WS-RM 146
18.2. WS-RM INTERCEPTORS 147
18.3. ENABLING WS-RM 148
18.4. CONFIGURING WS-RM 151
18.5. CONFIGURING WS-RM PERSISTENCE 159
.C .H . A. . P. T. .E . R. . 1. 9. .. E. .N . A. .B . L. .I N. .G . .H . I. G. .H . .A . V. .A . I. L. A. .B . I. L. I.T . Y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 6. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19.1. INTRODUCTION TO HIGH AVAILABILITY 162
19.2. ENABLING HA WITH STATIC FAILOVER 162
19.3. CONFIGURING HA WITH STATIC FAILOVER 164
.C .H . A. . P. T. .E . R. . 2. 0. .. .E . N. .A . B. .L . I.N . G. . H. .I .G . H. . A. .V . A. .I .L .A . B. .I .L .I T. .Y . .I N. . .F .U . S. .E . .F .A . B. .R . I. C. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 6. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20.1. LOAD BALANCING CLUSTER 166
20.2. FAILOVER CLUSTER 174
.C .H . A. . P. T. .E . R. . 2. 1. .. P. .A . C. .K . A. .G . I. N. .G . .A . N. . A. .P . P. .L .I .C .A . .T .I .O . N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 7. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CREATING A BUNDLE 178
REQUIRED BUNDLE 178
REQUIRED PACKAGES 178
EXAMPLE 179
.C .H . A. . P. T. .E . R. . 2. 2. .. .D . E. .P . L. O. .Y . I. N. .G . .A . N. . A. .P . P. .L .I .C . A. .T .I .O . N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 8. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 180
HOT DEPLOYMENT 180
DEPLOYING FROM THE CONSOLE 180
REFRESHING AN APPLICATION 180
STOPPING AN APPLICATION 180
UNINSTALLING AN APPLICATION 181
.A . P. .P .E . N. .D . I. X. . C. .. .A . P. .A . C. H. . E. .C . X. .F . .B . I.N . D. .I .N . G. . I.D . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 8. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.A . P. .P .E . N. .D . I. X. . D. .. .U . S. .I N. .G . .T . H. .E . .M . A. .V . E. .N . .O . S. .G . I. T. .O . O. .L . I.N . G. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 8. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D.1. SETTING UP A RED HAT JBOSS FUSE OSGI PROJECT 183
D.2. CONFIGURING THE BUNDLE PLUG-IN 186
.P .A . .R . T. .V . .. D. .E . V. .E . L. O. .P . I. N. .G . .A . P. .P .L . I.C . A. .T . I.O . .N . S. .U . S. .I .N . G. . J. A. .X . -. W. . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .9 . 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. . P. T. .E . R. . 2. 3. .. .B . O. .T . T. .O . M. .- .U . P. . S. .E .R . V. .I .C . E. .D . E. .V . E. .L .O . .P .M . .E . N. .T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 9. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.1. CREATING THE SEI 192
23.2. ANNOTATING THE CODE 194
23.3. GENERATING WSDL 216
.C .H . A. . P. T. .E . R. . 2. 4. .. .D . E. .V . E. .L .O . P. .I .N . G. . A. . C. .O . N. .S . U. .M . E. .R . .W . .I T. .H . O. .U . T. . A. . W. . S. D. . L. .C . O. .N . T. .R . A. .C . T. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. .1 .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
Red Hat JBoss Fuse 6.1 Apache CXF Development Guide
24.1. CREATING A SERVICE OBJECT 219
24.2. ADDING A PORT TO A SERVICE 221
24.3. GETTING A PROXY FOR AN ENDPOINT 222
24.4. IMPLEMENTING THE CONSUMER'S BUSINESS LOGIC 223
.C .H . A. . P. T. .E . R. . 2. 5. .. .A . .S . T. .A . R. .T .I .N . G. . P. .O . I.N . T. . W. . S. D. . L. .C . O. .N . T. .R . A. .C . T. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 2. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. . P. T. .E . R. . 2. 6. .. .T . O. .P . -. D. .O . W. . N. . S. E. .R . V. .I C. .E . .D . E. .V . E. .L .O . P. .M . .E .N . T. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 2. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
26.1. GENERATING THE STARTING POINT CODE 228
26.2. IMPLEMENTING THE SERVICE PROVIDER 230
.C .H . A. . P. T. .E . R. . 2. 7. .. .D . E. .V . E. L. .O . P. .I N. .G . .A . .C . O. .N . .S .U . M. . E. .R . .F .R . O. .M . . A. . W. . S. D. .L . .C . O. .N . T. .R . A. .C . T. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 3. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
27.1. GENERATING THE STUB CODE 232
27.2. IMPLEMENTING A CONSUMER 233
.C .H . A. . P. T. .E . R. . 2. 8. .. .F . I.N . D. .I .N . G. . W. .S . D. .L . .A . T. . R . .U . N. .T .I .M . E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 3. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.1. INSTANTIATING A PROXY BY INJECTION 238
28.2. USING A JAX-WS CATALOG 240
28.3. USING A CONTRACT RESOLVER 241
.C .H . A. . P. T. .E . R. . 2. 9. .. .G . E. .N . E. .R . I.C . .F .A . .U . L. T. . H. .A . N. .D . L. .I N. .G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 4. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.1. RUNTIME FAULTS 245
29.2. PROTOCOL FAULTS 246
.C .H . A. . P. T. .E . R. . 3. 0. .. .P . U. .B . L. .I S. .H . I.N . G. . A. . .S .E . R. .V . I.C . E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 4. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.1. APIS USED TO PUBLISH A SERVICE 248
30.2. PUBLISHING A SERVICE IN A PLAIN JAVA APPLICATION 250
30.3. PUBLISHING A SERVICE IN AN OSGI CONTAINER 252
.C .H . A. . P. T. .E . R. . 3. 1. .. B. .A . S. .I C. . D. .A . .T .A . .B . I. N. .D . I.N . G. . C. .O . N. .C . E. .P . T. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 5. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.1. INCLUDING AND IMPORTING SCHEMA DEFINITIONS 255
31.2. XML NAMESPACE MAPPING 257
31.3. THE OBJECT FACTORY 259
31.4. ADDING CLASSES TO THE RUNTIME MARSHALLER 260
.C .H . A. . P. T. .E . R. . 3. 2. .. .U . S. .I N. .G . .X . M. . L. .E . L. E. .M . .E .N . .T .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 6. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 262
XML SCHEMA MAPPING 262
JAVA MAPPING OF ELEMENTS WITH A NAMED TYPE 264
USING ELEMENTS WITH NAMED TYPES IN WSDL 265
JAVA MAPPING OF ELEMENTS WITH AN IN-LINE TYPE 266
JAVA MAPPING OF ABSTRACT ELEMENTS 266
JAVA MAPPING OF ELEMENTS WITH A DEFAULT VALUE 266
.C .H . A. . P. T. .E . R. . 3. 3. .. .U . S. .I N. .G . .S . I.M . .P . L. E. . T. .Y . P. E. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 6. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.1. PRIMITIVE TYPES 268
33.2. SIMPLE TYPES DEFINED BY RESTRICTION 270
33.3. ENUMERATIONS 273
33.4. LISTS 275
33.5. UNIONS 278
33.6. SIMPLE TYPE SUBSTITUTION 279
.C .H . A. . P. T. .E . R. . 3. 4. .. .U . S. .I N. . G. . C . O. .M . .P . L. E. .X . .T . Y. .P . E. S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. .8 . 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.1. BASIC COMPLEX TYPE MAPPING 281
34.2. ATTRIBUTES 285
34.3. DERIVING COMPLEX TYPES FROM SIMPLE TYPES 290
4
Table of Contents
34.4. DERIVING COMPLEX TYPES FROM COMPLEX TYPES 292
34.5. OCCURRENCE CONSTRAINTS 295
34.6. USING MODEL GROUPS 301
.C .H . A. . P. T. .E . R. . 3. 5. .. .U . S. .I N. .G . .W . .I L. .D . .C . A. .R . D. . T. .Y . P. .E .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . 0. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
35.1. USING ANY ELEMENTS 305
35.2. USING THE XML SCHEMA ANYTYPE TYPE 309
35.3. USING UNBOUND ATTRIBUTES 311
.C .H . A. . P. T. .E . R. . 3. 6. .. .E . L. E. .M . .E .N . T. . S. .U . B. .S . T. I. T. U. .T . I.O . .N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. .1 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
36.1. SUBSTITUTION GROUPS IN XML SCHEMA 314
36.2. SUBSTITUTION GROUPS IN JAVA 316
36.3. WIDGET VENDOR EXAMPLE 322
.C .H . A. . P. T. .E . R. . 3. 7. .. .C . U. .S .T . O. .M . .I Z. .I N. .G . .H . .O . W. . T. .Y . P. .E . S. .A . R. .E . .G . E. .N . E. .R . A. .T . E. D. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. 2. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
37.1. BASICS OF CUSTOMIZING TYPE MAPPINGS 329
37.2. SPECIFYING THE JAVA CLASS OF AN XML SCHEMA PRIMITIVE 331
37.3. GENERATING JAVA CLASSES FOR SIMPLE TYPES 337
37.4. CUSTOMIZING ENUMERATION MAPPING 339
37.5. CUSTOMIZING FIXED VALUE ATTRIBUTE MAPPING 343
37.6. SPECIFYING THE BASE TYPE OF AN ELEMENT OR AN ATTRIBUTE 346
.C .H . A. . P. T. .E . R. . 3. 8. .. .U . S. .I N. .G . .A . . J . A. .X . B. .C . O. .N . T. .E . X. .T . O. . B. .J .E . C. .T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . 4. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 349
BEST PRACTICES 349
GETTING A JAXBCONTEXT OBJECT USING AN OBJECT FACTORY 349
GETTING A JAXBCONTEXT OBJECT USING PACKAGE NAMES 350
.C .H . A. . P. T. .E . R. . 3. 9. .. .U . S. .I N. .G . .S . O. .A . P. . O. .V . E. .R . .J . M. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .5 . 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 351
JMS URIS 351
PUBLISHING A SERVICE 353
CONSUMING A SERVICE 354
.C .H . A. . P. T. .E . R. . 4. .0 .. . D . .E .V . E. .L . O. .P . I.N . G. . A. .S . Y. .N . C. .H . R. .O . N. .O . U. . S. .A . P. .P . L. .I C. .A . T. .I O. .N . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. 5. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
40.1. WSDL FOR ASYNCHRONOUS EXAMPLES 355
40.2. GENERATING THE STUB CODE 356
40.3. IMPLEMENTING AN ASYNCHRONOUS CLIENT WITH THE POLLING APPROACH 360
40.4. IMPLEMENTING AN ASYNCHRONOUS CLIENT WITH THE CALLBACK APPROACH 362
40.5. CATCHING EXCEPTIONS RETURNED FROM A REMOTE SERVICE 365
.C .H . A. . P. T. .E . R. . 4. .1 .. U. . S. I. N. .G . .R . A. .W . . X. .M . L. . M. .E . S. S. .A . G. .E . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . 6. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
41.1. USING XML IN A CONSUMER 368
41.2. USING XML IN A SERVICE PROVIDER 375
.C .H . A. . P. T. .E . R. . 4. .2 .. .W . .O . R. .K . I. N. .G . .W . I. T. .H . .C .O . .N . T. E. .X . T. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. 8. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
42.1. UNDERSTANDING CONTEXTS 383
42.2. WORKING WITH CONTEXTS IN A SERVICE IMPLEMENTATION 386
42.3. WORKING WITH CONTEXTS IN A CONSUMER IMPLEMENTATION 392
42.4. WORKING WITH JMS MESSAGE PROPERTIES 396
.C .H . A. . P. T. .E . R. . 4. .3 .. .W . .R . I.T . I.N . .G . H. . A. .N . D. .L .E . R. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 . 0. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
43.1. HANDLERS: AN INTRODUCTION 402
43.2. IMPLEMENTING A LOGICAL HANDLER 405
43.3. HANDLING MESSAGES IN A LOGICAL HANDLER 405
43.4. IMPLEMENTING A PROTOCOL HANDLER 411
5
Red Hat JBoss Fuse 6.1 Apache CXF Development Guide
43.5. HANDLING MESSAGES IN A SOAP HANDLER 412
43.6. INITIALIZING A HANDLER 416
43.7. HANDLING FAULT MESSAGES 416
43.8. CLOSING A HANDLER 417
43.9. RELEASING A HANDLER 418
43.10. CONFIGURING ENDPOINTS TO USE HANDLERS 418
.A . P. .P .E . N. .D . I. X. . E. .. M. . A. .V . E. .N . .T . O. .O . L. I. N. .G . .R . E. .F .E . R. .E . N. .C . E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 . 2. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
NAME 424
DEPENDENCIES 424
REPOSITORIES 424
NAME 425
SYNOPSIS 425
DESCRIPTION 426
WSDL OPTIONS 426
DEFAULT OPTIONS 426
OPTIONS 426
NAME 429
SYNOPSIS 429
DESCRIPTION 429
REQUIRED CONFIGURATION 429
OPTIONAL CONFIGURATION 429
.P .A . .R . T. .V . I. .. D. .E .V . E. .L . O. .P . I.N . G. . R. .E . S. .T .F . U. .L . W. . E. .B . .S .E . R. .V . I. C. E. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. .3 . 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. . P. T. .E . R. . 4. .4 .. .I .N . T. .R . O. .D . U. .C . T. .I O. .N . .T . O. . R. .E . S. T. .F . U. .L . W. . E. .B . .S .E . R. .V . I.C . E. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 . 3. .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 432
BASIC REST PRINCIPLES 432
RESOURCES 433
REST BEST PRACTICES 433
DESIGNING A RESTFUL WEB SERVICE 433
IMPLEMENTING REST WITH APACHE CXF 434
DATA BINDINGS 434
.C .H . A. . P. T. .E . R. . 4. .5 .. .C . R. .E . A. .T . I.N . G. . R. .E . S. .O . U. .R . C. .E .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 . 3. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
45.1. INTRODUCTION 435
45.2. BASIC JAX-RS ANNOTATIONS 436
45.3. ROOT RESOURCE CLASSES 437
45.4. WORKING WITH RESOURCE METHODS 439
45.5. WORKING WITH SUB-RESOURCES 441
45.6. RESOURCE SELECTION METHOD 444
.C .H . A. . P. T. .E . R. . 4. .6 .. .P . A. .S . S. .I N. .G . .I .N . F. O. .R . M. . A. .T . I.O . N. . I. N. .T . O. . R. .E .S . O. .U . R. .C . E. . C. .L .A . S. .S . E. .S . A. .N . .D . .M . E. .T . H. .O . D. .S . . . . . . . . . . . . . . . . . . . . . . .4 . 4. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
46.1. BASICS OF INJECTING DATA 448
46.2. USING JAX-RS APIS 448
46.3. USING APACHE CXF EXTENSIONS 457
.C .H . A. . P. T. .E . R. . 4. .7 .. .R . E. .T .U . .R . N. .I N. .G . .I .N . F. O. .R . M. . A. .T . I.O . N. . T. .O . .T . H. .E . .C . O. .N . S. .U . M. .E . R. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 . 5. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
47.1. RETURNING PLAIN JAVA CONSTRUCTS 459
47.2. FINE TUNING AN APPLICATION'S RESPONSES 460
47.3. RETURNING ENTITIES WITH GENERIC TYPE INFORMATION 466
.C .H . A. . P. T. .E . R. . 4. .8 .. .H . .A . N. .D . L. I. N. .G . .E . X. .C .E . P. .T . I.O . N. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 . 6. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
48.1. USING WEBAPPLICAITONEXCEPTION EXCEPTIONS TO REPORT ERRORS 469
48.2. MAPPING EXCEPTIONS TO RESPONSES 471
6