Red Hat JBoss Fuse 6.2.1 Apache Camel Development Guide

697 Pages·2016·4.22 MB·English

Red Hat JBoss Fuse 6.2.1
Apache Camel Development Guide
Develop applications with Apache Camel
Last Updated: 2017-09-20

Red Hat JBoss Fuse 6.2.1 Apache Camel Development Guide
Develop applications with Apache Camel
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
REVISIT -
Table of Contents
Table of Contents
.P .A . R. T. .I .. I.M . P. .L .E .M . E. .N .T . I.N .G . .E .N . T. E. .R .P . R. I.S . E. .I N. .T .E .G . R. .A .T . I.O .N . .P .A . T. T. E. .R .N . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. P. .T .E .R . .1 .. .B . U. I.L .D . I.N . G. .B . L. O. .C . K. S. . F. O. .R . R. .O . U. T. .E . D. .E .F .I N. .I T. I.O . N. S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1. IMPLEMENTING A ROUTEBUILDER CLASS 11
1.2. BASIC JAVA DSL SYNTAX 12
1.3. ROUTER SCHEMA IN A SPRING XML FILE 15
1.4. ENDPOINTS 17
1.5. PROCESSORS 22
.C .H . A. P. .T .E .R . .2 .. .B . A. S. .I C. .P . R. I.N . C. I.P . L. E. S. . O. .F . R. .O .U . T. E. . B. U. .I L. D. .I N. G. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.1. PIPELINE PROCESSING 31
2.2. MULTIPLE INPUTS 34
2.3. EXCEPTION HANDLING 37
2.4. BEAN INTEGRATION 53
2.5. CREATING EXCHANGE INSTANCES 64
2.6. TRANSFORMING MESSAGE CONTENT 65
2.7. PROPERTY PLACEHOLDERS 77
2.8. THREADING MODEL 87
2.9. CONTROLLING START-UP AND SHUTDOWN OF ROUTES 96
2.10. SCHEDULED ROUTE POLICY 100
2.11. METRICS 110
2.12. JMX NAMING 112
2.13. PERFORMANCE AND OPTIMIZATION 114
.C .H . A. P. .T .E .R . .3 .. .I N. .T .R .O . D. .U .C . I.N . G. .E . N. T. .E .R . P. R. .I S. E. . I.N .T .E . G. .R .A . T. I.O . N. .P . A. T. .T .E .R . N. S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .1 .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1. OVERVIEW OF THE PATTERNS 115
.C .H . A. P. .T .E .R . .4 .. .D . E. F. I.N . I.N .G . .R . E. S. .T . S. E. .R .V . I.C .E . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .2 .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1. OVERVIEW OF REST IN CAMEL 122
4.2. DEFINING SERVICES WITH REST DSL 124
4.3. MARSHALLING TO AND FROM JAVA OBJECTS 134
4.4. CONFIGURING THE REST DSL 142
4.5. SWAGGER INTEGRATION 147
.C .H . A. P. .T .E .R . .5 .. .M . E. S. .S .A . G. .I N. G. . S. Y. .S .T .E . M. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .5 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.1. MESSAGE 151
5.2. MESSAGE CHANNEL 152
5.3. MESSAGE ENDPOINT 154
5.4. PIPES AND FILTERS 155
5.5. MESSAGE ROUTER 157
5.6. MESSAGE TRANSLATOR 159
5.7. MESSAGE HISTORY 160
.C .H . A. P. .T .E .R . .6 .. .M . E. S. .S .A . G. .I N. G. . C. .H .A . N. N. .E .L . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .6 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1. POINT-TO-POINT CHANNEL 161
6.2. PUBLISH-SUBSCRIBE CHANNEL 162
6.3. DEAD LETTER CHANNEL 164
6.4. GUARANTEED DELIVERY 173
6.5. MESSAGE BUS 176
.C .H . A. P. .T .E .R . .7 .. .M . E. S. .S .A . G. .E . C. .O .N . S. T. .R .U . C. .T .I O. .N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .7 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1. CORRELATION IDENTIFIER 177
7.2. EVENT MESSAGE 177
1
Red Hat JBoss Fuse 6.2.1 Apache Camel Development Guide
7.3. RETURN ADDRESS 179
.C .H . A. P. .T .E .R . .8 .. .M . E. S. .S .A . G. .E . R. .O .U . T. I.N . G. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .8 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.1. CONTENT-BASED ROUTER 181
8.2. MESSAGE FILTER 182
8.3. RECIPIENT LIST 184
8.4. SPLITTER 193
8.5. AGGREGATOR 204
8.6. RESEQUENCER 224
8.7. ROUTING SLIP 228
8.8. THROTTLER 230
8.9. DELAYER 232
8.10. LOAD BALANCER 234
8.11. MULTICAST 243
8.12. COMPOSED MESSAGE PROCESSOR 250
8.13. SCATTER-GATHER 252
8.14. LOOP 256
8.15. SAMPLING 258
8.16. DYNAMIC ROUTER 260
.C .H . A. P. .T .E .R . .9 .. .M . E. S. .S .A . G. .E . T. R. .A .N . S. F. .O .R . M. .A . T. I.O . N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 .6 .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1. CONTENT ENRICHER 263
9.2. CONTENT FILTER 268
9.3. NORMALIZER 269
9.4. CLAIM CHECK 271
9.5. SORT 273
9.6. VALIDATE 274
.C .H . A. P. .T .E .R . .1 .0 .. .M . E. S. .S .A . G. .I N. G. . E. N. .D . P. O. .I N. T. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 .7 .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.1. MESSAGING MAPPER 276
10.2. EVENT DRIVEN CONSUMER 277
10.3. POLLING CONSUMER 277
10.4. COMPETING CONSUMERS 278
10.5. MESSAGE DISPATCHER 280
10.6. SELECTIVE CONSUMER 282
10.7. DURABLE SUBSCRIBER 284
10.8. IDEMPOTENT CONSUMER 287
10.9. TRANSACTIONAL CLIENT 293
10.10. MESSAGING GATEWAY 294
10.11. SERVICE ACTIVATOR 294
.C .H . A. P. .T .E .R . .1 .1 .. .S .Y . S. T. E. .M . .M . A. N. .A . G. E. .M . E. N. .T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 .9 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.1. DETOUR 297
11.2. LOGEIP 298
11.3. WIRE TAP 299
.C .H . A. P. .T .E .R . .1 .2 .. .S .E . R. V. .I C. E. . C. O. .M . P. .O .N . E. N. .T . R. .U . N. T. I.M . E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .0 .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ABSTRACT 305
WORKING WITH CAMEL AND SCR 305
CREATING A SERVICE COMPONENT 305
EXAMPLE OF A SERVICE COMPONENT CLASS 306
EXAMPLE OF A ROUTEBUILDER CLASS 307
USING APACHE CAMEL SCR BUNDLE AS A TEMPLATE 308
USING APACHE CAMEL-ARCHETYPE-SCR 309
2
Table of Contents
.P .A . R. T. .I I.. .R . O. .U .T . I.N .G . .E .X . P. R. .E .S . S. I.O . N. .A . N. .D . P. .R .E . D. I.C . A. .T .E . L. A. .N . G. U. .A . G. E. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .1 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. P. .T .E .R . .1 .3 .. .I N. .T .R .O . D. .U .C . T. I.O . N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .1 .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13.1. OVERVIEW OF THE LANGUAGES 312
13.2. HOW TO INVOKE AN EXPRESSION LANGUAGE 313
.C .H . A. P. .T .E .R . .1 .4 .. .C . O. N. .S .T . A. N. .T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .1 .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 318
XML EXAMPLE 318
JAVA EXAMPLE 318
.C .H . A. P. .T .E .R . .1 .5 .. .E .L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .1 .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 319
ADDING JUEL PACKAGE 319
STATIC IMPORT 319
VARIABLES 319
EXAMPLE 320
.C .H . A. P. .T .E .R . .1 .6 .. .T .H . E. .F .I L. .E . L. A. .N .G . U. .A .G . E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .2 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.1. WHEN TO USE THE FILE LANGUAGE 321
16.2. FILE VARIABLES 322
16.3. EXAMPLES 324
.C .H . A. P. .T .E .R . .1 .7 .. .G . R. O. .O . V. Y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .2 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 327
ADDING THE SCRIPT MODULE 327
STATIC IMPORT 327
BUILT-IN ATTRIBUTES 327
EXAMPLE 328
USING THE PROPERTIES COMPONENT 328
CUSTOMIZING GROOVY SHELL 329
.C .H . A. P. .T .E .R . .1 .8 .. .H . E. A. .D .E . R. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .3 .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 330
XML EXAMPLE 330
JAVA EXAMPLE 330
.C .H . A. P. .T .E .R . .1 .9 .. .J .A . V. A. .S .C . R. I.P . T. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .3 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 331
ADDING THE SCRIPT MODULE 331
STATIC IMPORT 331
BUILT-IN ATTRIBUTES 331
EXAMPLE 332
USING THE PROPERTIES COMPONENT 332
.C .H . A. P. .T .E .R . .2 .0 .. .J .O . S. Q. .L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .3 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 334
ADDING THE JOSQL MODULE 334
STATIC IMPORT 334
VARIABLES 334
EXAMPLE 335
.C .H . A. P. .T .E .R . .2 .1 .. .J .S .O . N. .P .A . T. H. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .3 .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 336
ADDING THE JSONPATH PACKAGE 336
JAVA EXAMPLE 336
3
Red Hat JBoss Fuse 6.2.1 Apache Camel Development Guide
XML EXAMPLE 336
SUPPRESS EXCEPTIONS 337
JSONPATH INJECTION 337
REFERENCE 338
.C .H . A. P. .T .E .R . .2 .2 .. .J .X .P . A. T. .H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .3 .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 339
ADDING JXPATH PACKAGE 339
VARIABLES 339
EXAMPLE 340
.C .H . A. P. .T .E .R . .2 .3 .. .M . V. E. .L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .4 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 341
SYNTAX 341
ADDING THE MVEL MODULE 341
BUILT-IN VARIABLES 341
EXAMPLE 342
.C .H . A. P. .T .E .R . .2 .4 .. .T .H . E. .O . B. .J .E .C . T. -.G . R. A. .P .H . .N . A. V. .I G. .A .T .I O. .N . .L .A . N. G. .U . A. G. .E .( .O .G . N. .L .) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .4 .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 343
CAMEL ON EAP DEPLOYMENT 343
ADDING THE OGNL MODULE 343
STATIC IMPORT 343
BUILT-IN VARIABLES 343
EXAMPLE 344
.C .H . A. P. .T .E .R . .2 .5 .. .P .H . P. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .4 .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 345
ADDING THE SCRIPT MODULE 345
STATIC IMPORT 345
BUILT-IN ATTRIBUTES 345
EXAMPLE 346
USING THE PROPERTIES COMPONENT 346
.C .H . A. P. .T .E .R . .2 .6 .. .E .X . C. H. .A . N. G. .E . P. .R .O . P. .E .R . T. Y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .4 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 347
XML EXAMPLE 347
JAVA EXAMPLE 347
.C .H . A. P. .T .E .R . .2 .7 .. .P .Y . T. H. .O .N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .4 .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 348
ADDING THE SCRIPT MODULE 348
STATIC IMPORT 348
BUILT-IN ATTRIBUTES 348
EXAMPLE 349
USING THE PROPERTIES COMPONENT 349
.C .H . A. P. .T .E .R . .2 .8 .. .R . E. F. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .5 .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 350
STATIC IMPORT 350
XML EXAMPLE 350
JAVA EXAMPLE 350
.C .H . A. P. .T .E .R . .2 .9 .. .R . U. B. .Y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .5 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 351
4
Table of Contents
ADDING THE SCRIPT MODULE 351
STATIC IMPORT 351
BUILT-IN ATTRIBUTES 351
EXAMPLE 352
USING THE PROPERTIES COMPONENT 352
.C .H . A. P. .T .E .R . .3 .0 .. .T .H . E. .S . I.M . P. L. E. . L. A. N. .G . U. A. .G . E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .5 .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.1. JAVA DSL 353
30.2. XML DSL 354
30.3. INVOKING AN EXTERNAL SCRIPT 355
30.4. EXPRESSIONS 355
30.5. PREDICATES 358
30.6. VARIABLE REFERENCE 360
30.7. OPERATOR REFERENCE 364
.C .H . A. P. .T .E .R . .3 .1 .. .S .P . E. L. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .6 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 367
SYNTAX 367
ADDING SPEL PACKAGE 367
VARIABLES 367
XML EXAMPLE 368
JAVA EXAMPLE 368
.C .H . A. P. .T .E .R . .3 .2 .. .T .H . E. .X . P. A. .T .H . L. .A .N . G. .U .A . G. .E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .7 .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32.1. JAVA DSL 370
32.2. XML DSL 371
32.3. XPATH INJECTION 373
32.4. XPATH BUILDER 374
32.5. ENABLING SAXON 375
32.6. EXPRESSIONS 377
32.7. PREDICATES 380
32.8. USING VARIABLES AND FUNCTIONS 381
32.9. VARIABLE NAMESPACES 382
32.10. FUNCTION REFERENCE 383
.C .H . A. P. .T .E .R . .3 .3 .. .X .Q . U. .E .R . Y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .8 .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OVERVIEW 385
JAVA SYNTAX 385
ADDING THE SAXON MODULE 385
CAMEL ON EAP DEPLOYMENT 385
STATIC IMPORT 385
VARIABLES 386
EXAMPLE 386
.P .A . R. T. .I I.I .. W. . E. B. . S. E. .R .V . I.C .E . S. .A . N. D. . R. O. .U . T. I.N . G. . W. .I T. H. . C. A. .M . E. L. . C. X. .F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .8 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. P. .T .E .R . .3 .4 .. .D . E. M. .O . N. S. .T .R . A. T. I.O . N. . C. O. .D . E. .F . O. R. . C. .A .M . E. .L ./ C. X. .F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .8 .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.1. DOWNLOADING AND INSTALLING THE DEMONSTRATIONS 388
34.2. RUNNING THE DEMONSTRATIONS 388
.C .H . A. P. .T .E .R . .3 .5 .. .J .A . V. A. .- F. I.R . S. T. .S . E. R. .V .I C. .E . I.M . P. .L .E .M . E. .N .T .A . T. I.O . N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 .9 .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
35.1. JAVA-FIRST OVERVIEW 392
35.2. DEFINE SEI AND RELATED CLASSES 393
35.3. ANNOTATE SEI FOR JAX-WS 396
35.4. INSTANTIATE THE WS ENDPOINT 399
5
Red Hat JBoss Fuse 6.2.1 Apache Camel Development Guide
35.5. JAVA-TO-WSDL MAVEN PLUG-IN 401
.C .H . A. P. .T .E .R . .3 .6 .. .W . S. .D .L . -.F .I R. .S .T . S. .E .R . V. I.C . E. .I M. .P . L. E. M. .E . N. T. A. .T .I O. .N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .0 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
36.1. WSDL-FIRST OVERVIEW 404
36.2. CUSTOMERSERVICE WSDL CONTRACT 405
36.3. WSDL-TO-JAVA MAVEN PLUG-IN 408
36.4. INSTANTIATE THE WS ENDPOINT 410
36.5. DEPLOY TO AN OSGI CONTAINER 411
.C .H . A. P. .T .E .R . .3 .7 .. .I M. .P .L . E. M. .E .N . T. I.N . G. . A. .W . .S . C. .L .I E. N. .T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .1 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
37.1. WS CLIENT OVERVIEW 414
37.2. WSDL-TO-JAVA MAVEN PLUG-IN 415
37.3. INSTANTIATE THE WS CLIENT PROXY 417
37.4. INVOKE WS OPERATIONS 419
37.5. DEPLOY TO AN OSGI CONTAINER 419
.C .H . A. P. .T .E .R . .3 .8 .. .P .O . J. O. .- B. .A .S . E. D. . R. O. .U . T. E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .2 .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
38.1. PROCESSING MESSAGES IN POJO FORMAT 422
38.2. WSDL-TO-JAVA MAVEN PLUG-IN 423
38.3. INSTANTIATE THE WS ENDPOINT 425
38.4. SORT MESSAGES BY OPERATION NAME 428
38.5. PROCESS OPERATION PARAMETERS 429
38.6. DEPLOY TO OSGI 431
.C .H . A. P. .T .E .R . .3 .9 .. .P .A . Y. L. .O .A . D. .- B. A. .S .E . D. .R . O. .U . T. E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .3 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
39.1. PROCESSING MESSAGES IN PAYLOAD FORMAT 434
39.2. INSTANTIATE THE WS ENDPOINT 435
39.3. SORT MESSAGES BY OPERATION NAME 437
39.4. SOAP/HTTP-TO-JMS BRIDGE USE CASE 438
39.5. GENERATING RESPONSES USING TEMPLATES 441
39.6. TYPECONVERTER FOR CXFPAYLOAD 444
39.7. DEPLOY TO OSGI 445
.C .H . A. P. .T .E .R . .4 .0 .. .P .R . O. .V .I D. .E .R . -.B . A. S. .E .D . .R .O . U. .T .E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .4 .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
40.1. PROVIDER-BASED JAX-WS ENDPOINT 448
40.2. CREATE A PROVIDER<?> IMPLEMENTATION CLASS 449
40.3. INSTANTIATE THE WS ENDPOINT 450
40.4. SORT MESSAGES BY OPERATION NAME 451
40.5. SOAP/HTTP-TO-JMS BRIDGE USE CASE 452
40.6. GENERATING RESPONSES USING TEMPLATES 455
40.7. TYPECONVERTER FOR SAXSOURCE 458
40.8. DEPLOY TO OSGI 458
.C .H . A. P. .T .E .R . .4 .1 .. .P .R . O. .X .Y . I.N .G . .A . .W . E. B. . S. E. .R .V . I.C . E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .6 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
41.1. PROXYING WITH HTTP 461
41.2. PROXYING WITH POJO FORMAT 463
41.3. PROXYING WITH PAYLOAD FORMAT 464
41.4. HANDLING HTTP HEADERS 466
.C .H . A. P. .T .E .R . .4 .2 .. .F .I L. T. .E .R . I.N .G . .S .O . A. .P . M. .E . S. S. .A .G . E. .H . E. A. .D . E. R. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .6 .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
42.1. BASIC CONFIGURATION 469
42.2. HEADER FILTERING 471
42.3. IMPLEMENTING A CUSTOM FILTER 472
42.4. INSTALLING FILTERS 475
6