Pro SpringSource dm Server™

290 Pages·2009·8.32 MB·English

by  Gary Mak

CYAN YELLOW
MAGENTA BLACK
PANTONE 123 C
BOOKS FOR PROFESSIONALS BY PROFESSIONALS® THE EXPERT’S VOICE® IN OPEN SOURCE
Companion
eBook
Available CCoovveerrss
Pro SpringSource dm Server™ SSpprriinnggSSoouurrccee
ddmm SSeerrvveerrTTMM22
Pro
Dear Reader,
Pro
The SpringSource dm Server™ is a new-generation Java™ application server S
based on the OSGi™ Service Platform, a technology specifically designed for
p
building dynamic and modular systems. OSGi brings great benefits by itself,
but the dm Server adds even more value by extending it and integrating it with r
other technologies that you need to build enterprise Java applications. The dm i
n SpringSource
Server 2 is a complete solution that brings the advantages of OSGi to Java EE
application development, packaging, and deployment. g
As a Java EE application developer, you may have become used to packaging
S
and deploying a modular and layered application in a single archive file. When
taking that approach, however, you’ve had to repackage, redeploy, and restart o
the entire application, including all of its modules, whenever you’ve updated u
even a single module. We’ll show you how to change to a more efficient process
dm Server
r
by using OSGi and the dm Server. ™
c
Pro SpringSource dm Server™ covers both application development and
system administration with the dm Server 2. It also introduces OSGi and Spring- e
DM, a Spring Portfolio project that brings the Spring Framework’s advantages to
OSGi, thus giving you the necessary background knowledge for learning about d
the dm Server. Each topic related to application development is introduced m
through a complete real-world example that you can follow step-by-step, with
an appropriate development environment set up. You will learn how the modu-

lar and dynamic capabilities of OSGi and the dm Server can bring you greater S
success in your project development and deployment.
e
Enjoy learning to use the exciting OSGi technology and the dm Server!
r
Gary Mak v Learn to use the core power of this OSGi™-based Java™
Daniel Rubio e application server through examples!
r
™
Companion eBook
THEAPRESS ROADMAP
Pro Flex on Spring
Pro Spring 2.5
Pro SpringSource
See last page for details Beginning Spring dm Server™
on $10 eBook version
Pro Spring Dynamic
Spring Recipes Modules for OSGi(tm)
Service Platforms
Gary Mak, Daniel Rubio
SOURCE CODE ONLINE
ISBN 978-1-4302-1640-7
www.apress.com R
53999 uM
b
a
iok
US $39.99
Shelve in
Java Programming
User level: 9 781430 216407
Intermediate–Advanced
this print for content only—size & color not accurate spine = 0.65625" 288 page count

Pro SpringSource dm
Server™

■ ■ ■
Gary Mak, Daniel Rubio
Pro SpringSource dm Server™
Copyright © 2009 by Gary Mak, Daniel Rubio
All rights reserved. No part of this work may be reproduced or transmitted in any form or
by any means, electronic or mechanical, including photocopying, recording, or by any
information storage or retrieval system, without the prior written permission of the
copyright owner and the publisher.
ISBN-13 (pbk): 978-1-4302-(cid:17)(cid:22)(cid:20)(cid:16)(cid:13)(cid:23)
ISBN-13 (electronic): 978-1-4302-1(cid:22)4(cid:17)-(cid:20)
Printed and bound in the United States of America 9 8 7 6 5 4 3 2 1
Trademarked names may appear in this book. Rather than use a trademark symbol with
every occurrence of a trademarked name, we use the names only in an editorial fashion
and to the benefit of the trademark owner, with no intention of infringement of the
trademark.
SpringSource is the company behind Spring, the de facto standard in enterprise Java.
SpringSource is a leading provider of enterprise Java infrastructure software and delivers
enterprise-class software, support, and services to help organizations utilize Spring. The
open source-based Spring Portfolio is a comprehensive enterprise application framework
designed on long-standing themes of simplicity and power. With more than five million
downloads to date, Spring has become an integral part of the enterprise application
infrastructure at organizations worldwide. For more information, visit
www.springsource.com.
Lead Editors: Steve Anglin, Tom Welsh
Technical Reviewers: Oleg Zhurakousky, Manuel Jordan
Editorial Board: Clay Andres, Steve Anglin, Mark Beckner, Ewan Buckingham, Tony
Campbell, Gary Cornell, Jonathan Gennick, Jonathan Hassell, Michelle Lowman,
Matthew Moodie, Jeffrey Pepper, Frank Pohlmann, Douglas Pundick, Ben Renow-
Clarke, Dominic Shakeshaft, Matt Wade, Tom Welsh
Project Manager: Kylie Johnston
Copy Editor: James A. Compton
Associate Production Director: Kari Brooks-Copony
Compositor: Bookmakers
Indexer: BIM Indexing
Cover Designer: Anna Ishchenko
Manufacturing Director: Tom Debolski
Distributed to the book trade worldwide by Springer New York, Inc., 233 Spring Street,
6th Floor, New York, NY 10013. Phone 1-800-SPRINGER, fax [phone], e-mail orders-
[email protected], or visit http://www.springeronline.com.
ii
For information on translations, please contact Apress directly at 233 Spring Street, New
York, NY 10013. E-mail [email protected], or visit http://www.apress.com.
Apress and friends of ED books may be purchased in bulk for academic, corporate, or
promotional use. eBook versions and licenses are also available for most titles. For more
information, reference our Special Bulk Sales–eBook Licensing web page at
http://www.apress.com/info/bulksales.
The information in this book is distributed on an “as is” basis, without warranty.
Although every precaution has been taken in the preparation of this work, neither the
author(s) nor Apress shall have any liability to any person or entity with respect to any
loss or damage caused or alleged to be caused directly or indirectly by the information
contained in this work.
The source code for this book is available to readers at http://www.apress.com.
iii
FMDedicationtext.
iv
Contents at a Glance
Contents at a Glance............................................................................................................v
Contents..............................................................................................................................vii
About the Technical Reviewer..........................................................................................xiv
Acknowledgments.............................................................................................................xvi
Introduction.......................................................................................................................xix
■Chapter 1: Introduction to OSGi......................................................................................1
■Chapter 2: Developing Bundles with Spring Dynamic Modules................................57
■Chapter 3: Introduction to the dm Server.....................................................................85
■Chapter 4: Getting Started with the dm Server...........................................................105
■Chapter 5: Developing Applications for the dm Server............................................131
■Chapter 6: Migrating Web Applications to the dm Server........................................191
■Chapter 7: Tracing Applications on the dm Server...................................................219
■Chapter 8: Managing Application Growth on the dm Server....................................237
v
vi
Contents
Contents at a Glance............................................................................................................v
Contents..............................................................................................................................vii
About the Technical Reviewer..........................................................................................xiv
Acknowledgments.............................................................................................................xvi
Introduction.......................................................................................................................xix
■Chapter 1: Introduction to OSGi......................................................................................1
Setting Up the Development Environment..................................................................................................1
Installing JDK.............................................................................................................................................1
Installing Eclipse or SpringSource Tools Suite (STS)..............................................................................2
Why You Need OSGi.......................................................................................................................................3
Creating a System with Multiple Modules...............................................................................................3
Problems When Updating the System...................................................................................................11
Introducing OSGi..........................................................................................................................................12
Introducing OSGi Bundles......................................................................................................................12
Introducing OSGi Containers.................................................................................................................15
Developing OSGi Bundles............................................................................................................................15
Creating the Report Bundle....................................................................................................................15
Creating the Export Bundle....................................................................................................................19
Creating the Ranking Bundle..................................................................................................................21
Creating the Stock Bundle......................................................................................................................24
vii
Deploying OSGi Bundles..............................................................................................................................25
Starting Equinox in Eclipse.....................................................................................................................25
Starting Equinox from the Command Line...........................................................................................26
Exporting Bundles in the Deployable Format.......................................................................................27
Using Commands in the Equinox OSGi Console..................................................................................28
Versioning Packages in Bundles..................................................................................................................32
Developing OSGi Services............................................................................................................................36
Registering an OSGi Service....................................................................................................................37
Consuming an OSGi Service...................................................................................................................38
Switching Between OSGi Service Implementations.............................................................................43
Tracking OSGi Services...........................................................................................................................48
Enterprise OSGi............................................................................................................................................54
Summary.......................................................................................................................................................55
■Chapter 2: Developing Bundles with Spring Dynamic Modules................................57
Introduction to Spring-DM..........................................................................................................................57
The Major Features of Spring-DM.........................................................................................................58
OSGi Bundles and Spring Application Contexts...................................................................................59
Application Contexts of an Enterprise Application..............................................................................59
Application Contexts of Bundles............................................................................................................59
The Spring-DM Extender Bundle...........................................................................................................60
Exporting and Importing OSGi Services................................................................................................60
Exporting a Spring Bean as an OSGi Service.........................................................................................61
Importing an OSGi Service Reference as a Spring Bean.......................................................................61
Setting Up Spring-DM..................................................................................................................................61
Downloading and Installing Spring-DM...............................................................................................61
Installing Spring-DM Bundles to the OSGi Container..........................................................................62
Configuring Logging for Spring-DM......................................................................................................67
Creating Bundles Using Spring-DM............................................................................................................70
Creating the Bundle Interfaces and Classes..........................................................................................70
Creating the Rate Interface Bundle........................................................................................................70
Creating the Fixed-Rate Implementation Bundle.................................................................................71
Creating the Interest Interface Bundle..................................................................................................72
viii