You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openjpa.apache.org by al...@apache.org on 2012/11/17 01:09:34 UTC
svn commit: r1410639 - in /openjpa/site/trunk: WhoIsWorkingOnWhat.txt
content/building.mdtext
Author: allee8285
Date: Sat Nov 17 00:09:33 2012
New Revision: 1410639
URL: http://svn.apache.org/viewvc?rev=1410639&view=rev
Log:
CMS migration updates.
Modified:
openjpa/site/trunk/WhoIsWorkingOnWhat.txt
openjpa/site/trunk/content/building.mdtext
Modified: openjpa/site/trunk/WhoIsWorkingOnWhat.txt
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/WhoIsWorkingOnWhat.txt?rev=1410639&r1=1410638&r2=1410639&view=diff
==============================================================================
--- openjpa/site/trunk/WhoIsWorkingOnWhat.txt (original)
+++ openjpa/site/trunk/WhoIsWorkingOnWhat.txt Sat Nov 17 00:09:33 2012
@@ -13,7 +13,7 @@ done automated-builds.mdtext
begin-using-openjpa---the-basics.mdtext
build-and-runtime-dependencies.mdtext
building-and-running-openbooks.mdtext
- building.mdtext
+done building.mdtext
done coding-standards.mdtext
committers.mdtext
community.mdtext
Modified: openjpa/site/trunk/content/building.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/building.mdtext?rev=1410639&r1=1410638&r2=1410639&view=diff
==============================================================================
--- openjpa/site/trunk/content/building.mdtext (original)
+++ openjpa/site/trunk/content/building.mdtext Sat Nov 17 00:09:33 2012
@@ -1,25 +1,30 @@
Title: Building
-{excerpt:hidden=true}How to build OpenJPA from source{excerpt}
+<a name="Building"></a>
<a name="Building-Contents"></a>
# Contents
+
* [Building OpenJPA](#Building-BuildingOpenJPA)
- * [Maven](#Building-Maven)
- * [Command Line Builds](#Building-CommandLineBuilds)
- * [Executing various Maven build tasks](#Building-ExecutingvariousMavenbuildtasks)
- * [Running just the "TestPersistence" test case](#Building-Runningjustthe"TestPersistence"testcase)
+
+ * [Maven](#Building-Maven)
+
+ * [Command Line Builds](#Building-CommandLineBuilds)
+ * [Executing various Maven build tasks](#Building-ExecutingvariousMavenbuildtasks)
+
+ * [Running just the "TestPersistence" test case](#Building-RunningjusttheTestPersistencetestcase)
* [Running tests with Java 2 security enabled](#Building-RunningtestswithJava2securityenabled)
* [Building and running only the examples included in the distribution](#Building-Buildingandrunningonlytheexamplesincludedinthedistribution)
* [Building just the javadoc](#Building-Buildingjustthejavadoc)
* [Building just the docbook documentation](#Building-Buildingjustthedocbookdocumentation)
- * [Building with JDK 1.4 module verification (only for versions of OpenJPA
-prior to svn revision 640685)](#Building-BuildingwithJDK1.4moduleverification(onlyforversionsofOpenJPApriortosvnrevision640685))
- * [Eclipse with Command-line Maven utilities](#Building-EclipsewithCommand-lineMavenutilities)
- * [Eclipse with M2Eclipse plugin](#Building-EclipsewithM2Eclipseplugin)
- * [Common 2.x Build Problems](#Building-Common2.xBuildProblems)
- * [Wrong Maven Level](#Building-WrongMavenLevel)
- * [Wrong Java Level](#Building-WrongJavaLevel)
- * [Missing License Headers](#Building-MissingLicenseHeaders)
+ * [Building with JDK 1.4 module verification (only for versions of OpenJPA prior to svn revision 640685)](#Building-BuildingwithJDK1.4moduleverification(onlyforversionsofOpenJPApriortosvnrevision640685))
+
+ * [Eclipse with Command-line Maven utilities](#Building-EclipsewithCommand-lineMavenutilities)
+ * [Eclipse with M2Eclipse plugin](#Building-EclipsewithM2Eclipseplugin)
+ * [Common 2.x Build Problems](#Building-Common2.xBuildProblems)
+
+ * [Wrong Maven Level](#Building-WrongMavenLevel)
+ * [Wrong Java Level](#Building-WrongJavaLevel)
+ * [Missing License Headers](#Building-MissingLicenseHeaders)
<a name="Building-BuildingOpenJPA"></a>
# Building OpenJPA
@@ -38,51 +43,48 @@ code (from the Subversion source code ma
(using the Apache Maven 2 build tool). They are written for use from the
console, and are known to work on Linux, Mac OSX and Windows.
-1. Ensure that you have Java installed and in your path by running: {{java
--fullversion}}
+1. Ensure that you have Java installed and in your path by running: `java
+-fullversion`
1. Install the build tool, Apache Maven 2.2.1 or later, from
-http://maven.apache.org/. If it is installed correctly, typing *mvn -v*
-from the console will result in text like {{Apache Maven 2.2.1 (r801777;
-2009-08-06 21:16:01+0200)}}
-1. Install Subversion v1.4.x or newer from http://subversion.apache.org/.
+<http://maven.apache.org/>. If it is installed correctly, typing *mvn -v*
+from the console will result in text like `Apache Maven 2.2.1 (r801777;
+2009-08-06 21:16:01+0200)`
+1. Install Subversion v1.4.x or newer from <http://subversion.apache.org/>.
If it is installed correctly, typing the following command should output
-help information: *svn help* or *svn --version*
+help information: **svn help** or **svn --version**
1. Create a new directory you want to do your work in, then change to that
directory from the console.
-1. Check out the sources by running: {{svn co
-https://svn.apache.org/repos/asf/openjpa/trunk openjpa-trunk}}. It will
+1. Check out the sources by running: `svn co`
+<https://svn.apache.org/repos/asf/openjpa/trunk> `openjpa-trunk`. It will
check out the sources to the openjpa-trunk directory. More information on
checking out the OpenJPA sources can be found on the [Source Code](source-code.html)
page.
1. Change to the openjpa-trunk directory, which has already been created in
the previous step.
-1. Build OpenJPA by running: *mvn package* or better *mvn install*. The
+1. Build OpenJPA by running: `mvn package` or better `mvn install`. The
first time you run the build, many dependencies are automatically resolved
-and downloaded. *It is common for dependency downloading to fail the first
-time, which will fail the build.* If any of these dependency downloads
+and downloaded. **It is common for dependency downloading to fail the first
+time, which will fail the build.** If any of these dependency downloads
fail, just re-run the command. You may also add the following to your
-*~/.m2/setting.xml* file (see
-http://maven.apache.org/guides/mini/guide-mirror-settings.html)
-
-
- <settings>
- <mirrors>
- <mirror>
- <id>repo.mergere.com</id>
- <url>http://repo.mergere.com/maven2</url>
- <mirrorOf>central</mirrorOf>
- </mirror>
- </mirrors>
- </settings>
+`~/.m2/setting.xml` file (see <http://maven.apache.org/guides/mini/guide-mirror-settings.html>)
+ <settings>
+ <mirrors>
+ <mirror>
+ <id>repo.mergere.com</id>
+ <url>http://repo.mergere.com/maven2</url>
+ <mirrorOf>central</mirrorOf>
+ </mirror>
+ </mirrors>
+ </settings>
If any tests fail, and you want to ignore the failures, instead run:
- *mvn package -DfailIfNoTests=false*
+ `mvn package -DfailIfNoTests=false`
- or
+ or
- *mvn package -DskipTests*
+ `mvn package -DskipTests`
An example session is as follows:
@@ -120,8 +122,7 @@ An example session is as follows:
A trunk/openjpa-lib/src/test/java/org/apache/openjpa
A trunk/openjpa-lib/src/test/java/org/apache/openjpa/lib
A trunk/openjpa-lib/src/test/java/org/apache/openjpa/lib/test
- A
-trunk/openjpa-lib/src/test/java/org/apache/openjpa/lib/test/AbstractTestCase.java
+ A trunk/openjpa-lib/src/test/java/org/apache/openjpa/lib/test/AbstractTestCase.java
...
@@ -132,170 +133,98 @@ trunk/openjpa-lib/src/test/java/org/apac
$ mvn compile
- [INFO]
- Scanning for projects...
- [INFO]
- Reactor build order:
- [INFO]
- OpenJPA Parent POM
- [INFO]
- OpenJPA Utilities Library
- [INFO]
- OpenJPA Kernel
- [INFO]
- OpenJPA JDBC
- [INFO]
- OpenJPA Persistence
- [INFO]
- OpenJPA Persistence JDBC
- [INFO]
- OpenJPA Persistence Locking Tests
- [INFO]
- OpenJPA XML Store
- [INFO]
- OpenJPA Slice
- [INFO]
- OpenJPA JEST
- [INFO]
- OpenJPA Aggregate Jar
- [INFO]
- OpenJPA Aggregate Jar with Dependencies
- [INFO]
- OpenJPA Project Docs and Assemblies
- [INFO]
- OpenJPA Examples
- [INFO]
- OpenJPA Examples - Simple
- [INFO]
- OpenJPA Examples - image-gallery
- [INFO]
- OpenJPA Examples - OpenBooks
- [INFO]
- OpenJPA Integration Tests
- [INFO]
- OpenJPA Integration Tests - Daytrader
- [INFO]
- OpenJPA Integration Tests - Examples
- [INFO]
- OpenJPA Integration Tests - SLF4JLogFactory
- [INFO]
- OpenJPA Integration Tests - JPA TCK
- [INFO]
- OpenJPA Integration Tests - Bean Validation
- [INFO]
- OpenJPA Integration Tests - JMX Platform MBeans
- [INFO]
- ------------------------------------------------------------------------
- [INFO]
- Building OpenJPA Parent POM
- [INFO]
- task-segment: [compile]
- [INFO]
- ------------------------------------------------------------------------
+ [INFO] Scanning for projects...
+ [INFO] Reactor build order:
+ [INFO] OpenJPA Parent POM
+ [INFO] OpenJPA Utilities Library
+ [INFO] OpenJPA Kernel
+ [INFO] OpenJPA JDBC
+ [INFO] OpenJPA Persistence
+ [INFO] OpenJPA Persistence JDBC
+ [INFO] OpenJPA Persistence Locking Tests
+ [INFO] OpenJPA XML Store
+ [INFO] OpenJPA Slice
+ [INFO] OpenJPA JEST
+ [INFO] OpenJPA Aggregate Jar
+ [INFO] OpenJPA Aggregate Jar with Dependencies
+ [INFO] OpenJPA Project Docs and Assemblies
+ [INFO] OpenJPA Examples
+ [INFO] OpenJPA Examples - Simple
+ [INFO] OpenJPA Examples - image-gallery
+ [INFO] OpenJPA Examples - OpenBooks
+ [INFO] OpenJPA Integration Tests
+ [INFO] OpenJPA Integration Tests - Daytrader
+ [INFO] OpenJPA Integration Tests - Examples
+ [INFO] OpenJPA Integration Tests - SLF4JLogFactory
+ [INFO] OpenJPA Integration Tests - JPA TCK
+ [INFO] OpenJPA Integration Tests - Bean Validation
+ [INFO] OpenJPA Integration Tests - JMX Platform MBeans
+ [INFO] ------------------------------------------------------------------------
+ [INFO] Building OpenJPA Parent POM
+ [INFO] task-segment: [compile]
+ [INFO] ------------------------------------------------------------------------
...
[INFO]
- [INFO]
- ------------------------------------------------------------------------
- [INFO]
- Reactor Summary:
- [INFO]
- ------------------------------------------------------------------------
- [INFO]
- OpenJPA Parent POM .................................... SUCCESS [1:23.143s]
- [INFO]
- OpenJPA Utilities Library ............................. SUCCESS [13.749s]
- [INFO]
- OpenJPA Kernel ........................................ SUCCESS [19.251s]
- [INFO]
- OpenJPA JDBC .......................................... SUCCESS [14.351s]
- [INFO]
- OpenJPA Persistence ................................... SUCCESS [10.254s]
- [INFO]
- OpenJPA Persistence JDBC .............................. SUCCESS [46.774s]
- [INFO]
- OpenJPA Persistence Locking Tests ..................... SUCCESS [15.183s]
- [INFO]
- OpenJPA XML Store ..................................... SUCCESS [11.788s]
- [INFO]
- OpenJPA Slice ......................................... SUCCESS [4.437s]
- [INFO]
- OpenJPA JEST .......................................... SUCCESS [4.854s]
- [INFO]
- OpenJPA Aggregate Jar ................................. SUCCESS [10.729s]
- [INFO]
- OpenJPA Aggregate Jar with Dependencies ............... SUCCESS [6.761s]
- [INFO]
- OpenJPA Project Docs and Assemblies ................... SUCCESS [1:41.937s]
- [INFO]
- OpenJPA Examples ...................................... SUCCESS [0.663s]
- [INFO]
- OpenJPA Examples - Simple ............................. SUCCESS [1.475s]
- [INFO]
- OpenJPA Examples - image-gallery ...................... SUCCESS [3.920s]
- [INFO]
- OpenJPA Examples - OpenBooks .......................... SUCCESS [12.961s]
- [INFO]
- OpenJPA Integration Tests ............................. SUCCESS [0.381s]
- [INFO]
- OpenJPA Integration Tests - Daytrader ................. SUCCESS [7.565s]
- [INFO]
- OpenJPA Integration Tests - Examples .................. SUCCESS [0.269s]
- [INFO]
- OpenJPA Integration Tests - SLF4JLogFactory ........... SUCCESS [1.977s]
- [INFO]
- OpenJPA Integration Tests - JPA TCK ................... SUCCESS [0.248s]
- [INFO]
- OpenJPA Integration Tests - Bean Validation ........... SUCCESS [3.213s]
- [INFO]
- OpenJPA Integration Tests - JMX Platform MBeans ....... SUCCESS [7.729s]
- [INFO]
- ------------------------------------------------------------------------
- [INFO]
- ------------------------------------------------------------------------
- [INFO]
- BUILD SUCCESSFUL
- [INFO]
- ------------------------------------------------------------------------
- [INFO]
- Total time: 6 minutes 26 seconds
- [INFO]
- Finished at: Sun Jan 30 19:43:50 CET 2011
- [INFO]
- Final Memory: 92M/158M
- [INFO]
- ------------------------------------------------------------------------
+ [INFO] ------------------------------------------------------------------------
+ [INFO] Reactor Summary:
+ [INFO] ------------------------------------------------------------------------
+ [INFO] OpenJPA Parent POM .................................... SUCCESS [1:23.143s]
+ [INFO] OpenJPA Utilities Library ............................. SUCCESS [13.749s]
+ [INFO] OpenJPA Kernel ........................................ SUCCESS [19.251s]
+ [INFO] OpenJPA JDBC .......................................... SUCCESS [14.351s]
+ [INFO] OpenJPA Persistence ................................... SUCCESS [10.254s]
+ [INFO] OpenJPA Persistence JDBC .............................. SUCCESS [46.774s]
+ [INFO] OpenJPA Persistence Locking Tests ..................... SUCCESS [15.183s]
+ [INFO] OpenJPA XML Store ..................................... SUCCESS [11.788s]
+ [INFO] OpenJPA Slice ......................................... SUCCESS [4.437s]
+ [INFO] OpenJPA JEST .......................................... SUCCESS [4.854s]
+ [INFO] OpenJPA Aggregate Jar ................................. SUCCESS [10.729s]
+ [INFO] OpenJPA Aggregate Jar with Dependencies ............... SUCCESS [6.761s]
+ [INFO] OpenJPA Project Docs and Assemblies ................... SUCCESS [1:41.937s]
+ [INFO] OpenJPA Examples ...................................... SUCCESS [0.663s]
+ [INFO] OpenJPA Examples - Simple ............................. SUCCESS [1.475s]
+ [INFO] OpenJPA Examples - image-gallery ...................... SUCCESS [3.920s]
+ [INFO] OpenJPA Examples - OpenBooks .......................... SUCCESS [12.961s]
+ [INFO] OpenJPA Integration Tests ............................. SUCCESS [0.381s]
+ [INFO] OpenJPA Integration Tests - Daytrader ................. SUCCESS [7.565s]
+ [INFO] OpenJPA Integration Tests - Examples .................. SUCCESS [0.269s]
+ [INFO] OpenJPA Integration Tests - SLF4JLogFactory ........... SUCCESS [1.977s]
+ [INFO] OpenJPA Integration Tests - JPA TCK ................... SUCCESS [0.248s]
+ [INFO] OpenJPA Integration Tests - Bean Validation ........... SUCCESS [3.213s]
+ [INFO] OpenJPA Integration Tests - JMX Platform MBeans ....... SUCCESS [7.729s]
+ [INFO] ------------------------------------------------------------------------
+ [INFO] ------------------------------------------------------------------------
+ [INFO] BUILD SUCCESSFUL
+ [INFO] ------------------------------------------------------------------------
+ [INFO] Total time: 6 minutes 26 seconds
+ [INFO] Finished at: Sun Jan 30 19:43:50 CET 2011
+ [INFO] Final Memory: 92M/158M
+ [INFO] ------------------------------------------------------------------------
$ mvn package -DskipTests
- [INFO]
- Scanning for projects...
+ [INFO] Scanning for projects...
...
- [INFO]
- Building zip:
-/tmp/trunk/openjpa-project/target/site/downloads/apache-openjpa-2.2.0-SNAPSHOT-binary.zip
+ [INFO] Building zip:/tmp/trunk/openjpa-project/target/site/downloads/apache-openjpa-2.2.0-SNAPSHOT-binary.zip
...
$ ls -lh openjpa-project/target/site/downloads/
total 40M
- -rw-r--r-- 1 milosz milosz 15M Jan 30 19:41
-apache-openjpa-2.2.0-SNAPSHOT-binary.zip
- -rw-r--r-- 1 milosz milosz 25M Jan 30 19:43
-apache-openjpa-2.2.0-SNAPSHOT-source.zip
+ -rw-r--r-- 1 milosz milosz 15M Jan 30 19:41 apache-openjpa-2.2.0-SNAPSHOT-binary.zip
+ -rw-r--r-- 1 milosz milosz 25M Jan 30 19:43 apache-openjpa-2.2.0-SNAPSHOT-source.zip
-
-
<a name="Building-ExecutingvariousMavenbuildtasks"></a>
### Executing various Maven build tasks
-<a name="Building-Runningjustthe"TestPersistence"testcase"></a>
+<a name="Building-RunningjusttheTestPersistencetestcase"></a>
##### Running just the "TestPersistence" test case
@@ -341,15 +270,13 @@ The javadoc will be output to *target/si
mvn -f openjpa-project/pom.xml process-resources -Pdocbook-profile
-The manual HTML will be output to
-*openjpa-project/target/manual/manual.html*.
+The manual HTML will be output to `openjpa-project/target/manual/manual.html`.
-h5. Building with JDK 1.4 module verification (only for versions of OpenJPA
-prior to svn revision 640685)
+<a name="Building-BuildingwithJDK1.4moduleverification(onlyforversionsofOpenJPApriortosvnrevision640685)"></a>
+##### Building with JDK 1.4 module verification (only for versions of OpenJPA prior to svn revision 640685)
- mvn compile -Djava14.jar=C:\Program Files\Java\j2re1.4.2_07\lib\rt.jar
-compile
+ mvn compile -Djava14.jar=C:\Program Files\Java\j2re1.4.2_07\lib\rt.jar compile
Specifying the "java14.jar" system property will cause the
@@ -365,60 +292,67 @@ which is why it needs to be manually spe
1. Checkout the source as described above
1. Build the source using Maven as described above
-
-
-
- mvn eclipse:eclipse
-
-
-
-
- mvn eclipse:configure-workspace -Declipse.workspace=${path to your
-workspace}
+1. Create the Eclipse Metadata -
+
+ mvn eclipse:eclipse
+ 1. If this is the first project in your workspace to use maven artifacts you need to create a classpath variable named M2_REPO which contains the full path to your local repository. The eclipse plugin can do this for you with the following command
+
+ mvn eclipse:configure-workspace -Declipse.workspace=${path to your workspace}
1. Start Eclipse (3.2 - 3.4 SR2 are known to work) and create a new
workspace
1. Import the OpenJPA projects, by:
-** Select File --> Import... --> General - Existing Projects into Workspace
---> Next
-** Select root directory = <svn checkout location above>
-** Deselect the openjpa-examples project
-** Press Finish
+
+ * Select File --> Import... --> General - Existing Projects into Workspace --> Next
+ * Select root directory = <svn checkout location above>
+ * Deselect the openjpa-examples project
+ * Press Finish
+
1. A few fixups will be required to remove the errors that exist in the
imported projects...
-** openjpa-kernel -> Properties -> Java Build Path -> Source -> Add Folders
-*** add target/generated-sources/javacc
-** openjpa-jdbc -> Properties -> Java Build Path -> Libraries -> JRE System
-Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
-can not use Java SE 6)
-** openjpa-persistence -> Properties -> Java Build Path -> Libraries -> JRE
-System Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+
+ * openjpa-kernel -> Properties -> Java Build Path -> Source -> Add Folders
+
+ * add target/generated-sources/javacc
+
+ * openjpa-jdbc -> Properties -> Java Build Path -> Libraries -> JRE System Library -> Edit
+
+ * change this to a Java 6 JRE to remove these errors (see below if you can not use Java SE 6)
+
+ * openjpa-persistence -> Properties -> Java Build Path -> Libraries -> JRE System Library -> Edit
+
+ * change this to a Java 6 JRE to remove these errors (see below if you
can not use Java SE 6)
-** openjpa-persistence-jdbc -> Properties -> Java Build Path -> Libraries
+
+ * openjpa-persistence-jdbc -> Properties -> Java Build Path -> Libraries
-> JRE System Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+
+ * change this to a Java 6 JRE to remove these errors (see below if you
can not use Java SE 6)
-** openjpa-examples. Open up src/main/java and select ReverseMapping
+
+ * openjpa-examples. Open up src/main/java and select ReverseMapping
folder. Right mouse click.
-*** Select Build Path -> Exclude
+
+ * Select Build Path -> Exclude
+
1. For each imported project, you'll need to edit the build properties to
remove an incorrect dependency:
-** Project --> Properties --> Java Build Path --> Source
-** Remove openjpa-project from the list of source folders
+
+ * Project --> Properties --> Java Build Path --> Source
+ * Remove openjpa-project from the list of source folders
For Java SE 5 users building from the 2.0.x branch, you will need to
exclude some Java SE 6 specific classes by performing the following steps
for the source:
+
1. Open the Properties for openjpa-persistence
1. Select Java Build Path --> Source
1. Edit the openjpa-persistence/src/main/java --> Excluded setting to
include the following:
- org/apache/openjpa/persistence/meta/AnnotationProcessor6.java
- org/apache/openjpa/persistence/meta/CompileTimeLogger.java
- org/apache/openjpa/persistence/meta/SourceAnnotationHandler.java
+ org/apache/openjpa/persistence/meta/AnnotationProcessor6.java
+ org/apache/openjpa/persistence/meta/CompileTimeLogger.java
+ org/apache/openjpa/persistence/meta/SourceAnnotationHandler.java
<a name="Building-EclipsewithM2Eclipseplugin"></a>
@@ -429,57 +363,58 @@ include the following:
1. Start Eclipse (3.5 Galileo is recommended) and create a new workspace
1. Good references for this M2Eclipse plugin (need to install the plugin
into your Eclipse environment)
-** http://m2eclipse.codehaus.org/
-** http://docs.codehaus.org/display/M2ECLIPSE/Home
-**
-http://www.theserverside.com/tt/articles/article.tss?l=Introductiontom2eclipse
+
+ * <http://m2eclipse.codehaus.org/>
+ * <http://docs.codehaus.org/display/M2ECLIPSE/Home>
+ * <http://www.theserverside.com/tt/articles/article.tss?l=Introductiontom2eclipse>
+
1. Import the OpenJPA projects, by:
-** Select File --> Import... --> General -> Maven Projects --> Next
-** Select root directory = <svn checkout location above>
-** All of the pom.xml files should be pre-selected for the svn checkout
+
+ * Select File --> Import... --> General -> Maven Projects --> Next
+ * Select root directory = <svn checkout location above>
+ * All of the pom.xml files should be pre-selected for the svn checkout
location
-** You can affect the naming convention used for the generated Eclipse projects (one for each Maven module). Click on Advanced and fill in the Name Template field. I prefer "TRUNK-\[artifactId\](artifactid\.html)
+ * You can affect the naming convention used for the generated Eclipse projects (one for each Maven module). Click on Advanced and fill in the Name Template field. I prefer "TRUNK-\[artifactId\](artifactid\.html)
" since it helps with workspace organization, but it's your choice.
-** Press Finish
-** *Note:* You may get a popup internal error at the end of this Import
+ * Press Finish
+ * **Note:** You may get a popup internal error at the end of this Import
processing. Not sure what the problem is, but it doesn't seem to affect
the usage.
+
1. A few fixups will be required to remove the errors that exist in the
imported projects...
-** openjpa-kernel -> Properties -> Java Build Path -> Source -> Add Folders
-*** add target/generated-sources/javacc
-** openjpa-jdbc -> Properties -> Java Build Path -> Libraries -> JRE System
+
+ * openjpa-kernel -> Properties -> Java Build Path -> Source -> Add Folders
+ * add target/generated-sources/javacc
+ * openjpa-jdbc -> Properties -> Java Build Path -> Libraries -> JRE System
Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+ * change this to a Java 6 JRE to remove these errors (see below if you
can not use Java SE 6)
-** openjpa-persistence -> Properties -> Java Build Path -> Libraries -> JRE
+ * openjpa-persistence -> Properties -> Java Build Path -> Libraries -> JRE
System Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+ * change this to a Java 6 JRE to remove these errors (see below if you
can not use Java SE 6)
-** openjpa-persistence-jdbc -> Properties -> Java Build Path -> Libraries
+ * openjpa-persistence-jdbc -> Properties -> Java Build Path -> Libraries
-> JRE System Library -> Edit
-*** change this to a Java 6 JRE to remove these errors (see below if you
+ * change this to a Java 6 JRE to remove these errors (see below if you
can not use Java SE 6)
-** openjpa-examples. Open up src/main/java and select ReverseMapping
+ * openjpa-examples. Open up src/main/java and select ReverseMapping
folder. Right mouse click.
-*** Select Build Path -> Exclude
+ * Select Build Path -> Exclude
For Java SE 5 users building from the 2.0.x branch, you will need to
exclude some Java SE 6 specific classes by performing the following steps
for the source:
+
1. Open the Properties for BR20-openjpa-persistence (or whatever your naming
convention is)
1. Select Java Build Path --> Source
1. Edit the openjpa-persistence/src/main/java --> Excluded setting to
include the following:
- org/apache/openjpa/persistence/meta/AnnotationProcessor6.java
- org/apache/openjpa/persistence/meta/CompileTimeLogger.java
- org/apache/openjpa/persistence/meta/SourceAnnotationHandler.java
-
-
-
-
+ org/apache/openjpa/persistence/meta/AnnotationProcessor6.java
+ org/apache/openjpa/persistence/meta/CompileTimeLogger.java
+ org/apache/openjpa/persistence/meta/SourceAnnotationHandler.java
<a name="Building-Common2.xBuildProblems"></a>
## Common 2.x Build Problems
@@ -488,114 +423,73 @@ include the following:
### Wrong Maven Level
Example Maven output -
-{code:none}
-[INFO](info.html)
- [enforcer:enforce {execution: default}]
-[WARNING](warning.html)
- Rule 0: org.apache.maven.plugins.enforcer.RequireMavenVersion failed with
-message:
-Detected Maven Version: 2.0.10 is not in the allowed range [2.2.1,).
-[INFO](info.html)
- ------------------------------------------------------------------------
-[ERROR](error.html)
- BUILD ERROR
-[INFO](info.html)
- ------------------------------------------------------------------------
-[INFO](info.html)
- Some Enforcer rules have failed. Look above for specific messages
-explaining why the rule failed.
- Solution - Upgrade to Maven 2.2.1 or later
-
- h3. Wrong Java Level
+ [INFO] [enforcer:enforce {execution: default}]
+ [WARNING] Rule 0: org.apache.maven.plugins.enforcer.RequireMavenVersion failed with message:
+ Detected Maven Version: 2.0.10 is not in the allowed range [2.2.1,).
+ [INFO] ------------------------------------------------------------------------
+ [ERROR] BUILD ERROR
+ [INFO] ------------------------------------------------------------------------
+ [INFO] Some Enforcer rules have failed. Look above for specific messages explaining why the rule failed.
+
+Solution - Upgrade to Maven 2.2.1 or later
+
+<a name="Building-WrongJavaLevel"></a>
+### Wrong Java Level
- Example Maven output -
- {code:none}
- [INFO]
- [enforcer:enforce {execution: default}]
- [WARNING]
- Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion failed with
-message:
+Example Maven output -
+
+ [INFO] [enforcer:enforce {execution: default}]
+ [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion failed with message:
Detected JDK Version: 1.5.0-19 is not in the allowed range [1.6,).
- [INFO]
- ------------------------------------------------------------------------
- [ERROR]
- BUILD ERROR
- [INFO]
- ------------------------------------------------------------------------
- [INFO]
- Some Enforcer rules have failed. Look above for specific messages
-explaining why the rule failed.
+ [INFO] ------------------------------------------------------------------------
+ [ERROR] BUILD ERROR
+ [INFO] ------------------------------------------------------------------------
+ [INFO] Some Enforcer rules have failed. Look above for specific messages explaining why the rule failed.
Solution - Upgrade to latest Sun JDK 1.6.0 or IBM 6 SDK
+
Note - OpenJDK and Java SE 7 are not supported at this time.
<a name="Building-MissingLicenseHeaders"></a>
### Missing License Headers
Example Maven output -
-{code:none}
-. . .
-[INFO](info.html)
- ------------------------------------------------------------------------
-[INFO](info.html)
- Building OpenJPA Parent POM
-[INFO](info.html)
- task-segment: [clean, install]
-[INFO](info.html)
- ------------------------------------------------------------------------
-. . .
-[INFO](info.html)
- [enforcer:enforce {execution: default}]
-[INFO](info.html)
- [source:test-jar {execution: attach-sources}]
-[INFO](info.html)
- [ianal:verify-legal-files {execution: default}]
-[INFO](info.html)
- [apache-rat:check {execution: default}]
-[INFO](info.html)
- Exclude: **/javax.persistence.spi.PersistenceProvider
-[INFO](info.html)
- Exclude: **/javax.annotation.processing.Processor
-[INFO](info.html)
- Exclude: **/*.rsrc
-[INFO](info.html)
- Exclude: **/org.apache.openjpa.revision.properties
-[INFO](info.html)
- Exclude: scripts/*.list
-[INFO](info.html)
- Exclude: scripts/*.options
-[INFO](info.html)
- Exclude: scripts/*.dict
-[INFO](info.html)
- Exclude: **/.*/**
-[INFO](info.html)
- Exclude: **/target/**/*
-[INFO](info.html)
- Exclude: **/dependency-reduced-pom.xml
-[INFO](info.html)
- Exclude: **/*.log
-[INFO](info.html)
- Exclude: **/maven-eclipse.xml
-[INFO](info.html)
- Exclude: **/rat.txt
-[INFO](info.html)
- Exclude: **/internal-repository/**
-[INFO](info.html)
- ------------------------------------------------------------------------
-[ERROR](error.html)
- BUILD FAILURE
-[INFO](info.html)
- ------------------------------------------------------------------------
-[INFO](info.html)
- Too many unapproved licenses: 1
-[INFO](info.html)
- ------------------------------------------------------------------------
- For the module that failed to build (which in the case above is the root
+ . . .
+ [INFO] ------------------------------------------------------------------------
+ [INFO] Building OpenJPA Parent POM
+ [INFO] task-segment: [clean, install]
+ [INFO] ------------------------------------------------------------------------
+ . . .
+ [INFO] [enforcer:enforce {execution: default}]
+ [INFO] [source:test-jar {execution: attach-sources}]
+ [INFO] [ianal:verify-legal-files {execution: default}]
+ [INFO] [apache-rat:check {execution: default}]
+ [INFO] Exclude: **/javax.persistence.spi.PersistenceProvider
+ [INFO] Exclude: **/javax.annotation.processing.Processor
+ [INFO] Exclude: **/*.rsrc
+ [INFO] Exclude: **/org.apache.openjpa.revision.properties
+ [INFO] Exclude: scripts/*.list
+ [INFO] Exclude: scripts/*.options
+ [INFO] Exclude: scripts/*.dict
+ [INFO] Exclude: **/.*/**
+ [INFO] Exclude: **/target/**/*
+ [INFO] Exclude: **/dependency-reduced-pom.xml
+ [INFO] Exclude: **/*.log
+ [INFO] Exclude: **/maven-eclipse.xml
+ [INFO] Exclude: **/rat.txt
+ [INFO] Exclude: **/internal-repository/**
+ [INFO] ------------------------------------------------------------------------
+ [ERROR] BUILD FAILURE
+ [INFO] ------------------------------------------------------------------------
+ [INFO] Too many unapproved licenses: 1
+ [INFO] ------------------------------------------------------------------------
+
+For the module that failed to build (which in the case above is the root
pom.xml) open the target/rat.txt file and search for any "????"
occurrences, like -
- {code:none}
+
. . .
*****************************************************
Files with Apache License headers will be marked AL
@@ -614,7 +508,3 @@ Solution - either add the missing ASL 2.
from your local working directory (if it is a temporary file that should
not be added to svn), or ask on the dev@openjpa list if the file can be
added to the exclude list for the apache-rat checks.
-
-
-
-