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 2022/11/30 13:52:08 UTC

[cayenne] branch STABLE-4.2 updated (9ea6cebb6 -> 90307ba98)

This is an automated email from the ASF dual-hosted git repository.

ntimofeev pushed a change to branch STABLE-4.2
in repository https://gitbox.apache.org/repos/asf/cayenne.git


    from 9ea6cebb6 Merge pull request #547 from m-dzianishchyts/CAY-2763,2764,2776
     new 87730ea06 Missing license header
     new 90307ba98 Add upgrade notes and new features guide

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 UPGRADE.txt                                        |  5 +++
 .../access/flush/operation/OpIdFactoryTest.java    | 19 ++++++++++
 .../docs/asciidoc/_upgrade-guide/new-features.adoc | 41 ++++++++++++++++++----
 3 files changed, 59 insertions(+), 6 deletions(-)


[cayenne] 01/02: Missing license header

Posted by nt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

ntimofeev pushed a commit to branch STABLE-4.2
in repository https://gitbox.apache.org/repos/asf/cayenne.git

commit 87730ea06c186f1a3ba89a9ce444892046942409
Author: Nikita Timofeev <st...@gmail.com>
AuthorDate: Wed Nov 30 16:51:31 2022 +0300

    Missing license header
---
 .../access/flush/operation/OpIdFactoryTest.java       | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/cayenne-server/src/test/java/org/apache/cayenne/access/flush/operation/OpIdFactoryTest.java b/cayenne-server/src/test/java/org/apache/cayenne/access/flush/operation/OpIdFactoryTest.java
index 0277f4c56..ec58afc63 100644
--- a/cayenne-server/src/test/java/org/apache/cayenne/access/flush/operation/OpIdFactoryTest.java
+++ b/cayenne-server/src/test/java/org/apache/cayenne/access/flush/operation/OpIdFactoryTest.java
@@ -1,3 +1,22 @@
+/*****************************************************************
+ *   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
+ *
+ *    https://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.
+ ****************************************************************/
+
 package org.apache.cayenne.access.flush.operation;
 
 import org.apache.cayenne.ObjectId;


[cayenne] 02/02: Add upgrade notes and new features guide

Posted by nt...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

ntimofeev pushed a commit to branch STABLE-4.2
in repository https://gitbox.apache.org/repos/asf/cayenne.git

commit 90307ba9864067d369e51a6fe4220850c212dfa5
Author: Nikita Timofeev <st...@gmail.com>
AuthorDate: Wed Nov 30 16:51:59 2022 +0300

    Add upgrade notes and new features guide
---
 UPGRADE.txt                                        |  5 +++
 .../docs/asciidoc/_upgrade-guide/new-features.adoc | 41 ++++++++++++++++++----
 2 files changed, 40 insertions(+), 6 deletions(-)

diff --git a/UPGRADE.txt b/UPGRADE.txt
index e909b00ce..4c005f2f2 100644
--- a/UPGRADE.txt
+++ b/UPGRADE.txt
@@ -5,6 +5,11 @@ 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.RC2
+
+* Per CAY-2743, CAY-2749 and CAY-2750 There are several modules that was deprecated with no direct replacement (including ROP).
+You can still use safely these modules in Cayenne 4.2, but they will be removed in future versions.
+
 UPGRADING TO 4.2.M2
 
 * Per CAY-2659 All batch translators (`InsertBatchTranslator`, `UpdateBatchTranslator`, etc.) are updated to the new SQLBuilder utility.
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 ae1305d87..0b0a4ae0d 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
@@ -13,8 +13,8 @@
 // License.
 == Java Version
 
-Minimum required JDK version is 1.8 or newer.
-Cayenne 4.2 is fully tested with Java 1.8 and 11.
+Minimum required JDK version is 8 or newer.
+Cayenne 4.2 is fully tested with Java 8, 11 and 17.
 
 == New Features
 
@@ -38,8 +38,9 @@ Property API are greatly revised.
 This API allows to use type aware expression factories aka Properties.
 These properties are normally generated as static constants in model classes, but they can also be created manually by
 `PropertyFactory` if needed.
+New API provides designated properties for different datatypes and relationships, including special variant that represents primary keys.
 
-Typical usage in select queries:
+Usage example in `ObjectSelect` query:
 
 [source,java]
 ----
@@ -51,6 +52,34 @@ Artist artist = ObjectSelect.query(Artist.class)
         .selectOne(context);
 ----
 
-//== Internal Changes
-//=== New select query translator
-//=== New Flush Action implementation
+See https://cayenne.apache.org/docs/4.2/api/org/apache/cayenne/exp/property/package-summary.html[JavaDoc] for details.
+
+=== New types support
+
+Cayenne 4.2 brings support for the Json and Geo types that are common now in RDBMS, see https://github.com/apache/cayenne-examples/tree/master/cayenne-jdbc-type-other[this demo] for the usage example.
+Additionally, Cayenne now supports `java.time.Duration` and `java.time.Period` out of the box.
+
+== Deprecations and API incompatibilities
+
+For the full list of deprecations refer to `UPGRADE.txt`. Here's the most important changes.
+
+=== SelectQuery
+
+`SelectQuery` is deprecated in favour of `ObjectSelect`. It's still fully functional and could be used,
+but it will be removed in a future.
+
+=== Obsolete modules
+
+There are several modules that are deprecated in Cayenne 4.2 and will be removed in a later version:
+
+- Cayenne ROP
+- Cayenne Web
+- Event bridges: XMPP, JMS and JGroups
+
+These modules could be still safely used in 4.2.
+
+=== ObjectId
+
+ObjectId can't be instantiated directly, `ObjectId.of(..)` factory methods should be used.
+E.g. `ObjectId.of("Artist", 1)` instead of `new ObjectId("Artist", 1)`.
+