You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cayenne.apache.org by nt...@apache.org on 2018/12/26 13:26:52 UTC
[1/2] cayenne git commit: CAY-2467 New type-aware Property API -
release and upgrade notes
Repository: cayenne
Updated Branches:
refs/heads/master 9ea878c02 -> a45cf9510
CAY-2467 New type-aware Property API
- release and upgrade notes
Project: http://git-wip-us.apache.org/repos/asf/cayenne/repo
Commit: http://git-wip-us.apache.org/repos/asf/cayenne/commit/96da6d53
Tree: http://git-wip-us.apache.org/repos/asf/cayenne/tree/96da6d53
Diff: http://git-wip-us.apache.org/repos/asf/cayenne/diff/96da6d53
Branch: refs/heads/master
Commit: 96da6d5358730a74fc3360e13c3d2db53e7641f6
Parents: 9ea878c
Author: Nikita Timofeev <st...@gmail.com>
Authored: Wed Dec 26 15:54:57 2018 +0300
Committer: Nikita Timofeev <st...@gmail.com>
Committed: Wed Dec 26 15:54:57 2018 +0300
----------------------------------------------------------------------
RELEASE-NOTES.txt | 11 +++++++++++
UPGRADE.txt | 6 ++++++
2 files changed, 17 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cayenne/blob/96da6d53/RELEASE-NOTES.txt
----------------------------------------------------------------------
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index f2248cd..d3487ab 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -8,6 +8,17 @@ To browse individual bug reports check out project issue tracker:
https://issues.apache.org/jira/browse/CAY
----------------------------------
+Release: 4.2.M1
+Date:
+----------------------------------
+Changes/New Features:
+
+CAY-2467 New type-aware Property API
+
+Bug Fixes:
+
+
+----------------------------------
Release: 4.1.M3
Date:
----------------------------------
http://git-wip-us.apache.org/repos/asf/cayenne/blob/96da6d53/UPGRADE.txt
----------------------------------------------------------------------
diff --git a/UPGRADE.txt b/UPGRADE.txt
index bd660d3..d752cdb 100644
--- a/UPGRADE.txt
+++ b/UPGRADE.txt
@@ -5,6 +5,12 @@ IMPORTANT: be sure to read all notes for the intermediate releases between your
current release and the release you are upgrading to.
-------------------------------------------------------------------------------
+UPGRADING TO 4.2.M1
+
+* Per CAY-2467 Property class is replaced with a type-aware Property API, it's mostly backwards compatible.
+ To take advantage of this new API you should regenerate code via Modeler ("Tools" -> "Generate Classes") or cgen tools.
+
+
UPGRADING TO 4.1.M2
* Per CAY-2438 DataChannelFilter filter was deprecated and two new independent filters are introduced:
[2/2] cayenne git commit: Switch master to 4.2
Posted by nt...@apache.org.
Switch master to 4.2
Project: http://git-wip-us.apache.org/repos/asf/cayenne/repo
Commit: http://git-wip-us.apache.org/repos/asf/cayenne/commit/a45cf951
Tree: http://git-wip-us.apache.org/repos/asf/cayenne/tree/a45cf951
Diff: http://git-wip-us.apache.org/repos/asf/cayenne/diff/a45cf951
Branch: refs/heads/master
Commit: a45cf9510ebd8c4354465073a1f49b6e353938c4
Parents: 96da6d5
Author: Nikita Timofeev <st...@gmail.com>
Authored: Wed Dec 26 16:26:40 2018 +0300
Committer: Nikita Timofeev <st...@gmail.com>
Committed: Wed Dec 26 16:26:40 2018 +0300
----------------------------------------------------------------------
.../docs/asciidoc/_cayenne-guide/header.html | 4 +-
.../asciidoc/_cayenne-guide/part1/setup.adoc | 12 ++--
.../_getting-started-db-first/header.html | 4 +-
.../_getting-started-db-first/part1-setup.adoc | 2 +-
.../asciidoc/_getting-started-guide/header.html | 4 +-
.../asciidoc/_getting-started-guide/setup.adoc | 2 +-
.../asciidoc/_getting-started-rop/header.html | 2 +-
.../part1/prerequisites.adoc | 2 +-
docs/asciidoc/pom.xml | 2 +-
.../docs/asciidoc/_upgrade-guide/header.html | 4 +-
.../asciidoc/_upgrade-guide/new-features.adoc | 74 +-------------------
.../src/docs/asciidoc/upgrade-guide.adoc | 4 +-
12 files changed, 22 insertions(+), 94 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/header.html
----------------------------------------------------------------------
diff --git a/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/header.html b/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/header.html
index 9f5486f..19c4fd1 100644
--- a/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/header.html
+++ b/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/header.html
@@ -18,13 +18,13 @@
title: "Cayenne Guide"
description: "Cayenne Guide"
-cayenneVersion: "4.1"
+cayenneVersion: "4.2"
weight: 20
menu:
footer:
weight: 30
parent: docs
- name: "Cayenne Guide (4.1)"
+ name: "Cayenne Guide (4.2)"
---
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/part1/setup.adoc
----------------------------------------------------------------------
diff --git a/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/part1/setup.adoc b/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/part1/setup.adoc
index 2edd2f0..16311bb 100644
--- a/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/part1/setup.adoc
+++ b/docs/asciidoc/cayenne-guide/src/docs/asciidoc/_cayenne-guide/part1/setup.adoc
@@ -26,6 +26,10 @@ include::../var.adoc[]
|===
|Cayenne Version |Java Version |Status
+|4.2
+|Java 1.8 or newer
+|Development
+
|4.1
|Java 1.8 or newer
|Beta
@@ -34,12 +38,8 @@ include::../var.adoc[]
|Java 1.7 or newer
|Stable
-|3.1
-|Java 1.5 or newer
-|Stable
-
-|3.0
-|Java 1.5
+|3.0 / 3.1
+|Java 1.5 -- Java 1.8
|Aging
|1.2 / 2.0
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/header.html
----------------------------------------------------------------------
diff --git a/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/header.html b/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/header.html
index 843b641..c250c79 100644
--- a/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/header.html
+++ b/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/header.html
@@ -18,12 +18,12 @@
title: "Cayenne Database First tutorial"
description: "Tutorial how to quick start new Cayenne project from existing database"
-cayenneVersion: "4.1"
+cayenneVersion: "4.2"
docsMenuTitle: "Database First Tutorial"
weight: 30
menu:
footer:
weight: 30
parent: docs
- name: "Database First tutorial (4.1)"
+ name: "Database First tutorial (4.2)"
---
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/part1-setup.adoc
----------------------------------------------------------------------
diff --git a/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/part1-setup.adoc b/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/part1-setup.adoc
index e3f34e8..606e817 100644
--- a/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/part1-setup.adoc
+++ b/docs/asciidoc/getting-started-db-first/src/docs/asciidoc/_getting-started-db-first/part1-setup.adoc
@@ -19,7 +19,7 @@ This chapter lists the recommended software used in the tutorial.
==== Java
-Cayenne 4.1 requires JDK 1.8 or newer.
+Cayenne 4.2 requires JDK 1.8 or newer.
==== IntelliJ IDEA IDE
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/header.html
----------------------------------------------------------------------
diff --git a/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/header.html b/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/header.html
index e271769..1b8b096 100644
--- a/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/header.html
+++ b/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/header.html
@@ -20,10 +20,10 @@ title: "Cayenne Getting Started Guide"
description: "Tutorial how to quick start new Cayenne project"
weight: 10
docsMenuTitle: "Getting Started"
-cayenneVersion: "4.1"
+cayenneVersion: "4.2"
menu:
footer:
weight: 10
parent: docs
- name: "Getting Started (4.1)"
+ name: "Getting Started (4.2)"
---
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/setup.adoc
----------------------------------------------------------------------
diff --git a/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/setup.adoc b/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/setup.adoc
index cf2fe51..272a8ab 100644
--- a/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/setup.adoc
+++ b/docs/asciidoc/getting-started-guide/src/docs/asciidoc/_getting-started-guide/setup.adoc
@@ -18,7 +18,7 @@ installed) a minimally needed set of software to build a Cayenne application.
=== Install Java
-Obviously, JDK has to be installed. Cayenne 4.1 requires JDK 1.8 or newer.
+Obviously, JDK has to be installed. Cayenne 4.2 requires JDK 1.8 or newer.
=== Install IntelliJ IDEA
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/header.html
----------------------------------------------------------------------
diff --git a/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/header.html b/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/header.html
index e35b98b..a61b6f7 100644
--- a/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/header.html
+++ b/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/header.html
@@ -18,7 +18,7 @@
title: "Cayenne Getting Started ROP"
description: "Tutorial how to quick start new Cayenne ROP project"
-cayenneVersion: "4.1"
+cayenneVersion: "4.2"
docsMenuTitle: "Getting Started ROP"
weight: 40
---
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/part1/prerequisites.adoc
----------------------------------------------------------------------
diff --git a/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/part1/prerequisites.adoc b/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/part1/prerequisites.adoc
index 22587e0..473b62d 100644
--- a/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/part1/prerequisites.adoc
+++ b/docs/asciidoc/getting-started-rop/src/docs/asciidoc/_getting-started-rop/part1/prerequisites.adoc
@@ -22,4 +22,4 @@ This tutorial starts where "Getting Started with Cayenne" left off. If you have
* Step 4 - Create Java Classes
* Step 5 - Convert the project to webapp.
-Note that at "Step 5" you can skip the JSP creation part. Just setup web.xml and maven-jetty-plugin in the POM.
+Note that at "Step 5" you can skip the JSP creation part. Just setup `web.xml` and `maven-jetty-plugin` in the POM.
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/pom.xml
----------------------------------------------------------------------
diff --git a/docs/asciidoc/pom.xml b/docs/asciidoc/pom.xml
index 4034ac0..091033a 100644
--- a/docs/asciidoc/pom.xml
+++ b/docs/asciidoc/pom.xml
@@ -47,7 +47,7 @@
<asciidoctorj.pdf.version>1.5.0-alpha.16</asciidoctorj.pdf.version>
<jruby.version>9.2.0.0</jruby.version>
<cayenne.version>${project.version}</cayenne.version>
- <cayenne.major.version>4.1</cayenne.major.version>
+ <cayenne.major.version>4.2</cayenne.major.version>
</properties>
<dependencies>
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/header.html
----------------------------------------------------------------------
diff --git a/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/header.html b/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/header.html
index c72bcc2..7a4cb34 100644
--- a/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/header.html
+++ b/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/header.html
@@ -16,9 +16,9 @@
# specific language governing permissions and limitations
# under the License.
-title: "Guide to 4.1 Features"
+title: "Guide to 4.2 Features"
description: "This guide highlights the new features and changes introduced in Apache Cayenne 4.1"
-cayenneVersion: "4.1"
+cayenneVersion: "4.2"
docsMenuTitle: "Upgrade Guide"
weight: 50
---
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/new-features.adoc
----------------------------------------------------------------------
diff --git a/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/new-features.adoc b/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/new-features.adoc
index c7a2c5f..be97a0e 100644
--- a/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/new-features.adoc
+++ b/docs/asciidoc/upgrade-guide/src/docs/asciidoc/_upgrade-guide/new-features.adoc
@@ -14,76 +14,4 @@
== Java Version
Minimum required JDK version is 1.8 or newer.
-Cayenne 4.1 is fully tested with Java 1.8 and 11.
-
-== New Features
-
-=== Cayenne Core is Dependency-Free
-
-Cayenne now depends only on `slf4j-api` library. We removed `velocity`, `commons-lang` and `commons-collections` dependencies from the Cayenne core. Velocity templates replaced with a simplified (and also much faster) parser for the parts of the Velocity syntax essential for Cayenne.
-
-This should be transparent in almost all case. See `UPGRADE.txt` for details.
-
-=== Field-Based Data Objects
-
-Cayenne *4.1* generates field-based DataObjects by default. And it is HUGE for the app performance. The new objects are much faster to read and write and significantly reduce the overall app memory footprint and the corresponding GC pauses.
-
-The new objects are mostly backwards-compatible with our “classic” map-based objects from the application standpoint. The main source of incompatibility is support for “dynamic” properties (i.e. persistent properties not known at compile time).
-
-Field-based DataObjects are generated via new class templates. So to take advantage of this feature you should simply regenerate you model classes.
-
-=== Extensible Project XML Structure
-
-Cayenne mapping project structure was modularized, allowing embedding of extensions with their own XML schemas.
-This enables support for comments for entities, attributes and relationships.
-Also Cayenne 4.1 have extensions for cdbimport and cgen, making OR modeling workflow experience so much smoother.
-
-image::../images/modeler-dbimport.png[align="center"]
-
-== API Changes
-
-=== Transaction propagation logic and isolation level
-
-New API allows to fully control transaction behavior where it's needed.
-
-[source,java]
-----
-TransactionManager manager = runtime.getInjector().getInstance(TransactionManager.class);
- TransactionDescriptor descriptor = new TransactionDescriptor(
- Connection.TRANSACTION_SERIALIZABLE, // set transaction isolation to SERIALIZABLE
- TransactionPropagation.REQUIRES_NEW // require new transaction for every operation
- );
- manager.performInTransaction(() -> {
- // perform some DB operations...
- return null;
- }, descriptor);
-----
-
-=== Injectable PkGenerator
-
-All `PkGenerators` are now managed by DI so you can simply inject your own implementation.
-
-[source,java]
-----
-ServerModule.contributePkGenerators(binder)
- .put(MySQLAdapter.class.getName(), CustomSQLPkGenerator.class);
-----
-
-=== DataChannelFilter replaced with DataChannelQueryFilter and DataChannelSyncFilter
-
-`DataChannelFilter` is deprecated. Instead two separate filters are introduced.
-
-[source,java]
-----
-ServerModule.contributeDomainQueryFilters(binder).add((context, query, chain) -> {
- // do something with query
- // ...
- return chain.onQuery(context, query);
-});
-
-ServerModule.contributeDomainSyncFilters(binder).add((context, changes, syncType, chain) -> {
- // do something with changes
- // ...
- return chain.onSync(context, changes, syncType);
-});
-----
\ No newline at end of file
+Cayenne 4.2 is fully tested with Java 1.8 and 11.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cayenne/blob/a45cf951/docs/asciidoc/upgrade-guide/src/docs/asciidoc/upgrade-guide.adoc
----------------------------------------------------------------------
diff --git a/docs/asciidoc/upgrade-guide/src/docs/asciidoc/upgrade-guide.adoc b/docs/asciidoc/upgrade-guide/src/docs/asciidoc/upgrade-guide.adoc
index 73be281..6ba4f86 100644
--- a/docs/asciidoc/upgrade-guide/src/docs/asciidoc/upgrade-guide.adoc
+++ b/docs/asciidoc/upgrade-guide/src/docs/asciidoc/upgrade-guide.adoc
@@ -11,7 +11,7 @@
// CONDITIONS OF ANY KIND, either express or implied. See the License for
// the specific language governing permissions and limitations under the
// License.
-= Guide to 4.1 Features
+= Guide to {project-major-version} Features
:revnumber: {project-major-version} ({project-version})
// enable section numbering, limiting depth to 2
:sectnums:
@@ -36,7 +36,7 @@ is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND
See the License for the specific language governing permissions and limitations under the License._#
-This guide highlights the new features and changes introduced in Apache Cayenne 4.1. For a full list of changes consult
+This guide highlights the new features and changes introduced in Apache Cayenne 4.2. For a full list of changes consult
RELEASE-NOTES.txt included in Cayenne download. For release-specific upgrade instructions check UPGRADE.txt.
include::_upgrade-guide/new-features.adoc[]
\ No newline at end of file