You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/07/07 08:55:53 UTC
isis-site git commit: ISIS-1163: migration notes updated
Repository: isis-site
Updated Branches:
refs/heads/asf-site 0a6fe28fa -> 26fb59fcd
ISIS-1163: migration notes updated
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/26fb59fc
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/26fb59fc
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/26fb59fc
Branch: refs/heads/asf-site
Commit: 26fb59fcd6ac0ab94dd54e36af42755b007b2b51
Parents: 0a6fe28
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Jul 7 07:49:18 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Jul 7 07:49:18 2015 +0100
----------------------------------------------------------------------
content/migration-notes.html | 49 ++++++++++++++++++++++++++++++++-------
1 file changed, 41 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/26fb59fc/content/migration-notes.html
----------------------------------------------------------------------
diff --git a/content/migration-notes.html b/content/migration-notes.html
index 90f07e0..af188d3 100644
--- a/content/migration-notes.html
+++ b/content/migration-notes.html
@@ -742,19 +742,13 @@ isis.persistor.datanucleus.impl.datanucleus.schema.validateConstraints=true</cod
</tr>
</table>
</div>
-<div class="literalblock">
-<div class="content">
-<pre> [[_migration-notes_1.8.0-to-1.9.0_upgrading-to-java8]]
-= Upgrading to Java 8
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/</pre>
</div>
</div>
+<div class="sect2">
+<h3 id="_migration-notes_1.8.0-to-1.9.0_upgrading-to-java8">Upgrading to Java 8</h3>
<div class="paragraph">
<p>Apache Isis 1.9.0 is the first version to support Java 8. You can continue to use Java 7, but if you want to move to Java 8 then there are several small changes to be made.</p>
</div>
-</div>
<div class="sect3">
<h4 id="_in_the_parent_code_pom_xml_code_2">In the parent <code>pom.xml</code></h4>
<div class="paragraph">
@@ -910,6 +904,40 @@ isis.persistor.datanucleus.impl.datanucleus.schema.validateConstraints=true</cod
<p>If you did not register this service directly but instead registered a subclass of this service, then you should refactor your code so that your implementation is in a separate service, eg by subclassing <code>ExceptionRecognizerComposite</code>. You should probably also annotate with <code>@DomainService</code>.</p>
</div>
</div>
+<div class="sect2">
+<h3 id="_migration-notes_1.8.0-to-1.9.0_war-packaging">War packaging</h3>
+<div class="paragraph">
+<p>As discussed in <a href="ug.html#_ug_getting-started_simpleapp-archetype">SimpleApp archetype</a> and elsewhere, the <code>org.apache.isis.WebServer</code> provides the ability to run your app from an embedded jetty. This is great for prototyping. The class resides in the <code>isis-core-webserver</code> module, which also has the dependency on jetty.</p>
+</div>
+<div class="paragraph">
+<p>In 1.9.0 we have upgraded the jetty dependency to use Jetty 9.2.0 (<code>org.eclipse.jetty.aggregate:jetty-all:9.2.11.v20150529</code>, to be precise). One consequence of this is that the packaged WAR file will not boot on Tomcat.</p>
+</div>
+<div class="paragraph">
+<p>One fix is to simply remove the <code>isis-core-webserver</code> module as a dependency of your webapp module, however this will prevent you from using our <code>org.apache.isis.WebServer</code> launcher. That’s not necessarily a bad thing; you could continue to use <code>jetty:run</code>, say. But it might be a change to your development workflow that you don’t want.</p>
+</div>
+<div class="paragraph">
+<p>Alternatively you can change your webapp’s <code>pom.xml</code> so that when the war is packaged up it excludes the jetty files. To do this, locate the <code>maven-war-plugin</code> module definition (under <code><build>/<plugins></code> and add to its <code><configuration></code> section:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="xml"><span class="tag"><plugin></span>
+ <span class="tag"><artifactId></span>maven-war-plugin<span class="tag"></artifactId></span>
+ <span class="tag"><configuration></span>
+ ...
+ <span class="tag"><packagingExcludes></span>
+ WEB-INF/lib/isis-core-webserver*.jar,
+ WEB-INF/lib/javax.servlet-api-*.jar,
+ WEB-INF/lib/javax.websocket-api-*.jar,
+ WEB-INF/lib/jetty-all-*.jar
+ <span class="tag"></packagingExcludes></span>
+ <span class="tag"></configuration></span>
+<span class="tag"></plugin></span></code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>For future projects the <a href="ug.html#_ug_getting-started_simpleapp-archetype">SimpleApp archetype</a> has been updated with this change.</p>
+</div>
+</div>
</div>
</div>
<div class="sect1">
@@ -1260,10 +1288,15 @@ into the new <code>org.isisaddons.module.settings:isis-module-settings-dom</code
<li><a href="#_in_the_parent_code_pom_xml_code">In the parent <code>pom.xml</code></a></li>
<li><a href="#_in_code_dom_pom_xml_code">In <code>dom/pom.xml</code>,</a></li>
<li><a href="#_in_the_webapp_s_code_persistor_datanucleus_properties_code">In the webapp’s <code>persistor_datanucleus.properties</code></a></li>
+</ul>
+</li>
+<li><a href="#_migration-notes_1.8.0-to-1.9.0_upgrading-to-java8">Upgrading to Java 8</a>
+<ul class="sectlevel3">
<li><a href="#_in_the_parent_code_pom_xml_code_2">In the parent <code>pom.xml</code></a></li>
</ul>
</li>
<li><a href="#_migration-notes_1.8.0-to-1.9.0_upgrading-to-java8"><code>ExceptionRecognizerCompositeForJdoObjectStore</code></a></li>
+<li><a href="#_migration-notes_1.8.0-to-1.9.0_war-packaging">War packaging</a></li>
</ul>
</li>
<li><a href="#_release-notes_migration-notes_1.7.0-to-1.8.0">From v1.7.0 to 1.8.0</a></li>