Preface.
1. Introduction.
The Internet and the Networked Home.
The Service Gateway.
Challenges.
A Multitude of Competing Solutions.
A New Application Environment.
Java Embedded Server.
The Open Services Gateway Initiative.
The Operational Model of OSGi.
2. Getting Started.
Setting up Java Embedded Server.
The 'Home, Sweet Home' Bundle.
Running the Bundle.
Getting Help.
The JES Cache Directory.
The Bundle Base URL.
Brief Summary of the Major Commands.
3. Architecture and Basic Concepts.
Motivation.
Architecture.
Service.
Bundle.
A Bundle Is a Packaging Vehicle.
A Bundle Is a Functional Module.
The 'Hooks' to the Framework.
The Framework.
Bundle Context.
Cooperation among Bundles and Services.
Exporting and Importing Packages.
Registering and Obtaining Services.
Package versus Service Dependency.
Life within the Framework.
Installing a Bundle.
Starting the Bundle.
Importing Packages and Getting Services.
Handling the Dynamic Service Dependency.
Updating a Bundle.
Stopping and Uninstalling a Bundle.
The Component-based Model.
Forget CLASSPATH.
4. Developing Bundles.
Writing Service Bundles.
Same Service Interface, Different Implementations.
Packaging Options.
Retrieving Resources from within the Bundle. Obtaining and Calling Registered Services.
Inter-Bundle Dependency and Class Loading Issues.
Service Use Count.
Compiling Client Bundles.
Service Factory.
Producing a Customized Service for Each Client Bundle.
Service Cache.
Customization for Getting and Releasing Service.
Relevant org.osgi.framework APIs.
BundleContext Interface.
ServiceReference Interface.
ServiceRegistration Interface.
Library BundleS.
Nested JARs.
Advanced Examples.
A Mailer.
An LPD Print Service.
Writing Bundles that Contain Native Code.
Common Mistakes.
5. Cooperation among Service Bundles.
Event Handling.
Bundle State and Service Registration.
Synchronous and Asynchronous Events.
Dealing with Service Unregistration.
Don't Start without the Service.
Discovering Stale Service.
Carrying on without the Service.
Picking an Alternative.
Cascading Service Registration.
Refusing to Service.
Cooperation with Asynchronous Events.
6. Design Patterns and Pitfalls.
Designing the Service.
Separating Service Interface and Implementation.
Challenges in Designing a Service Interface.
Approaching an Interface Design.
The Social Aspect.
Designing Library Bundles.
Delegation and Callback.
Leveraging the Service Registry.
Threading.
Preventing Runaway Threads.
Writing a Multithreaded Server Bundle.
Using a Thread Pool.
Managing Object Allocation.
Nullify References after Use.
Managing References among Bundles.
7. Standard Services.
The Log Service.
Using LogService to Write Logs.
Using LogReaderService to Get Logs.
Performing Persistent Logging.
The HTTP Service.
The Standard HttpService.
Performing Basic Authentication.
The JES HTTP Service.
8. Device Access.
Introduction.
The Software Stack in Device Access.
What DA Is Not.
Motivation.
Cast of Characters.
Device Service.
Driver Services.
Driver Locator.
Device Manager.
Writing DA Services.
The Base Driver.
Device Detection.
Device Refinement.
The Reconfiguration Process.
Putting It Together.
9. Permission-based Security and Administration.
The Permission-based Security Inside Java 2 Platform.
Code Source.
Permission.
Policy.
Granting Permissions to Classes.
Security Manager.
The OSGi Permissions.
AdminPermission.
ServicePermission.
PackagePermission.
Permission Required by the Framework APIs
Running JES with Security Enabled.
Setting Up a Policy.
Enabling Security for JES.
Using Permissions in Your Service.
Checking Permissions.
Performing Privileged Actions.
Creating Your Own Permission Types.
Administration.
Resolving Bundles Dynamically.
Relevant APIs.
10. Future Directions.
Removing Phantom BundleS.
Dynamic PermissionS.
Preferences.
User AdministratioN.
Configuration ManagemenT.
What's Next...
Appendix A Code Examples.
Chapter 4. Developing Bundles.
The LPD Print Service.
Chapter 8. Device Access.
Serial Service and Driver Locator.
Driver Service and Modem Service.
Web Interface to the Serial Ports.
Chapter 9 Permission-based Security and Administration.
Parameter Services.
Parameter Configuration Servlet.
Facilitator.
Bibliography.
Index.
