# Release Notes for Apache OpenJPA 3.0.0

- Overview
- Prerequisites
- Documentation
- Getting Involved
- License
- Notice
- Release Notes
- Release Notes for previous OpenJPA releases

## Overview

The Apache OpenJPA community is proud to release a distribution of OpenJPA 3.0.0. This distribution is based on the final JSR 338 Java Persistence API, Version 2.2 specification while not beeing fully TCK tested. We remain backwards compatible with prior releases based on the Java Persistence API 1.0 and 2.0.

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

## Prerequisites

OpenJPA requires Java 8 or higher and a relational database of some sort.

## Documentation

If you have questions about OpenJPA, a good source of information is the online product manual. You can find the manual for the current release as well as older releases of OpenJPA at http://openjpa.apache.org/documentation.html

If you can't find what you are looking for in the manual or would like more clarification, please post to the OpenJPA development mailing list. Information on all of the OpenJPA mailing lists may be found here: http://openjpa.apache.org/mailing-lists.html

## Getting Involved

The Apache OpenJPA project is being built by the open source community for the open source community - we welcome your input and contributions!

What we are looking for:

- Source code and fixes contributions
- Documentation assistance
- Product and feature suggestions
- Detailed and constructive feedback
- Articles and whitepapers

How do I contribute?

- To discuss Apache OpenJPA topics check out the mailing lists.
- Informal discussion also occurs on the #openjpa IRC channel on freenode.net.
- Bugs and other issues can be posted on the issue tracker.

## License

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.

The license may also be found in LICENSE.txt which is included in each release of OpenJPA.

## Notice

Copyright 2006,2018 The Apache Software Foundation
This product includes software developed at The Apache Software Foundation (http://www.apache.org/).

Apache OpenJPA includes the persistence and orm schemas from the JPA specifications.
Copyright 2005-2009 Sun Microsystems, Inc. All rights reserved.
Apache OpenJPA elects to include this software in this distribution under the CDDL license.
You can obtain a copy of the License at: https://glassfish.dev.java.net/public/CDDL+GPL.html
The source code is available at: http://java.net/projects/glassfish

The complete list of notices can be found in NOTICE.txt included in each assembly.

## Release Notes

### OpenJPA 3.0.0

Release Notes - OpenJPA - Version 3.0.0

## Sub-task

- [OPENJPA-2663] - cleanup ConcreteClassGenerator and move to ASM

## Bug

- [OPENJPA-2300] - AnnotationProcessor shows warnings when executed on Java 7 sources
- [OPENJPA-2646] - Sporadic NullPointerException occurs under heavy load when QuerySQLCache is enabled.
- [OPENJPA-2658] - TestQueryTimeout test is broken
- [OPENJPA-2672] - ConfigurationImpl.loadGlobals() has java.util.ConcurrentModificationException vulnerability
- [OPENJPA-2674] - JarFile is not closed
- [OPENJPA-2675] - Missing check for null parameter in equals()
- [OPENJPA-2676] - openjpa relies on default locale
- [OPENJPA-2684] - Persistence entities not recognized in Wildfly 10 if in a JAR
- [OPENJPA-2689] - Calling setFixedCHAR on newer Oracle JDBC drivers fails with an IllegalAccessException
- [OPENJPA-2690] - Update OSGi Import-Package to support Oracle CLOB/BLOB
- [OPENJPA-2691] - OracleDictionary should use non Deprecated method of empty_lob
- [OPENJPA-2698] - Query cache incorrectly handles parameters for BETWEEN expressions
- [OPENJPA-2725] - fix ConcurrentModificationException during unrefed dependents cleanup

## New Feature

- [OPENJPA-2592] - JPA 2.1 stored procedure support
- [OPENJPA-2598] - Support SQL server Offset Fetch syntax for pagination

## Improvement

- [OPENJPA-2660] - Resolve Maven warnings
- [OPENJPA-2669] - Add apache karaf feature for openjpa and adapt OSGi imports

## Task

- [OPENJPA-2641] - update build pom
- [OPENJPA-2652] - Prepare SVN for OpenJPA-3.0 development
- [OPENJPA-2653] - Upgrade documentation page for 3.0.0 work
- [OPENJPA-2654] - merge over the work done in branches/openjpa_jpa-2.1/ to trunk
- [OPENJPA-2655] - verify signature of geronimo-jpa-2.1-spec with the RI jars
- [OPENJPA-2659] - upgrade to apache-parent-18
- [OPENJPA-2664] - migrate from commons-lang to commons-lang3
- [OPENJPA-2666] - Fix Java9 compatibility
- [OPENJPA-2667] - Upgrade BVAL to 1.1
- [OPENJPA-2677] - upgrade to BVAL-1.1.2

## Dependency upgrade

- [OPENJPA-2730] - Update to XBean Asm 6 Shaded 4.8

## Previous Releases

Release notes for earlier releases of OpenJPA may be found in SVN at the following locations.

- OpenJPA 2.4.3 RELEASE-NOTES.html
- OpenJPA 2.4.2 RELEASE-NOTES.html
- OpenJPA 2.4.1 RELEASE-NOTES.html
- OpenJPA 2.4.0 RELEASE-NOTES.html
- OpenJPA 2.3.0 RELEASE-NOTES.html
- OpenJPA 2.2.2 RELEASE-NOTES.html
- OpenJPA 2.2.1 RELEASE-NOTES.html
- OpenJPA 2.2.0 RELEASE-NOTES.html
- OpenJPA 2.1.1 RELEASE-NOTES.html
- OpenJPA 2.1.1 RELEASE-NOTES.html
- OpenJPA 2.1.0 RELEASE-NOTES.html
- OpenJPA 2.0.1 RELEASE-NOTES.html
- OpenJPA 2.0.0 RELEASE-NOTES.html
- OpenJPA 2.0.0-Beta 3 RELEASE-NOTES.html
- OpenJPA 2.0.0-Beta 2 RELEASE-NOTES.html
- OpenJPA 2.0.0-Beta RELEASE-NOTES.html
- OpenJPA 2.0.0-Milestone 3 RELEASE-NOTES.html
- OpenJPA 1.2.2 RELEASE-NOTES.html
- OpenJPA 1.2.2 RELEASE-NOTES.html
- OpenJPA 1.2.1 RELEASE-NOTES.html
- OpenJPA 1.1.0 RELEASE-NOTES.html
- OpenJPA 1.0.4 RELEASE-NOTES.html
- OpenJPA 1.0.3 RELEASE-NOTES.html

Copyright (C) 2006,2015 Apache Software Foundation. Licensed under Apache License 2.0.
Apache, the Apache feather logo and OpenJPA are trademarks of Apache Software Foundation.