Uploaded image for project: 'mdsal'
  1. mdsal
  2. MDSAL-382

Clarify WriteOperations' ensureParentsViaMerge parameter

XMLWordPrintable

    • Icon: Improvement Improvement
    • Resolution: Done
    • Icon: Medium Medium
    • 3.0.2
    • None
    • Binding API
    • None

      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.

            rovarga Robert Varga
            rovarga Robert Varga
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: