| <html> |
| <head> |
| <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <title>Virgo Programmer Guide</title> |
| <meta content="DocBook XSL Stylesheets V1.76.0" name="generator"> |
| <link rel="home" href="index.html" title="Virgo Programmer Guide"> |
| <link rel="next" href="pr01.html" title="Preface"> |
| </head> |
| <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" |
| alink="#0000FF"> |
| <div class="navheader"> |
| <table summary="Navigation header" width="100%"> |
| <tr> |
| <td align="left" width="20%"> </td> |
| <th align="center" width="60%"> </th> |
| <td align="right" width="20%"> <a accesskey="n" |
| href="pr01.html">Next</a></td> |
| </tr> |
| </table> |
| <hr> |
| </div> |
| <div class="book" title="Virgo Programmer Guide"> |
| <div class="titlepage"> |
| <div> |
| <div> |
| <h1 class="title"> |
| <a name="N10001"></a>Virgo Programmer Guide |
| </h1> |
| </div> |
| <div> |
| <div class="authorgroup"> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Ramnivas</span> <span class="surname">Laddad</span> |
| </h3> |
| </div> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Colin</span> <span class="surname">Yates</span> |
| </h3> |
| </div> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Sam</span> <span class="surname">Brannen</span> |
| </h3> |
| </div> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Rob</span> <span class="surname">Harrop</span> |
| </h3> |
| </div> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Christian</span> <span class="surname">Dupuis</span> |
| </h3> |
| </div> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Andy</span> <span class="surname">Wilkinson</span> |
| </h3> |
| </div> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Glyn</span> <span class="surname">Normington</span> |
| </h3> |
| </div> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Steve</span> <span class="surname">Powell</span> |
| </h3> |
| </div> |
| <div class="author"> |
| <h3 class="author"> |
| <span class="firstname">Christopher</span> <span class="surname">Frost</span> |
| </h3> |
| </div> |
| </div> |
| </div> |
| <div> |
| <p class="releaseinfo">3.5.0</p> |
| </div> |
| <div> |
| <div class="legalnotice" title="Legal Notice"> |
| <a name="N10049"></a> |
| <p>Copyright © 2011 VMware Inc.</p> |
| </div> |
| </div> |
| </div> |
| <hr> |
| </div> |
| <div class="toc"> |
| <p> |
| <b>Table of Contents</b> |
| </p> |
| <dl> |
| <dt> |
| <span class="preface"><a href="pr01.html">Preface</a></span> |
| </dt> |
| <dt> |
| <span class="chapter"><a href="ch01.html">1. |
| Prerequisites</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch01.html#prerequisites-environment">Runtime |
| Environment</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch01s02.html">References</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="chapter"><a href="ch02.html">2. |
| Introduction to the Virgo Server for Apache Tomcat</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch02.html#introduction-preface">Overview</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch02s02.html">What is |
| the Virgo Server for Apache Tomcat?</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch02s02.html#introduction-constituents">What Makes |
| up the Virgo Server for Apache Tomcat?</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch02s03.html">Why the |
| Virgo Server for Apache Tomcat?</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch02s03.html#introduction-unified-deployment">Deployment |
| Options and Migration Paths</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch02s03.html#introduction-simplified-deployment">Simplified |
| Development and Deployment of OSGi-based Applications</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch02s03.html#introduction-diagnostics">Enhanced |
| Diagnostics During Deployment and in Production</a></span> |
| </dt> |
| </dl> |
| </dd> |
| </dl> |
| </dd> |
| <dt> |
| <span class="chapter"><a href="ch03.html">3. Deployment |
| Architecture</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch03.html#architecture-deployment-formats">Supported |
| Deployment Formats</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch03.html#architecture-raw-osgi-bundles">Raw OSGi |
| Bundles</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch03.html#architecture-wars">WAR Deployment Formats</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch03.html#architecture-pars">PAR</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch03.html#architecture-plans">Plans</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch03.html#architecture-configurations">Configurations</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch03s02.html">Dependency |
| Types</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch03s03.html">Regions</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch03s04.html">A Guide |
| to Forming Bundles</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="chapter"><a href="ch04.html">4. Developing |
| Applications</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch04.html#developing-applications-bundle">Anatomy of a |
| Bundle</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch04s02.html">Creating |
| PARs and Web Applications</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch04s02.html#developing-applications-packaging-par">PARs</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s02.html#developing-applications-web-application-bundles">Web |
| Application Bundles</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch04s03.html">Creating |
| Plans</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch04s03.html#developing-applications-plans-create">Creating |
| the Plan XML File</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s03.html#names-of-artifacts">Artifact Names</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s03.html#passing-properties">Supplying |
| Properties to Artifacts</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s03.html#developing-applications-plans-use">Using |
| the Plan</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s03.html#developing-applications-plans-scoping">Plans |
| and Scoping</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch04s04.html">Creating |
| and Using Configuration Artifacts</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch04s04.html#developing-applications-configuration-artifacts-propfile">Creating |
| the Properties File</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s04.html#developing-applications-configuration-artifacts-app">Updating |
| Your Application</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s04.html#developing-applications-configuration-artifacts-plan">Adding |
| the Configuration Artifact to a Plan</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch04s05.html">Using |
| Spring, Spring DM, and Blueprint</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch04s06.html">Programmatic |
| Access to the Servlet Context</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch04s06.html#developing-applications-programmatic-access-web">Programmatic |
| Access to Web Features</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch04s07.html">Web |
| Application Manifest Processing</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch04s08.html">Working |
| with Dependencies</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch04s08.html#developing-applications-importing-libraries">Importing |
| Libraries</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s08.html#developing-applications-importing-bundles">Importing |
| Bundles</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s08.html#developing-applications-scoping-libraries-bundles">Scoping |
| Bundles in an Application</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s08.html#developing-applications-defining-libraries">Defining |
| Libraries</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch04s08.html#developing-applications-installing-dependencies">Installing |
| Dependencies</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch04s09.html">Application |
| Trace</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch04s10.html">Application |
| Versioning</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="chapter"><a href="ch05.html">5. Migrating |
| to OSGi</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch05.html#migrating-to-osgi-web">Migrating Web |
| Applications</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch05.html#migrating-to-osgi-web-standard-war">Standard |
| WAR</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch05.html#migrating-to-osgi-web-shared-libraries-war">Shared |
| Libraries WAR</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch05.html#migrating-to-osgi-web-shared-services-war">Shared |
| Services WAR</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch05.html#migrating-to-osgi-web-summary">Web |
| Migration Summary</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch05s02.html">Migrating |
| to a Plan or a PAR</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch05s02.html#migrating-to-osgi-parplan-bundles">Creating |
| the Application Bundles</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch05s02.html#migrating-to-osgi-parplan-decide">Plan |
| or PAR?</a></span> |
| </dt> |
| </dl> |
| </dd> |
| </dl> |
| </dd> |
| <dt> |
| <span class="chapter"><a href="ch06.html">6. Migrating |
| Form Tags</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch06.html#formtags-case-study-introduction">Overview |
| of the Form Tags Sample Application</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch06s02.html">Form Tags |
| WAR</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch06s03.html">Form Tags |
| Shared Libraries WAR</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch06s04.html">Form Tags |
| Shared Services WAR</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch06s04.html#formtags-case-study-war-shared-services-service">The |
| Service Bundle</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch06s04.html#formtags-case-study-war-shared-services-war">Accessing |
| the Service and Types from the WAR</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch06s05.html">Form Tags |
| PAR</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch06s05.html#formtags-case-study-par-granularity">Granularity |
| of the PAR</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch06s05.html#formtags-case-study-par-domain-and-service">Domain |
| and Service Bundles</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a |
| href="ch06s05.html#formtags-case-study-par-par">Constructing |
| the PAR</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch06s06.html">Summary |
| of the Form Tags Migration</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch06s07.html">Form Tags |
| as a Plan</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="chapter"><a href="ch07.html">7. Common |
| Libraries</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch07.html#common-libraries-hibernate">Working with |
| Hibernate</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a |
| href="ch07.html#common-libraries-hibernate-import">Importing |
| Hibernate</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="section"><a href="ch07s02.html">Working |
| with DataSources</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch07s03.html">Weaving |
| and Instrumentation</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch07s04.html">JSP Tag |
| Libraries</a></span> |
| </dt> |
| </dl> |
| </dd> |
| <dt> |
| <span class="chapter"><a href="ch08.html">8. Known |
| Issues</a></span> |
| </dt> |
| <dd> |
| <dl> |
| <dt> |
| <span class="section"><a href="ch08.html#known-issues-jpa">JPA |
| Entity Scanning</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch08s02.html"><code |
| class="classname">ClassNotFoundError</code> When Creating a |
| Proxy</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch08s03.html">Creating |
| proxies with CGLIB for Package Protected Types</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch08s04.html">Virgo |
| Jetty Server Restrictions</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch08s05.html">Virgo |
| Server for Apache Tomcat Restrictions</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch08s06.html">Default |
| Web Application Bundle Headers</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch08s07.html">Hibernate |
| Resolution Issue</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch08s08.html">Scoping |
| and Substitutable Exports</a></span> |
| </dt> |
| <dt> |
| <span class="section"><a href="ch08s09.html">EclipseLink |
| Resolution Issue</a></span> |
| </dt> |
| </dl> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| <div class="navfooter"> |
| <hr> |
| <table summary="Navigation footer" width="100%"> |
| <tr> |
| <td align="left" width="40%"> </td> |
| <td align="center" width="20%"> </td> |
| <td align="right" width="40%"> <a accesskey="n" |
| href="pr01.html">Next</a></td> |
| </tr> |
| </table> |
| </div> |
| </body> |
| </html> |
