org.eclipse.incquery.runtime.api

## Class MatchUpdateAdapter<Match extends IPatternMatch>

- java.lang.Object
- - org.eclipse.incquery.runtime.api.MatchUpdateAdapter<Match>

- All Implemented Interfaces:
    IMatchUpdateListener<Match>

      public class MatchUpdateAdapter<Match extends IPatternMatch>
      extends java.lang.Object
      implements IMatchUpdateListener<Match>

  A default implementation of `IMatchUpdateListener` that contains two match processors, one for appearance, one for disappearance. Any of the two can be null; in this case, corresponding notifications will be ignored.

  Instantiate using either constructor.

  Author:
    Bergmann Gabor

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `MatchUpdateAdapter()` Constructs an instance without any match processors registered yet.
    `MatchUpdateAdapter(IMatchProcessor<Match> appearCallback, IMatchProcessor<Match> disappearCallback)` Constructs an instance by specifying match processors.

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `IMatchProcessor<Match>` | `getAppearCallback()`
    `IMatchProcessor<Match>` | `getDisappearCallback()`
    `void` | `notifyAppearance(Match match)` Will be invoked on each new match that appears.
    `void` | `notifyDisappearance(Match match)` Will be invoked on each existing match that disappears.
    `void` | `setAppearCallback(IMatchProcessor<Match> appearCallback)`
    `void` | `setDisappearCallback(IMatchProcessor<Match> disappearCallback)`

    - ### Methods inherited from class java.lang.Object

      `equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

    - #### MatchUpdateAdapter

          public MatchUpdateAdapter()

      Constructs an instance without any match processors registered yet. Use `setAppearCallback(IMatchProcessor)` and `setDisappearCallback(IMatchProcessor)` to specify optional match processors for match appearance and disappearance, respectively.

    - #### MatchUpdateAdapter

          public MatchUpdateAdapter(IMatchProcessor<Match> appearCallback,
                                    IMatchProcessor<Match> disappearCallback)

      Constructs an instance by specifying match processors.
      Parameters:
        `appearCallback` - a match processor that will be invoked on each new match that appears. If null, no callback will be executed on match appearance. See `IMatchProcessor` for details on how to implement.
        `disappearCallback` - a match processor that will be invoked on each existing match that disappears. If null, no callback will be executed on match disappearance. See `IMatchProcessor` for details on how to implement.

  - ### Method Detail

    - #### getAppearCallback

          public IMatchProcessor<Match> getAppearCallback()

      Returns:
        the match processor that will be invoked on each new match that appears. If null, no callback will be executed on match appearance.

    - #### setAppearCallback

          public void setAppearCallback(IMatchProcessor<Match> appearCallback)

      Parameters:
        `appearCallback` - a match processor that will be invoked on each new match that appears. If null, no callback will be executed on match appearance. See `IMatchProcessor` for details on how to implement.

    - #### getDisappearCallback

          public IMatchProcessor<Match> getDisappearCallback()

      Returns:
        the match processor that will be invoked on each existing match that disappears. If null, no callback will be executed on match disappearance.

    - #### setDisappearCallback

          public void setDisappearCallback(IMatchProcessor<Match> disappearCallback)

      Parameters:
        `disappearCallback` - a match processor that will be invoked on each existing match that disappears. If null, no callback will be executed on match disappearance. See `IMatchProcessor` for details on how to implement.

    - #### notifyAppearance

          public void notifyAppearance(Match match)

      Description copied from interface: `IMatchUpdateListener`
      Will be invoked on each new match that appears.
      Specified by:
        `notifyAppearance` in interface `IMatchUpdateListener<Match extends IPatternMatch>`
      Parameters:
        `match` - the match that has just appeared.

    - #### notifyDisappearance

          public void notifyDisappearance(Match match)

      Description copied from interface: `IMatchUpdateListener`
      Will be invoked on each existing match that disappears.
      Specified by:
        `notifyDisappearance` in interface `IMatchUpdateListener<Match extends IPatternMatch>`
      Parameters:
        `match` - the match that has just disappeared.