Next
Virgo Programmer Guide
Ramnivas
Laddad
Colin
Yates
Sam
Brannen
Rob
Harrop
Christian
Dupuis
Andy
Wilkinson
Glyn
Normington
Steve
Powell
Christopher
Frost
3.5.0
Copyright © 2011 VMware Inc.
Table of Contents
Preface
1. Prerequisites
Runtime Environment
References
2. Introduction to the Virgo Server for Apache Tomcat
Overview
What is the Virgo Server for Apache Tomcat?
What Makes up the Virgo Server for Apache Tomcat?
Why the Virgo Server for Apache Tomcat?
Deployment Options and Migration Paths
Simplified Development and Deployment of OSGi-based Applications
Enhanced Diagnostics During Deployment and in Production
3. Deployment Architecture
Supported Deployment Formats
Raw OSGi Bundles
WAR Deployment Formats
PAR
Plans
Configurations
Dependency Types
Regions
A Guide to Forming Bundles
4. Developing Applications
Anatomy of a Bundle
Creating PARs and Web Applications
PARs
Web Application Bundles
Creating Plans
Creating the Plan XML File
Artifact Names
Supplying Properties to Artifacts
Using the Plan
Plans and Scoping
Creating and Using Configuration Artifacts
Creating the Properties File
Updating Your Application
Adding the Configuration Artifact to a Plan
Using Spring, Spring DM, and Blueprint
Programmatic Access to the Servlet Context
Programmatic Access to Web Features
Web Application Manifest Processing
Working with Dependencies
Importing Libraries
Importing Bundles
Scoping Bundles in an Application
Defining Libraries
Installing Dependencies
Application Trace
Application Versioning
5. Migrating to OSGi
Migrating Web Applications
Standard WAR
Shared Libraries WAR
Shared Services WAR
Web Migration Summary
Migrating to a Plan or a PAR
Creating the Application Bundles
Plan or PAR?
6. Migrating Form Tags
Overview of the Form Tags Sample Application
Form Tags WAR
Form Tags Shared Libraries WAR
Form Tags Shared Services WAR
The Service Bundle
Accessing the Service and Types from the WAR
Form Tags PAR
Granularity of the PAR
Domain and Service Bundles
Constructing the PAR
Summary of the Form Tags Migration
Form Tags as a Plan
7. Common Libraries
Working with Hibernate
Importing Hibernate
Working with DataSources
Weaving and Instrumentation
JSP Tag Libraries
8. Known Issues
JPA Entity Scanning
ClassNotFoundError
When Creating a Proxy
Creating proxies with CGLIB for Package Protected Types
Virgo Jetty Server Restrictions
Virgo Server for Apache Tomcat Restrictions
Default Web Application Bundle Headers
Hibernate Resolution Issue
Scoping and Substitutable Exports
EclipseLink Resolution Issue