Red Hat JBoss Fuse 6.3 Deploying into Apache Karaf

206 Pages·2017·1.28 MB·English

Red Hat JBoss Fuse
6.3
Deploying into Apache Karaf
Deploying application packages into the Apache Karaf container
JBoss A-MQ Docs
Team

Red Hat JBoss Fuse 6.3 Deploying into Apache Karaf
Deploying application packages into the Apache Karaf container
JBoss A-MQ Docs Team
Content Services
[email protected]
Legal Notice
Copyright © 2016 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
The guide describes the options for deploying applications into a Red Hat JBoss Fuse container.
Table of Contents
Table of Contents
.P .A . R. T. .I .. T. .H .E . .R .E . D. .H . A. T. . J. B. O. .S .S . .F .U . S. E. .C . O. .N .T . A. I.N . E. R. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. P. .T .E .R . .1 .. .R . E. D. . H. A. .T . J. B. .O .S . S. .F .U . S. E. . O. .V .E . R. V. .I E. W. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1. RED HAT JBOSS FUSE CONTAINER ARCHITECTURE 5
1.2. DEPLOYMENT MODELS 6
1.3. DEPENDENCY INJECTION FRAMEWORKS 8
1.4. SYNCHRONOUS COMMUNICATION 10
1.5. ASYNCHRONOUS COMMUNICATION 11
1.6. FUSE FABRIC 12
.C .H . A. P. .T .E .R . .2 .. .D . E. P. E. .N .D . E. N. .C . Y. .I N. .J .E .C . T. I.O . N. .F . R. A. .M . E. W. . O. R. .K . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.1. SPRING AND BLUEPRINT FRAMEWORKS 14
2.2. HOT DEPLOYMENT 16
2.3. USING OSGI CONFIGURATION PROPERTIES 18
.C .H . A. P. .T .E .R . .3 .. .B . U. I.L .D . I.N . G. .W . .I T. H. . M. .A .V . E. N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1. MAVEN DIRECTORY STRUCTURE 21
3.2. PREPARING TO USE MAVEN 23
.C .H . A. P. .T .E .R . .4 .. .L .O . C. .A .T .I N. .G . .A .R . T. I.F .A . C. .T .S . W. . I.T .H . .M . A. V. .E .N . .A .N . D. .H . T. T. P. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 .8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1. LOCATING HTTP ARTIFACTS 28
4.2. LOCATING MAVEN ARTIFACTS AT BUILD TIME 29
4.3. LOCATING MAVEN ARTIFACTS AT RUN TIME 31
.P .A . R. T. .I I.. .O . S. .G .I .B . U. .N .D . L. E. .D . E. P. .L .O . Y. M. .E . N. T. .M . O. .D . E. L. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. P. .T .E .R . .5 .. .I N. .T .R .O . D. .U .C . T. I.O . N. . T. O. . O. S. .G . I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.1. RED HAT JBOSS FUSE 47
5.2. OSGI FRAMEWORK 49
5.3. OSGI SERVICES 50
5.4. OSGI BUNDLES 52
.C .H . A. P. .T .E .R . .6 .. .B . U. I.L .D . I.N . G. .A . N. . O. S. .G . I. B. U. .N .D . L. E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1. GENERATING A BUNDLE PROJECT 54
6.2. MODIFYING AN EXISTING MAVEN PROJECT 55
6.3. PACKAGING A WEB SERVICE IN A BUNDLE 57
6.4. CONFIGURING THE BUNDLE PLUG-IN 59
.C .H . A. P. .T .E .R . .7 .. .D . E. P. L. .O .Y . I.N .G . .A . N. .O . S. .G .I .B . U. .N .D . L. E. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1. HOT DEPLOYMENT 65
7.2. MANUAL DEPLOYMENT 65
7.3. LIFECYCLE MANAGEMENT 67
7.4. TROUBLESHOOTING DEPENDENCIES 70
.C .H . A. P. .T .E .R . .8 .. .D . E. P. L. .O .Y . I.N .G . .F .E . A. T. .U .R . E. S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.1. CREATING A FEATURE 73
8.2. DEPLOYING A FEATURE 77
.C .H . A. P. .T .E .R . .9 .. .D . E. P. L. .O .Y . I.N .G . .A . .P .L .A . I.N . .J .A .R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1. BUNDLE TOOL (BND) 82
9.2. CONVERTING A JAR USING BND 83
9.3. CONVERTING A JAR USING THE WRAP SCHEME 87
.C .H . A. P. .T .E .R . .1 .0 .. .O . S. G. .I .B . U. N. .D .L . E. .T .U . T. O. .R .I A. .L .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.1. GENERATING AND RUNNING AN EIP BUNDLE 89
1
Red Hat JBoss Fuse 6.3 Deploying into Apache Karaf
10.2. GENERATING AND RUNNING A WEB SERVICES BUNDLE 91
.P .A . R. T. .I I.I .. W. . A. R. . D. .E .P .L . O. Y. .M . E. N. .T . M. .O . D. E. .L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 .5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. P. .T .E .R . .1 .1 .. .B . U. I.L .D . I.N . G. .A . .W . A. .R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.1. MODIFYING AN EXISTING MAVEN PROJECT 96
11.2. BOOTSTRAPPING A CXF SERVLET IN A WAR 99
11.3. BOOTSTRAPPING A SPRING CONTEXT IN A WAR 100
.C .H . A. P. .T .E .R . .1 .2 .. .D . E. P. L. .O .Y . I.N .G . .A . .W . A. .R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .0 .2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12.1. CONVERTING THE WAR USING THE WAR SCHEME 102
12.2. CONFIGURING THE WEB CONTAINER 104
.P .A . R. T. .I V. .. .C .D . I. D. .E .P .L . O. Y. .M . E. N. .T . M. .O . D. E. .L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .0 .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. P. .T .E .R . .1 .3 .. .C . O. N. .T .E . X. T. S. . A. N. .D . D. .E .P . E. N. .D . E. N. .C .Y . .I N. J. E. .C .T .I O. .N . .( C. .D .I ). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .0 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13.1. INTRODUCTION TO CDI 107
13.2. USE CDI 107
.C .H . A. P. .T .E .R . .1 .4 .. .P .A . X. .C . D. .I .A .N . D. .O . S. .G .I .S . E. R. .V .I C. .E .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .2 .6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14.1. PAX CDI ARCHITECTURE 126
14.2. ENABLING PAX CDI 127
14.3. OSGI SERVICES EXTENSION 130
.C .H . A. P. .T .E .R . .1 .5 .. .C . A. M. .E . L. .C .D . I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .3 .4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.1. BASIC FEATURES 134
15.2. CAMEL BEAN INTEGRATION 142
15.3. CDI EVENTS IN CAMEL 144
15.4. OSGI INTEGRATION 147
.P .A . R. T. .V . .. O. .S .G . I. S. E. .R .V . I.C .E . .L .A .Y . E. R. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .4 .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.C .H . A. P. .T .E .R . .1 .6 .. .O . S. G. .I .S .E . R. V. .I C. E. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .5 .0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.1. THE BLUEPRINT CONTAINER 150
16.2. PUBLISHING AN OSGI SERVICE 166
16.3. ACCESSING AN OSGI SERVICE 170
16.4. INTEGRATION WITH APACHE CAMEL 174
.C .H . A. P. .T .E .R . .1 .7 .. .J .M . S. .B . R. .O .K . E. R. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .7 .7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.1. WORKING WITH THE DEFAULT BROKER 177
17.2. JMS ENDPOINTS IN A ROUTER APPLICATION 178
.A .P . P. E. N. .D . I.X . A. .. .U .R . L. .H . A. N. .D .L . E. R. .S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .8 .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A.1. FILE URL HANDLER 183
A.2. HTTP URL HANDLER 183
A.3. MVN URL HANDLER 183
A.4. WRAP URL HANDLER 186
A.5. WAR URL HANDLER 188
.A .P . P. E. N. .D . I.X . B. .. .O .S . G. .I .B .E . S. T. .P . R. A. .C .T . I.C .E . S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .9 .1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B.1. OSGI TOOLING 191
B.2. BUILDING OSGI BUNDLES 192
B.3. SAMPLE POM FILE 198
.I N. D. .E .X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .9 .9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
Table of Contents
3
Red Hat JBoss Fuse 6.3 Deploying into Apache Karaf
PART I. THE RED HAT JBOSS FUSE CONTAINER
Abstract
The Red Hat JBoss Fuse container is a flexible container that supports a variety of different
deployment models: OSGi bundle deployment and WAR deployment. The container is also
integrated with Apache Maven, so that required artifacts can be downloaded and installed
dynamically at deploy time.
4
CHAPTER 1. RED HAT JBOSS FUSE OVERVIEW
CHAPTER 1. RED HAT JBOSS FUSE OVERVIEW
Abstract
Red Hat JBoss Fuse is a flexible container that allows you to deploy applications in a range of
different package types (WAR or OSGi bundle) and has support for both synchronous and
asynchronous communication.
1.1. RED HAT JBOSS FUSE CONTAINER ARCHITECTURE
Overview
Figure 1.1, “Red Hat JBoss Fuse Container Architecture” shows a high-level overview of the Red
Hat JBoss Fuse container architecture, showing the variety of deployment models that are
supported.
Figure 1.1. Red Hat JBoss Fuse Container Architecture
e R
l A
d
W
n
u
B
Deployment models
Red Hat JBoss Fuse is a multi-faceted container that supports a variety of deployment models. You
can deploy any of the following kinds of deployment unit:
OSGi bundle
An OSGi bundle is a JAR file augmented with metadata in the JAR's META-
INF/MANIFEST.MF file. Because the Red Hat JBoss Fuse container is fundamentally an
OSGi container, the OSGi bundle is also the native format for the container. Ultimately, after
deployment, all of the other deployment unit types are converted into OSGi bundles.
WAR
A Web application ARchive (WAR) is the standard archive format for applications that run
inside a Web server. As originally conceived by the Java servlet specification, a WAR
packages Web pages, JSP pages, Java classes, servlet code, and so on, as required for a
typical Web application. More generally, however, a WAR can be any deployment unit that
5
Red Hat JBoss Fuse 6.3 Deploying into Apache Karaf
obeys the basic WAR packaging rules (which, in particular, require the presence of a Web
application deployment descriptor, web.xml).
Spring framework
The Spring framework is a popular dependency injection framework, which is fully integrated into the
JBoss Fuse container. In other words, Spring enables you to create instances of Java objects and
wire them together by defining a file in XML format. In addition, you can also access a wide variety
of utilities and services (such as security, persistence, and transactions) through the Spring
framework.
Blueprint framework
The blueprint framework is a dependency injection framework defined by the OSGi Alliance. It is
similar to Spring (in fact, it was originally sponsored by SpringSource), but is a more lightweight
framework that is optimized for the OSGi environment.
OSGi core framework
At its heart, Red Hat JBoss Fuse is an OSGi container, based on Apache Karaf, whose architecture
is defined by the OSGi Service Platform Core Specification (available from
http://www.osgi.org/Release4/Download). OSGi is a flexible and dynamic container, whose
particular strengths include: sophisticated management of version dependencies; sharing libraries
between applications; and support for dynamically updating libraries at run time (hot fixes).
For more details about the OSGi framework, see Chapter 5, Introduction to OSGi.
Red Hat JBoss Fuse kernel
The JBoss Fuse kernel extends the core framework of OSGi, adding features such as the runtime
console, administration, logging, deployment, provisioning, management, and so on. For more
details, see Section 5.1, “Red Hat JBoss Fuse”.
1.2. DEPLOYMENT MODELS
09/27/12
Reordered to make OSGi more prominent
Overview
Although Red Hat JBoss Fuse is an OSGi container at heart, it supports a variety of different
deployment models. You can think of these as virtual containers, which hide the details of the OSGi
framework. In this section we compare the deployment models to give you some idea of the
weaknesses and strengths of each model.
Table 1.1, “Alternative Deployment Packages” shows an overview of the package types associated
with each deployment model.
6