[causeway] branch master updated: CAUSEWAY-3606: just java-doc

[ah...@apache.org]

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

ahuber pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/causeway.git


The following commit(s) were added to refs/heads/master by this push:
     new e205ac3c89 CAUSEWAY-3606: just java-doc
e205ac3c89 is described below

commit e205ac3c897aa6ae18cd7fc4088d61020ae50f32
Author: Andi Huber <ah...@apache.org>
AuthorDate: Tue Sep 26 16:27:48 2023 +0200

    CAUSEWAY-3606: just java-doc
---
 .../jdo/datanucleus/entities/DnStateManagerForHollow.java            | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/persistence/jdo/datanucleus/src/main/java/org/apache/causeway/persistence/jdo/datanucleus/entities/DnStateManagerForHollow.java b/persistence/jdo/datanucleus/src/main/java/org/apache/causeway/persistence/jdo/datanucleus/entities/DnStateManagerForHollow.java
index 64f13340b9..52340a07cf 100644
--- a/persistence/jdo/datanucleus/src/main/java/org/apache/causeway/persistence/jdo/datanucleus/entities/DnStateManagerForHollow.java
+++ b/persistence/jdo/datanucleus/src/main/java/org/apache/causeway/persistence/jdo/datanucleus/entities/DnStateManagerForHollow.java
@@ -270,6 +270,11 @@ class DnStateManagerForHollow implements DNStateManager<Persistable> {
     private final static String INVALID_FIELD_ACCESS_MSG =
             "JDO entity %s(oid=%s) is in HOLLOW state, its fields are no longer valid.";
 
+    /**
+     * There is no point in trying to generate a message from a hollow {@link Persistable}'s,
+     * toString() method, as its fields are all set to null.
+     * Instead we provide type and OID information.
+     */
     private RuntimeException invalidFieldAccess(final @Nullable Persistable pc) {
         return pc==null
             ? _Exceptions.unrecoverable(INVALID_FIELD_ACCESS_MSG, "Persistable", "oidStringified") // just in case