[CAUSEWAY-3500] [Persistence] Cleanup ambiguous EntityState Terminology

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Resolved
• Fix Version/s: 2.0.0-RC3
• Component/s: Persistence JDO, Persistence JPA
• Assignee: Andi Huber
• Reporter: Andi Huber
• Created: 24/Jun/23 06:19
• Updated: 02/Aug/23 05:37
• Resolved: 25/Jul/23 15:44

Description

In the framework's context DETACHED just means PERSISTABLE but currently NOT-ATTACHED.

However, within JDO and JPA context, DETACHED means that an entity can be still worked with then be made persistent again later, whilst the persistence layer will have kept track of any changes in between.

While JDO supports this technology, we historically never enabled it. Instead the framework relies on Bookmarks/OIDs to re-fetch entities, should there be an interaction.

JDO instead offers the lightweight HOLLOW state for entities, which JPA does not.

So my goal is to clean up the EntityState enum, perhaps rename some of the states and correct any ambiguous associated java-doc.

Issue Links

• links to: GitHub Pull Request #1757