diff --git a/openjpa-project/BUILDING.txt b/openjpa-project/BUILDING.txt new file mode 100644 index 000000000..7ec1c1cfb --- /dev/null +++ b/openjpa-project/BUILDING.txt @@ -0,0 +1,163 @@ +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. + + + Building OpenJPA +=============================================================================== + +These instructions describe how to build OpenJPA from source code using the +Apache Maven 2 build too. They are written for use from the console, and are +known to work on Linux and Mac OSX. They are also reported to work from Windows. + +The most up to date version of these instructions may be found on the OpenJPA +website at http://incubator.apache.org/openjpa/building-openjpa.html + + 1. Ensure that you have Java 1.5 installed and in your path by running: + java -version + 2. Install the build tool Apache Maven 2.0.4, from http://maven.apache.org/. + If it is installed correctly, typing mvn -v from the console will result + in the text "Maven version: 2.0.4" + 3. Extract the source archive if you have not already done so. + The source will create a new directory named: + openjpa-project-${version}-source. Where ${version} is the openjpa + version, for example openjpa-project-0.9.7-incubating-source. + 4. Change to the openjpa source directory, which has already been created in + the previous step. + 5. 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 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) + + + + + repo.mergere.com + http://repo.mergere.com/maven2 + central + + + + + If any tests fail, and you want to ignore the failures, instead run: + mvn package -Dtest=false + +An example session as as follows: + +$ cd /tmp/ + +$ java -version + +java version "1.5.0_06" +Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-112) +Java HotSpot(TM) Client VM (build 1.5.0_06-64, mixed mode, sharing) + +$ mvn -v + +Maven version: 2.0.4 + +$ svn --version + +svn, version 1.1.4 (r13838) + compiled Jul 10 2006, 22:17:43 + +$ svn co https://svn.apache.org/repos/asf/incubator/openjpa/trunk/ + +A trunk/openjpa-lib +A trunk/openjpa-lib/src +A trunk/openjpa-lib/src/test +A trunk/openjpa-lib/src/test/java +A trunk/openjpa-lib/src/test/java/org +A trunk/openjpa-lib/src/test/java/org/apache +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-persistence/pom.xml +Checked out revision 421381. + +$ cd trunk/ + +$ mvn compile + +[INFO] Scanning for projects... +[INFO] Reactor build order: +[INFO] OpenJPA +[INFO] Utilities +[INFO] Kernel +[INFO] JDBC +[INFO] XML Store +[INFO] JDBC 1.5 +[INFO] Kernel 1.5 +[INFO] JPA +[INFO] JPA JDBC +[INFO] OpenJPA Project +[INFO] ------------------------------------------------------------------------- +[INFO] Building OpenJPA +[INFO] task-segment: [compile] +[INFO] ------------------------------------------------------------------------- + + ... + +[INFO] +[INFO] ------------------------------------------------------------------------ +[INFO] Reactor Summary: +[INFO] ------------------------------------------------------------------------ +[INFO] OpenJPA ............................................... SUCCESS [0.789s] +[INFO] Utilities ............................................. SUCCESS [3.489s] +[INFO] Kernel ................................................ SUCCESS [9.347s] +[INFO] JDBC .................................................. SUCCESS [12.208s] +[INFO] XML Store ............................................. SUCCESS [1.166s] +[INFO] JDBC 1.5 .............................................. SUCCESS [1.519s] +[INFO] Kernel 1.5 ............................................ SUCCESS [0.538s] +[INFO] JPA ................................................... SUCCESS [2.777s] +[INFO] JPA JDBC .............................................. SUCCESS [2.151s] +[INFO] OpenJPA Project ....................................... SUCCESS [1.495s] +[INFO] ------------------------------------------------------------------------ +[INFO] ------------------------------------------------------------------------ +[INFO] BUILD SUCCESSFUL +[INFO] ------------------------------------------------------------------------ +[INFO] Total time: 37 seconds +[INFO] Finished at: Wed Jul 26 11:44:33 PDT 2006 +[INFO] Final Memory: 10M/41M +[INFO] ------------------------------------------------------------------------ + + +$ mvn package -Dtest=false + +[INFO] Scanning for projects... + +... + +[INFO] [assembly:assembly {execution: bin}] +[INFO] Building zip: /tmp/openjpatestbuild/trunk/openjpa-project/target/filtered +-site/resources/downloads/openjpa-0.9.0.zip + +... + + +$ ls -lh openjpa-project/target/filtered-site/resources/downloads/ + +total 9.2M +-rw-r--r-- 1 mprudhom wheel 4.0M Jul 26 11:46 openjpa-0.9.0-sources.zip +-rw-r--r-- 1 mprudhom wheel 5.2M Jul 26 11:46 openjpa-0.9.0.zip + + diff --git a/openjpa-project/CHANGES.txt b/openjpa-project/CHANGES.txt new file mode 100644 index 000000000..ede3cc6eb --- /dev/null +++ b/openjpa-project/CHANGES.txt @@ -0,0 +1,83 @@ +Changes in OpenJPA 0.9.7 + +Additional information on a specific change can be found in the OpenJPA +project's issue tracker at http://issues.apache.org/jira/browse/OPENJPA + +** Bugs + * [OPENJPA-16] - NPE in createQuery for EJB QL with nested correlated subqueries + * [OPENJPA-21] - Time is missing from list of mutable classes. + * [OPENJPA-22] - locate & substring queries fail both db2 & derby, cannot use parameter markers in expression ?-? + * [OPENJPA-23] - -418 sqlexception using DB2 and EJB QL with SQRT or MOD + * [OPENJPA-24] - Allow OpenJPA to be extensible + * [OPENJPA-25] - Incorrect SQL generated for queries involving more than one AbstractSchemaNames, generated SQL FROM clause is missing 'Table alias' + * [OPENJPA-35] - In-memory Delete operation fails with active DataCache + * [OPENJPA-41] - transforming classes doesn't work + * [OPENJPA-48] - parsing error - cast of subselect does not work + * [OPENJPA-50] - bad sql pushdown, cast changes datatype + * [OPENJPA-53] - bad sql pushdown for nested subselects, missing nested subselect + * [OPENJPA-54] - bad sql pushdown, should use all syntax + * [OPENJPA-56] - in derby concat with input parameter needs a cast, otherwise becomes long varchar and some operations do not work + * [OPENJPA-60] - Specifying the wrong persistence implementation in persistence.xml leads to misleading error message + * [OPENJPA-62] - Ejbql join queries show invalid null Entities when run in a new persistence context where no entity instances exist. + * [OPENJPA-71] - Caching primitive array types consumes excessive memory + * [OPENJPA-77] - Problems in default setting in DB2Dictionary , also missing support for DB2 z/OS platforms + * [OPENJPA-80] - Bad Escaping for LIKE in MySQL + * [OPENJPA-98] - Java deadlock when insert in t1 and find in t2 when using IBM JVM 1.5.0 + * [OPENJPA-100] - entries failing to be processed for persistence unit rooted in an EAR + * [OPENJPA-102] - JTA transaction rollback, nonexistant instances, transactional persistence context => failures during afterCompletion() and close() + * [OPENJPA-103] - Default Listeners not being processed correctly + * [OPENJPA-104] - OpenJPA does not detach instances on rollback() + * [OPENJPA-107] - @SqlResultSetMappings fails in mapping tool with java.lang.ArrayStoreException + * [OPENJPA-108] - @AttributeOverrides fails in mapping tool with java.lang.ArrayStoreException + * [OPENJPA-109] - every NativeQuery using SqlResultSetMapping fails at runtime with There is no query result mapping for "null" with name "xxx" when the entity is persisted in a different method than the method doing the query. + * [OPENJPA-110] - Every NamedNativeQuery using ResultSetMapping fails at runtime with class cast exception when try to iterate over list + * [OPENJPA-111] - native queries fail when use named parameters + * [OPENJPA-115] - Bottleneck(s) with using OpenJPA in a Container-managed environment + * [OPENJPA-116] - EntityManager.getDelegate should throw an IllegalStateException + * [OPENJPA-118] - AutoDetach property has no effect + * [OPENJPA-119] - EntityManager.clear() should not implicitly invoke the flush operation + * [OPENJPA-121] - Table name defaults to the class name instead of the entity name + * [OPENJPA-122] - EntityManager does not throw exceptions after close() in required cases + * [OPENJPA-132] - java.lang.NoSuchMethodError for entity with ID of type java.sql.Date + * [OPENJPA-133] - Can't find non-public callback methods with superclass or interface parameters + * [OPENJPA-139] - PersistenceException merging an entity with a Calendar field. + * [OPENJPA-140] - Wrong package name in test classes + * [OPENJPA-142] - Entity name is ignored when specified in the orm.xml file + * [OPENJPA-144] - JDBCConfigurationImpl does not support JNDI lookup for non-jta-data-source. + * [OPENJPA-146] - Entity enhancement fails while using EmbeddedId on a MappedSuperclass + * [OPENJPA-150] - @Column in @AttributeOverride not honoring table attribute that maps to a secondary table in mappedsuperclass entity + * [OPENJPA-154] - OptimisticLockException working with Savepoints + * [OPENJPA-155] - java.lang.ArrayIndexOutOfBoundsException during commit + * [OPENJPA-157] - NullPointerException when running query with null parameter + * [OPENJPA-162] - @OrderBy on @OneToMany does not allow ordering by @Id value + * [OPENJPA-174] - error when find()'ing an abstract class + * [OPENJPA-175] - Eager selects by PagingResultObjectProvider may not use the FetchBatchSize + * [OPENJPA-179] - Schemas defined in orm.xml are only applied when a name is also specified. + * [OPENJPA-181] - ClassCastException when executing bulk delete on an entity that owns a OneToOne with a Cascade.DELETE when DataCache is on + * [OPENJPA-185] - optional attribute is not overriden by xml descriptor + * [OPENJPA-186] - Build failure of OpenJPA sources from trunk + +** Improvements + * [OPENJPA-10] - persistence unit name should be default diagnostic context for standard OpenJPA log impl + * [OPENJPA-37] - Support ant typedefs for OpenJPA tasks + * [OPENJPA-55] - Allow executeUpdate() invocations on native queries + * [OPENJPA-57] - persistence_1_0.xsd is missing + * [OPENJPA-63] - Better pessimistic lock support for DB2 v8.2+ + * [OPENJPA-151] - Added field in enhanced vesrion of a class is not serialized. Hence the change in detached+serialized instances is not registered under certain conditions. + * [OPENJPA-153] - WebSphere and non-jta-data-source and default ManagedRuntime + * [OPENJPA-158] - OpenJPA logs overly-verbose at INFO level + * [OPENJPA-161] - Overuse of synchronization in AbstractBrokerFactory + * [OPENJPA-166] - Track the reason why a setRollbackOnly invocation was made + * [OPENJPA-176] - Exception prefixes should be human-readable + * [OPENJPA-196] - Ease the restrictions on forcing a matche between the number of declared and assigned positional parameters + +** New Features + * [OPENJPA-92] - Support for H2 Database Engine + * [OPENJPA-93] - Sequence generation in a JTA environment should not require non-JTA datasource + * [OPENJPA-94] - Allow MappingTool and persistence.xml to support drop-create for database schema + +** Tasks + * [OPENJPA-36] - Add cwiki url to incubator status page + +** Tests + * [OPENJPA-40] - Testing OpenJPA and Spring integration fails diff --git a/openjpa-project/RELEASE-NOTES.html b/openjpa-project/RELEASE-NOTES.html new file mode 100644 index 000000000..1d2b6882f --- /dev/null +++ b/openjpa-project/RELEASE-NOTES.html @@ -0,0 +1,109 @@ + +Release Notes for OpenJPA - Version 0.9.7 + +

Release Notes for OpenJPA - Version 0.9.7

+ + + +

Overview

+ +

+OpenJPA aims to be a feature-rich implementation of the persistence part of Sun + JSR-220 (Enterprise JavaBeans 3.0), which is known as the Java Persistence API +(JPA). OpenJPA can be used as a stand-alone POJO persistence layer, or it can be + integrated into any EJB3.0 compliant container and many lightweight frameworks. +

+ +

+Additional information on the OpenJPA project may be found at the project web +site: +http://incubator.apache.org/openjpa/ + + +

Bugs

+The following bugs have been fixed since version 0.9.6 + + +

Improvements

+Improvements made since version 0.9.6 + + +

New Features

+Features added since version 0.9.6 + + diff --git a/openjpa-project/assembly.xml b/openjpa-project/assembly.xml index c14993e40..5f17d697d 100644 --- a/openjpa-project/assembly.xml +++ b/openjpa-project/assembly.xml @@ -37,6 +37,11 @@ LICENSE.txt STATUS.txt NOTICE.txt + RELEASE-NOTES + RELEASE-NOTES.html + RELEASE-NOTES.txt + CHANGES + CHANGES.txt