OSGi in Action source code examples

Requirements:

Java SDK (1.5 or later http://java.sun.com/javase/downloads/index.jsp) Apache Ant (1.7 or later http://ant.apache.org/bindownload.cgi)

Contents:

chapter01

• greeting-example - "Hello, world" using each OSGi layer in turn

chapter02

• paint-nonmodular - Original non-OSGi paint application

• paint-modular - Painting with modularity

chapter03

• shell-example - Remote shell example (telnet 127.0.0.1 7070)

• paint-example - Painting with lifecycles (extender pattern)

chapter04

• dynamics - Examples & counter-examples of handling services

• paint-example - Painting with services (whiteboard pattern)

chapter05

• paint-example - Painting with advanced modularity

chapter06

• BeanUtils-example - Wrapping BeanUtils

• HttpClient-example - Wrapping HttpClient

• jEdit-example - Migrating jEdit to OSGi

chapter07

• migration-example - Migrating tests to OSGi

• mocking-example - Mocking OSGi APIs

• testing-example - OSGi integration testing

chapter08

• debugging-bundles - Debugging OSGi code

• classloading - Common classloading issues

• memory-leaks - OSGi memory leak example

• dangling-services - Dangling service example

chapter09

• combined-example - Managed shell example

chapter10

• combined-example - Managed paint example

chapter11

• non-component-example - Non-component example

• paint-example-common - Shared component code

• paint-example-ds - Declarative Services example

chapter12

• non-component-example - Non-component example

• paint-example-common - Shared component code

• paint-example-bp - Blueprint example

• paint-example-bp-fragment - Blueprint fragment example

• paint-example-ip - Apache Felix iPOJO example

• paint-example-mixed - Mixed component model example

chapter13

• paint-example - Launching and embedding example

chapter14

• combined-example - Secure paint example

chapter15

• httpservice - Simple servlet example

• pax-web - Advanced JSP example

• gwtapp - OSGi web application (GWT)

• webservice - Remote OSGi service example

• webservice-client - ... client

• webservice-impl - ... distribution provider

Building:

To build all the examples, just type "ant" from the top directory.

Running:

A few examples are packaged as normal Java applications, to run these type

java -jar main.jar

Most examples are packaged as collections of OSGi bundles, to run these type

java -jar launcher.jar bundles

The source for the basic OSGi launcher can be found in the "launcher" directory.

Additional Ant targets:

ant clean - remove all compiled/cached files

ant wipe - remove all generated content

ant dist - build examples (this is the default target)

ant pde - generate Eclipse/PDE project files

Please raise any questions or issues at http://code.google.com/p/osgi-in-action/