Skip to content

Commit

Permalink
Add documentation for CARGO-1628
Browse files Browse the repository at this point in the history
  • Loading branch information
@alitokmen
alitokmen committed May 5, 2024
1 parent 88a2b9f commit 8c1ef2f
Show file tree
Hide file tree
Showing 5 changed files with 9 additions and 10 deletions.
11 changes: 5 additions & 6 deletions cargo/Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -304,9 +304,9 @@ <h3 id="Navigation-Development">Development</h3>
</tr>
<tr valign="top">
<td class="rightColumn">
<h3 id="DeployinglegacyWARstoTomcat10.xonwards-Definition">Definition</h3>Deploying J2EE / Java EE WARs on Tomcat 10.x onwards (which is Jakarta EE)
<p><a href="Tomcat+10.x.html">Tomcat 10.x</a> onwards uses Jakarta EE, which is not backwards compatible with J1EE / Java EE.</p>
<p>To ease migration, a Jakarta EE migration tool is part of Tomcat, and through <a href="https://tomcat.apache.org/tomcat-10.0-doc/config/host.html#Common_Attributes">the <code class="attributeName">legacyAppBase</code> configuration property</a> allows automatic conversion of legacy WARs to Jakarta EE WARs.</p>
<h3 id="DeployinglegacyWARstoTomcat10.xonwards-Definition">Definition</h3><span><a href="Tomcat+10.x.html">Tomcat 10.x</a> onwards uses Jakarta EE, which is not backwards compatible with J2EE / Java EE.
<p></p>
<p>To ease migration, a Jakarta EE migration tool is part of Tomcat, and through <a href="https://tomcat.apache.org/tomcat-10.0-doc/config/host.html#Common_Attributes">the <code class="attributeName">legacyAppBase</code> configuration property</a> allows automatic conversion of legacy WARs to Jakarta EE WARs.</p></span>
<p>Codehaus Cargo 1.10.14 <a href="https://codehaus-cargo.atlassian.net/browse/CARGO-1628">introduced a functionality to benefit for the same</a>, by providing a property called <code>version</code> on <a href="Deployable.html">Deployable</a> objects, to specify whether it is <code>j2ee</code>, <code>javaee</code> or <code>jakartaee</code> and enable the Tomcat deployer to handle it accordingly:</p>
<ul>
<li><code>j2ee</code> and <code>javaee</code> WARs are deployed into the <code>legacyAppBase</code> folder, steered through the property value for <code><a href="https://codehaus-cargo.github.io/apidocs/org/codehaus/cargo/container/tomcat/TomcatPropertySet.html#WEBAPPS_LEGACY_DIRECTORY">TomcatPropertySet.WEBAPPS_LEGACY_DIRECTORY</a></code></li>
Expand Down Expand Up @@ -344,7 +344,7 @@ <h3 id="DeployinglegacyWARstoTomcat10.xonwards-ExampleusingtheAnttasks">Example
<pre class="syntaxhighlighter-pre">&lt;cargo containerId="tomcat10x" home="c:/tomcat/tomcat-10.1.23" action="start"&gt;
&lt;configuration&gt;
&lt;deployable type="war" file="path/to/some-war.war"&gt;
&lt;property name="versiob" value="javaee"/&gt;
&lt;property name="version" value="javaee"/&gt;
&lt;/deployable&gt;
&lt;/configuration&gt;
&lt;/cargo&gt;
Expand Down Expand Up @@ -392,8 +392,7 @@ <h3 id="DeployinglegacyWARstoTomcat10.xonwards-ExampleusingtheMaven3plugin">Exam
&lt;/plugins&gt;
</pre>
</div>
</div>
<p><br></p></td>
</div></td>
</tr>
</tbody>
</table></td>
Expand Down
2 changes: 1 addition & 1 deletion cargo/Features.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -373,7 +373,7 @@ <h3 id="Navigation-Development">Development</h3>
<li><a href="Static+deployment+of+RAR.html">Static deployment of RAR</a> — <span class="smalltext">Deploy a Java EE resource adapter (RAR) that will be started when the container starts</span></li>
<li><a href="Static+deployment+of+WAR.html">Static deployment of WAR</a> — <span class="smalltext">Deploy a WAR that will be started when the container starts</span>
<ul class="childpages-macro">
<li><a href="Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html">Deploying legacy WARs to Tomcat 10.x onwards</a> — <span class="smalltext">Deploying J2EE / Java EE WARs on Tomcat 10.x onwards (which is Jakarta EE)</span></li>
<li><a href="Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html">Deploying legacy WARs to Tomcat 10.x onwards</a> — <span class="smalltext">Tomcat 10.x onwards uses Jakarta EE, which is not backwards compatible with J2EE / Java EE.</span></li>
</ul></li>
</ul></li>
</ul></li>
Expand Down
2 changes: 1 addition & 1 deletion cargo/TomEE+9.x.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -308,7 +308,7 @@ <h3 id="Navigation-Development">Development</h3>
<span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"> </span>
<div class="confluence-information-macro-body">
<p>Users of TomEE 9.x onwards should be aware that, as a result of the move from Java EE to Jakarta EE as part of the transfer of Java EE to the Eclipse Foundation, the primary package for all implemented APIs has changed from <code>javax.*</code> to <code>jakarta.*</code>. This will almost certainly require code changes to enable applications to migrate to TomEE 9.x and later.</p>
<p>TomEE 9 has an integrated functionality for automatically migrating J2EE / Java EE WARs to Jakarta EE. You can follow the instructions on <a href="Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html">Deploying legacy WARs to Tomcat 10.x onwards</a> to make use of it.</p>
<p>TomEE 9.x has an integrated functionality for automatically migrating J2EE / Java EE WARs to Jakarta EE. You can follow the instructions on <a href="Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html">Deploying legacy WARs to Tomcat 10.x onwards</a> to make use of it.</p>
</div>
</div>
<h3 id="TomEE9.x-ContainerFeatures">Container Features</h3>
Expand Down
2 changes: 1 addition & 1 deletion cargo/Tomcat+10.x.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -308,7 +308,7 @@ <h3 id="Navigation-Development">Development</h3>
<span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"> </span>
<div class="confluence-information-macro-body">
<p>Users of Tomcat 10.x onwards should be aware that, as a result of the move from Java EE to Jakarta EE as part of the transfer of Java EE to the Eclipse Foundation, the primary package for all implemented APIs has changed from <code>javax.*</code> to <code>jakarta.*</code>. This will almost certainly require code changes to enable applications to migrate to Tomcat 10.x and later.</p>
<p>Tomcat 10 has an integrated functionality for automatically migrating J2EE / Java EE WARs to Jakarta EE. You can follow the instructions on <a href="Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html">Deploying legacy WARs to Tomcat 10.x onwards</a> to make use of it.</p>
<p>Tomcat 10.x has an integrated functionality for automatically migrating J2EE / Java EE WARs to Jakarta EE. You can follow the instructions on <a href="Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html">Deploying legacy WARs to Tomcat 10.x onwards</a> to make use of it.</p>
</div>
</div>
<h3 id="Tomcat10.x-ContainerFeatures">Container Features</h3>
Expand Down
2 changes: 1 addition & 1 deletion cargo/Tomcat+11.x.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -308,7 +308,7 @@ <h3 id="Navigation-Development">Development</h3>
<span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"> </span>
<div class="confluence-information-macro-body">
<p>Users of Tomcat 10.x onwards should be aware that, as a result of the move from Java EE to Jakarta EE as part of the transfer of Java EE to the Eclipse Foundation, the primary package for all implemented APIs has changed from <code>javax.*</code> to <code>jakarta.*</code>. This will almost certainly require code changes to enable applications to migrate to Tomcat 10.x and later.</p>
<p>Tomcat 10 has an integrated functionality for automatically migrating J2EE / Java EE WARs to Jakarta EE. You can follow the instructions on <a href="Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html">Deploying legacy WARs to Tomcat 10.x onwards</a> to make use of it.</p>
<p>Tomcat 10.x has an integrated functionality for automatically migrating J2EE / Java EE WARs to Jakarta EE. You can follow the instructions on <a href="Deploying+legacy+WARs+to+Tomcat+10.x+onwards.html">Deploying legacy WARs to Tomcat 10.x onwards</a> to make use of it.</p>
</div>
</div>
<h3 id="Tomcat11.x-ContainerFeatures">Container Features</h3>
Expand Down

0 comments on commit 8c1ef2f

Please sign in to comment.