Package org.optaplanner.core.impl.score.director.drools

## Class DroolsScoreDirector<Solution_,​Score_ extends Score<Score_>>

- java.lang.Object
- - org.optaplanner.core.impl.score.director.AbstractScoreDirector<Solution_,​Score_,​DroolsScoreDirectorFactory<Solution_,​Score_>>
  - - org.optaplanner.core.impl.score.director.drools.DroolsScoreDirector<Solution_,​Score_>

- Type Parameters:
    `Solution_` - the solution type, the class with the `PlanningSolution` annotation
    `Score_` - the score type to go with the solution
  All Implemented Interfaces:
    `AutoCloseable`, `Cloneable`, `ScoreDirector<Solution_>`, `InnerScoreDirector<Solution_,​Score_>`
  Direct Known Subclasses:
    `TestGenDroolsScoreDirector`

      public class DroolsScoreDirector<Solution_,​Score_ extends Score<Score_>>
      extends AbstractScoreDirector<Solution_,​Score_,​DroolsScoreDirectorFactory<Solution_,​Score_>>

  Drools implementation of `ScoreDirector`, which directs the Rule Engine to calculate the `Score` of the `working solution`.
  See Also:
    `ScoreDirector`

- - ### Field Summary

    Fields
    Modifier and Type | Field | Description
    --- | --- | ---
    `static String` | `GLOBAL_SCORE_HOLDER_KEY` |
    `protected org.kie.api.runtime.KieSession` | `kieSession` |
    `protected AbstractScoreHolder<Score_>` | `scoreHolder` |

    - ### Fields inherited from class org.optaplanner.core.impl.score.director.AbstractScoreDirector

      `allChangesWillBeUndoneBeforeStepEnds, calculationCount, constraintMatchEnabledPreference, logger, lookUpEnabled, lookUpManager, scoreDirectorFactory, variableListenerSupport, workingEntityListRevision, workingInitScore, workingSolution`

  - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---
    `DroolsScoreDirector​(DroolsScoreDirectorFactory<Solution_,​Score_> scoreDirectorFactory, boolean lookUpEnabled, boolean constraintMatchEnabledPreference)` |

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `void` | `afterEntityAdded​(EntityDescriptor<Solution_> entityDescriptor, Object entity)` |
    `void` | `afterEntityRemoved​(EntityDescriptor<Solution_> entityDescriptor, Object entity)` |
    `void` | `afterProblemFactAdded​(Object problemFact)` |
    `void` | `afterProblemFactRemoved​(Object problemFact)` |
    `void` | `afterProblemPropertyChanged​(Object problemFactOrEntity)` |
    `void` | `afterVariableChanged​(VariableDescriptor variableDescriptor, Object entity)` |
    `Score_` | `calculateScore()` | Calculates the `Score` and updates the `working solution` accordingly.
    `void` | `close()` | Needs to be called after use because some implementations need to clean up their resources.
    `Map<String,​ConstraintMatchTotal<Score_>>` | `getConstraintMatchTotalMap()` | Explains the `Score` of `InnerScoreDirector.calculateScore()` by splitting it up per `Constraint`.
    `Map<Object,​Indictment<Score_>>` | `getIndictmentMap()` | Explains the impact of each planning entity or problem fact on the `Score`.
    `org.kie.api.runtime.KieSession` | `getKieSession()` |
    `Collection<Object>` | `getWorkingFacts()` |
    `boolean` | `isConstraintMatchEnabled()` |
    `void` | `setWorkingSolution​(Solution_ workingSolution)` | The `working solution` must never be the same instance as the `best solution`, it should be a (un)changed clone.

    - ### Methods inherited from class org.optaplanner.core.impl.score.director.AbstractScoreDirector

      `afterEntityAdded, afterEntityRemoved, afterVariableChanged, assertExpectedUndoMoveScore, assertExpectedWorkingScore, assertNonNullPlanningIds, assertPredictedScoreFromScratch, assertShadowVariablesAreNotStale, assertWorkingScoreFromScratch, beforeEntityAdded, beforeEntityAdded, beforeEntityRemoved, beforeEntityRemoved, beforeProblemFactAdded, beforeProblemFactRemoved, beforeProblemPropertyChanged, beforeVariableChanged, beforeVariableChanged, buildScoreCorruptionAnalysis, buildShadowVariableAnalysis, changeVariableFacade, clone, cloneSolution, cloneWorkingSolution, createChildThreadScoreDirector, createShadowVariablesViolationMessage, doAndProcessMove, doAndProcessMove, getCalculationCount, getScoreDefinition, getScoreDirectorFactory, getSolutionDescriptor, getSupplyManager, getWorkingEntityCount, getWorkingEntityList, getWorkingEntityListRevision, getWorkingSolution, getWorkingValueCount, isAllChangesWillBeUndoneBeforeStepEnds, isConstraintMatchEnabledPreference, isLookUpEnabled, isWorkingEntityListDirty, lookUpWorkingObject, lookUpWorkingObjectOrReturnNull, overwriteConstraintMatchEnabledPreference, resetCalculationCount, setAllChangesWillBeUndoneBeforeStepEnds, setCalculatedScore, setWorkingEntityListDirty, toString, triggerVariableListeners`

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

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

- - ### Field Detail

    - #### GLOBAL_SCORE_HOLDER_KEY

          public static final String GLOBAL_SCORE_HOLDER_KEY

      See Also:
        Constant Field Values

    - #### kieSession

          protected org.kie.api.runtime.KieSession kieSession

    - #### scoreHolder

          protected AbstractScoreHolder<Score_ extends Score<Score_>> scoreHolder

  - ### Constructor Detail

    - #### DroolsScoreDirector

          public DroolsScoreDirector​(DroolsScoreDirectorFactory<Solution_,​Score_> scoreDirectorFactory,
                                     boolean lookUpEnabled,
                                     boolean constraintMatchEnabledPreference)

  - ### Method Detail

    - #### getKieSession

          public org.kie.api.runtime.KieSession getKieSession()

    - #### setWorkingSolution

          public void setWorkingSolution​(Solution_ workingSolution)

      Description copied from interface: `InnerScoreDirector`
      The `working solution` must never be the same instance as the `best solution`, it should be a (un)changed clone.
      Specified by:
        `setWorkingSolution` in interface `InnerScoreDirector<Solution_,​Score_ extends Score<Score_>>`
      Overrides:
        `setWorkingSolution` in class `AbstractScoreDirector<Solution_,​Score_ extends Score<Score_>,​DroolsScoreDirectorFactory<Solution_,​Score_ extends Score<Score_>>>`
      Parameters:
        `workingSolution` - never null

    - #### getWorkingFacts

          public Collection<Object> getWorkingFacts()

    - #### calculateScore

          public Score_ calculateScore()

      Description copied from interface: `InnerScoreDirector`
      Calculates the `Score` and updates the `working solution` accordingly.
      Returns:
        never null, the `Score` of the `working solution`

    - #### isConstraintMatchEnabled

          public boolean isConstraintMatchEnabled()

      Returns:
        true if `InnerScoreDirector.getConstraintMatchTotalMap()` and `InnerScoreDirector.getIndictmentMap()` can be called

    - #### getConstraintMatchTotalMap

          public Map<String,​ConstraintMatchTotal<Score_>> getConstraintMatchTotalMap()

      Description copied from interface: `InnerScoreDirector`
      Explains the `Score` of `InnerScoreDirector.calculateScore()` by splitting it up per `Constraint`.

      The sum of `ConstraintMatchTotal.getScore()` equals `InnerScoreDirector.calculateScore()`.

      Call `InnerScoreDirector.calculateScore()` before calling this method, unless that method has already been called since the last `PlanningVariable` changes.

      Returns:
        never null, the key is the `constraintId` (to create one, use `ConstraintMatchTotal.composeConstraintId(String, String)`).
      See Also:
        `InnerScoreDirector.getIndictmentMap()`

    - #### getIndictmentMap

          public Map<Object,​Indictment<Score_>> getIndictmentMap()

      Description copied from interface: `InnerScoreDirector`
      Explains the impact of each planning entity or problem fact on the `Score`. An `Indictment` is basically the inverse of a `ConstraintMatchTotal`: it is a `Score` total for each justification `Object` in `ConstraintMatch.getJustificationList()`.

      The sum of `ConstraintMatchTotal.getScore()` differs from `InnerScoreDirector.calculateScore()` because each `ConstraintMatch.getScore()` is counted for each justification in `ConstraintMatch.getJustificationList()`.

      Call `InnerScoreDirector.calculateScore()` before calling this method, unless that method has already been called since the last `PlanningVariable` changes.

      Returns:
        never null, the key is a `problem fact` or a `planning entity`
      See Also:
        `InnerScoreDirector.getConstraintMatchTotalMap()`

    - #### close

          public void close()

      Description copied from interface: `InnerScoreDirector`
      Needs to be called after use because some implementations need to clean up their resources.
      Specified by:
        `close` in interface `AutoCloseable`
      Specified by:
        `close` in interface `InnerScoreDirector<Solution_,​Score_ extends Score<Score_>>`
      Overrides:
        `close` in class `AbstractScoreDirector<Solution_,​Score_ extends Score<Score_>,​DroolsScoreDirectorFactory<Solution_,​Score_ extends Score<Score_>>>`

    - #### afterEntityAdded

          public void afterEntityAdded​(EntityDescriptor<Solution_> entityDescriptor,
                                       Object entity)

      Overrides:
        `afterEntityAdded` in class `AbstractScoreDirector<Solution_,​Score_ extends Score<Score_>,​DroolsScoreDirectorFactory<Solution_,​Score_ extends Score<Score_>>>`

    - #### afterVariableChanged

          public void afterVariableChanged​(VariableDescriptor variableDescriptor,
                                           Object entity)

      Specified by:
        `afterVariableChanged` in interface `InnerScoreDirector<Solution_,​Score_ extends Score<Score_>>`
      Overrides:
        `afterVariableChanged` in class `AbstractScoreDirector<Solution_,​Score_ extends Score<Score_>,​DroolsScoreDirectorFactory<Solution_,​Score_ extends Score<Score_>>>`

    - #### afterEntityRemoved

          public void afterEntityRemoved​(EntityDescriptor<Solution_> entityDescriptor,
                                         Object entity)

      Overrides:
        `afterEntityRemoved` in class `AbstractScoreDirector<Solution_,​Score_ extends Score<Score_>,​DroolsScoreDirectorFactory<Solution_,​Score_ extends Score<Score_>>>`

    - #### afterProblemFactAdded

          public void afterProblemFactAdded​(Object problemFact)

      Specified by:
        `afterProblemFactAdded` in interface `ScoreDirector<Solution_>`
      Overrides:
        `afterProblemFactAdded` in class `AbstractScoreDirector<Solution_,​Score_ extends Score<Score_>,​DroolsScoreDirectorFactory<Solution_,​Score_ extends Score<Score_>>>`

    - #### afterProblemPropertyChanged

          public void afterProblemPropertyChanged​(Object problemFactOrEntity)

      Specified by:
        `afterProblemPropertyChanged` in interface `ScoreDirector<Solution_>`
      Overrides:
        `afterProblemPropertyChanged` in class `AbstractScoreDirector<Solution_,​Score_ extends Score<Score_>,​DroolsScoreDirectorFactory<Solution_,​Score_ extends Score<Score_>>>`

    - #### afterProblemFactRemoved

          public void afterProblemFactRemoved​(Object problemFact)

      Specified by:
        `afterProblemFactRemoved` in interface `ScoreDirector<Solution_>`
      Overrides:
        `afterProblemFactRemoved` in class `AbstractScoreDirector<Solution_,​Score_ extends Score<Score_>,​DroolsScoreDirectorFactory<Solution_,​Score_ extends Score<Score_>>>`