BindPath (groovy 2.4.7 API)
Date: 2016-06-03

Package: org.codehaus.groovy.binding

## [Java] Class BindPath

- org.codehaus.groovy.binding.BindPath

- The bind path object. This class represents one "step" in the bind path.

- - ### Methods Summary

    Methods
    Type | Name and description
    --- | ---
    `void` | `addAllListeners(PropertyChangeListener listener, Object newObject, Set updateSet)` Adds all the listeners to the objects in the bind path.
    `void` | `addListeners(PropertyChangeListener listener, Object newObject, Set updateSet)` Add listeners to a specific object.
    `TriggerBinding` | `getSyntheticTriggerBinding(Object newObject)`
    `void` | `removeListeners()` Remove listeners, believing that our bould flags are accurate and it removes only as declared.
    `void` | `updateLocalSyntheticProperties(Map<String, TriggerBinding> synthetics)`
    `void` | `updatePath(PropertyChangeListener listener, Object newObject, Set updateSet)` Called when we detect a change somewhere down our path.

  - ### Inherited Methods Summary

    Inherited Methods
    Methods inherited from class | Name
    --- | ---
    `class Object` | `wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll`

- - ### Method Detail

    - #### public void addAllListeners(PropertyChangeListener listener, Object newObject, Set updateSet)

      Adds all the listeners to the objects in the bind path. This assumes that we are not added as listeners to any of them, hence it is not idempotent.

      Parameters:
        `listener` - This listener to attach.
        `newObject` - The object we should read our property off of.
        `updateSet` - The list of objects we have added listeners to

    - #### public void addListeners(PropertyChangeListener listener, Object newObject, Set updateSet)

      Add listeners to a specific object. Updates the bould flags and update set

      Parameters:
        `listener` - This listener to attach.
        `newObject` - The object we should read our property off of.
        `updateSet` - The list of objects we have added listeners to

    - #### public TriggerBinding getSyntheticTriggerBinding(Object newObject)

    - #### public void removeListeners()

      Remove listeners, believing that our bould flags are accurate and it removes only as declared.

    - #### public void updateLocalSyntheticProperties(Map<String, TriggerBinding> synthetics)

    - #### public void updatePath(PropertyChangeListener listener, Object newObject, Set updateSet)

      Called when we detect a change somewhere down our path. First, check to see if our object is changing. If so remove our old listener Next, update the reference object the children have and recurse Finally, add listeners if we have a different object

      Parameters:
        `listener` - This listener to attach.
        `newObject` - The object we should read our property off of.
        `updateSet` - The list of objects we have added listeners to