Red Hat JBoss Fuse 6.2 Apache CXF Development Guide

772 Pages·2015·4.35 MB·English

Red Hat JBoss Fuse 6.2
Apache CXF Development Guide
Develop applications with Apache CXF Web services
Last Updated: 2017-09-26

Red Hat JBoss Fuse 6.2 Apache CXF Development Guide
Develop applications with Apache CXF Web services
JBoss A-MQ Docs Team
Content Services
[email protected]
Legal Notice
Copyright © 2015 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
Guide to developing Web services using Apache CXF.
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. INTRODUCTION TO LOGICAL DATA UNITS 13
2.2. MAPPING DATA INTO LOGICAL DATA UNITS 13
2.3. ADDING DATA UNITS TO A CONTRACT 14
2.4. XML SCHEMA SIMPLE TYPES 15
2.5. DEFINING COMPLEX DATA TYPES 16
2.6. 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. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 26
MESSAGES AND PARAMETER LISTS 26
MESSAGE DESIGN FOR INTEGRATING WITH LEGACY SYSTEMS 26
MESSAGE DESIGN FOR SOAP SERVICES 27
MESSAGE NAMING 27
MESSAGE PARTS 27
EXAMPLE 28
.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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 30
PROCESS 30
PORT TYPES 30
OPERATIONS 30
OPERATION MESSAGES 31
RETURN VALUES 32
EXAMPLE 32
.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. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.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. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 34
PORT TYPES AND BINDINGS 34
THE WSDL ELEMENTS 34
ADDING TO A CONTRACT 34
SUPPORTED BINDINGS 35
.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. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1. ADDING A SOAP 1.1 BINDING 36
6.2. ADDING SOAP HEADERS TO A SOAP 1.1 BINDING 38
.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. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1. ADDING A SOAP 1.2 BINDING TO A WSDL DOCUMENT 43
7.2. ADDING HEADERS TO A SOAP 1.2 MESSAGE 45
.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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 50
NAMESPACE 50
CHANGING THE MESSAGE BINDING 50
1
Red Hat JBoss Fuse 6.2 Apache CXF Development Guide
DESCRIBING A MIME MULTIPART MESSAGE 51
EXAMPLE 52
.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. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1. OVERVIEW OF MTOM 54
9.2. ANNOTATING DATA TYPES TO USE MTOM 54
9.3. ENABLING MTOM 57
.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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
XML BINDING NAMESPACE 60
HAND EDITING 60
XML MESSAGES ON THE WIRE 61
OVERRIDING THE BINDING'S ROOTNODE ATTRIBUTE SETTING 62
.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. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.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. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 65
ENDPOINTS AND SERVICES 65
THE WSDL ELEMENTS 65
ADDING ENDPOINTS TO A CONTRACT 65
SUPPORTED TRANSPORTS 65
.C .H . A. . P. T. .E . R. . 1. 2. .. U. .S . I.N . .G . .H . T. T. .P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12.1. ADDING A BASIC HTTP ENDPOINT 67
12.2. CONFIGURING A CONSUMER 69
12.3. CONFIGURING A SERVICE PROVIDER 76
12.4. CONFIGURING THE JETTY RUNTIME 82
12.5. CONFIGURING THE NETTY RUNTIME 85
12.6. USING THE HTTP TRANSPORT IN DECOUPLED MODE 90
.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. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13.1. BASIC CONFIGURATION 95
13.2. JMS URIS 97
13.3. WSDL EXTENSIONS 102
.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. .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14.1. APPROACHES TO CONFIGURING JMS 107
14.2. USING THE JMS CONFIGURATION BEAN 107
14.3. OPTIMIZING CLIENT-SIDE JMS PERFORMANCE 116
14.4. CONFIGURING JMS TRANSACTIONS 117
14.5. USING WSDL TO CONFIGURE JMS 119
14.6. USING A NAMED REPLY DESTINATION 124
.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. 2. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 126
THE INITIAL CONTEXT FACTORY 126
LOOKING UP THE CONNECTION FACTORY 126
SYNTAX FOR DYNAMIC DESTINATIONS 126
.A . P. .P .E . N. .D . I. X. . B. .. .C . O. .N . D. .U . I.T . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 2. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 128
CONDUIT LIFE-CYCLE 128
CONDUIT WEIGHT 128
.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. 2. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
Table of Contents
.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. 3. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.1. CONFIGURING SERVICE PROVIDERS 130
15.2. CONFIGURING CONSUMER ENDPOINTS 139
.C .H . A. . P. T. .E . R. . 1. 6. .. C. .O . N. .F . I.G . U. .R . I. N. .G . .J .A . X. .- .R . S. . E. .N . D. .P . O. .I N. .T . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 4. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.1. CONFIGURING JAX-RS SERVER ENDPOINTS 143
16.2. CONFIGURING JAX-RS CLIENT ENDPOINTS 155
16.3. DEFINING REST SERVICES WITH THE MODEL SCHEMA 159
.C .H . A. . P. T. .E . R. . 1. 7. .. A. .P . A. .C . H. .E . .C . X. .F . L. .O . G. .G . I.N . G. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. 6. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.1. OVERVIEW OF APACHE CXF LOGGING 164
17.2. SIMPLE EXAMPLE OF USING LOGGING 165
17.3. DEFAULT LOGGING CONFIGURATION FILE 166
17.4. ENABLING LOGGING AT THE COMMAND LINE 169
17.5. LOGGING FOR SUBSYSTEMS AND SERVICES 169
17.6. LOGGING MESSAGE CONTENT 171
.C .H . A. . P. T. .E . R. . 1. 8. .. D. .E . P. .L .O . .Y . I.N . G. . W. . S. .- A. .D . .D . R. .E .S . S. .I N. .G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 7. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18.1. INTRODUCTION TO WS-ADDRESSING 175
18.2. WS-ADDRESSING INTERCEPTORS 175
18.3. ENABLING WS-ADDRESSING 176
18.4. CONFIGURING WS-ADDRESSING ATTRIBUTES 177
.C .H . A. . P. T. .E . R. . 1. 9. .. 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 7. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19.1. INTRODUCTION TO WS-RM 179
19.2. WS-RM INTERCEPTORS 181
19.3. ENABLING WS-RM 182
19.4. RUNTIME CONTROL 185
19.5. CONFIGURING WS-RM 187
19.6. CONFIGURING WS-RM PERSISTENCE 195
.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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 9. .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20.1. INTRODUCTION TO HIGH AVAILABILITY 197
20.2. ENABLING HA WITH STATIC FAILOVER 197
20.3. CONFIGURING HA WITH STATIC FAILOVER 199
.C .H . A. . P. T. .E . R. . 2. 1. .. 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. .0 . 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21.1. LOAD BALANCING CLUSTER 201
21.2. FAILOVER CLUSTER 209
.C .H . A. . P. T. .E . R. . 2. 2. .. .P . A. .C . K. .A . G. .I .N . G. . A. .N . .A . P. .P . L. I. C. A. .T . I. O. .N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 .1 .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CREATING A BUNDLE 213
REQUIRED BUNDLE 213
REQUIRED PACKAGES 213
EXAMPLE 214
.C .H . A. . P. T. .E . R. . 2. 3. .. .D . E. .P . L. O. .Y . I. N. .G . .A . N. . A. .P . P. .L .I .C . A. .T .I .O . N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 .1 .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 215
HOT DEPLOYMENT 215
DEPLOYING FROM THE CONSOLE 215
REFRESHING AN APPLICATION 215
STOPPING AN APPLICATION 216
UNINSTALLING AN APPLICATION 216
.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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 .1 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TABLE OF BINDING IDS 217
3
Red Hat JBoss Fuse 6.2 Apache CXF Development Guide
.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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. .1 .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D.1. THE MAVEN BUNDLE PLUG-IN 218
D.2. SETTING UP A RED HAT JBOSS FUSE OSGI PROJECT 218
D.3. CONFIGURING THE BUNDLE PLUG-IN 221
.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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 2. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. . P. T. .E . R. . 2. 4. .. .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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 2. .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.1. INTRODUCTION TO JAX-WS SERVICE DEVELOPMENT 227
24.2. CREATING THE SEI 227
24.3. ANNOTATING THE CODE 229
24.4. GENERATING WSDL 251
.C .H . A. . P. T. .E . R. . 2. 5. .. .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 . 5. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1. JAVA-FIRST CONSUMER DEVELOPMENT 254
25.2. CREATING A SERVICE OBJECT 254
25.3. ADDING A PORT TO A SERVICE 256
25.4. GETTING A PROXY FOR AN ENDPOINT 257
25.5. IMPLEMENTING THE CONSUMER'S BUSINESS LOGIC 258
.C .H . A. . P. T. .E . R. . 2. 6. .. .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 . 6. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
26.1. SAMPLE WSDL CONTRACT 260
.C .H . A. . P. T. .E . R. . 2. 7. .. .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. 6. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
27.1. OVERVIEW OF JAX-WS SERVICE PROVIDER DEVELOPMENT 263
27.2. GENERATING THE STARTING POINT CODE 263
27.3. IMPLEMENTING THE SERVICE PROVIDER 265
.C .H . A. . P. T. .E . R. . 2. 8. .. .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. 6. .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.1. GENERATING THE STUB CODE 267
28.2. IMPLEMENTING A CONSUMER 268
.C .H . A. . P. T. .E . R. . 2. 9. .. .F . I.N . D. .I .N . G. . W. .S . D. .L . .A . T. .R . U. . N. .T .I .M . E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 7. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.1. MECHANISMS FOR LOCATING THE WSDL DOCUMENT 273
29.2. INSTANTIATING A PROXY BY INJECTION 273
29.3. USING A JAX-WS CATALOG 275
29.4. USING A CONTRACT RESOLVER 276
.C .H . A. . P. T. .E . R. . 3. 0. .. .G . E. .N . E. .R . I.C . .F . A. .U . L. T. . H. .A . N. .D . L. .I N. .G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 8. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.1. RUNTIME FAULTS 280
30.2. PROTOCOL FAULTS 281
.C .H . A. . P. T. .E . R. . 3. 1. .. P. .U . B. .L . I.S . H. .I N. .G . .A . .S . E. .R . V. .I C. .E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 . 8. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.1. WHEN TO PUBLISH A SERVICE 283
31.2. APIS USED TO PUBLISH A SERVICE 283
31.3. PUBLISHING A SERVICE IN A PLAIN JAVA APPLICATION 285
31.4. PUBLISHING A SERVICE IN AN OSGI CONTAINER 287
.C .H . A. . P. T. .E . R. . 3. 2. .. .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 . 9. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32.1. INCLUDING AND IMPORTING SCHEMA DEFINITIONS 290
32.2. XML NAMESPACE MAPPING 292
32.3. THE OBJECT FACTORY 294
32.4. ADDING CLASSES TO THE RUNTIME MARSHALLER 295
.C .H . A. . P. T. .E . R. . 3. 3. .. .U . S. .I N. .G . .X . M. . L. .E . L. E. .M . .E .N . .T .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. 9. .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 297
4
Table of Contents
XML SCHEMA MAPPING 297
JAVA MAPPING OF ELEMENTS WITH A NAMED TYPE 299
USING ELEMENTS WITH NAMED TYPES IN WSDL 300
JAVA MAPPING OF ELEMENTS WITH AN IN-LINE TYPE 301
JAVA MAPPING OF ABSTRACT ELEMENTS 301
JAVA MAPPING OF ELEMENTS WITH A DEFAULT VALUE 301
.C .H . A. . P. T. .E . R. . 3. 4. .. .U . S. .I N. . G. . S . I. M. .P . L. E. . T. .Y . P. .E .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . 0. .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.1. PRIMITIVE TYPES 303
34.2. SIMPLE TYPES DEFINED BY RESTRICTION 305
34.3. ENUMERATIONS 308
34.4. LISTS 310
34.5. UNIONS 313
34.6. SIMPLE TYPE SUBSTITUTION 314
.C .H . A. . P. T. .E . R. . 3. 5. .. .U . S. .I N. .G . .C . O. .M . .P . L. E. .X . .T .Y . .P .E . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .1 .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
35.1. BASIC COMPLEX TYPE MAPPING 316
35.2. ATTRIBUTES 320
35.3. DERIVING COMPLEX TYPES FROM SIMPLE TYPES 325
35.4. DERIVING COMPLEX TYPES FROM COMPLEX TYPES 327
35.5. OCCURRENCE CONSTRAINTS 330
35.6. USING MODEL GROUPS 336
.C .H . A. . P. T. .E . R. . 3. 6. .. .U . S. .I N. .G . .W . .I L. .D . .C . A. .R . D. . T. .Y . P. .E .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . 4. .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
36.1. USING ANY ELEMENTS 340
36.2. USING THE XML SCHEMA ANYTYPE TYPE 344
36.3. USING UNBOUND ATTRIBUTES 346
.C .H . A. . P. T. .E . R. . 3. 7. .. .E .L . E. .M . E. .N . T. . S. U. . B. .S .T . I.T . U. .T . I.O . N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . 4. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
37.1. SUBSTITUTION GROUPS IN XML SCHEMA 349
37.2. SUBSTITUTION GROUPS IN JAVA 351
37.3. WIDGET VENDOR EXAMPLE 357
.C .H . A. . P. T. .E . R. . 3. 8. .. .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 . 6. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
38.1. BASICS OF CUSTOMIZING TYPE MAPPINGS 364
38.2. SPECIFYING THE JAVA CLASS OF AN XML SCHEMA PRIMITIVE 366
38.3. GENERATING JAVA CLASSES FOR SIMPLE TYPES 372
38.4. CUSTOMIZING ENUMERATION MAPPING 374
38.5. CUSTOMIZING FIXED VALUE ATTRIBUTE MAPPING 378
38.6. SPECIFYING THE BASE TYPE OF AN ELEMENT OR AN ATTRIBUTE 381
.C .H . A. . P. T. .E . R. . 3. 9. .. .U . S. .I N. .G . .A . .J . A. .X . B. .C . O. .N . T. .E . X. .T . O. .B . .J .E . C. .T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . 8. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 384
BEST PRACTICES 384
GETTING A JAXBCONTEXT OBJECT USING AN OBJECT FACTORY 384
GETTING A JAXBCONTEXT OBJECT USING PACKAGE NAMES 385
.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 . 8. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
40.1. TYPES OF ASYNCHRONOUS INVOCATION 386
40.2. WSDL FOR ASYNCHRONOUS EXAMPLES 386
40.3. GENERATING THE STUB CODE 387
40.4. IMPLEMENTING AN ASYNCHRONOUS CLIENT WITH THE POLLING APPROACH 391
40.5. IMPLEMENTING AN ASYNCHRONOUS CLIENT WITH THE CALLBACK APPROACH 393
40.6. CATCHING EXCEPTIONS RETURNED FROM A REMOTE SERVICE 396
5
Red Hat JBoss Fuse 6.2 Apache CXF Development Guide
.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. 9. .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
41.1. USING XML IN A CONSUMER 399
41.2. USING XML IN A SERVICE PROVIDER 406
.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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. .1 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
42.1. UNDERSTANDING CONTEXTS 414
42.2. WORKING WITH CONTEXTS IN A SERVICE IMPLEMENTATION 417
42.3. WORKING WITH CONTEXTS IN A CONSUMER IMPLEMENTATION 423
42.4. WORKING WITH JMS MESSAGE PROPERTIES 427
.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 . 3. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
43.1. HANDLERS: AN INTRODUCTION 434
43.2. IMPLEMENTING A LOGICAL HANDLER 437
43.3. HANDLING MESSAGES IN A LOGICAL HANDLER 437
43.4. IMPLEMENTING A PROTOCOL HANDLER 443
43.5. HANDLING MESSAGES IN A SOAP HANDLER 444
43.6. INITIALIZING A HANDLER 448
43.7. HANDLING FAULT MESSAGES 448
43.8. CLOSING A HANDLER 449
43.9. RELEASING A HANDLER 450
43.10. CONFIGURING ENDPOINTS TO USE HANDLERS 450
.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 . 5. .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
E.1. PLUG-IN SETUP 456
E.2. CXF-CODEGEN-PLUGIN 457
E.3. JAVA2WS 462
.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 . 6. .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.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 . 6. .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 465
BASIC REST PRINCIPLES 465
RESOURCES 466
REST BEST PRACTICES 466
DESIGNING A RESTFUL WEB SERVICE 466
IMPLEMENTING REST WITH APACHE CXF 467
DATA BINDINGS 467
.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 . 6. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
45.1. INTRODUCTION 468
45.2. BASIC JAX-RS ANNOTATIONS 469
45.3. ROOT RESOURCE CLASSES 470
45.4. WORKING WITH RESOURCE METHODS 472
45.5. WORKING WITH SUB-RESOURCES 474
45.6. RESOURCE SELECTION METHOD 477
.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. .8 . 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
46.1. BASICS OF INJECTING DATA 481
46.2. USING JAX-RS APIS 481
46.3. PARAMETER CONVERTERS 492
46.4. USING APACHE CXF EXTENSIONS 496
.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 . 9. .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
47.1. RETURN TYPES 498
47.2. RETURNING PLAIN JAVA CONSTRUCTS 498
6