[jboss-cvs] JBossAS SVN: r94843 - in projects/jboss-osgi/trunk/distribution: docbook/en/modules and 1 other directories.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Wed Oct 14 05:40:08 EDT 2009 

Author: thomas.diesler at jboss.com
Date: 2009-10-14 05:40:07 -0400 (Wed, 14 Oct 2009)
New Revision: 94843

Added:
   projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-equinox.png
   projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-felix.png
   projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-jbossmc.png
Removed:
   projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-home.png
Modified:
   projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch020-getting-started.xml
   projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch040-framework-integration.xml
   projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch070-provided-bundles.xml
   projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch080-provided-examples.xml
   projects/jboss-osgi/trunk/distribution/installer/src/main/etc/ReleaseNotes.html
Log:
More userguide + Release Notes

Deleted: projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-home.png
===================================================================
(Binary files differ)

Added: projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-equinox.png
===================================================================
(Binary files differ)


Property changes on: projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-equinox.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-felix.png
===================================================================
(Binary files differ)


Property changes on: projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-felix.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-jbossmc.png
===================================================================
(Binary files differ)


Property changes on: projects/jboss-osgi/trunk/distribution/docbook/en/images/hudson-matrix-jbossmc.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Modified: projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch020-getting-started.xml
===================================================================
--- projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch020-getting-started.xml	2009-10-14 07:58:52 UTC (rev 94842)
+++ projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch020-getting-started.xml	2009-10-14 09:40:07 UTC (rev 94843)
@@ -232,14 +232,26 @@
     <para>If in future we should discover a problem with a previous JBoss OSGi release, it will be possible to provide a patch and verify that change using 
     the original QA environment for that release.</para>
      
-    <para>With every release we test the matrix of supported target containers and JDKs.</para>
+    <para>With every release we test the matrix of supported target containers, frameworks and JDKs.</para>
     
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/hudson-home.png" contentwidth="450"/> 
+        <imagedata fileref="images/hudson-matrix-felix.png" contentwidth="450"/> 
       </imageobject>
     </mediaobject>
   
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/hudson-matrix-equinox.png" contentwidth="450"/> 
+      </imageobject>
+    </mediaobject>
+  
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/hudson-matrix-jbossmc.png" contentwidth="450"/> 
+      </imageobject>
+    </mediaobject>
+  
     <emphasis role="bold">Set Hudson Properties</emphasis>
 
     <para>You need to set a few properties, especially these</para>

Modified: projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch040-framework-integration.xml
===================================================================
--- projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch040-framework-integration.xml	2009-10-14 07:58:52 UTC (rev 94842)
+++ projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch040-framework-integration.xml	2009-10-14 09:40:07 UTC (rev 94843)
@@ -134,7 +134,7 @@
   <sect1 xml:id="SecIntegrationEquinox">  
     <title>Equinox Integration</title>
     
-    <para>JBoss OSGi also provides basic integration for the <ulink url="http://www.eclipse.org/equinox">Eclpipse Equinox</ulink> OSGi Framework.</para>
+    <para>JBoss OSGi also provides basic integration for the <ulink url="http://www.eclipse.org/equinox">Eclipse Equinox</ulink> OSGi Framework.</para>
     
     <para>Equinox integration can be configured through properties in the <link linkend="ChapRuntime">JBoss OSGi Runtime</link>.</para>
     

Modified: projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch070-provided-bundles.xml
===================================================================
--- projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch070-provided-bundles.xml	2009-10-14 07:58:52 UTC (rev 94842)
+++ projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch070-provided-bundles.xml	2009-10-14 09:40:07 UTC (rev 94843)
@@ -158,4 +158,39 @@
     
   </sect1>
   
+  <sect1 xml:id="SecHttpService">  
+    <title>HttpService</title>
+    
+    <para>The <emphasis role="bold">pax-web-jetty-bundle.jar</emphasis> bundle from the OPS4J 
+    <ulink url="http://wiki.ops4j.org/display/paxweb/Pax+Web">Pax Web</ulink> project provides access to the 
+    <ulink url="http://www.osgi.org/javadoc/r4v42/org/osgi/service/http/package-frame.html">HttpService</ulink>.</para> 
+    
+    <para>An example of how a bundle uses the HttpService to register servlet and resources is given in 
+    <link linkend="SecHTTPServiceExample">HttpService Example</link>.</para>
+    
+  </sect1>
+  
+  <sect1 xml:id="SecWebAppExtender">  
+    <title>WebApp Extender</title>
+    
+    <para>The <emphasis role="bold">pax-web-extender-war.jar</emphasis> bundle from the OPS4J 
+    <ulink url="http://wiki.ops4j.org/display/paxweb/WAR+Extender">Pax Web</ulink> project provides WAR processing functionality.</para> 
+    
+    <emphasis role="bold">Deploying a WAR onto JBoss OSGi</emphasis>
+    
+    <para>You should have a war file compliant with Servlet specs. Additionally, the war file must have the necessary OSGi manifest headers.</para>
+    
+    <itemizedlist>
+      <listitem><emphasis role="bold">Bundle-ManifestVersion: 2</emphasis> - This header defines that the bundle follows the rules of R4 specification.</listitem>
+      <listitem><emphasis role="bold">Bundle-SymbolicName</emphasis> - This header specifies a unique, non-localizable name for this bundle.</listitem>
+    </itemizedlist>
+
+    <para>There are also a number of other OSGi manifest headers that are processed by the WAR Extender. 
+    Please have a look at <ulink url="http://wiki.ops4j.org/display/paxweb/OSGi-fy+your+WAR">OSGify your WAR</ulink> for details.</para>
+    
+    <para>An example of how a bundle uses the WAR Extender to register servlet and resources is given in 
+    <link linkend="SecWebAppExample">WebApp Example</link>.</para>
+    
+  </sect1>
+  
 </chapter>

Modified: projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch080-provided-examples.xml
===================================================================
--- projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch080-provided-examples.xml	2009-10-14 07:58:52 UTC (rev 94842)
+++ projects/jboss-osgi/trunk/distribution/docbook/en/modules/ch080-provided-examples.xml	2009-10-14 09:40:07 UTC (rev 94843)
@@ -262,7 +262,7 @@
   </sect1>
   
   <sect1 xml:id="SecHTTPServiceExample">  
-    <title>HTTP Service Example</title>
+    <title>HttpService Example</title>
     
     <para>The <emphasis role="bold">example-http.jar</emphasis> bundle contains a Service 
     that registeres a servlet and a resource with the <ulink url="http://www.osgi.org/javadoc/r4v41/org/osgi/service/http/HttpService.html">HttpService</ulink>.
@@ -286,7 +286,7 @@
   </sect1>
   
   <sect1 xml:id="SecWebAppExample">  
-    <title>Web App Example</title>
+    <title>WebApp Example</title>
     
     <para>The <emphasis role="bold">example-webapp.war</emphasis> archive is an OSGi Bundle as well as an Web Application Archive (WAR)
     at the same time. Similar to <link linkend="SecHTTPServiceExample">HTTP Service Example</link> it registers a servlet and resources with 
@@ -315,6 +315,17 @@
     </web-app>
     ]]></programlisting>
     
+    <para>The associated OSGi manifest looks like this.</para>
+
+    <programlisting><![CDATA[
+    Manifest-Version: 1.0
+    Bundle-Name: example-webapp
+    Bundle-ManifestVersion: 2
+    Bundle-SymbolicName: example-webapp
+    Bundle-ClassPath: .,WEB-INF/classes
+    Import-Package: org.osgi.service.http,org.ops4j.pax.web.service,javax.servlet,javax.servlet.http
+    ]]></programlisting>
+    
     <para>The test verifies that we can access the servlet and some resourtces.</para>
 
     <programlisting role="JAVA">

Modified: projects/jboss-osgi/trunk/distribution/installer/src/main/etc/ReleaseNotes.html
===================================================================
--- projects/jboss-osgi/trunk/distribution/installer/src/main/etc/ReleaseNotes.html	2009-10-14 07:58:52 UTC (rev 94842)
+++ projects/jboss-osgi/trunk/distribution/installer/src/main/etc/ReleaseNotes.html	2009-10-14 09:40:07 UTC (rev 94843)
@@ -1,61 +1,78 @@
 <body>
 
+<h2>Release Notes - JBossOSGi-1.0.0.Beta4</h2>
+
 <p>I am happy to announce the release of JBossOSGi-1.0.0.Beta4.</p>
 <p/>
 
-<p>You can download the binary here: <a href="https://sourceforge.net/projects/jboss/files/JBossOSGi/1.0.0.Beta4/jboss-osgi-installer-1.0.0.Beta4.jar">jboss-osgi-installer-1.0.0.Beta3.jar</a></p>
+<p>You can download the binary here: <a href="https://sourceforge.net/projects/jboss/files/JBossOSGi/1.0.0.Beta4/jboss-osgi-installer-1.0.0.Beta4.jar">jboss-osgi-installer-1.0.0.Beta4.jar</a></p>
 <p/>
 
 <p>The release comes with improvements in the following areas</p>
 <p/>
 
 <ul>
-<li>Initial release of our native <a href="http://jbmuc.dyndns.org/jboss-osgi/userguide/html/ChapFrameworkIntegration.html#SecIntegrationJBossMC">JBossMC based OSGi Framework</a>.</li>
-<li>More samples for <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta3/userguide/html/ChapProvidedExamples.html#SecXMLParserServiceExample">SAX/DOM</a>.</li>
-<li>Aggregated online <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta3/apidocs/">API docs</a></li>
+<li>Initial release of our native <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta4/userguide/html/ChapFrameworkIntegration.html#SecIntegrationJBossMC">JBossMC based OSGi Framework</a>.</li>
+<li>Added support for OSGi WebApps using <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta4/userguide/html/ChapProvidedBundles.html#SecWebAppExtender">WebApp Extender</a></li>
+<li>Improved support for the <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta4/userguide/html/ChapProvidedBundles.html#SecHttpService">HttpService</a>.</li>
 </ul>
 <p/>
 
-<p>For details please have a look at the latest version of our <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta3/userguide/html/"><span class="jive-link-external-small">User Guide</span></a>.</p>
+<p>For details please have a look at the latest version of our <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta4/userguide/html/"><span class="jive-link-external-small">User Guide</span></a>.</p>
 <p/>
 
 <p>Here are the change log details</p>
 <p/>
 
-<p><strong>Feature Requests</strong></p>
-<p/>
+<h4>Feature Request</h4>
 <ul>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-93">JBOSGI-93</a>] -         Uninstall bundles on OSGiRuntime.shutdown() </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-98">JBOSGI-98</a>] -         Support configuration per profile </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-102">JBOSGI-102</a>] -         Add support for static Husky context injection </li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-110'>JBOSGI-110</a>] - Support WAR deployments in the OSGi runtime</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-127'>JBOSGI-127</a>] - Provide build and hudson support for MC facade</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-128'>JBOSGI-128</a>] - Add Framework launch API</li>
 </ul>
-<p/>
 
-<p><strong>Tasks</strong></p>
-<p/>
+<h4>Task</h4>
 <ul>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-71">JBOSGI-71</a>] -         Upgrade to IzPack 4.3.1 </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-73">JBOSGI-73</a>] -         Provide Blueprint example </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-95">JBOSGI-95</a>] -         Provide JAXB example </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-97">JBOSGI-97</a>] -         Provide SAX/DOM parser example </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-101">JBOSGI-101</a>] -         Create a ziped source distribution </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-103">JBOSGI-103</a>] -         Add support for BlueprintContainer API </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-104">JBOSGI-104</a>] -         Upgrade to Felix Web Console 1.2.10 </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-108">JBOSGI-108</a>] -         Investigate statics on PackageAdmin.refresh </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-109">JBOSGI-109</a>] -         Upgrade to Felix-1.8.1 </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-111">JBOSGI-111</a>] -         Allign distributed sources with libs </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-112">JBOSGI-112</a>] -         Investigate Exception in SynchronousBundleListener </li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-80'>JBOSGI-80</a>] - Add support for Framework Launching (RFC-132)</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-132'>JBOSGI-132</a>] - Release JBoss MC Framework 1.0.0.Alpha1</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-134'>JBOSGI-134</a>] - Add support for BundleContext.getDataFile()</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-142'>JBOSGI-142</a>] - Investigate classloading space</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-148'>JBOSGI-148</a>] - Autostart bundles when deployed in JBossAS</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-156'>JBOSGI-156</a>] - Setup r4v42 core TCK</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-159'>JBOSGI-159</a>] - Fire events asynchronously</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-160'>JBOSGI-160</a>] - Use Pax Web instead of Apache Http-Service</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-164'>JBOSGI-164</a>] - Update Blueprint to 1.0.0.Alpha2</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-165'>JBOSGI-165</a>] - Update to jboss-osgi-common-1.0.2</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-166'>JBOSGI-166</a>] - Update to jboss-osgi-common-core-2.2.13.GA</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-167'>JBOSGI-167</a>] - Update to jboss-osgi-husky-1.0.1</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-168'>JBOSGI-168</a>] - Update to jboss-osgi-jmx-1.0.1</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-169'>JBOSGI-169</a>] - Update to jboss-osgi-jndi-1.0.1</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-170'>JBOSGI-170</a>] - Update to jboss-osgi-microcontainer-1.0.2</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-171'>JBOSGI-171</a>] - Update to Eclipse Equinox-3.5</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-172'>JBOSGI-172</a>] - Update to Apache Felix-2.0.0</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-173'>JBOSGI-173</a>] - Update to jboss-osgi-spi-1.0.2</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-174'>JBOSGI-174</a>] - Update to jboss-osgi-webconsole-1.0.1</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-175'>JBOSGI-175</a>] - Update to osgi core/compendium R4v42</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-176'>JBOSGI-176</a>] - Release JBoss OSGi 1.0.0.Beta4</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-133'>JBOSGI-133</a>] - Pass all example tests with MC Framework</li>
 </ul>
-<p/>
 
-<p><strong>Bugs</strong></p>
-<p/>
+<h4>Bug</h4>
 <ul>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-66">JBOSGI-66</a>] -         Support bundle deployment through web console </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-92">JBOSGI-92</a>] -         Class.forName issue with XMLParserActivator </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-99">JBOSGI-99</a>] -         No explicit control over bundle.start() </li>
-<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-107">JBOSGI-107</a>] -         MC beans cannot be redeployed after refresh </li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-78'>JBOSGI-78</a>] - ResourceNotFoundException too verbose</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-130'>JBOSGI-130</a>] - Bundle is still in state INSTALLED after bundle.start()</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-135'>JBOSGI-135</a>] - Cannot handle package being imported and exported by the same bundle</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-136'>JBOSGI-136</a>] - Cannot resolve dependency against unstarted bundle</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-140'>JBOSGI-140</a>] - Invalid delivery of framework events</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-144'>JBOSGI-144</a>] - Framework does not handle ServiceFactory provided services properly</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-151'>JBOSGI-151</a>] - Cannot resolve circular dependencies</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-155'>JBOSGI-155</a>] - OutOfMemoryError on repeated install/unstall bundle</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-158'>JBOSGI-158</a>] - Framework itself must be a bundle</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-161'>JBOSGI-161</a>] - Cannot use commons-logging</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-162'>JBOSGI-162</a>] - Cannot load classes from Bundle-ClassPath</li>
+<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-163'>JBOSGI-163</a>] - Husky invocation before async extender processing</li>
 </ul>
+
 <p/>
 
 <p>Enjoy</p>

More information about the jboss-cvs-commits mailing list