Package org.optaplanner.core.api.score.constraint

Class ConstraintMatch<Score_ extends Score<Score_>>

java.lang.Object

org.optaplanner.core.api.score.constraint.ConstraintMatch<Score_>

Type Parameters:

Score_ - the actual score type

All Implemented Interfaces:

Comparable<ConstraintMatch<Score_>>

public final class ConstraintMatch<Score_ extends Score<Score_>>
extends Object
implements Comparable<ConstraintMatch<Score_>>

Retrievable from ConstraintMatchTotal.getConstraintMatchSet() and Indictment.getConstraintMatchSet().

This class implements Comparable for consistent ordering of constraint matches in visualizations. The details of this ordering are unspecified and are subject to change.

Constructor Summary

Constructors

Constructor	Description
ConstraintMatch(String constraintPackage, String constraintName, List<Object> justificationList, Score_ score)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer ConstraintMatch(String, String, ConstraintJustification, Collection, Score).
ConstraintMatch(String constraintPackage, String constraintName, ConstraintJustification justification, Collection<Object> indictedObjects, Score_ score)

Method Summary

Modifier and Type	Method	Description
int	compareTo(ConstraintMatch<Score_> other)
String	getConstraintId()
String	getConstraintName()
String	getConstraintPackage()
String	getIdentificationString()
List<Object>	getIndictedObjectList()	Returns a set of objects indicted for causing this constraint match.
<Justification_ extends ConstraintJustification> Justification_	getJustification()	Return a singular justification for the constraint.
List<Object>	getJustificationList()	Deprecated, for removal: This API element is subject to removal in a future version. Prefer getJustification() or getIndictedObjectList().
Score_	getScore()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ConstraintMatch

@Deprecated(forRemoval=true)
public ConstraintMatch(String constraintPackage,
                       String constraintName,
                       List<Object> justificationList,
                       Score_ score)

Deprecated, for removal: This API element is subject to removal in a future version.

Prefer ConstraintMatch(String, String, ConstraintJustification, Collection, Score).

Parameters:

constraintPackage - never null

constraintName - never null

justificationList - never null, sometimes empty

score - never null

ConstraintMatch

public ConstraintMatch(String constraintPackage,
                       String constraintName,
                       ConstraintJustification justification,
                       Collection<Object> indictedObjects,
                       Score_ score)

Parameters:

constraintPackage - never null

constraintName - never null

justification - never null

score - never null

Method Detail

getConstraintPackage

public String getConstraintPackage()

getConstraintName

public String getConstraintName()

getJustificationList

@Deprecated(forRemoval=true)
public List<Object> getJustificationList()

Deprecated, for removal: This API element is subject to removal in a future version.

Prefer getJustification() or getIndictedObjectList().

Return a list of justifications for the constraint.

This method has a different meaning based on which score director the constraint comes from.

• For Score DRL, it returns every object that Drools considers to be part of the match. This is largely undefined.
• For incremental score calculation, it returns what the calculator is implemented to return.
• For constraint streams, it returns a list of facts from the matching tuple for backwards compatibility (eg. [A, B] for a bi stream), unless a custom justification mapping was provided, in which case it throws an exception, pointing users towards getJustification().

Returns:

never null

getJustification

public <Justification_ extends ConstraintJustification> Justification_ getJustification()

Return a singular justification for the constraint.

This method has a different meaning based on which score director the constraint comes from.

• For Score DRL, it returns DefaultConstraintJustification of all objects that Drools considers to be part of the match. This is largely undefined.
• For incremental score calculation, it returns what the calculator is implemented to return.
• For constraint streams, it returns DefaultConstraintJustification from the matching tuple (eg. [A, B] for a bi stream), unless a custom justification mapping was provided, in which case it returns the return value of that function.

Returns:

never null

getIndictedObjectList

public List<Object> getIndictedObjectList()

Returns a set of objects indicted for causing this constraint match.

This method has a different meaning based on which score director the constraint comes from.

• For Score DRL, it returns DefaultConstraintJustification of all objects that Drools considers to be part of the match. This is largely undefined.
• For incremental score calculation, it returns what the calculator is implemented to return.
• For constraint streams, it returns the facts from the matching tuple (eg. [A, B] for a bi stream), unless a custom indictment mapping was provided, in which case it returns the return value of that function.

Returns:

never null, may be empty

getScore

public Score_ getScore()

getConstraintId

public String getConstraintId()

getIdentificationString

public String getIdentificationString()

compareTo

public int compareTo(ConstraintMatch<Score_> other)

Specified by:

compareTo in interface Comparable<Score_ extends Score<Score_>>

toString

public String toString()

Overrides:

toString in class Object