Skip to Content.
Sympa Menu

notify-dpml - r1977 - in trunk: . central/site/src/docs/about/download central/site/src/docs/metro/tutorials

notify-dpml AT lists.ibiblio.org

Subject: DPML Notify

List archive

Chronological Thread  
  • From: mcconnell at BerliOS <mcconnell AT mail.berlios.de>
  • To: notify-dpml AT lists.ibiblio.org
  • Subject: r1977 - in trunk: . central/site/src/docs/about/download central/site/src/docs/metro/tutorials
  • Date: Wed, 18 Apr 2007 09:48:54 +0200

Author: mcconnell
Date: 2007-04-18 09:48:52 +0200 (Wed, 18 Apr 2007)
New Revision: 1977

Removed:
trunk/central/site/src/docs/metro/tutorials/intro.xml
Modified:
trunk/central/site/src/docs/about/download/archive.xml
trunk/central/site/src/docs/about/download/index.xml
trunk/central/site/src/docs/metro/tutorials/index.xml
trunk/central/site/src/docs/metro/tutorials/navigation.xml
trunk/index.xml
Log:
prep for 2.0.1 release

Modified: trunk/central/site/src/docs/about/download/archive.xml
===================================================================
--- trunk/central/site/src/docs/about/download/archive.xml 2007-04-16
20:27:00 UTC (rev 1976)
+++ trunk/central/site/src/docs/about/download/archive.xml 2007-04-18
07:48:52 UTC (rev 1977)
@@ -17,12 +17,72 @@
The following table lists formal distributions published by the DPML.
</p>

- <subsection name="Version @VERSION@">
+ <subsection name="Version 2.0.1">

<p>
Resolved issues and/or enhancements:
</p>

+ <p>
+ Maintenance update incorporating improvements to general exception
+ handling and error reporting.
+ </p>
+
+ <table>
+ <tr>
+ <td>Windows NSIS Installer</td>
+ <td>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.1/dpml-sdk-win32-2.0.1.exe";>
+ dpml-sdk-win32-2.0.1.exe</a>
+ </td>
+ <td>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.1/dpml-sdk-win32-2.0.1.exe.md5";>
+ MD5</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Windows Zip Archive</td>
+ <td>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.1/dpml-sdk-win32-2.0.1.zip";>
+ dpml-sdk-win32-2.0.1.zip</a>
+ </td>
+ <td>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.1/dpml-sdk-win32-2.0.1.zip.md5";>
+ MD5</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Linux Archive</td>
+ <td>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.1/dpml-sdk-linux-2.0.1.tar.gz";>
+ dpml-sdk-linux-2.0.1.tar.gz</a>
+ </td>
+ <td>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.1/dpml-sdk-linux-2.0.1.tar.gz.md5";>
+ MD5</a>
+ </td>
+ </tr>
+ <tr>
+ <td>Documentation Archive</td>
+ <td>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.1/dpml-sdk-docs-2.0.1.zip";>
+ dpml-sdk-docs-2.0.1.zip</a>
+ </td>
+ <td>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.1/dpml-sdk-docs-2.0.1.zip.md5";>
+ MD5</a>
+ </td>
+ </tr>
+ </table>
+
+ </subsection>
+
+ <subsection name="Version 2.0.0">
+
+ <p>
+ Resolved issues and/or enhancements:
+ </p>
+
<ul>
<li>JSR 277 readiness.</li>
<li>Integral support for <tt>java.util.ServiceLoader</tt> as an
basic extension mechansims.</li>
@@ -43,44 +103,44 @@
<tr>
<td>Windows NSIS Installer</td>
<td>
- <a
href="http://download.dpml.net/formal/sdk/@VERSION@/dpml-sdk-win32-@VERSION@.exe";>
- dpml-sdk-win32-@VERSION@.exe</a>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.0/dpml-sdk-win32-2.0.0.exe";>
+ dpml-sdk-win32-2.0.0.exe</a>
</td>
<td>
- <a
href="http://download.dpml.net/formal/sdk/@VERSION@/dpml-sdk-win32-@VERSION@.exe.md5";>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.0/dpml-sdk-win32-2.0.0.exe.md5";>
MD5</a>
</td>
</tr>
<tr>
<td>Windows Zip Archive</td>
<td>
- <a
href="http://download.dpml.net/formal/sdk/@VERSION@/dpml-sdk-win32-@VERSION@.zip";>
- dpml-sdk-win32-@VERSION@.zip</a>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.0/dpml-sdk-win32-2.0.0.zip";>
+ dpml-sdk-win32-2.0.0.zip</a>
</td>
<td>
- <a
href="http://download.dpml.net/formal/sdk/@VERSION@/dpml-sdk-win32-@VERSION@.zip.md5";>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.0/dpml-sdk-win32-2.0.0.zip.md5";>
MD5</a>
</td>
</tr>
<tr>
<td>Linux Archive</td>
<td>
- <a
href="http://download.dpml.net/formal/sdk/@VERSION@/dpml-sdk-linux-@VERSION@.tar.gz";>
- dpml-sdk-linux-@VERSION@.tar.gz</a>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.0/dpml-sdk-linux-2.0.0.tar.gz";>
+ dpml-sdk-linux-2.0.0.tar.gz</a>
</td>
<td>
- <a
href="http://download.dpml.net/formal/sdk/@VERSION@/dpml-sdk-linux-@VERSION@.tar.gz.md5";>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.0/dpml-sdk-linux-2.0.0.tar.gz.md5";>
MD5</a>
</td>
</tr>
<tr>
<td>Documentation Archive</td>
<td>
- <a
href="http://download.dpml.net/formal/sdk/@VERSION@/dpml-sdk-docs-@VERSION@.zip";>
- dpml-sdk-docs-@VERSION@.zip</a>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.0/dpml-sdk-docs-2.0.0.zip";>
+ dpml-sdk-docs-2.0.0.zip</a>
</td>
<td>
- <a
href="http://download.dpml.net/formal/sdk/@VERSION@/dpml-sdk-docs-@VERSION@.zip.md5";>
+ <a
href="http://download.dpml.net/formal/sdk/2.0.0/dpml-sdk-docs-2.0.0.zip.md5";>
MD5</a>
</td>
</tr>

Modified: trunk/central/site/src/docs/about/download/index.xml
===================================================================
--- trunk/central/site/src/docs/about/download/index.xml 2007-04-16
20:27:00 UTC (rev 1976)
+++ trunk/central/site/src/docs/about/download/index.xml 2007-04-18
07:48:52 UTC (rev 1977)
@@ -33,10 +33,14 @@
@VERSION@ version has a structural dependency on the Java 1.6
platform. Semantics
of component deployment such as Context definition remain backward
compatible with
the 1.X series. Internal APIs have changed relative to 1.X to
better align with
- draft JSR 277 module specifications. New features and/or
enhancements delivered under
- version 2.0.0 relative to 1.1.0 include:
+ draft JSR 277 module specifications.
</p>

+ <p>
+ New features and/or enhancements delivered under
+ version @VERSION@ relative to 1.1.0 include:
+ </p>
+
<ul>
<li>JSR 277 readiness.</li>
<li>Integral support for <tt>java.util.ServiceLoader</tt> as an
basic extension mechansims.</li>
@@ -53,6 +57,11 @@
<li>Improvements to Station deployment metadata.</li>
</ul>

+ <p>
+ New features and/or enhancements delivered under
+ version @VERSION@ relative to the 2.0.0 distribution include
improvements to
+ general exception handling and error reporting.
+ </p>

</subsection>


Modified: trunk/central/site/src/docs/metro/tutorials/index.xml
===================================================================
--- trunk/central/site/src/docs/metro/tutorials/index.xml 2007-04-16
20:27:00 UTC (rev 1976)
+++ trunk/central/site/src/docs/metro/tutorials/index.xml 2007-04-18
07:48:52 UTC (rev 1977)
@@ -9,8 +9,146 @@

<body>

- <section name="Overview">
+ <section name="Metro Tutorial">

+ <p>
+ In the Depot tutorials dealing with
+ <a href="../../util/depot/tutorials/plugins.html">strategy
datatypes</a>
+ we covered the general subject of a deployment unit descriptor that
associated
+ an object instantiation <tt>strategy</tt> with a <tt>classloader</tt>
chain
+ definition. The Metro platform provides the prefered deployment
strategy and
+ runtime handler that delivers a complete context driven IOC object
+ instantiation model.
+ In addition to instantiation there are several aspects of a class that
+ effect its deployment. These aspects include thread-safety, a
depoyment and
+ decommissioning lifecycle, garbage collection policy, etc. Each of
these concerns
+ are expresssed as well defined semantic features within the Metro
component model.
+ </p>
+
+ <subsection name="Totorial Objective">
+
+ <p>
+ The objective of this tutorial is the demonstration of how we can
+ introduce a new instantiation strategy into a part deployment
descriptor.
+ Subsequent tutorials will use the resource established here as the
baseline
+ for the introduction of the core Metro component model concepts.
+ </p>
+
+ <p>
+ Supporting classes:
+ </p>
+
+ <table>
+ <tr>
+ <td><a href="hello/Demo.java.html">Demo.java</a></td>
+ <td>A minimal component implementation.</td>
+ </tr>
+ <tr>
+ <td><a
href="hello/DemoTestCase.java.html">DemoTestCase.java</a></td>
+ <td>Testcase that validates component deployment.</td>
+ </tr>
+ </table>
+
+ </subsection>
+
+ <subsection name="Component Creation">
+
+ <p>
+ In the following Depot project definition we are declaring
+ a new project with publication of a jar and a part artifact.
+ The significant difference from a regular plugin is the usage
+ of a custom part strategy.
+ </p>
+
+ <p><i>From the global index.xml we establish the reference to out
target project:</i></p>
+<pre>
+&lt;index ..... &gt;
+
+ ...
+
+ &lt;project xmlns="dpml:library" name="hello"&gt;
+
+ &lt;info title="DPML Metro Hello Tutorial"&gt;
+ &lt;description&gt;Introductory Hello World demo.&lt;/description&gt;
+ &lt;/info&gt;
+
+ &lt;types>
+ &lt;type id="jar"/&gt;
+ &lt;type id="part" source="target/component.xml"/&gt;
+ &lt;/types&gt;
+
+ &lt;dependencies&gt;
+ &lt;test&gt;
+ &lt;include ref="dpml/metro/dpml-metro-part"/&gt;
+ &lt;include ref="org/apache/ant/ant-junit"/&gt;
+ &lt;/test&gt;
+ &lt;/dependencies&gt;
+
+ &lt;/project&gt;
+
+ ...
+
+&lt;/index&gt;
+</pre>
+
+ <p><i>The component.xml file referenced in the part type production
+ statement contains the information about the component deployment
+ strategy.</i></p>
+
+<pre>
+&lt;component xmlns="dpml:metro" name="demo" class="org.acme.Demo"/&gt;
+</pre>
+
+ <p>
+ The custom part definition introduced under the <tt>dpml:metro</tt>
+ namespace is declaring the production of a new <tt>part</tt>
datastructure under which
+ the class <tt>org.acme.Demo</tt> is to handled by the Metro runtime
platform. The above
+ project definition also includes the declaration of test phase
dependencies that we will need in
+ order to launch the component.
+ </p>
+
+ <p>
+ The generated part datastructure is show below (the custom Metro
deployment
+ strategy is hilighted in red). The datastructure include dependency
information
+ extracted from the prject defintion, together with component
deployment infromation
+ resolved from the referenced component.xml deployment directive.
+ </p>
+
+<source>
+&lt;part xmlns="dpml:part"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"&gt;
+
+ &lt;info/&gt;
+
+ <font color="darkred">&lt;component xmlns="dpml:metro"
+ class="org.acme.Demo"
+ name="demo"/&gt;</font>
+
+ &lt;classpath&gt;
+ &lt;private&gt;
+
&lt;uri&gt;artifact:jar:dpmlx/tutorials/components/acme-demo-hello#SNAPSHOT&lt;/uri&gt;
+ &lt;/private&gt;
+ &lt;/classpath&gt;
+
+&lt;/part&gt;
+</source>
+
+ </subsection>
+
+ <subsection name="Summary">
+
+ <p>
+ In this example the Demo implementation class contains nothing
significant -
+ however, the important point of this tutorial is the association of
+ a different runtime handler for the class within our part definition.
+ Our next tutorial extends this project with the introduction of
+ <a href="context.html">context management</a> and in particular, the
way in
+ which a component class declares context assumptions, and the
mechanisms
+ used by the Metro runtime to fullfill those requirements.
+ </p>
+
+ </subsection>
+
</section>

</body>

Deleted: trunk/central/site/src/docs/metro/tutorials/intro.xml
===================================================================
--- trunk/central/site/src/docs/metro/tutorials/intro.xml 2007-04-16
20:27:00 UTC (rev 1976)
+++ trunk/central/site/src/docs/metro/tutorials/intro.xml 2007-04-18
07:48:52 UTC (rev 1977)
@@ -1,159 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-
-<document>
-
- <properties>
- <author email="mcconnell AT osm.net">Stephen McConnell</author>
- <title>Component Development</title>
- </properties>
-
- <body>
-
- <section name="Overview">
-
- <p>
- In the earlier tutorials dealing with
- <a href="../../util/depot/tutorials/plugins.html">Depot plugin
datatypes</a>
- we covered the general subject of a deployment unit descriptor that
associated
- an object instantiation <tt>strategy</tt> with a <tt>classloader</tt>
chain
- definition. The Metro platform provides the prefered deployment
strategy and
- runtime handler that delivers a complete context driven IOC object
- instantiation model.
- In addition to instantiation there are several aspects of a class that
- effect its deployment. These aspects include thread-safety, a
depoyment and
- decommissioning lifecycle, garbage collection policy, etc. Each of
these concerns
- are expresssed as well defined semantic features within the Metro
component model.
- </p>
-
- <subsection name="Totorial Objective">
-
- <p>
- The objective of this tutorial is the demonstration of how we can
- introduce a new instantiation strategy into a part deployment
descriptor.
- Subsequent tutorials will use the resource established here as the
baseline
- for the introduction of the core Metro component model concepts.
- </p>
-
- <p>
- Supporting classes:
- </p>
-
- <table>
- <tr>
- <td><a href="hello/Demo.java.html">Demo.java</a></td>
- <td>A minimal component implementation.</td>
- </tr>
- <tr>
- <td><a
href="hello/DemoTestCase.java.html">DemoTestCase.java</a></td>
- <td>Testcase that validates component deployment.</td>
- </tr>
- </table>
-
- </subsection>
-
- <subsection name="Component Creation">
-
- <p>
- In the following Depot project definition we are declaring
- a new project with publication of a jar and a part artifact.
- The significant difference from a regular plugin is the usage
- of a custom part strategy.
- </p>
-
- <p><i>From the global index.xml we establish the reference to out
target project:</i></p>
-<pre>
-&lt;index ..... &gt;
-
- ...
-
- &lt;project xmlns="dpml:library" name="hello"&gt;
-
- &lt;info title="DPML Metro Hello Tutorial"&gt;
- &lt;description&gt;Introductory Hello World demo.&lt;/description&gt;
- &lt;/info&gt;
-
- &lt;types>
- &lt;type id="jar"/&gt;
- &lt;type id="part" source="target/component.xml"/&gt;
- &lt;/types&gt;
-
- &lt;dependencies&gt;
- &lt;test&gt;
- &lt;include ref="dpml/metro/dpml-metro-part"/&gt;
- &lt;include ref="org/apache/ant/ant-junit"/&gt;
- &lt;/test&gt;
- &lt;/dependencies&gt;
-
- &lt;/project&gt;
-
- ...
-
-&lt;/index&gt;
-</pre>
-
- <p><i>The component.xml file referenced in the part type production
- statement contains the information about the component deployment
- strategy.</i></p>
-
-<pre>
-&lt;component xmlns="dpml:metro" name="demo" class="org.acme.Demo"/&gt;
-</pre>
-
- <p>
- The custom part definition introduced under the <tt>dpml:metro</tt>
- namespace is declaring the production of a new <tt>part</tt>
datastructure under which
- the class <tt>org.acme.Demo</tt> is to handled by the Metro runtime
platform. The above
- project definition also includes the declaration of test phase
dependencies that we will need in
- order to launch the component.
- </p>
-
- <p>
- The generated part datastructure is show below (the custom Metro
deployment
- strategy is hilighted in red). The datastructure include dependency
information
- extracted from the prject defintion, together with component
deployment infromation
- resolved from the referenced component.xml deployment directive.
- </p>
-
-<source>
-&lt;part xmlns="dpml:part"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"&gt;
-
- &lt;info/&gt;
-
- <font color="darkred">&lt;component xmlns="dpml:metro"
- class="org.acme.Demo"
- name="demo"/&gt;</font>
-
- &lt;classpath&gt;
- &lt;private&gt;
-
&lt;uri&gt;artifact:jar:dpmlx/tutorials/components/acme-demo-hello#SNAPSHOT&lt;/uri&gt;
- &lt;/private&gt;
- &lt;/classpath&gt;
-
-&lt;/part&gt;
-</source>
-
- </subsection>
-
- <subsection name="Summary">
-
- <p>
- In this example the Demo implementation class contains nothing
significant -
- however, the important point of this tutorial is the association of
- a different runtime handler for the class within our part definition.
- Our next tutorial extends this project with the introduction of
- <a href="context.html">context management</a> and in particular, the
way in
- which a component class declares context assumptions, and the
mechanisms
- used by the Metro runtime to fullfill those requirements.
- </p>
-
- </subsection>
-
- </section>
-
- </body>
-
-</document>
-
-
-

Modified: trunk/central/site/src/docs/metro/tutorials/navigation.xml
===================================================================
--- trunk/central/site/src/docs/metro/tutorials/navigation.xml 2007-04-16
20:27:00 UTC (rev 1976)
+++ trunk/central/site/src/docs/metro/tutorials/navigation.xml 2007-04-18
07:48:52 UTC (rev 1977)
@@ -25,7 +25,6 @@
<body>

<menu>
- <item name="Introduction" href="intro.html"/>
<item name="Context Management" href="context.html"/>
<item name="Context Examples" href="context-examples.html"/>
<item name="The Sum of the Parts" href="composition-by-parts.html"/>

Modified: trunk/index.xml
===================================================================
--- trunk/index.xml 2007-04-16 20:27:00 UTC (rev 1976)
+++ trunk/index.xml 2007-04-18 07:48:52 UTC (rev 1977)
@@ -20,7 +20,7 @@
<property name="project.svn.host"
value="svn://svn.berlios.de/dpml/trunk/main"/>
<property name="project.major.version" value="2"/>
<property name="project.minor.version" value="0"/>
- <property name="project.micro.version" value="0"/>
+ <property name="project.micro.version" value="1"/>
<property name="project.javadoc.linksource" value="false"/>
</properties>





  • r1977 - in trunk: . central/site/src/docs/about/download central/site/src/docs/metro/tutorials, mcconnell at BerliOS, 04/18/2007

Archive powered by MHonArc 2.6.24.

Top of Page