[IGNITE-22582] Improve javadoc for KeyValueView#getAllAsync regarding not existing keys

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.0.0-beta1
• Component/s: documentation
• Labels: ignite-3
• Ignite Flags: Docs Required, Release Notes Required
• Assignee: Tiago Marques Godinho
• Reporter: Tiago Marques Godinho
• Reviewer: Pavel Tupitsyn
• Created: 26/Jun/24 07:58
• Updated: 02/Jul/24 16:58
• Resolved: 26/Jun/24 12:11

Description

The [current javadoc|
https://github.com/apache/ignite-3/blob/38d13fcd5f0b45879f210bcc15b1e048b8916fa4/modules/api/src/main/java/org/apache/ignite/table/KeyValueView.java#L129-L137] for the `getAll` methods in the KeyValueView does not specify what happens if the requested keys are not found.

The user might expect the following behaviours:

• Method fails because cannot find all the keys
• The returned map contains all the keys but non-existing keys are mapped to a null value.
• The returned map does not contain non-existing keys.

What to do:

• Clarify the actual scenario in the javadoc.

Issue Links

• links to: Github PR
• links to: GitHub Pull Request #3988