(cayenne) branch master updated: API cleanup

[aadamchik]

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

asf-gitbox-commits pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cayenne.git


The following commit(s) were added to refs/heads/master by this push:
     new 4b5af7b92 API cleanup
4b5af7b92 is described below

commit 4b5af7b924fe8ab3bb3b46d7ee262a3c39d64c35
Author: Andrus Adamchik <and...@objectstyle.com>
AuthorDate: Tue Jul 21 18:03:42 2026 +0200

    API cleanup
---
 .../java/org/apache/cayenne/runtime/CayenneRuntime.java   | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git 
a/cayenne/src/main/java/org/apache/cayenne/runtime/CayenneRuntime.java 
b/cayenne/src/main/java/org/apache/cayenne/runtime/CayenneRuntime.java
index 853cc2c81..6f07b0867 100644
--- a/cayenne/src/main/java/org/apache/cayenne/runtime/CayenneRuntime.java
+++ b/cayenne/src/main/java/org/apache/cayenne/runtime/CayenneRuntime.java
@@ -51,12 +51,11 @@ import java.util.Objects;
  * }
  * </pre>
  *
- * @since 3.1 is introduced
- * @since 5.0 is repurposed as a single implementation of Cayenne runtime and 
moved to {@link org.apache.cayenne.runtime} package.
- *
  * @see #builder()
  * @see #builder(String)
  * @see CayenneRuntimeBuilder
+ * @since 3.1 is introduced
+ * @since 5.0 is repurposed as a single implementation of Cayenne runtime and 
moved to {@link org.apache.cayenne.runtime} package.
  */
 public class CayenneRuntime {
 
@@ -96,7 +95,6 @@ public class CayenneRuntime {
      * Creates a builder of CayenneRuntime.
      *
      * @return a builder of CayenneRuntime.
-     *
      * @see #builder(String)
      * @see CayenneRuntimeBuilder
      * @since 5.0
@@ -110,7 +108,6 @@ public class CayenneRuntime {
      *
      * @param name optional symbolic name of the created runtime.
      * @return a named builder of CayenneRuntime.
-     *
      * @see #builder()
      * @see CayenneRuntimeBuilder
      * @since 5.0
@@ -170,9 +167,8 @@ public class CayenneRuntime {
      *
      * @param op         an operation to perform within the transaction.
      * @param descriptor describes additional transaction parameters
-     * @param <T> result type
+     * @param <T>        result type
      * @return a value returned by the "op" operation.
-     *
      * @since 4.2
      */
     public <T> T performInTransaction(TransactionalOperation<T> op, 
TransactionDescriptor descriptor) {
@@ -191,9 +187,8 @@ public class CayenneRuntime {
      * @param op         an operation to perform within the transaction.
      * @param callback   a callback to notify as transaction progresses 
through stages.
      * @param descriptor describes additional transaction parameters
-     * @param <T> returned value type
+     * @param <T>        returned value type
      * @return a value returned by the "op" operation.
-     *
      * @since 4.2
      */
     public <T> T performInTransaction(TransactionalOperation<T> op, 
TransactionListener callback, TransactionDescriptor descriptor) {
@@ -262,7 +257,9 @@ public class CayenneRuntime {
      * Returns the collection of modules used to initialize this runtime.
      *
      * @since 4.0
+     * @deprecated this is fairly useless. Modules are opaque. {@link 
#getInjector()} is the closest useful thing.
      */
+    @Deprecated(since = "5.0", forRemoval = true)
     public Collection<Module> getModules() {
         return modules;
     }