[IGNITE-22267] Improve Table API javadocs

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 3.0
• Component/s: documentation
• Labels: ignite-3
• Assignee: Mirza Aliev
• Reporter: Pavel Tupitsyn
• Reviewer: Pavel Tupitsyn
• Created: 17/May/24 10:02
• Updated: 04/Sep/24 16:08
• Resolved: 16/Aug/24 15:23

Description

1. Remove "started table" term, "table" is enough
2. Remove "binary object" mentions
3. Explain how KV view "splits" row data in two parts. It does not actually operate on separate keys and values.
4. Replace "Transaction or null to auto-commit" with "Transaction or null for implicit transaction"
5. Remove "@throws IgniteException If an unspecified platform exception has occurred internally", it is not useful
6. Declare order of tables in tables() and tablesAsync()

Issue Links

• links to: GitHub Pull Request #4242