[MDSAL-382] Clarify WriteOperations' ensureParentsViaMerge parameter Created: 04/Nov/18  Updated: 22/Nov/18  Resolved: 22/Nov/18

Status: Resolved
Project: mdsal
Component/s: Binding API
Affects Version/s: None
Fix Version/s: 3.0.2

Type: Improvement Priority: Medium
Reporter: Robert Varga Assignee: Robert Varga
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

Ensuring parents is a relatively expensive operation, which is not sufficiently documented in the API contract and design. The users are lead to believe the two options have roughly equal cost, which is certainly not true.

Moreover, this operation is only meaningful when the InstanceIdentifier crosses either a presence container or a list entry - otherwise it behaves exactly the same, except it has a higher overhead.

Document this behaviour and express it in API design by splitting off the "true" operation, so as to increase documentation visibility as well as making call sites more visible.


Generated at Wed Feb 07 20:09:40 UTC 2024 using Jira 8.20.10#820010-sha1:ace47f9899e9ee25d7157d59aa17ab06aee30d3d.