[CVS jcontainer] Upgrading dependencies. Added more words to porting guide
Peter Royal <proyal-yCVjj/[email protected]> Thu, 19 Feb 2004 21:37:24 -0600
| Newsgroups | gmane.comp.java.jcontainer.cvs |
|---|---|
| Message-ID | <[email protected]> |
<html>
<head>
<style><!--
body {background-color:#ffffff;}
.file {border:1px solid #eeeeee;margin-top:1em;margin-bottom:1em;}
.pathname {font-family:monospace; float:right;}
.fileheader {margin-bottom:.5em;}
.diff {margin:0;}
.tasklist {padding:4px;border:1px dashed #000000;margin-top:1em;}
.tasklist ul {margin-top:0;margin-bottom:0;}
tr.alt {background-color:#eeeeee}
#added {background-color:#ddffdd;}
#addedchars {background-color:#99ff99;font-weight:bolder;}
tr.alt #added {background-color:#ccf7cc;}
#removed {background-color:#ffdddd;}
#removedchars {background-color:#ff9999;font-weight:bolder;}
tr.alt #removed {background-color:#f7cccc;}
#info {color:#888888;}
#context {background-color:#eeeeee;}
td {padding-left:.3em;padding-right:.3em;}
tr.head {border-bottom-width:1px;border-bottom-style:solid;}
tr.head td {padding:0;padding-top:.2em;}
.task {background-color:#ffff00;}
.comment {padding:4px;border:1px dashed #000000;background-color:#ffffdd}
.error {color:red;}
hr {border-width:0px;height:2px;background:black;}
--></style>
</head>
<body>
<table cellspacing="0" cellpadding="0" border="0" rules="cols">
<tr class="head"><td colspan="4">Commit in <b><tt>jcontainer/loom</tt></b><span id="info"> on MAIN</span></td></tr>
<tr><td><tt>demos/avalonlifecycle/<a href="#file1">project.xml</a></tt></td><td align="right" id="added">+2</td><td align="right" id="removed">-3</td><td nowrap="nowrap" align="center"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/avalonlifecycle/project.xml?rev=1.17&content-type=text/vnd.viewcvs-markup">1.17</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/avalonlifecycle/project.xml.diff?r1=1.17&r2=1.18">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/avalonlifecycle/project.xml?rev=1.18&content-type=text/vnd.viewcvs-markup">1.18</a></td></tr>
<tr class="alt"><td><tt>demos/distributed/server/<a href="#file2">project.xml</a></tt></td><td align="right" id="added">+2</td><td align="right" id="removed">-3</td><td nowrap="nowrap" align="center"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/distributed/server/project.xml?rev=1.14&content-type=text/vnd.viewcvs-markup">1.14</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/distributed/server/project.xml.diff?r1=1.14&r2=1.15">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/distributed/server/project.xml?rev=1.15&content-type=text/vnd.viewcvs-markup">1.15</a></td></tr>
<tr><td><tt>demos/helloworld/<a href="#file3">project.xml</a></tt></td><td align="right" id="added">+2</td><td align="right" id="removed">-3</td><td nowrap="nowrap" align="center"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/helloworld/project.xml?rev=1.22&content-type=text/vnd.viewcvs-markup">1.22</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/helloworld/project.xml.diff?r1=1.22&r2=1.23">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/helloworld/project.xml?rev=1.23&content-type=text/vnd.viewcvs-markup">1.23</a></td></tr>
<tr class="alt"><td><tt>site/xdocs/<a href="#file4">porting-guide.xml</a></tt></td><td align="right" id="added">+96</td><td align="right" id="removed">-40</td><td nowrap="nowrap" align="center"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/xdocs/porting-guide.xml?rev=1.7&content-type=text/vnd.viewcvs-markup">1.7</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/xdocs/porting-guide.xml.diff?r1=1.7&r2=1.8">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/xdocs/porting-guide.xml?rev=1.8&content-type=text/vnd.viewcvs-markup">1.8</a></td></tr>
<tr><td><tt>site/<a href="#file5">project.xml</a></tt></td><td align="right" id="added">+3</td><td align="right" id="removed">-4</td><td nowrap="nowrap" align="center"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/project.xml?rev=1.35&content-type=text/vnd.viewcvs-markup">1.35</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/project.xml.diff?r1=1.35&r2=1.36">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/project.xml?rev=1.36&content-type=text/vnd.viewcvs-markup">1.36</a></td></tr>
<tr><td></td><td align="right" id="added">+105</td><td align="right" id="removed">-53</td><td></td></tr>
</table>
<small id="info">5 modified files</small><br />
<pre class="comment">
Upgrading dependencies. Added more words to porting guide
</pre>
<hr /><a name="file1" /><div class="file">
<span class="pathname"><a href="http://xstream.cvs.codehaus.org/jcontainer">jcontainer</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom">loom</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos">demos</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/avalonlifecycle">avalonlifecycle</a><br /></span>
<div class="fileheader"><big><b>project.xml</b></big> <small id="info"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/avalonlifecycle/project.xml?rev=1.17&content-type=text/vnd.viewcvs-markup">1.17</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/avalonlifecycle/project.xml.diff?r1=1.17&r2=1.18">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/avalonlifecycle/project.xml?rev=1.18&content-type=text/vnd.viewcvs-markup">1.18</a></small></div>
<pre class="diff"><small id="info">diff -u -r1.17 -r1.18
--- project.xml 27 Nov 2003 01:20:37 -0000 1.17
+++ project.xml 20 Feb 2004 03:37:24 -0000 1.18
@@ -17,9 +17,8 @@
</small></pre><pre class="diff" id="context"> <type>plugin</type>
</dependency>
<dependency>
</pre><pre class="diff" id="removed">- <groupId>avalon</groupId>
- <artifactId>avalon-framework</artifactId>
- <version>4.1.4</version>
</pre><pre class="diff" id="added">+ <id>avalon-framework</id>
+ <version>4.1.5</version>
</pre><pre class="diff" id="context"> </dependency>
</dependencies>
</pre></div>
<hr /><a name="file2" /><div class="file">
<span class="pathname"><a href="http://xstream.cvs.codehaus.org/jcontainer">jcontainer</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom">loom</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos">demos</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/distributed">distributed</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/distributed/server">server</a><br /></span>
<div class="fileheader"><big><b>project.xml</b></big> <small id="info"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/distributed/server/project.xml?rev=1.14&content-type=text/vnd.viewcvs-markup">1.14</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/distributed/server/project.xml.diff?r1=1.14&r2=1.15">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/distributed/server/project.xml?rev=1.15&content-type=text/vnd.viewcvs-markup">1.15</a></small></div>
<pre class="diff"><small id="info">diff -u -r1.14 -r1.15
--- project.xml 27 Nov 2003 01:20:12 -0000 1.14
+++ project.xml 20 Feb 2004 03:37:24 -0000 1.15
@@ -17,9 +17,8 @@
</small></pre><pre class="diff" id="context"> <type>plugin</type>
</dependency>
<dependency>
</pre><pre class="diff" id="removed">- <groupId>avalon</groupId>
- <artifactId>avalon-framework</artifactId>
- <version>4.1.4</version>
</pre><pre class="diff" id="added">+ <id>avalon-framework</id>
+ <version>4.1.5</version>
</pre><pre class="diff" id="context"> </dependency>
</dependencies>
</pre></div>
<hr /><a name="file3" /><div class="file">
<span class="pathname"><a href="http://xstream.cvs.codehaus.org/jcontainer">jcontainer</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom">loom</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos">demos</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/helloworld">helloworld</a><br /></span>
<div class="fileheader"><big><b>project.xml</b></big> <small id="info"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/helloworld/project.xml?rev=1.22&content-type=text/vnd.viewcvs-markup">1.22</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/helloworld/project.xml.diff?r1=1.22&r2=1.23">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/demos/helloworld/project.xml?rev=1.23&content-type=text/vnd.viewcvs-markup">1.23</a></small></div>
<pre class="diff"><small id="info">diff -u -r1.22 -r1.23
--- project.xml 15 Dec 2003 17:31:08 -0000 1.22
+++ project.xml 20 Feb 2004 03:37:24 -0000 1.23
@@ -17,9 +17,8 @@
</small></pre><pre class="diff" id="context"> <type>plugin</type>
</dependency>
<dependency>
</pre><pre class="diff" id="removed">- <groupId>avalon</groupId>
- <artifactId>avalon-framework</artifactId>
- <version>4.1.4</version>
</pre><pre class="diff" id="added">+ <id>avalon-framework</id>
+ <version>4.1.5</version>
</pre><pre class="diff" id="context"> </dependency>
<dependency>
<groupId>phoenix</groupId>
</pre></div>
<hr /><a name="file4" /><div class="file">
<span class="pathname"><a href="http://xstream.cvs.codehaus.org/jcontainer">jcontainer</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom">loom</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site">site</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/xdocs">xdocs</a><br /></span>
<div class="fileheader"><big><b>porting-guide.xml</b></big> <small id="info"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/xdocs/porting-guide.xml?rev=1.7&content-type=text/vnd.viewcvs-markup">1.7</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/xdocs/porting-guide.xml.diff?r1=1.7&r2=1.8">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/xdocs/porting-guide.xml?rev=1.8&content-type=text/vnd.viewcvs-markup">1.8</a></small></div>
<pre class="diff"><small id="info">diff -u -r1.7 -r1.8
--- porting-guide.xml 3 Dec 2003 10:44:49 -0000 1.7
+++ porting-guide.xml 20 Feb 2004 03:37:24 -0000 1.8
@@ -1,12 +1,10 @@
</small></pre><pre class="diff" id="context"> <?xml version="1.0" encoding="iso-8859-1"?>
<document>
</pre><pre class="diff" id="removed">-
</pre><pre class="diff" id="context"> <properties>
<title>Porting Guide</title>
</properties>
<body>
</pre><pre class="diff" id="removed">-
</pre><pre class="diff" id="context"> <section name="Porting Phoenix 4.0.x applications">
<p>
Loom 1.0 supports applications running in Phoenix 4.0.x releases,
</pre><pre class="diff"><small id="info">@@ -14,7 +12,14 @@
</small></pre><pre class="diff" id="context"> <a href="/plugins/maven-sar/">Maven Sar Plugin</a>
provided by Loom and the appropriate libraries are bundles in the sar.
</p>
</pre><pre class="diff" id="removed">- <subsection name="Creating a Loom Sar">
</pre><pre class="diff" id="added">+
+ <p>
+ For users that still have an
+ <a href="http://ant.apache.org">Apache Ant</a> based build, the Phoenix sar
+ task can still be used. Otherwise, it is possible to create a SAR using Ant's
+ <code>jar</code> task.
+ </p>
+ <subsection name="Creating a Loom Sar with Maven">
</pre><pre class="diff" id="context"> <p>
Since the generation of metaclass descriptors is more generic in
Loom compared with Phoenix, but still fully compatible with it,
</pre><pre class="diff"><small id="info">@@ -39,9 +44,9 @@
</small></pre><pre class="diff" id="context"> compilation by adding the following to a custom maven.xml.
<source>
<![CDATA[
</pre><pre class="diff" id="removed">- <postGoal name="java:compile">
- <attainGoal name="sar:metagenerate"/>
- </postGoal>
</pre><pre class="diff" id="added">+<postGoal name="java:compile">
+ <attainGoal name="sar:metagenerate"/>
+</postGoal>
</pre><pre class="diff" id="context"> ]]>
</source>
and execute
</pre><pre class="diff"><small id="info">@@ -50,6 +55,44 @@
</small></pre><pre class="diff" id="context"> </source>
</p>
</subsection>
</pre><pre class="diff" id="added">+ <subsection name="Creating a Loom Sar with Ant">
+ <p>
+ Loom's new metaclass descriptors can still be created with Ant.
+ Since the generation of metaclass descriptors is more generic in
+ Loom compared with Phoenix, but still fully compatible with it,
+ users can deploy applications running in Phoenix 4.0.x by simply
+ regenerating from the Java source the descriptors using the Maven Sar Plugin.
+ </p>
+
+ <p>To do so, use the following in your ant build file (JAR file versions may need to be adjusted to the
+ latest releases) :
+ <source><![CDATA[
+<taskdef
+ name="metaclassGen"
+ classname="org.realityforge.metaclass.tools.tasks.GenerateClassDescriptorsTask"
+>
+ <classpath>
+ <pathelement location="${path.to}/spice-metaclass-1.0-rc3-dev.jar"/>
+ <pathelement location="${path.to}/qdox-1.3.jar"/>
+ <pathelement location="${path.to}/asm-1.4.jar"/>
+ </classpath>
+</taskdef>
+
+<metaclassGen destDir="${dest.dir}" namespaceTagsOnly="false">
+ <fileset dir="${src.dir}"/>
+ <interceptor name="org.jcontainer.loom.info.PhoenixAttributeInterceptor">
+ <classpath>
+ <pathelement location="${path.to}/maven-sar-plugin-1.0-beta1-dev.jar"/>
+ </classpath>
+ </interceptor>
+</metaclassGen>
+
+ ]]></source>
+ </p>
+
+ <p>For the time being, it is recommended to continue using the Ant-based SAR task to create a SAR.
+ (instructions on how to create one without it are welcome!)</p>
+ </subsection>
</pre><pre class="diff" id="context"> <subsection name="Comparison of libraries bundled">
<p>
Compared to the Phoenix 4.0.x distribution, in the Loom 1.0 distribution
</pre><pre class="diff"><small id="info">@@ -57,46 +100,59 @@
</small></pre><pre class="diff" id="context"> <code>lib/</code> directory
have been removed as they are not used by the container.
If your app uses any of the excluded libraries,
</pre><pre class="diff" id="removed">- you simply need to bundle them with the sar<span id="removedchars">.</span>
</pre><pre class="diff" id="added">+ you simply need to bundle them with the sar<span id="addedchars">, or put them in the</span>
+ <code>lib/</code> directory.
+ </p>
+
+ <p>
+ The general migration tip is to make sure that what is in your old
+ <code>lib/</code> directory
+ is either in the new
+ <code>lib/</code> directory, or bundled with your sar.
</pre><pre class="diff" id="context"> </p>
</pre><pre class="diff" id="added">+
+ <p>There were migration issues from Phoenix 4.0.3 to 4.0.4, but that should not be an issue upgrading to
+ Loom, as the problem libraries are no longer in a shared classpath between the Loom core and applications.
+ </p>
+
</pre><pre class="diff" id="context"> <p>
Loom 1.0 comes with a lean set of libraries:
</pre><pre class="diff" id="removed">- <source>
-avalon-framework
-excalibur-instrument
-logkit
-log4j
-mx4j-jmx
-phoenix-client
- </source>
</pre><pre class="diff" id="added">+ <ul>
+ <li>avalon-framework</li>
+ <li>excalibur-instrument</li>
+ <li>logkit</li>
+ <li>log4j</li>
+ <li>mx4j-jmx</li>
+ <li>phoenix-client</li>
+ </ul>
</pre><pre class="diff" id="context"> </p>
<p>
Phoenix 4.0.x ships a bigger set of libraries:
</pre><pre class="diff" id="removed">- <source>
-avalon-framework
-excalibur-baxter
-excalibur-cli
-excalibur-collections
-excalibur-concurrent
-excalibur-configuration
-excalibur-containerkit
-excalibur-extension
-excalibur-i18n
-excalibur-instrument
-excalibur-io
-excalibur-logger
-excalibur-pool
-excalibur-thread
-excalibur-threadcontext
-excalibur-util
-isorelax.jar
-jing.jar
-logkit
-phoenix-client
-xalan
-xercesImpl
-xml-apis
- </source>
</pre><pre class="diff" id="added">+ <ul>
+ <li>avalon-framework</li>
+ <li>excalibur-baxter</li>
+ <li>excalibur-cli</li>
+ <li>excalibur-collections</li>
+ <li>excalibur-concurrent</li>
+ <li>excalibur-configuration</li>
+ <li>excalibur-containerkit</li>
+ <li>excalibur-extension</li>
+ <li>excalibur-i18n</li>
+ <li>excalibur-instrument</li>
+ <li>excalibur-io</li>
+ <li>excalibur-logger</li>
+ <li>excalibur-pool</li>
+ <li>excalibur-thread</li>
+ <li>excalibur-threadcontext</li>
+ <li>excalibur-util</li>
+ <li>isorelax.jar</li>
+ <li>jing.jar</li>
+ <li>logkit</li>
+ <li>phoenix-client</li>
+ <li>xalan</li>
+ <li>xercesImpl</li>
+ <li>xml-apis</li>
+ </ul>
</pre><pre class="diff" id="context"> </p>
</subsection>
</section>
</pre></div>
<hr /><a name="file5" /><div class="file">
<span class="pathname"><a href="http://xstream.cvs.codehaus.org/jcontainer">jcontainer</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom">loom</a>/<a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site">site</a><br /></span>
<div class="fileheader"><big><b>project.xml</b></big> <small id="info"><a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/project.xml?rev=1.35&content-type=text/vnd.viewcvs-markup">1.35</a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/project.xml.diff?r1=1.35&r2=1.36">-></a> <a href="http://xstream.cvs.codehaus.org/jcontainer/loom/site/project.xml?rev=1.36&content-type=text/vnd.viewcvs-markup">1.36</a></small></div>
<pre class="diff"><small id="info">diff -u -r1.35 -r1.36
--- project.xml 15 Dec 2003 17:32:46 -0000 1.35
+++ project.xml 20 Feb 2004 03:37:24 -0000 1.36
@@ -17,9 +17,8 @@
</small></pre><pre class="diff" id="context"> <version>1.2.2</version>
</dependency>
<dependency>
</pre><pre class="diff" id="removed">- <groupId>avalon</groupId>
- <artifactId>avalon-framework</artifactId>
- <version>4.1.4</version>
</pre><pre class="diff" id="added">+ <id>avalon-framework</id>
+ <version>4.1.5</version>
</pre><pre class="diff" id="context"> </dependency>
<dependency>
<groupId>phoenix</groupId>
</pre><pre class="diff"><small id="info">@@ -102,7 +101,7 @@
</small></pre><pre class="diff" id="context"> <dependency>
<groupId>spice</groupId>
<artifactId>spice-metaclass</artifactId>
</pre><pre class="diff" id="removed">- <version>1.0-rc<span id="removedchars">2</span></version>
</pre><pre class="diff" id="added">+ <version>1.0-rc<span id="addedchars">3-dev</span></version>
</pre><pre class="diff" id="context"> </dependency>
<dependency>
<groupId>spice</groupId>
</pre></div>
<center><small><a href="http://www.badgers-in-foil.co.uk/projects/cvsspam/" title="commit -> email">CVSspam</a> 0.2.8</small></center>
</body></html>