Skip to Content.
Sympa Menu

notify-dpml - r1926 - in trunk: central/site/src/docs/util/command central/site/src/docs/util/depot/tutorials central/site/src/docs/util/transit/tutorials tutorials/tooling/complex/plugin tutorials/tooling/complex/plugin/impl/etc

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: r1926 - in trunk: central/site/src/docs/util/command central/site/src/docs/util/depot/tutorials central/site/src/docs/util/transit/tutorials tutorials/tooling/complex/plugin tutorials/tooling/complex/plugin/impl/etc
  • Date: Tue, 20 Mar 2007 16:27:35 +0100

Author: mcconnell
Date: 2007-03-20 16:27:34 +0100 (Tue, 20 Mar 2007)
New Revision: 1926

Added:
trunk/tutorials/tooling/complex/plugin/impl/etc/component.xml
Removed:
trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml
Modified:
trunk/central/site/src/docs/util/command/index.xml
trunk/central/site/src/docs/util/depot/tutorials/alias.xml
trunk/central/site/src/docs/util/depot/tutorials/automation.xml
trunk/central/site/src/docs/util/depot/tutorials/export.xml
trunk/central/site/src/docs/util/depot/tutorials/plugins.xml
trunk/central/site/src/docs/util/depot/tutorials/unit.xml
trunk/central/site/src/docs/util/transit/tutorials/artifacts.xml
trunk/tutorials/tooling/complex/plugin/module.xml
Log:
cleaning up the depot tutorials

Modified: trunk/central/site/src/docs/util/command/index.xml
===================================================================
--- trunk/central/site/src/docs/util/command/index.xml 2007-03-19 15:50:08
UTC (rev 1925)
+++ trunk/central/site/src/docs/util/command/index.xml 2007-03-20 15:27:34
UTC (rev 1926)
@@ -30,7 +30,7 @@
<pre>@UTIL-CLI-URI@</pre>

<p>
- The CLI indexprovides an API for processing command line interfaces.
+ The CLI utility package provides an API for processing command line
interfaces.
</p>
<p>
The implementation is based on the Jakarta Commons CLI2 library
written

Modified: trunk/central/site/src/docs/util/depot/tutorials/alias.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/alias.xml 2007-03-19
15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/alias.xml 2007-03-20
15:27:34 UTC (rev 1926)
@@ -86,27 +86,14 @@
versioned artifact (similar to a unix symlink for artifacts). This
tutorial
has covered the creation of a simple non-versioned alias associated
with the
produced jar file. Alias attributes may be used on any resource type
- production statement. An alternative form of versioned alias
production
- is available using the <tt>version</tt> attribute in place of
<tt>alias</tt>.
- For example - the following statement would result in the generation
of a alias
- artifact referencing version 1.0.
+ production statement.
</p>

-<pre>
- &lt;project name="demo" basedir="."&gt;
- &lt;properties&gt;
- &lt;property name="location" value="New York"/&gt;
- &lt;property name="message" value="Hello from ${user.name} in
${location}"/&gt;
- &lt;/properties&gt;
- &lt;types&gt;
- <font color="darkred">&lt;type id="jar" version="1.0"/&gt;</font>
- &lt;/types&gt;
- &lt;filters&gt;
- &lt;filter token="MESSAGE" value="${message}"/&gt;
- &lt;/filters&gt;
- &lt;/project&gt;
-</pre>
-
+ <p>
+ The <a href="unit.html">following tutorial</a> moves on to the
broader subject of unit
+ testing in an environment backed by a rich project model.
+ </p>
+
</subsection>

</section>

Modified: trunk/central/site/src/docs/util/depot/tutorials/automation.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/automation.xml
2007-03-19 15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/automation.xml
2007-03-20 15:27:34 UTC (rev 1926)
@@ -11,7 +11,7 @@
<section name="Build Automation using Templates">

<p>
- One of the nice features added to Ant 1.6 is the support for
+ One of the nice features added to Ant 1.6 wassupport for
the import of template build files. The Depot system comes with
a default template that handles the establishment of a number of
tasks that are project-aware. Using information about a target
@@ -28,10 +28,9 @@
</p>

<pre>
-&lt;project name="demo" default="install"
- xmlns:transit="antlib:dpml.tools.transit"&gt;
+&lt;project name="demo" default="install" xmlns:x="antlib:dpml.tools"&gt;

- <font color="darkred">&lt;transit:import
uri="local:template:dpml/tools/standard"/&gt;</font>
+ <font color="darkred">&lt;x:import
uri="local:template:dpml/tools/standard"/&gt;</font>

&lt;/project&gt;
</pre>

Modified: trunk/central/site/src/docs/util/depot/tutorials/export.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/export.xml 2007-03-19
15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/export.xml 2007-03-20
15:27:34 UTC (rev 1926)
@@ -24,8 +24,7 @@
<p>
Our index definition remains unchanged except for the addition of
a type production statement declaring that the module build produces
- a module artifact (and just for fun we have requested a version alias
- to be produced at the same time).
+ a module artifact.
</p>

<pre>
@@ -40,7 +39,7 @@
&lt;module name="org/acme" basedir="."&gt;

<font color="darkred">&lt;types&gt;
- &lt;type id="module" version="1.0"&gt;
+ &lt;type id="module"&gt;
&lt;/types&gt;</font>

&lt;project name="clock-api" basedir="api"&gt;

Modified: trunk/central/site/src/docs/util/depot/tutorials/plugins.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/plugins.xml
2007-03-19 15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/plugins.xml
2007-03-20 15:27:34 UTC (rev 1926)
@@ -40,8 +40,7 @@

<pre>
&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
-&lt;index xmlns="dpml:library"
- <font color="darkred">xmlns:part="dpml:part"</font>&gt;
+&lt;index xmlns="dpml:library"&gt;

&lt;imports&gt;
&lt;import uri="link:module:ant"/&gt;
@@ -86,8 +85,8 @@
<subsection name="The Part Artifact">

<p>
- During the build the following part defintion is created based on
the input
- part definition source.
+ During the build the following part defintion is created based on
the
+ depolyment strategy input resource from the source data.
</p>

<p><i>Generated part:</i>
<tt>artifact:part:org/acme/plugin/clock-impl#SNAPSHOT</tt></p>
@@ -100,10 +99,12 @@

<info/>

- <strategy xsi:type="plugin" class="org.acme.impl.SimpleClock">
- <param value="h:mm"/>
- <param class="java.util.Locale" method="getDefault"/>
- </strategy>
+ <component xmlns="dpml:metro" type="org.acme.impl.SimpleClock">
+ <context>
+ <entry key="format" value="h:mm"/>
+ <entry key="locale" class="java.util.Locale" method="getDefault"/>
+ </context>
+ </component>

<classpath>
<private>

Modified: trunk/central/site/src/docs/util/depot/tutorials/unit.xml
===================================================================
--- trunk/central/site/src/docs/util/depot/tutorials/unit.xml 2007-03-19
15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/depot/tutorials/unit.xml 2007-03-20
15:27:34 UTC (rev 1926)
@@ -30,13 +30,16 @@
&lt;index xmlns="dpml:library"&gt;

&lt;project name="demo" basedir="."&gt;
+
&lt;properties&gt;
&lt;property name="location" value="New York"/&gt;
&lt;property name="message" value="Hello from ${user.name} in
${location}"/&gt;
&lt;/properties&gt;
+
&lt;types&gt;
&lt;type id="jar" alias="true"/&gt;
&lt;/types&gt;
+
<font color="darkred">&lt;dependencies&gt;
&lt;test&gt;
&lt;include uri="artifact:jar:ant/ant-junit#1.6.5"/&gt;
@@ -44,10 +47,10 @@
&lt;include uri="artifact:jar:junit/junit#3.8.1"/&gt;
&lt;/test&gt;
&lt;/dependencies&gt;</font>
+
&lt;filters&gt;
&lt;filter token="MESSAGE" value="${message}"/&gt;
&lt;/filters&gt;
- &lt;dependencies&gt;

&lt;/project&gt;


Modified: trunk/central/site/src/docs/util/transit/tutorials/artifacts.xml
===================================================================
--- trunk/central/site/src/docs/util/transit/tutorials/artifacts.xml
2007-03-19 15:50:08 UTC (rev 1925)
+++ trunk/central/site/src/docs/util/transit/tutorials/artifacts.xml
2007-03-20 15:27:34 UTC (rev 1926)
@@ -102,7 +102,7 @@
When the new URL constructor is invoked the JVM checks available
URLStreamHandlers
using a number of mechanisms - one of which is to check the value of
the
"java.protocol.handler.pkgs" system property. The JVM will look for
a protocol
- handler named "net.dpml.transit" + [protocol].Handler. The
Transit's artifact
+ handler named "dpml.transit" + [protocol].Handler. The Transit's
artifact
Handler class is primarily responsible for the establishment of a
ArtifactURLConnection.
The ArtifactURLConnection holds a reference to the Transit system.
When the openStream
operation is invoked the Artifact URL connection will use a cache
handler to resolve
@@ -128,14 +128,17 @@

</subsection>

- <subsection name="Next Topic - Plugins">
+ <subsection name="Next Topic - the Local Protocol">

<p>
- This page has presented a more in-depth look at the
<tt>artifact</tt> protocol.
- The <a href="plugins.html">next tutorial</a> introduced a simple
datatype called a
- <tt>part</tt> that describes an object instantiation strategy with a
classloader
- chain definition. This datatype is commonly referred to as a
<tt>plugin</tt> and
- demonstrates the usage of one artifact to describe the usage of many
artifacts.
+ The machinery underlying the artifact uri is designed around the
availability of
+ local or remote hosts which serve as the resource source repository.
This is apropriate
+ when dealing with general integration of multiple projects, however
- it is not suitable
+ for the management of local configuration data. The <a
href="local.html">next tutorial</a> introduces
+ the local protocol which provides support for the resolution of
preference information
+ local to the application runtime environment. In general terms it
follows the same patterns
+ as the artifact protocol but the underlying machining resolves
resources relative to a
+ local system wide preference root directory.
</p>

</subsection>

Copied: trunk/tutorials/tooling/complex/plugin/impl/etc/component.xml (from
rev 1924, trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml)

Deleted: trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml
===================================================================
--- trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml 2007-03-19
15:50:08 UTC (rev 1925)
+++ trunk/tutorials/tooling/complex/plugin/impl/etc/plugin.xml 2007-03-20
15:27:34 UTC (rev 1926)
@@ -1,8 +0,0 @@
-<?xml version="1.0"?>
-
-<component xmlns="dpml:metro" type="org.acme.impl.SimpleClock">
- <context>
- <entry key="format" value="h:mm"/>
- <entry key="locale" class="java.util.Locale" method="getDefault"/>
- </context>
-</component>

Modified: trunk/tutorials/tooling/complex/plugin/module.xml
===================================================================
--- trunk/tutorials/tooling/complex/plugin/module.xml 2007-03-19 15:50:08
UTC (rev 1925)
+++ trunk/tutorials/tooling/complex/plugin/module.xml 2007-03-20 15:27:34
UTC (rev 1926)
@@ -15,7 +15,7 @@
<project name="clock-impl" basedir="impl">
<types>
<type id="jar"/>
- <type id="part" source="etc/plugin.xml"/>
+ <type id="part" source="etc/component.xml"/>
</types>
<dependencies>
<runtime>




  • r1926 - in trunk: central/site/src/docs/util/command central/site/src/docs/util/depot/tutorials central/site/src/docs/util/transit/tutorials tutorials/tooling/complex/plugin tutorials/tooling/complex/plugin/impl/etc, mcconnell at BerliOS, 03/20/2007

Archive powered by MHonArc 2.6.24.

Top of Page