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

Author: thomas.diesler(a)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... + + <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">... 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/HttpSer...;. @@ -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.B... +<p>You can download the binary here: <a href="https://sourceforge.net/projects/jboss/files/JBossOSGi/1.0.0.B... <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/ChapFramewor... based OSGi Framework</a>.</li> -<li>More samples for <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta3/userguide/html/... -<li>Aggregated online <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta3/apidocs/"&... docs</a></li> +<li>Initial release of our native <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta4/userguide/html/... 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/... Extender</a></li> +<li>Improved support for the <a href="http://jbmuc.dyndns.org/jboss-osgi-1.0.0.Beta4/userguide/html/... </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/... 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/... 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-9...>] - Uninstall bundles on OSGiRuntime.shutdown() </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-98">JBOSGI-9...>] - Support configuration per profile </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-102">JBOSGI-...>] - Add support for static Husky context injection </li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-110'>JBOSGI-11...>] - Support WAR deployments in the OSGi runtime</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-127'>JBOSGI-12...>] - Provide build and hudson support for MC facade</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-128'>JBOSGI-12...>] - 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-7...>] - Upgrade to IzPack 4.3.1 </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-73">JBOSGI-7...>] - Provide Blueprint example </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-95">JBOSGI-9...>] - Provide JAXB example </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-97">JBOSGI-9...>] - Provide SAX/DOM parser example </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-101">JBOSGI-...>] - Create a ziped source distribution </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-103">JBOSGI-...>] - Add support for BlueprintContainer API </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-104">JBOSGI-...>] - Upgrade to Felix Web Console 1.2.10 </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-108">JBOSGI-...>] - Investigate statics on PackageAdmin.refresh </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-109">JBOSGI-...>] - Upgrade to Felix-1.8.1 </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-111">JBOSGI-...>] - Allign distributed sources with libs </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-112">JBOSGI-...>] - Investigate Exception in SynchronousBundleListener </li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-80'>JBOSGI-80&...>] - Add support for Framework Launching (RFC-132)</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-132'>JBOSGI-13...>] - Release JBoss MC Framework 1.0.0.Alpha1</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-134'>JBOSGI-13...>] - Add support for BundleContext.getDataFile()</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-142'>JBOSGI-14...>] - Investigate classloading space</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-148'>JBOSGI-14...>] - Autostart bundles when deployed in JBossAS</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-156'>JBOSGI-15...>] - Setup r4v42 core TCK</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-159'>JBOSGI-15...>] - Fire events asynchronously</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-160'>JBOSGI-16...>] - Use Pax Web instead of Apache Http-Service</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-164'>JBOSGI-16...>] - Update Blueprint to 1.0.0.Alpha2</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-165'>JBOSGI-16...>] - Update to jboss-osgi-common-1.0.2</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-166'>JBOSGI-16...>] - Update to jboss-osgi-common-core-2.2.13.GA</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-167'>JBOSGI-16...>] - Update to jboss-osgi-husky-1.0.1</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-168'>JBOSGI-16...>] - Update to jboss-osgi-jmx-1.0.1</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-169'>JBOSGI-16...>] - Update to jboss-osgi-jndi-1.0.1</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-170'>JBOSGI-17...>] - Update to jboss-osgi-microcontainer-1.0.2</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-171'>JBOSGI-17...>] - Update to Eclipse Equinox-3.5</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-172'>JBOSGI-17...>] - Update to Apache Felix-2.0.0</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-173'>JBOSGI-17...>] - Update to jboss-osgi-spi-1.0.2</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-174'>JBOSGI-17...>] - Update to jboss-osgi-webconsole-1.0.1</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-175'>JBOSGI-17...>] - Update to osgi core/compendium R4v42</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-176'>JBOSGI-17...>] - Release JBoss OSGi 1.0.0.Beta4</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-133'>JBOSGI-13...>] - 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-6...>] - Support bundle deployment through web console </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-92">JBOSGI-9...>] - Class.forName issue with XMLParserActivator </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-99">JBOSGI-9...>] - No explicit control over bundle.start() </li> -<li>[<a href="https://jira.jboss.org/jira/browse/JBOSGI-107">JBOSGI-...>] - MC beans cannot be redeployed after refresh </li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-78'>JBOSGI-78&...>] - ResourceNotFoundException too verbose</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-130'>JBOSGI-13...>] - Bundle is still in state INSTALLED after bundle.start()</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-135'>JBOSGI-13...>] - Cannot handle package being imported and exported by the same bundle</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-136'>JBOSGI-13...>] - Cannot resolve dependency against unstarted bundle</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-140'>JBOSGI-14...>] - Invalid delivery of framework events</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-144'>JBOSGI-14...>] - Framework does not handle ServiceFactory provided services properly</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-151'>JBOSGI-15...>] - Cannot resolve circular dependencies</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-155'>JBOSGI-15...>] - OutOfMemoryError on repeated install/unstall bundle</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-158'>JBOSGI-15...>] - Framework itself must be a bundle</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-161'>JBOSGI-16...>] - Cannot use commons-logging</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-162'>JBOSGI-16...>] - Cannot load classes from Bundle-ClassPath</li> +<li>[<a href='https://jira.jboss.org/jira/browse/JBOSGI-163'>JBOSGI-16...>] - Husky invocation before async extender processing</li> </ul> + <p/> <p>Enjoy</p>