[CAUSEWAY-1364] Improve Asciidoc and Javadoc for migrating from DomainObjectContainer#persist() to RepositoryService#persist()

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.12.0
• Fix Version/s: 1.13.0
• Component/s: Core
• Assignee: Óscar Bou
• Reporter: Óscar Bou
• Created: 09/Apr/16 23:18
• Updated: 11/Jul/16 19:36
• Resolved: 10/Apr/16 12:56

Description

DomainObjectContainer#persist() has been deprecated and RepositoryService#persist() might be used instead.

But current RepositoryService#persist() implementation does not throw an exception if the Domain Object is already persistent, so its behavior is different from the current DomainObjectContainer#persist() one.
In fact, is identical to DomainObjectContainer#persistIfNotAlready(), which has also been moved to RepositoryService#persistIfNotAlready()

Improve Asciidoc migration notes and documentation, and also Javadoc on DomainObjectContainer.