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

Clarify WriteOperations' ensureParentsViaMerge parameter

    XMLWordPrintable

Details

    • Improvement
    • Status: Resolved
    • Medium
    • Resolution: Done
    • None
    • 3.0.2
    • Binding API
    • None

    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.

      Attachments

        # Subject Branch Project Status CR V

        Activity

          People

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

            Dates

              Created:
              Updated:
              Resolved: