anchor.diff:  isis.persistor.datanucleus.impl.datanucleus.identifier.case=MixedCase
   ----
   
  +
  +== Upgrading to Java 8 (1.9.0-SNAPSHOT and later)
  +
  +Apache Isis 1.9.0-SNAPSHOT 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.
  +
  +=== In the parent `pom.xml`
  +
  +under `<build>/<pluginManagement>/<plugins>`, add (or update) maven-enforcer-plugin:
  +
  +[source,xml]
  +----
  +<plugin>
  +    <groupId>org.apache.maven.plugins</groupId>
  +    <artifactId>maven-compiler-plugin</artifactId>
  +    <version>3.1</version>
  +    <configuration>
  +        <source>1.8</source>
  +        <target>1.8</target>
  +        <compilerArgument>-parameters</compilerArgument>
  +    </configuration>
  +    <executions>
  +        <execution>
  +            <id>source</id>
  +            <phase>compile</phase>
  +        </execution>
  +        <execution>
  +            <id>test</id>
  +            <phase>test-compile</phase>
  +        </execution>
  +    </executions>
  +</plugin>
  +----
  +
  +[TIP]
  +====
  +The `-parameters` argument causes the Java compiler to capture the names of method parameters in the `.class` files.  Isis can be configured to use this, thereby avoiding the requirement to annotate every parameter with `@ParameterLayout(named=...)` or `@Named()`.  The necessary configuration is provided in an http://github.com/isisaddons/isis-metamodel-paraname8}[Isis addons' paraname8]  metamodel extension (non-ASF).
  +====
  +
  +We also recommend that you add the `maven-enforcer-plugin` (if not used already).  Again, this resides under `<build>/<pluginManagement>/<plugins>`:
  +
  +[source,xml]
  +----
  +<plugin>
  +    <groupId>org.apache.maven.plugins</groupId>
  +    <artifactId>maven-enforcer-plugin</artifactId>
  +    <version>1.3.1</version>
  +    <configuration>
  +        <rules>
  +            <requireMavenVersion>
  +                <version>[3.2.1,)</version>
  +            </requireMavenVersion>
  +            <requireJavaVersion>
  +                <version>[1.8.0,)</version>
  +            </requireJavaVersion>
  +            <requirePluginVersions>
  +                <message>All plugin versions must be defined!</message>
  +                <banLatest>true</banLatest>
  +                <banRelease>true</banRelease>
  +            </requirePluginVersions>
  +            <DependencyConvergence />
  +        </rules>
  +    </configuration>
  +    <executions>
  +        <execution>
  +            <id>validate-enforce</id>
  +            <phase>validate</phase>
  +            <goals>
  +                <goal>enforce</goal>
  +            </goals>
  +        </execution>
  +    </executions>
  +</plugin>
  +----
  
positive.code: 
  
  
  == In the webapp's `persistor_datanucleus.properties`
  
  in `src/main/webapp/WEB-INF/`,
  
  
negative.code: ----
  
  
  === In `dom/pom.xml`,
  
  under `<build>/<plugins>`, remove:
  
  