Package org.optaplanner.core.api.score.stream.uni

Interface UniConstraintStream<A>

Type Parameters:

A - the type of the first and only fact in the tuple.

All Superinterfaces:

ConstraintStream

public interface UniConstraintStream<A>
extends ConstraintStream

A ConstraintStream that matches one fact.

See Also:

• ConstraintStream

Method Summary

Modifier and Type	Method	Description
UniConstraintStream<A>	distinct()	Transforms the stream in such a way that all the tuples going through it are distinct.
UniConstraintStream<A>	filter(Predicate<A> predicate)	Exhaustively test each fact against the Predicate and match if Predicate.test(Object) returns true.
<ResultA_> UniConstraintStream<ResultA_>	flattenLast(Function<A,Iterable<ResultA_>> mapping)	Takes each tuple and applies a mapping on it, which turns the tuple into a Iterable.
<GroupKey_> UniConstraintStream<GroupKey_>	groupBy(Function<A,GroupKey_> groupKeyMapping)	Convert the UniConstraintStream to a different UniConstraintStream, containing the set of tuples resulting from applying the group key mapping function on all tuples of the original stream.
<GroupKey_, ResultContainer_, Result_> BiConstraintStream<GroupKey_,Result_>	groupBy(Function<A,GroupKey_> groupKeyMapping, UniConstraintCollector<A,ResultContainer_,Result_> collector)	Convert the UniConstraintStream to a BiConstraintStream, consisting of unique tuples with two facts.
<GroupKey_, ResultContainerB_, ResultB_, ResultContainerC_, ResultC_> TriConstraintStream<GroupKey_,ResultB_,ResultC_>	groupBy(Function<A,GroupKey_> groupKeyMapping, UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB, UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC)	Convert the UniConstraintStream to a TriConstraintStream, consisting of unique tuples with three facts.
<GroupKey_, ResultContainerB_, ResultB_, ResultContainerC_, ResultC_, ResultContainerD_, ResultD_> QuadConstraintStream<GroupKey_,ResultB_,ResultC_,ResultD_>	groupBy(Function<A,GroupKey_> groupKeyMapping, UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB, UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC, UniConstraintCollector<A,ResultContainerD_,ResultD_> collectorD)	Convert the UniConstraintStream to a QuadConstraintStream, consisting of unique tuples with four facts.
<GroupKeyA_, GroupKeyB_> BiConstraintStream<GroupKeyA_,GroupKeyB_>	groupBy(Function<A,GroupKeyA_> groupKeyAMapping, Function<A,GroupKeyB_> groupKeyBMapping)	Convert the UniConstraintStream to a BiConstraintStream, consisting of unique tuples with two facts.
<GroupKeyA_, GroupKeyB_, GroupKeyC_> TriConstraintStream<GroupKeyA_,GroupKeyB_,GroupKeyC_>	groupBy(Function<A,GroupKeyA_> groupKeyAMapping, Function<A,GroupKeyB_> groupKeyBMapping, Function<A,GroupKeyC_> groupKeyCMapping)	Convert the UniConstraintStream to a TriConstraintStream, consisting of unique tuples with three facts.
<GroupKeyA_, GroupKeyB_, GroupKeyC_, GroupKeyD_> QuadConstraintStream<GroupKeyA_,GroupKeyB_,GroupKeyC_,GroupKeyD_>	groupBy(Function<A,GroupKeyA_> groupKeyAMapping, Function<A,GroupKeyB_> groupKeyBMapping, Function<A,GroupKeyC_> groupKeyCMapping, Function<A,GroupKeyD_> groupKeyDMapping)	Convert the UniConstraintStream to a QuadConstraintStream, consisting of unique tuples with four facts.
<GroupKeyA_, GroupKeyB_, GroupKeyC_, ResultContainerD_, ResultD_> QuadConstraintStream<GroupKeyA_,GroupKeyB_,GroupKeyC_,ResultD_>	groupBy(Function<A,GroupKeyA_> groupKeyAMapping, Function<A,GroupKeyB_> groupKeyBMapping, Function<A,GroupKeyC_> groupKeyCMapping, UniConstraintCollector<A,ResultContainerD_,ResultD_> collectorD)	Combines the semantics of groupBy(Function, Function) and groupBy(UniConstraintCollector).
<GroupKeyA_, GroupKeyB_, ResultContainer_, Result_> TriConstraintStream<GroupKeyA_,GroupKeyB_,Result_>	groupBy(Function<A,GroupKeyA_> groupKeyAMapping, Function<A,GroupKeyB_> groupKeyBMapping, UniConstraintCollector<A,ResultContainer_,Result_> collector)	Combines the semantics of groupBy(Function, Function) and groupBy(UniConstraintCollector).
<GroupKeyA_, GroupKeyB_, ResultContainerC_, ResultC_, ResultContainerD_, ResultD_> QuadConstraintStream<GroupKeyA_,GroupKeyB_,ResultC_,ResultD_>	groupBy(Function<A,GroupKeyA_> groupKeyAMapping, Function<A,GroupKeyB_> groupKeyBMapping, UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC, UniConstraintCollector<A,ResultContainerD_,ResultD_> collectorD)	Combines the semantics of groupBy(Function, Function) and groupBy(UniConstraintCollector).
<ResultContainer_, Result_> UniConstraintStream<Result_>	groupBy(UniConstraintCollector<A,ResultContainer_,Result_> collector)	Convert the UniConstraintStream to a different UniConstraintStream, containing only a single tuple, the result of applying UniConstraintCollector.
<ResultContainerA_, ResultA_, ResultContainerB_, ResultB_> BiConstraintStream<ResultA_,ResultB_>	groupBy(UniConstraintCollector<A,ResultContainerA_,ResultA_> collectorA, UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB)	Convert the UniConstraintStream to a BiConstraintStream, containing only a single tuple, the result of applying two UniConstraintCollectors.
<ResultContainerA_, ResultA_, ResultContainerB_, ResultB_, ResultContainerC_, ResultC_> TriConstraintStream<ResultA_,ResultB_,ResultC_>	groupBy(UniConstraintCollector<A,ResultContainerA_,ResultA_> collectorA, UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB, UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC)	Convert the UniConstraintStream to a TriConstraintStream, containing only a single tuple, the result of applying three UniConstraintCollectors.
<ResultContainerA_, ResultA_, ResultContainerB_, ResultB_, ResultContainerC_, ResultC_, ResultContainerD_, ResultD_> QuadConstraintStream<ResultA_,ResultB_,ResultC_,ResultD_>	groupBy(UniConstraintCollector<A,ResultContainerA_,ResultA_> collectorA, UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB, UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC, UniConstraintCollector<A,ResultContainerD_,ResultD_> collectorD)	Convert the UniConstraintStream to a QuadConstraintStream, containing only a single tuple, the result of applying four UniConstraintCollectors.
default <B> UniConstraintStream<A>	ifExists(Class<B> otherClass, BiJoiner<A,B> joiner)	Create a new UniConstraintStream for every A where B exists for which the BiJoiner is true (for the properties it extracts from both facts).
<B> UniConstraintStream<A>	ifExists(Class<B> otherClass, BiJoiner<A,B>... joiners)	As defined by ifExists(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifExists(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2)	As defined by ifExists(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifExists(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3)	As defined by ifExists(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifExists(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3, BiJoiner<A,B> joiner4)	As defined by ifExists(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B> joiner)	Create a new UniConstraintStream for every A where B exists for which the BiJoiner is true (for the properties it extracts from both facts).
<B> UniConstraintStream<A>	ifExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B>... joiners)	As defined by ifExistsIncludingNullVars(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2)	As defined by ifExistsIncludingNullVars(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3)	As defined by ifExistsIncludingNullVars(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3, BiJoiner<A,B> joiner4)	As defined by ifExistsIncludingNullVars(Class, BiJoiner).
default UniConstraintStream<A>	ifExistsOther(Class<A> otherClass)	Create a new UniConstraintStream for every A, if another A exists that does not Object.equals(Object) the first.
default UniConstraintStream<A>	ifExistsOther(Class<A> otherClass, BiJoiner<A,A> joiner)	Create a new UniConstraintStream for every A, if another A exists that does not Object.equals(Object) the first, and for which the BiJoiner is true (for the properties it extracts from both facts).
default UniConstraintStream<A>	ifExistsOther(Class<A> otherClass, BiJoiner<A,A>... joiners)	As defined by ifExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifExistsOther(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2)	As defined by ifExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifExistsOther(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2, BiJoiner<A,A> joiner3)	As defined by ifExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifExistsOther(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2, BiJoiner<A,A> joiner3, BiJoiner<A,A> joiner4)	As defined by ifExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifExistsOtherIncludingNullVars(Class<A> otherClass)	Create a new UniConstraintStream for every A, if another A exists that does not Object.equals(Object) the first.
default UniConstraintStream<A>	ifExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A> joiner)	Create a new UniConstraintStream for every A, if another A exists that does not Object.equals(Object) the first, and for which the BiJoiner is true (for the properties it extracts from both facts).
default UniConstraintStream<A>	ifExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A>... joiners)	As defined by ifExistsOtherIncludingNullVars(Class, BiJoiner).
default UniConstraintStream<A>	ifExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2)	As defined by ifExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2, BiJoiner<A,A> joiner3)	As defined by ifExistsOtherIncludingNullVars(Class, BiJoiner).
default UniConstraintStream<A>	ifExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2, BiJoiner<A,A> joiner3, BiJoiner<A,A> joiner4)	As defined by ifExistsOtherIncludingNullVars(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifNotExists(Class<B> otherClass, BiJoiner<A,B> joiner)	Create a new UniConstraintStream for every A where B does not exist for which the BiJoiner is true (for the properties it extracts from both facts).
<B> UniConstraintStream<A>	ifNotExists(Class<B> otherClass, BiJoiner<A,B>... joiners)	As defined by ifNotExists(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifNotExists(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2)	As defined by ifNotExists(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifNotExists(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3)	As defined by ifNotExists(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifNotExists(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3, BiJoiner<A,B> joiner4)	As defined by ifNotExists(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifNotExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B> joiner)	Create a new UniConstraintStream for every A where B does not exist for which the BiJoiner is true (for the properties it extracts from both facts).
<B> UniConstraintStream<A>	ifNotExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B>... joiners)	As defined by ifNotExistsIncludingNullVars(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifNotExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2)	As defined by ifNotExistsIncludingNullVars(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifNotExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3)	As defined by ifNotExistsIncludingNullVars(Class, BiJoiner).
default <B> UniConstraintStream<A>	ifNotExistsIncludingNullVars(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3, BiJoiner<A,B> joiner4)	As defined by ifNotExistsIncludingNullVars(Class, BiJoiner).
default UniConstraintStream<A>	ifNotExistsOther(Class<A> otherClass)	Create a new UniConstraintStream for every A, if no other A exists that does not Object.equals(Object) the first.
default UniConstraintStream<A>	ifNotExistsOther(Class<A> otherClass, BiJoiner<A,A> joiner)	Create a new UniConstraintStream for every A, if no other A exists that does not Object.equals(Object) the first, and for which the BiJoiner is true (for the properties it extracts from both facts).
default UniConstraintStream<A>	ifNotExistsOther(Class<A> otherClass, BiJoiner<A,A>... joiners)	As defined by ifNotExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifNotExistsOther(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2)	As defined by ifNotExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifNotExistsOther(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2, BiJoiner<A,A> joiner3)	As defined by ifNotExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifNotExistsOther(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2, BiJoiner<A,A> joiner3, BiJoiner<A,A> joiner4)	As defined by ifNotExistsOther(Class, BiJoiner).
default UniConstraintStream<A>	ifNotExistsOtherIncludingNullVars(Class<A> otherClass)	Create a new UniConstraintStream for every A, if no other A exists that does not Object.equals(Object) the first.
default UniConstraintStream<A>	ifNotExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A> joiner)	Create a new UniConstraintStream for every A, if no other A exists that does not Object.equals(Object) the first, and for which the BiJoiner is true (for the properties it extracts from both facts).
default UniConstraintStream<A>	ifNotExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A>... joiners)	As defined by ifNotExistsOtherIncludingNullVars(Class, BiJoiner).
default UniConstraintStream<A>	ifNotExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2)	As defined by ifNotExistsOtherIncludingNullVars(Class, BiJoiner).
default UniConstraintStream<A>	ifNotExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2, BiJoiner<A,A> joiner3)	As defined by ifNotExistsOtherIncludingNullVars(Class, BiJoiner).
default UniConstraintStream<A>	ifNotExistsOtherIncludingNullVars(Class<A> otherClass, BiJoiner<A,A> joiner1, BiJoiner<A,A> joiner2, BiJoiner<A,A> joiner3, BiJoiner<A,A> joiner4)	As defined by ifNotExistsOtherIncludingNullVars(Class, BiJoiner).
default Constraint	impact(String constraintPackage, String constraintName, Score<?> constraintWeight, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impact(Score, ToIntFunction).
default Constraint	impact(String constraintName, Score<?> constraintWeight, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impact(Score, ToIntFunction).
default <Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	impact(Score_ constraintWeight)	Positively or negatively impacts the Score by the constraintWeight for each match and returns a builder to apply optional constraint properties.
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	impact(Score_ constraintWeight, ToIntFunction<A> matchWeigher)	Positively or negatively impacts the Score by constraintWeight multiplied by matchWeight for each match and returns a builder to apply optional constraint properties.
default Constraint	impactBigDecimal(String constraintPackage, String constraintName, Score<?> constraintWeight, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactBigDecimal(Score, Function).
default Constraint	impactBigDecimal(String constraintName, Score<?> constraintWeight, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactBigDecimal(Score, Function).
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	impactBigDecimal(Score_ constraintWeight, Function<A,BigDecimal> matchWeigher)	As defined by impact(Score, ToIntFunction), with an impact of type BigDecimal.
default UniConstraintBuilder<A,?>	impactConfigurable()	Positively impacts the Score by the ConstraintWeight for each match, and returns a builder to apply optional constraint properties.
default Constraint	impactConfigurable(String constraintPackage, String constraintName, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactConfigurable(ToIntFunction).
default Constraint	impactConfigurable(String constraintName, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactConfigurable(ToIntFunction).
UniConstraintBuilder<A,?>	impactConfigurable(ToIntFunction<A> matchWeigher)	Positively impacts the Score by the ConstraintWeight multiplied by match weight for each match, and returns a builder to apply optional constraint properties.
default Constraint	impactConfigurableBigDecimal(String constraintPackage, String constraintName, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactConfigurableBigDecimal(Function).
default Constraint	impactConfigurableBigDecimal(String constraintName, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactConfigurableBigDecimal(Function).
UniConstraintBuilder<A,?>	impactConfigurableBigDecimal(Function<A,BigDecimal> matchWeigher)	As defined by impactConfigurable(ToIntFunction), with an impact of type BigDecimal.
default Constraint	impactConfigurableLong(String constraintPackage, String constraintName, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactConfigurableLong(ToLongFunction).
default Constraint	impactConfigurableLong(String constraintName, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactConfigurableLong(ToLongFunction).
UniConstraintBuilder<A,?>	impactConfigurableLong(ToLongFunction<A> matchWeigher)	As defined by impactConfigurable(ToIntFunction), with an impact of type long.
default Constraint	impactLong(String constraintPackage, String constraintName, Score<?> constraintWeight, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactLong(Score, ToLongFunction).
default Constraint	impactLong(String constraintName, Score<?> constraintWeight, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer impactLong(Score, ToLongFunction).
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	impactLong(Score_ constraintWeight, ToLongFunction<A> matchWeigher)	As defined by impact(Score, ToIntFunction), with an impact of type long.
default <B> BiConstraintStream<A,B>	join(Class<B> otherClass)	Create a new BiConstraintStream for every combination of A and B.
default <B> BiConstraintStream<A,B>	join(Class<B> otherClass, BiJoiner<A,B> joiner)	Create a new BiConstraintStream for every combination of A and B for which the BiJoiner is true (for the properties it extracts from both facts).
<B> BiConstraintStream<A,B>	join(Class<B> otherClass, BiJoiner<A,B>... joiners)	As defined by join(Class, BiJoiner).
default <B> BiConstraintStream<A,B>	join(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2)	As defined by join(Class, BiJoiner).
default <B> BiConstraintStream<A,B>	join(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3)	As defined by join(Class, BiJoiner).
default <B> BiConstraintStream<A,B>	join(Class<B> otherClass, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3, BiJoiner<A,B> joiner4)	As defined by join(Class, BiJoiner).
default <B> BiConstraintStream<A,B>	join(UniConstraintStream<B> otherStream)	Create a new BiConstraintStream for every combination of A and B.
default <B> BiConstraintStream<A,B>	join(UniConstraintStream<B> otherStream, BiJoiner<A,B> joiner)	Create a new BiConstraintStream for every combination of A and B for which the BiJoiner is true (for the properties it extracts from both facts).
<B> BiConstraintStream<A,B>	join(UniConstraintStream<B> otherStream, BiJoiner<A,B>... joiners)	As defined by join(UniConstraintStream, BiJoiner).
default <B> BiConstraintStream<A,B>	join(UniConstraintStream<B> otherStream, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2)	As defined by join(UniConstraintStream, BiJoiner).
default <B> BiConstraintStream<A,B>	join(UniConstraintStream<B> otherStream, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3)	As defined by join(UniConstraintStream, BiJoiner).
default <B> BiConstraintStream<A,B>	join(UniConstraintStream<B> otherStream, BiJoiner<A,B> joiner1, BiJoiner<A,B> joiner2, BiJoiner<A,B> joiner3, BiJoiner<A,B> joiner4)	As defined by join(UniConstraintStream, BiJoiner).
<ResultA_> UniConstraintStream<ResultA_>	map(Function<A,ResultA_> mapping)	Transforms the stream in such a way that tuples are remapped using the given function.
default Constraint	penalize(String constraintPackage, String constraintName, Score<?> constraintWeight, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalize(Score, ToIntFunction).
default Constraint	penalize(String constraintName, Score<?> constraintWeight, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalize(Score, ToIntFunction).
default <Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	penalize(Score_ constraintWeight)	As defined by penalize(Score, ToIntFunction), where the match weight is one (1).
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	penalize(Score_ constraintWeight, ToIntFunction<A> matchWeigher)	Applies a negative Score impact, subtracting the constraintWeight multiplied by the match weight, and returns a builder to apply optional constraint properties.
default Constraint	penalizeBigDecimal(String constraintPackage, String constraintName, Score<?> constraintWeight, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeBigDecimal(Score, Function).
default Constraint	penalizeBigDecimal(String constraintName, Score<?> constraintWeight, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeBigDecimal(Score, Function).
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	penalizeBigDecimal(Score_ constraintWeight, Function<A,BigDecimal> matchWeigher)	As defined by penalize(Score, ToIntFunction), with a penalty of type BigDecimal.
default UniConstraintBuilder<A,?>	penalizeConfigurable()	Negatively impacts the Score, subtracting the ConstraintWeight for each match, and returns a builder to apply optional constraint properties.
default Constraint	penalizeConfigurable(String constraintPackage, String constraintName, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeConfigurable(ToIntFunction).
default Constraint	penalizeConfigurable(String constraintName, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeConfigurable(ToIntFunction).
UniConstraintBuilder<A,?>	penalizeConfigurable(ToIntFunction<A> matchWeigher)	Negatively impacts the Score, subtracting the ConstraintWeight multiplied by match weight for each match, and returns a builder to apply optional constraint properties.
default Constraint	penalizeConfigurableBigDecimal(String constraintPackage, String constraintName, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeConfigurableBigDecimal(Function).
default Constraint	penalizeConfigurableBigDecimal(String constraintName, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeConfigurableBigDecimal(Function).
UniConstraintBuilder<A,?>	penalizeConfigurableBigDecimal(Function<A,BigDecimal> matchWeigher)	As defined by penalizeConfigurable(ToIntFunction), with a penalty of type BigDecimal.
default Constraint	penalizeConfigurableLong(String constraintPackage, String constraintName, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeConfigurableLong(ToLongFunction).
default Constraint	penalizeConfigurableLong(String constraintName, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeConfigurableLong(ToLongFunction).
UniConstraintBuilder<A,?>	penalizeConfigurableLong(ToLongFunction<A> matchWeigher)	As defined by penalizeConfigurable(ToIntFunction), with a penalty of type long.
default Constraint	penalizeLong(String constraintPackage, String constraintName, Score<?> constraintWeight, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeLong(Score, ToLongFunction).
default Constraint	penalizeLong(String constraintName, Score<?> constraintWeight, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer penalizeLong(Score, ToLongFunction).
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	penalizeLong(Score_ constraintWeight, ToLongFunction<A> matchWeigher)	As defined by penalize(Score, ToIntFunction), with a penalty of type long.
default Constraint	reward(String constraintPackage, String constraintName, Score<?> constraintWeight, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer reward(Score, ToIntFunction).
default Constraint	reward(String constraintName, Score<?> constraintWeight, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer reward(Score, ToIntFunction).
default <Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	reward(Score_ constraintWeight)	As defined by reward(Score, ToIntFunction), where the match weight is one (1).
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	reward(Score_ constraintWeight, ToIntFunction<A> matchWeigher)	Applies a positive Score impact, adding the constraintWeight multiplied by the match weight, and returns a builder to apply optional constraint properties.
default Constraint	rewardBigDecimal(String constraintPackage, String constraintName, Score<?> constraintWeight, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardBigDecimal(Score, Function).
default Constraint	rewardBigDecimal(String constraintName, Score<?> constraintWeight, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardBigDecimal(Score, Function).
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	rewardBigDecimal(Score_ constraintWeight, Function<A,BigDecimal> matchWeigher)	As defined by reward(Score, ToIntFunction), with a penalty of type BigDecimal.
default UniConstraintBuilder<A,?>	rewardConfigurable()	Positively impacts the Score, adding the ConstraintWeight for each match, and returns a builder to apply optional constraint properties.
default Constraint	rewardConfigurable(String constraintPackage, String constraintName, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardConfigurable(ToIntFunction).
default Constraint	rewardConfigurable(String constraintName, ToIntFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardConfigurable(ToIntFunction).
UniConstraintBuilder<A,?>	rewardConfigurable(ToIntFunction<A> matchWeigher)	Positively impacts the Score, adding the ConstraintWeight multiplied by match weight for each match, and returns a builder to apply optional constraint properties.
default Constraint	rewardConfigurableBigDecimal(String constraintPackage, String constraintName, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardConfigurableBigDecimal(Function).
default Constraint	rewardConfigurableBigDecimal(String constraintName, Function<A,BigDecimal> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardConfigurableBigDecimal(Function).
UniConstraintBuilder<A,?>	rewardConfigurableBigDecimal(Function<A,BigDecimal> matchWeigher)	As defined by rewardConfigurable(ToIntFunction), with a penalty of type BigDecimal.
default Constraint	rewardConfigurableLong(String constraintPackage, String constraintName, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardConfigurableLong(ToLongFunction).
default Constraint	rewardConfigurableLong(String constraintName, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardConfigurableLong(ToLongFunction).
UniConstraintBuilder<A,?>	rewardConfigurableLong(ToLongFunction<A> matchWeigher)	As defined by rewardConfigurable(ToIntFunction), with a penalty of type long.
default Constraint	rewardLong(String constraintPackage, String constraintName, Score<?> constraintWeight, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardLong(Score, ToLongFunction).
default Constraint	rewardLong(String constraintName, Score<?> constraintWeight, ToLongFunction<A> matchWeigher)	Deprecated, for removal: This API element is subject to removal in a future version. Prefer rewardLong(Score, ToLongFunction).
<Score_ extends Score<Score_>> UniConstraintBuilder<A,Score_>	rewardLong(Score_ constraintWeight, ToLongFunction<A> matchWeigher)	As defined by reward(Score, ToIntFunction), with a penalty of type long.

Methods inherited from interface org.optaplanner.core.api.score.stream.ConstraintStream

getConstraintFactory, impact, impact, penalize, penalize, penalizeConfigurable, penalizeConfigurable, reward, reward, rewardConfigurable, rewardConfigurable

Method Details

filter

UniConstraintStream<A> filter(Predicate<A> predicate)

Exhaustively test each fact against the Predicate and match if Predicate.test(Object) returns true.

Parameters:

predicate - never null

Returns:

never null

join

default <B> BiConstraintStream<A,B> join(UniConstraintStream<B> otherStream)

Create a new BiConstraintStream for every combination of A and B.

Important: Filtering this is slower and less scalable than a join(UniConstraintStream, BiJoiner), because it doesn't apply hashing and/or indexing on the properties, so it creates and checks every combination of A and B.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherStream - never null

Returns:

never null, a stream that matches every combination of A and B

join

default <B> BiConstraintStream<A,B> join(UniConstraintStream<B> otherStream,
 BiJoiner<A,B> joiner)

Create a new BiConstraintStream for every combination of A and B for which the BiJoiner is true (for the properties it extracts from both facts).

Important: This is faster and more scalable than a join followed by a filter, because it applies hashing and/or indexing on the properties, so it doesn't create nor checks every combination of A and B.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherStream - never null

joiner - never null

Returns:

never null, a stream that matches every combination of A and B for which the BiJoiner is true

join

default <B> BiConstraintStream<A,B> join(UniConstraintStream<B> otherStream,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2)

As defined by join(UniConstraintStream, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherStream - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every combination of A and B for which all the joiners are true

join

default <B> BiConstraintStream<A,B> join(UniConstraintStream<B> otherStream,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3)

As defined by join(UniConstraintStream, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherStream - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every combination of A and B for which all the joiners are true

join

default <B> BiConstraintStream<A,B> join(UniConstraintStream<B> otherStream,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3,
 BiJoiner<A,B> joiner4)

As defined by join(UniConstraintStream, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherStream - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every combination of A and B for which all the joiners are true

join

<B> BiConstraintStream<A,B> join(UniConstraintStream<B> otherStream,
 BiJoiner<A,B>... joiners)

As defined by join(UniConstraintStream, BiJoiner). If multiple BiJoiners are provided, for performance reasons, the indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherStream - never null

joiners - never null

Returns:

never null, a stream that matches every combination of A and B for which all the joiners are true

join

default <B> BiConstraintStream<A,B> join(Class<B> otherClass)

Create a new BiConstraintStream for every combination of A and B.

Important: Filtering this is slower and less scalable than a join(Class, BiJoiner), because it doesn't apply hashing and/or indexing on the properties, so it creates and checks every combination of A and B.

Important: This is faster and more scalable than a join followed by a filter, because it applies hashing and/or indexing on the properties, so it doesn't create nor checks every combination of A and B.

Note that, if a legacy constraint stream uses ConstraintFactory.from(Class) as opposed to ConstraintFactory.forEach(Class), a different range of B may be selected. (See ConstraintFactory.from(Class) Javadoc.)

This method is syntactic sugar for join(UniConstraintStream).

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

Returns:

never null, a stream that matches every combination of A and B

join

default <B> BiConstraintStream<A,B> join(Class<B> otherClass,
 BiJoiner<A,B> joiner)

Create a new BiConstraintStream for every combination of A and B for which the BiJoiner is true (for the properties it extracts from both facts).

Important: This is faster and more scalable than a join followed by a filter, because it applies hashing and/or indexing on the properties, so it doesn't create nor checks every combination of A and B.

Note that, if a legacy constraint stream uses ConstraintFactory.from(Class) as opposed to ConstraintFactory.forEach(Class), a different range of B may be selected. (See ConstraintFactory.from(Class) Javadoc.)

This method is syntactic sugar for join(UniConstraintStream, BiJoiner).

This method has overloaded methods with multiple BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every combination of A and B for which the BiJoiner is true

join

default <B> BiConstraintStream<A,B> join(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2)

As defined by join(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every combination of A and B for which all the joiners are true

join

default <B> BiConstraintStream<A,B> join(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3)

As defined by join(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every combination of A and B for which all the joiners are true

join

default <B> BiConstraintStream<A,B> join(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3,
 BiJoiner<A,B> joiner4)

As defined by join(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every combination of A and B for which all the joiners are true

join

<B> BiConstraintStream<A,B> join(Class<B> otherClass,
 BiJoiner<A,B>... joiners)

As defined by join(Class, BiJoiner). For performance reasons, the indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every combination of A and B for which all the joiners are true

ifExists

default <B> UniConstraintStream<A> ifExists(Class<B> otherClass,
 BiJoiner<A,B> joiner)

Create a new UniConstraintStream for every A where B exists for which the BiJoiner is true (for the properties it extracts from both facts).

This method has overloaded methods with multiple BiJoiner parameters.

Note that, if a legacy constraint stream uses ConstraintFactory.from(Class) as opposed to ConstraintFactory.forEach(Class), a different definition of exists applies. (See ConstraintFactory.from(Class) Javadoc.)

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every A where B exists for which the BiJoiner is true

ifExists

default <B> UniConstraintStream<A> ifExists(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2)

As defined by ifExists(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every A where B exists for which all the BiJoiners are true

ifExists

default <B> UniConstraintStream<A> ifExists(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3)

As defined by ifExists(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every A where B exists for which all the BiJoiners are true

ifExists

default <B> UniConstraintStream<A> ifExists(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3,
 BiJoiner<A,B> joiner4)

As defined by ifExists(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every A where B exists for which all the BiJoiners are true

ifExists

<B> UniConstraintStream<A> ifExists(Class<B> otherClass,
 BiJoiner<A,B>... joiners)

As defined by ifExists(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every A where B exists for which all the BiJoiners are true

ifExistsIncludingNullVars

default <B> UniConstraintStream<A> ifExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B> joiner)

Create a new UniConstraintStream for every A where B exists for which the BiJoiner is true (for the properties it extracts from both facts). For classes annotated with PlanningEntity, this method also includes instances with null variables.

This method has overloaded methods with multiple BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every A where B exists for which the BiJoiner is true

ifExistsIncludingNullVars

default <B> UniConstraintStream<A> ifExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2)

As defined by ifExistsIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every A where B exists for which all the BiJoiners are true

ifExistsIncludingNullVars

default <B> UniConstraintStream<A> ifExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3)

As defined by ifExistsIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every A where B exists for which all the BiJoiners are true

ifExistsIncludingNullVars

default <B> UniConstraintStream<A> ifExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3,
 BiJoiner<A,B> joiner4)

As defined by ifExistsIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every A where B exists for which all the BiJoiners are true

ifExistsIncludingNullVars

<B> UniConstraintStream<A> ifExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B>... joiners)

As defined by ifExistsIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every A where B exists for which all the BiJoiners are true

ifExistsOther

default UniConstraintStream<A> ifExistsOther(Class<A> otherClass)

Create a new UniConstraintStream for every A, if another A exists that does not Object.equals(Object) the first.

Note that, if a legacy constraint stream uses ConstraintFactory.from(Class) as opposed to ConstraintFactory.forEach(Class), a different definition of exists applies. (See ConstraintFactory.from(Class) Javadoc.)

Parameters:

otherClass - never null

Returns:

never null, a stream that matches every A where a different A exists

ifExistsOther

default UniConstraintStream<A> ifExistsOther(Class<A> otherClass,
 BiJoiner<A,A> joiner)

Create a new UniConstraintStream for every A, if another A exists that does not Object.equals(Object) the first, and for which the BiJoiner is true (for the properties it extracts from both facts).

This method has overloaded methods with multiple BiJoiner parameters.

Note that, if a legacy constraint stream uses ConstraintFactory.from(Class) as opposed to ConstraintFactory.forEach(Class), a different definition of exists applies. (See ConstraintFactory.from(Class) Javadoc.)

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every A where a different A exists for which the BiJoiner is true

ifExistsOther

default UniConstraintStream<A> ifExistsOther(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2)

As defined by ifExistsOther(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every A where a different A exists for which all the BiJoiners are true

ifExistsOther

default UniConstraintStream<A> ifExistsOther(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2,
 BiJoiner<A,A> joiner3)

As defined by ifExistsOther(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every A where a different A exists for which all the BiJoiners are true

ifExistsOther

default UniConstraintStream<A> ifExistsOther(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2,
 BiJoiner<A,A> joiner3,
 BiJoiner<A,A> joiner4)

As defined by ifExistsOther(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every A where a different A exists for which all the BiJoiners are true

ifExistsOther

default UniConstraintStream<A> ifExistsOther(Class<A> otherClass,
 BiJoiner<A,A>... joiners)

As defined by ifExistsOther(Class, BiJoiner). For performance reasons, the indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every A where a different A exists for which all the BiJoiners are true

ifExistsOtherIncludingNullVars

default UniConstraintStream<A> ifExistsOtherIncludingNullVars(Class<A> otherClass)

Create a new UniConstraintStream for every A, if another A exists that does not Object.equals(Object) the first. For classes annotated with PlanningEntity, this method also includes instances with null variables.

Parameters:

otherClass - never null

Returns:

never null, a stream that matches every A where a different A exists

ifExistsOtherIncludingNullVars

default UniConstraintStream<A> ifExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A> joiner)

Create a new UniConstraintStream for every A, if another A exists that does not Object.equals(Object) the first, and for which the BiJoiner is true (for the properties it extracts from both facts). For classes annotated with PlanningEntity, this method also includes instances with null variables.

This method has overloaded methods with multiple BiJoiner parameters.

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every A where a different A exists for which the BiJoiner is true

ifExistsOtherIncludingNullVars

default UniConstraintStream<A> ifExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2)

As defined by ifExistsOther(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every A where a different A exists for which all the BiJoiners are true

ifExistsOtherIncludingNullVars

default UniConstraintStream<A> ifExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2,
 BiJoiner<A,A> joiner3)

As defined by ifExistsOtherIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every A where a different A exists for which all the BiJoiners are true

ifExistsOtherIncludingNullVars

default UniConstraintStream<A> ifExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2,
 BiJoiner<A,A> joiner3,
 BiJoiner<A,A> joiner4)

As defined by ifExistsOtherIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every A where a different A exists for which all the BiJoiners are true

ifExistsOtherIncludingNullVars

default UniConstraintStream<A> ifExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A>... joiners)

As defined by ifExistsOtherIncludingNullVars(Class, BiJoiner). If multiple BiJoiners are provided, for performance reasons, the indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every A where a different A exists for which all the BiJoiners are true

ifNotExists

default <B> UniConstraintStream<A> ifNotExists(Class<B> otherClass,
 BiJoiner<A,B> joiner)

Create a new UniConstraintStream for every A where B does not exist for which the BiJoiner is true (for the properties it extracts from both facts).

This method has overloaded methods with multiple BiJoiner parameters.

Note that, if a legacy constraint stream uses ConstraintFactory.from(Class) as opposed to ConstraintFactory.forEach(Class), a different definition of exists applies. (See ConstraintFactory.from(Class) Javadoc.)

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every A where B does not exist for which the BiJoiner is true

ifNotExists

default <B> UniConstraintStream<A> ifNotExists(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2)

As defined by ifNotExists(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every A where B does not exist for which all the BiJoiners are true

ifNotExists

default <B> UniConstraintStream<A> ifNotExists(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3)

As defined by ifNotExists(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every A where B does not exist for which all the BiJoiners are true

ifNotExists

default <B> UniConstraintStream<A> ifNotExists(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3,
 BiJoiner<A,B> joiner4)

As defined by ifNotExists(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every A where B does not exist for which all the BiJoiners are true

ifNotExists

<B> UniConstraintStream<A> ifNotExists(Class<B> otherClass,
 BiJoiner<A,B>... joiners)

As defined by ifNotExists(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every A where B does not exist for which all the BiJoiners are true

ifNotExistsIncludingNullVars

default <B> UniConstraintStream<A> ifNotExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B> joiner)

Create a new UniConstraintStream for every A where B does not exist for which the BiJoiner is true (for the properties it extracts from both facts). For classes annotated with PlanningEntity, this method also includes instances with null variables.

This method has overloaded methods with multiple BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every A where B does not exist for which the BiJoiner is true

ifNotExistsIncludingNullVars

default <B> UniConstraintStream<A> ifNotExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2)

As defined by ifNotExistsIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every A where B does not exist for which all the BiJoiners are true

ifNotExistsIncludingNullVars

default <B> UniConstraintStream<A> ifNotExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3)

As defined by ifNotExistsIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every A where B does not exist for which all the BiJoiners are true

ifNotExistsIncludingNullVars

default <B> UniConstraintStream<A> ifNotExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B> joiner1,
 BiJoiner<A,B> joiner2,
 BiJoiner<A,B> joiner3,
 BiJoiner<A,B> joiner4)

As defined by ifNotExistsIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every A where B does not exist for which all the BiJoiners are true

ifNotExistsIncludingNullVars

<B> UniConstraintStream<A> ifNotExistsIncludingNullVars(Class<B> otherClass,
 BiJoiner<A,B>... joiners)

As defined by ifNotExistsIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Type Parameters:

B - the type of the second matched fact

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every A where B does not exist for which all the BiJoiners are true

ifNotExistsOther

default UniConstraintStream<A> ifNotExistsOther(Class<A> otherClass)

Create a new UniConstraintStream for every A, if no other A exists that does not Object.equals(Object) the first.

Note that, if a legacy constraint stream uses ConstraintFactory.from(Class) as opposed to ConstraintFactory.forEach(Class), a different definition of exists applies. (See ConstraintFactory.from(Class) Javadoc.)

Parameters:

otherClass - never null

Returns:

never null, a stream that matches every A where a different A does not exist

ifNotExistsOther

default UniConstraintStream<A> ifNotExistsOther(Class<A> otherClass,
 BiJoiner<A,A> joiner)

Create a new UniConstraintStream for every A, if no other A exists that does not Object.equals(Object) the first, and for which the BiJoiner is true (for the properties it extracts from both facts).

This method has overloaded methods with multiple BiJoiner parameters.

Note that, if a legacy constraint stream uses ConstraintFactory.from(Class) as opposed to ConstraintFactory.forEach(Class), a different definition of exists applies. (See ConstraintFactory.from(Class) Javadoc.)

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which the BiJoiner is true

ifNotExistsOther

default UniConstraintStream<A> ifNotExistsOther(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2)

As defined by ifNotExistsOther(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which all the BiJoiners are true

ifNotExistsOther

default UniConstraintStream<A> ifNotExistsOther(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2,
 BiJoiner<A,A> joiner3)

As defined by ifNotExistsOther(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which all the BiJoiners are true

ifNotExistsOther

default UniConstraintStream<A> ifNotExistsOther(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2,
 BiJoiner<A,A> joiner3,
 BiJoiner<A,A> joiner4)

As defined by ifNotExistsOther(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which all the BiJoiners are true

ifNotExistsOther

default UniConstraintStream<A> ifNotExistsOther(Class<A> otherClass,
 BiJoiner<A,A>... joiners)

As defined by ifNotExistsOther(Class, BiJoiner). For performance reasons, the indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which all the BiJoiners are true

ifNotExistsOtherIncludingNullVars

default UniConstraintStream<A> ifNotExistsOtherIncludingNullVars(Class<A> otherClass)

Create a new UniConstraintStream for every A, if no other A exists that does not Object.equals(Object) the first. For classes annotated with PlanningEntity, this method also includes instances with null variables.

Parameters:

otherClass - never null

Returns:

never null, a stream that matches every A where a different A does not exist

ifNotExistsOtherIncludingNullVars

default UniConstraintStream<A> ifNotExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A> joiner)

Create a new UniConstraintStream for every A, if no other A exists that does not Object.equals(Object) the first, and for which the BiJoiner is true (for the properties it extracts from both facts). For classes annotated with PlanningEntity, this method also includes instances with null variables.

This method has overloaded methods with multiple BiJoiner parameters.

Parameters:

otherClass - never null

joiner - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which the BiJoiner is true

ifNotExistsOtherIncludingNullVars

default UniConstraintStream<A> ifNotExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2)

As defined by ifNotExistsOtherIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which all the BiJoiners are true

ifNotExistsOtherIncludingNullVars

default UniConstraintStream<A> ifNotExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2,
 BiJoiner<A,A> joiner3)

As defined by ifNotExistsOtherIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which all the BiJoiners are true

ifNotExistsOtherIncludingNullVars

default UniConstraintStream<A> ifNotExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A> joiner1,
 BiJoiner<A,A> joiner2,
 BiJoiner<A,A> joiner3,
 BiJoiner<A,A> joiner4)

As defined by ifNotExistsOtherIncludingNullVars(Class, BiJoiner). For performance reasons, indexing joiners must be placed before filtering joiners.

Parameters:

otherClass - never null

joiner1 - never null

joiner2 - never null

joiner3 - never null

joiner4 - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which all the BiJoiners are true

ifNotExistsOtherIncludingNullVars

default UniConstraintStream<A> ifNotExistsOtherIncludingNullVars(Class<A> otherClass,
 BiJoiner<A,A>... joiners)

As defined by ifNotExistsOtherIncludingNullVars(Class, BiJoiner). If multiple BiJoiners are provided, for performance reasons, the indexing joiners must be placed before filtering joiners.

This method causes Unchecked generics array creation for varargs parameter warnings, but we can't fix it with a SafeVarargs annotation because it's an interface method. Therefore, there are overloaded methods with up to 4 BiJoiner parameters.

Parameters:

otherClass - never null

joiners - never null

Returns:

never null, a stream that matches every A where a different A does not exist for which all the BiJoiners are true

groupBy

<ResultContainer_,
Result_>
UniConstraintStream<Result_> groupBy(UniConstraintCollector<A,ResultContainer_,Result_> collector)

Convert the UniConstraintStream to a different UniConstraintStream, containing only a single tuple, the result of applying UniConstraintCollector.

Type Parameters:

ResultContainer_ - the mutable accumulation type (often hidden as an implementation detail)

Result_ - the type of a fact in the destination UniConstraintStream's tuple

Parameters:

collector - never null, the collector to perform the grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<ResultContainerA_,
ResultA_,
ResultContainerB_,
ResultB_>
BiConstraintStream<ResultA_,ResultB_> groupBy(UniConstraintCollector<A,ResultContainerA_,ResultA_> collectorA,
 UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB)

Convert the UniConstraintStream to a BiConstraintStream, containing only a single tuple, the result of applying two UniConstraintCollectors.

Type Parameters:

ResultContainerA_ - the mutable accumulation type (often hidden as an implementation detail)

ResultA_ - the type of the first fact in the destination BiConstraintStream's tuple

ResultContainerB_ - the mutable accumulation type (often hidden as an implementation detail)

ResultB_ - the type of the second fact in the destination BiConstraintStream's tuple

Parameters:

collectorA - never null, the collector to perform the first grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorB - never null, the collector to perform the second grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<ResultContainerA_,
ResultA_,
ResultContainerB_,
ResultB_,
ResultContainerC_,
ResultC_>
TriConstraintStream<ResultA_,ResultB_,ResultC_> groupBy(UniConstraintCollector<A,ResultContainerA_,ResultA_> collectorA,
 UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB,
 UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC)

Convert the UniConstraintStream to a TriConstraintStream, containing only a single tuple, the result of applying three UniConstraintCollectors.

Type Parameters:

ResultContainerA_ - the mutable accumulation type (often hidden as an implementation detail)

ResultA_ - the type of the first fact in the destination TriConstraintStream's tuple

ResultContainerB_ - the mutable accumulation type (often hidden as an implementation detail)

ResultB_ - the type of the second fact in the destination TriConstraintStream's tuple

ResultContainerC_ - the mutable accumulation type (often hidden as an implementation detail)

ResultC_ - the type of the third fact in the destination TriConstraintStream's tuple

Parameters:

collectorA - never null, the collector to perform the first grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorB - never null, the collector to perform the second grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorC - never null, the collector to perform the third grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<ResultContainerA_,
ResultA_,
ResultContainerB_,
ResultB_,
ResultContainerC_,
ResultC_,
ResultContainerD_,
ResultD_>
QuadConstraintStream<ResultA_,ResultB_,ResultC_,ResultD_> groupBy(UniConstraintCollector<A,ResultContainerA_,ResultA_> collectorA,
 UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB,
 UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC,
 UniConstraintCollector<A,ResultContainerD_,ResultD_> collectorD)

Convert the UniConstraintStream to a QuadConstraintStream, containing only a single tuple, the result of applying four UniConstraintCollectors.

Type Parameters:

ResultContainerA_ - the mutable accumulation type (often hidden as an implementation detail)

ResultA_ - the type of the first fact in the destination QuadConstraintStream's tuple

ResultContainerB_ - the mutable accumulation type (often hidden as an implementation detail)

ResultB_ - the type of the second fact in the destination QuadConstraintStream's tuple

ResultContainerC_ - the mutable accumulation type (often hidden as an implementation detail)

ResultC_ - the type of the third fact in the destination QuadConstraintStream's tuple

ResultContainerD_ - the mutable accumulation type (often hidden as an implementation detail)

ResultD_ - the type of the fourth fact in the destination QuadConstraintStream's tuple

Parameters:

collectorA - never null, the collector to perform the first grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorB - never null, the collector to perform the second grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorC - never null, the collector to perform the third grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorD - never null, the collector to perform the fourth grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<GroupKey_> UniConstraintStream<GroupKey_> groupBy(Function<A,GroupKey_> groupKeyMapping)

Convert the UniConstraintStream to a different UniConstraintStream, containing the set of tuples resulting from applying the group key mapping function on all tuples of the original stream. Neither tuple of the new stream Objects.equals(Object, Object) any other.

Type Parameters:

GroupKey_ - the type of a fact in the destination UniConstraintStream's tuple; must honor the general contract of hashCode.

Parameters:

groupKeyMapping - never null, mapping function to convert each element in the stream to a different element

Returns:

never null

groupBy

<GroupKey_,
ResultContainer_,
Result_>
BiConstraintStream<GroupKey_,Result_> groupBy(Function<A,GroupKey_> groupKeyMapping,
 UniConstraintCollector<A,ResultContainer_,Result_> collector)

Convert the UniConstraintStream to a BiConstraintStream, consisting of unique tuples with two facts.

The first fact is the return value of the group key mapping function, applied on the incoming tuple. The second fact is the return value of a given UniConstraintCollector applied on all incoming tuples with the same first fact.

Type Parameters:

GroupKey_ - the type of the first fact in the destination BiConstraintStream's tuple; must honor the general contract of hashCode.

ResultContainer_ - the mutable accumulation type (often hidden as an implementation detail)

Result_ - the type of the second fact in the destination BiConstraintStream's tuple

Parameters:

groupKeyMapping - never null, function to convert the fact in the original tuple to a different fact

collector - never null, the collector to perform the grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<GroupKey_,
ResultContainerB_,
ResultB_,
ResultContainerC_,
ResultC_>
TriConstraintStream<GroupKey_,ResultB_,ResultC_> groupBy(Function<A,GroupKey_> groupKeyMapping,
 UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB,
 UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC)

Convert the UniConstraintStream to a TriConstraintStream, consisting of unique tuples with three facts.

The first fact is the return value of the group key mapping function, applied on the incoming tuple. The remaining facts are the return value of the respective UniConstraintCollector applied on all incoming tuples with the same first fact.

Type Parameters:

GroupKey_ - the type of the first fact in the destination TriConstraintStream's tuple; must honor the general contract of hashCode.

ResultContainerB_ - the mutable accumulation type (often hidden as an implementation detail)

ResultB_ - the type of the second fact in the destination TriConstraintStream's tuple

ResultContainerC_ - the mutable accumulation type (often hidden as an implementation detail)

ResultC_ - the type of the third fact in the destination TriConstraintStream's tuple

Parameters:

groupKeyMapping - never null, function to convert the fact in the original tuple to a different fact

collectorB - never null, the collector to perform the first grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorC - never null, the collector to perform the second grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<GroupKey_,
ResultContainerB_,
ResultB_,
ResultContainerC_,
ResultC_,
ResultContainerD_,
ResultD_>
QuadConstraintStream<GroupKey_,ResultB_,ResultC_,ResultD_> groupBy(Function<A,GroupKey_> groupKeyMapping,
 UniConstraintCollector<A,ResultContainerB_,ResultB_> collectorB,
 UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC,
 UniConstraintCollector<A,ResultContainerD_,ResultD_> collectorD)

Convert the UniConstraintStream to a QuadConstraintStream, consisting of unique tuples with four facts.

The first fact is the return value of the group key mapping function, applied on the incoming tuple. The remaining facts are the return value of the respective UniConstraintCollector applied on all incoming tuples with the same first fact.

Type Parameters:

GroupKey_ - the type of the first fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

ResultContainerB_ - the mutable accumulation type (often hidden as an implementation detail)

ResultB_ - the type of the second fact in the destination QuadConstraintStream's tuple

ResultContainerC_ - the mutable accumulation type (often hidden as an implementation detail)

ResultC_ - the type of the third fact in the destination QuadConstraintStream's tuple

ResultContainerD_ - the mutable accumulation type (often hidden as an implementation detail)

ResultD_ - the type of the fourth fact in the destination QuadConstraintStream's tuple

Parameters:

groupKeyMapping - never null, function to convert the fact in the original tuple to a different fact

collectorB - never null, the collector to perform the first grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorC - never null, the collector to perform the second grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorD - never null, the collector to perform the third grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<GroupKeyA_,
GroupKeyB_>
BiConstraintStream<GroupKeyA_,GroupKeyB_> groupBy(Function<A,GroupKeyA_> groupKeyAMapping,
 Function<A,GroupKeyB_> groupKeyBMapping)

Convert the UniConstraintStream to a BiConstraintStream, consisting of unique tuples with two facts.

The first fact is the return value of the first group key mapping function, applied on the incoming tuple. The second fact is the return value of the second group key mapping function, applied on all incoming tuples with the same first fact.

Type Parameters:

GroupKeyA_ - the type of the first fact in the destination BiConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyB_ - the type of the second fact in the destination BiConstraintStream's tuple; must honor the general contract of hashCode.

Parameters:

groupKeyAMapping - never null, function to convert the original tuple into a first fact

groupKeyBMapping - never null, function to convert the original tuple into a second fact

Returns:

never null

groupBy

<GroupKeyA_,
GroupKeyB_,
ResultContainer_,
Result_>
TriConstraintStream<GroupKeyA_,GroupKeyB_,Result_> groupBy(Function<A,GroupKeyA_> groupKeyAMapping,
 Function<A,GroupKeyB_> groupKeyBMapping,
 UniConstraintCollector<A,ResultContainer_,Result_> collector)

Combines the semantics of groupBy(Function, Function) and groupBy(UniConstraintCollector). That is, the first and second facts in the tuple follow the groupBy(Function, Function) semantics, and the third fact is the result of applying UniConstraintCollector.finisher() on all the tuples of the original UniConstraintStream that belong to the group.

Type Parameters:

GroupKeyA_ - the type of the first fact in the destination TriConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyB_ - the type of the second fact in the destination TriConstraintStream's tuple; must honor the general contract of hashCode.

ResultContainer_ - the mutable accumulation type (often hidden as an implementation detail)

Result_ - the type of the third fact in the destination TriConstraintStream's tuple

Parameters:

groupKeyAMapping - never null, function to convert the original tuple into a first fact

groupKeyBMapping - never null, function to convert the original tuple into a second fact

collector - never null, the collector to perform the grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<GroupKeyA_,
GroupKeyB_,
ResultContainerC_,
ResultC_,
ResultContainerD_,
ResultD_>
QuadConstraintStream<GroupKeyA_,GroupKeyB_,ResultC_,ResultD_> groupBy(Function<A,GroupKeyA_> groupKeyAMapping,
 Function<A,GroupKeyB_> groupKeyBMapping,
 UniConstraintCollector<A,ResultContainerC_,ResultC_> collectorC,
 UniConstraintCollector<A,ResultContainerD_,ResultD_> collectorD)

Combines the semantics of groupBy(Function, Function) and groupBy(UniConstraintCollector). That is, the first and second facts in the tuple follow the groupBy(Function, Function) semantics. The third fact is the result of applying the first UniConstraintCollector.finisher() on all the tuples of the original UniConstraintStream that belong to the group. The fourth fact is the result of applying the second UniConstraintCollector.finisher() on all the tuples of the original UniConstraintStream that belong to the group

Type Parameters:

GroupKeyA_ - the type of the first fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyB_ - the type of the second fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

ResultContainerC_ - the mutable accumulation type (often hidden as an implementation detail)

ResultC_ - the type of the third fact in the destination QuadConstraintStream's tuple

ResultContainerD_ - the mutable accumulation type (often hidden as an implementation detail)

ResultD_ - the type of the fourth fact in the destination QuadConstraintStream's tuple

Parameters:

groupKeyAMapping - never null, function to convert the original tuple into a first fact

groupKeyBMapping - never null, function to convert the original tuple into a second fact

collectorC - never null, the collector to perform the first grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

collectorD - never null, the collector to perform the second grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<GroupKeyA_,
GroupKeyB_,
GroupKeyC_>
TriConstraintStream<GroupKeyA_,GroupKeyB_,GroupKeyC_> groupBy(Function<A,GroupKeyA_> groupKeyAMapping,
 Function<A,GroupKeyB_> groupKeyBMapping,
 Function<A,GroupKeyC_> groupKeyCMapping)

Convert the UniConstraintStream to a TriConstraintStream, consisting of unique tuples with three facts.

The first fact is the return value of the first group key mapping function, applied on the incoming tuple. The second fact is the return value of the second group key mapping function, applied on all incoming tuples with the same first fact. The third fact is the return value of the third group key mapping function, applied on all incoming tuples with the same first fact.

Type Parameters:

GroupKeyA_ - the type of the first fact in the destination TriConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyB_ - the type of the second fact in the destination TriConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyC_ - the type of the third fact in the destination TriConstraintStream's tuple; must honor the general contract of hashCode.

Parameters:

groupKeyAMapping - never null, function to convert the original tuple into a first fact

groupKeyBMapping - never null, function to convert the original tuple into a second fact

groupKeyCMapping - never null, function to convert the original tuple into a third fact

Returns:

never null

groupBy

<GroupKeyA_,
GroupKeyB_,
GroupKeyC_,
ResultContainerD_,
ResultD_>
QuadConstraintStream<GroupKeyA_,GroupKeyB_,GroupKeyC_,ResultD_> groupBy(Function<A,GroupKeyA_> groupKeyAMapping,
 Function<A,GroupKeyB_> groupKeyBMapping,
 Function<A,GroupKeyC_> groupKeyCMapping,
 UniConstraintCollector<A,ResultContainerD_,ResultD_> collectorD)

Combines the semantics of groupBy(Function, Function) and groupBy(UniConstraintCollector). That is, the first three facts in the tuple follow the groupBy(Function, Function) semantics. The final fact is the result of applying the first UniConstraintCollector.finisher() on all the tuples of the original UniConstraintStream that belong to the group.

Type Parameters:

GroupKeyA_ - the type of the first fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyB_ - the type of the second fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyC_ - the type of the third fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

ResultContainerD_ - the mutable accumulation type (often hidden as an implementation detail)

ResultD_ - the type of the fourth fact in the destination QuadConstraintStream's tuple

Parameters:

groupKeyAMapping - never null, function to convert the original tuple into a first fact

groupKeyBMapping - never null, function to convert the original tuple into a second fact

groupKeyCMapping - never null, function to convert the original tuple into a third fact

collectorD - never null, the collector to perform the grouping operation with See ConstraintCollectors for common operations, such as count(), sum() and others.

Returns:

never null

groupBy

<GroupKeyA_,
GroupKeyB_,
GroupKeyC_,
GroupKeyD_>
QuadConstraintStream<GroupKeyA_,GroupKeyB_,GroupKeyC_,GroupKeyD_> groupBy(Function<A,GroupKeyA_> groupKeyAMapping,
 Function<A,GroupKeyB_> groupKeyBMapping,
 Function<A,GroupKeyC_> groupKeyCMapping,
 Function<A,GroupKeyD_> groupKeyDMapping)

Convert the UniConstraintStream to a QuadConstraintStream, consisting of unique tuples with four facts.

The first fact is the return value of the first group key mapping function, applied on the incoming tuple. The second fact is the return value of the second group key mapping function, applied on all incoming tuples with the same first fact. The third fact is the return value of the third group key mapping function, applied on all incoming tuples with the same first fact. The fourth fact is the return value of the fourth group key mapping function, applied on all incoming tuples with the same first fact.

Type Parameters:

GroupKeyA_ - the type of the first fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyB_ - the type of the second fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyC_ - the type of the third fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

GroupKeyD_ - the type of the fourth fact in the destination QuadConstraintStream's tuple; must honor the general contract of hashCode.

Parameters:

groupKeyAMapping - * calling map(Person::getAge) on such stream will produce a stream of Integers * [20, 25, 30],

groupKeyBMapping - never null, function to convert the original tuple into a second fact

groupKeyCMapping - never null, function to convert the original tuple into a third fact

groupKeyDMapping - never null, function to convert the original tuple into a fourth fact

Returns:

never null

map

<ResultA_> UniConstraintStream<ResultA_> map(Function<A,ResultA_> mapping)

Transforms the stream in such a way that tuples are remapped using the given function. This may produce a stream with duplicate tuples. See distinct() for details.

There are several recommendations for implementing the mapping function:

• Purity. The mapping function should only depend on its input. That is, given the same input, it always returns the same output.
• Bijectivity. No two input tuples should map to the same output tuple, or to tuples that are equal. Not following this recommendation creates a constraint stream with duplicate tuples, and may force you to use distinct() later, which comes with a performance cost.
• Immutable data carriers. The objects returned by the mapping function should be identified by their contents and nothing else. If two of them have contents which equal, then they should likewise equal and preferably be the same instance. The objects returned by the mapping function should also be immutable, meaning their contents should not be allowed to change.

Simple example: assuming a constraint stream of tuples of Persons [Ann(age = 20), Beth(age = 25), Cathy(age = 30)], calling map(Person::getAge) on such stream will produce a stream of Integers [20, 25, 30],

Example with a non-bijective mapping function: assuming a constraint stream of tuples of Persons [Ann(age = 20), Beth(age = 25), Cathy(age = 30), David(age = 30), Eric(age = 20)], calling map(Person::getAge) on such stream will produce a stream of Integers [20, 25, 30, 30, 20].

Type Parameters:

ResultA_ - the type of the only fact in the resulting UniConstraintStream's tuple

Parameters:

mapping - never null, function to convert the original tuple into the new tuple

Returns:

never null

flattenLast

<ResultA_> UniConstraintStream<ResultA_> flattenLast(Function<A,Iterable<ResultA_>> mapping)

Takes each tuple and applies a mapping on it, which turns the tuple into a Iterable. Returns a constraint stream consisting of contents of those iterables. This may produce a stream with duplicate tuples. See distinct() for details.

In cases where the original tuple is already an Iterable, use Function.identity() as the argument.

Simple example: assuming a constraint stream of tuples of Persons [Ann(roles = [USER, ADMIN]]), Beth(roles = [USER]), Cathy(roles = [ADMIN, AUDITOR])], calling flattenLast(Person::getRoles) on such stream will produce a stream of [USER, ADMIN, USER, ADMIN, AUDITOR].

Type Parameters:

ResultA_ - the type of facts in the resulting tuples. It is recommended that this type be deeply immutable. Not following this recommendation may lead to hard-to-debug hashing issues down the stream, especially if this value is ever used as a group key.

Parameters:

mapping - never null, function to convert the original tuple into Iterable

Returns:

never null

distinct

UniConstraintStream<A> distinct()

Transforms the stream in such a way that all the tuples going through it are distinct. (No two tuples will equal.)

By default, tuples going through a constraint stream are distinct. However, operations such as map(Function) may create a stream which breaks that promise. By calling this method on such a stream, duplicate copies of the same tuple will be omitted at a performance cost.

Returns:

never null

penalize

default <Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> penalize(Score_ constraintWeight)

As defined by penalize(Score, ToIntFunction), where the match weight is one (1).

Returns:

never null

penalize

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> penalize(Score_ constraintWeight,
 ToIntFunction<A> matchWeigher)

Applies a negative Score impact, subtracting the constraintWeight multiplied by the match weight, and returns a builder to apply optional constraint properties.

For non-int Score types use penalizeLong(Score, ToLongFunction) or penalizeBigDecimal(Score, Function) instead.

Parameters:

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

penalizeLong

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> penalizeLong(Score_ constraintWeight,
 ToLongFunction<A> matchWeigher)

As defined by penalize(Score, ToIntFunction), with a penalty of type long.

penalizeBigDecimal

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> penalizeBigDecimal(Score_ constraintWeight,
 Function<A,BigDecimal> matchWeigher)

As defined by penalize(Score, ToIntFunction), with a penalty of type BigDecimal.

penalizeConfigurable

default UniConstraintBuilder<A,?> penalizeConfigurable()

Negatively impacts the Score, subtracting the ConstraintWeight for each match, and returns a builder to apply optional constraint properties.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use penalize(Score) instead.

Returns:

never null

penalizeConfigurable

UniConstraintBuilder<A,?> penalizeConfigurable(ToIntFunction<A> matchWeigher)

Negatively impacts the Score, subtracting the ConstraintWeight multiplied by match weight for each match, and returns a builder to apply optional constraint properties.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use penalize(Score, ToIntFunction) instead.

Parameters:

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

penalizeConfigurableLong

UniConstraintBuilder<A,?> penalizeConfigurableLong(ToLongFunction<A> matchWeigher)

As defined by penalizeConfigurable(ToIntFunction), with a penalty of type long.

If there is no ConstraintConfiguration, use penalizeLong(Score, ToLongFunction) instead.

penalizeConfigurableBigDecimal

UniConstraintBuilder<A,?> penalizeConfigurableBigDecimal(Function<A,BigDecimal> matchWeigher)

As defined by penalizeConfigurable(ToIntFunction), with a penalty of type BigDecimal.

If there is no ConstraintConfiguration, use penalizeBigDecimal(Score, Function) instead.

reward

default <Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> reward(Score_ constraintWeight)

As defined by reward(Score, ToIntFunction), where the match weight is one (1).

Returns:

never null

reward

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> reward(Score_ constraintWeight,
 ToIntFunction<A> matchWeigher)

Applies a positive Score impact, adding the constraintWeight multiplied by the match weight, and returns a builder to apply optional constraint properties.

For non-int Score types use rewardLong(Score, ToLongFunction) or rewardBigDecimal(Score, Function) instead.

Parameters:

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

rewardLong

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> rewardLong(Score_ constraintWeight,
 ToLongFunction<A> matchWeigher)

As defined by reward(Score, ToIntFunction), with a penalty of type long.

rewardBigDecimal

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> rewardBigDecimal(Score_ constraintWeight,
 Function<A,BigDecimal> matchWeigher)

As defined by reward(Score, ToIntFunction), with a penalty of type BigDecimal.

rewardConfigurable

default UniConstraintBuilder<A,?> rewardConfigurable()

Positively impacts the Score, adding the ConstraintWeight for each match, and returns a builder to apply optional constraint properties.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use reward(Score) instead.

Returns:

never null

rewardConfigurable

UniConstraintBuilder<A,?> rewardConfigurable(ToIntFunction<A> matchWeigher)

Positively impacts the Score, adding the ConstraintWeight multiplied by match weight for each match, and returns a builder to apply optional constraint properties.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use reward(Score, ToIntFunction) instead.

Parameters:

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

rewardConfigurableLong

UniConstraintBuilder<A,?> rewardConfigurableLong(ToLongFunction<A> matchWeigher)

As defined by rewardConfigurable(ToIntFunction), with a penalty of type long.

If there is no ConstraintConfiguration, use rewardLong(Score, ToLongFunction) instead.

rewardConfigurableBigDecimal

UniConstraintBuilder<A,?> rewardConfigurableBigDecimal(Function<A,BigDecimal> matchWeigher)

As defined by rewardConfigurable(ToIntFunction), with a penalty of type BigDecimal.

If there is no ConstraintConfiguration, use rewardBigDecimal(Score, Function) instead.

impact

default <Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> impact(Score_ constraintWeight)

Positively or negatively impacts the Score by the constraintWeight for each match and returns a builder to apply optional constraint properties.

Use penalize(...) or reward(...) instead, unless this constraint can both have positive and negative weights.

Parameters:

constraintWeight - never null

Returns:

never null

impact

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> impact(Score_ constraintWeight,
 ToIntFunction<A> matchWeigher)

Positively or negatively impacts the Score by constraintWeight multiplied by matchWeight for each match and returns a builder to apply optional constraint properties.

Use penalize(...) or reward(...) instead, unless this constraint can both have positive and negative weights.

Parameters:

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

impactLong

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> impactLong(Score_ constraintWeight,
 ToLongFunction<A> matchWeigher)

As defined by impact(Score, ToIntFunction), with an impact of type long.

impactBigDecimal

<Score_ extends Score<Score_>>
UniConstraintBuilder<A,Score_> impactBigDecimal(Score_ constraintWeight,
 Function<A,BigDecimal> matchWeigher)

As defined by impact(Score, ToIntFunction), with an impact of type BigDecimal.

impactConfigurable

default UniConstraintBuilder<A,?> impactConfigurable()

Positively impacts the Score by the ConstraintWeight for each match, and returns a builder to apply optional constraint properties.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use impact(Score) instead.

Returns:

never null

impactConfigurable

UniConstraintBuilder<A,?> impactConfigurable(ToIntFunction<A> matchWeigher)

Positively impacts the Score by the ConstraintWeight multiplied by match weight for each match, and returns a builder to apply optional constraint properties.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use impact(Score, ToIntFunction) instead.

Returns:

never null

impactConfigurableLong

UniConstraintBuilder<A,?> impactConfigurableLong(ToLongFunction<A> matchWeigher)

As defined by impactConfigurable(ToIntFunction), with an impact of type long.

If there is no ConstraintConfiguration, use impactLong(Score, ToLongFunction) instead.

impactConfigurableBigDecimal

UniConstraintBuilder<A,?> impactConfigurableBigDecimal(Function<A,BigDecimal> matchWeigher)

As defined by impactConfigurable(ToIntFunction), with an impact of type BigDecimal.

If there is no ConstraintConfiguration, use impactBigDecimal(Score, Function) instead.

penalize

@Deprecated(forRemoval=true)
default Constraint penalize(String constraintName,
 Score<?> constraintWeight,
 ToIntFunction<A> matchWeigher)

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

Prefer penalize(Score, ToIntFunction).

Negatively impact the Score: subtract the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.penalize(String, Score).

For non-int Score types use penalizeLong(String, Score, ToLongFunction) or penalizeBigDecimal(String, Score, Function) instead.

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

penalize

@Deprecated(forRemoval=true)
default Constraint penalize(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 ToIntFunction<A> matchWeigher)

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

Prefer penalize(Score, ToIntFunction).

As defined by penalize(String, Score, ToIntFunction).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

penalizeLong

@Deprecated(forRemoval=true)
default Constraint penalizeLong(String constraintName,
 Score<?> constraintWeight,
 ToLongFunction<A> matchWeigher)

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

Prefer penalizeLong(Score, ToLongFunction).

Negatively impact the Score: subtract the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.penalize(String, Score).

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

penalizeLong

@Deprecated(forRemoval=true)
default Constraint penalizeLong(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 ToLongFunction<A> matchWeigher)

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

Prefer penalizeLong(Score, ToLongFunction).

As defined by penalizeLong(String, Score, ToLongFunction).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

penalizeBigDecimal

@Deprecated(forRemoval=true)
default Constraint penalizeBigDecimal(String constraintName,
 Score<?> constraintWeight,
 Function<A,BigDecimal> matchWeigher)

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

Prefer penalizeBigDecimal(Score, Function).

Negatively impact the Score: subtract the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.penalize(String, Score).

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

penalizeBigDecimal

@Deprecated(forRemoval=true)
default Constraint penalizeBigDecimal(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 Function<A,BigDecimal> matchWeigher)

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

Prefer penalizeBigDecimal(Score, Function).

As defined by penalizeBigDecimal(String, Score, Function).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

penalizeConfigurable

@Deprecated(forRemoval=true)
default Constraint penalizeConfigurable(String constraintName,
 ToIntFunction<A> matchWeigher)

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

Prefer penalizeConfigurable(ToIntFunction).

Negatively impact the Score: subtract the ConstraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.penalizeConfigurable(String).

For non-int Score types use penalizeConfigurableLong(String, ToLongFunction) or penalizeConfigurableBigDecimal(String, Function) instead.

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

penalizeConfigurable

@Deprecated(forRemoval=true)
default Constraint penalizeConfigurable(String constraintPackage,
 String constraintName,
 ToIntFunction<A> matchWeigher)

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

Prefer penalizeConfigurable(ToIntFunction).

As defined by penalizeConfigurable(String, ToIntFunction).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null

penalizeConfigurableLong

@Deprecated(forRemoval=true)
default Constraint penalizeConfigurableLong(String constraintName,
 ToLongFunction<A> matchWeigher)

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

Prefer penalizeConfigurableLong(ToLongFunction).

Negatively impact the Score: subtract the ConstraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.penalizeConfigurable(String).

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

penalizeConfigurableLong

@Deprecated(forRemoval=true)
default Constraint penalizeConfigurableLong(String constraintPackage,
 String constraintName,
 ToLongFunction<A> matchWeigher)

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

Prefer penalizeConfigurableLong(ToLongFunction).

As defined by penalizeConfigurableLong(String, ToLongFunction).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null

penalizeConfigurableBigDecimal

@Deprecated(forRemoval=true)
default Constraint penalizeConfigurableBigDecimal(String constraintName,
 Function<A,BigDecimal> matchWeigher)

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

Prefer penalizeConfigurableBigDecimal(Function).

Negatively impact the Score: subtract the ConstraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.penalizeConfigurable(String).

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

penalizeConfigurableBigDecimal

@Deprecated(forRemoval=true)
default Constraint penalizeConfigurableBigDecimal(String constraintPackage,
 String constraintName,
 Function<A,BigDecimal> matchWeigher)

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

Prefer penalizeConfigurableBigDecimal(Function).

As defined by penalizeConfigurableBigDecimal(String, Function).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null

reward

@Deprecated(forRemoval=true)
default Constraint reward(String constraintName,
 Score<?> constraintWeight,
 ToIntFunction<A> matchWeigher)

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

Prefer reward(Score, ToIntFunction).

Positively impact the Score: add the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.reward(String, Score).

For non-int Score types use rewardLong(String, Score, ToLongFunction) or rewardBigDecimal(String, Score, Function) instead.

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

reward

@Deprecated(forRemoval=true)
default Constraint reward(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 ToIntFunction<A> matchWeigher)

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

Prefer reward(Score, ToIntFunction).

As defined by reward(String, Score, ToIntFunction).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

rewardLong

@Deprecated(forRemoval=true)
default Constraint rewardLong(String constraintName,
 Score<?> constraintWeight,
 ToLongFunction<A> matchWeigher)

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

Prefer rewardLong(Score, ToLongFunction).

Positively impact the Score: add the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.reward(String, Score).

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

rewardLong

@Deprecated(forRemoval=true)
default Constraint rewardLong(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 ToLongFunction<A> matchWeigher)

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

Prefer rewardLong(Score, ToLongFunction).

As defined by rewardLong(String, Score, ToLongFunction).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

rewardBigDecimal

@Deprecated(forRemoval=true)
default Constraint rewardBigDecimal(String constraintName,
 Score<?> constraintWeight,
 Function<A,BigDecimal> matchWeigher)

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

Prefer rewardBigDecimal(Score, Function).

Positively impact the Score: add the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.reward(String, Score).

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

rewardBigDecimal

@Deprecated(forRemoval=true)
default Constraint rewardBigDecimal(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 Function<A,BigDecimal> matchWeigher)

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

Prefer rewardBigDecimal(Score, Function).

As defined by rewardBigDecimal(String, Score, Function).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

rewardConfigurable

@Deprecated(forRemoval=true)
default Constraint rewardConfigurable(String constraintName,
 ToIntFunction<A> matchWeigher)

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

Prefer rewardConfigurable(ToIntFunction).

Positively impact the Score: add the ConstraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.rewardConfigurable(String).

For non-int Score types use rewardConfigurableLong(String, ToLongFunction) or rewardConfigurableBigDecimal(String, Function) instead.

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

rewardConfigurable

@Deprecated(forRemoval=true)
default Constraint rewardConfigurable(String constraintPackage,
 String constraintName,
 ToIntFunction<A> matchWeigher)

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

Prefer rewardConfigurable(ToIntFunction).

As defined by rewardConfigurable(String, ToIntFunction).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null

rewardConfigurableLong

@Deprecated(forRemoval=true)
default Constraint rewardConfigurableLong(String constraintName,
 ToLongFunction<A> matchWeigher)

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

Prefer rewardConfigurableLong(ToLongFunction).

Positively impact the Score: add the ConstraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.rewardConfigurable(String).

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

rewardConfigurableLong

@Deprecated(forRemoval=true)
default Constraint rewardConfigurableLong(String constraintPackage,
 String constraintName,
 ToLongFunction<A> matchWeigher)

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

Prefer rewardConfigurableLong(ToLongFunction).

As defined by rewardConfigurableLong(String, ToLongFunction).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null

rewardConfigurableBigDecimal

@Deprecated(forRemoval=true)
default Constraint rewardConfigurableBigDecimal(String constraintName,
 Function<A,BigDecimal> matchWeigher)

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

Prefer rewardConfigurableBigDecimal(Function).

Positively impact the Score: add the ConstraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.rewardConfigurable(String).

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

rewardConfigurableBigDecimal

@Deprecated(forRemoval=true)
default Constraint rewardConfigurableBigDecimal(String constraintPackage,
 String constraintName,
 Function<A,BigDecimal> matchWeigher)

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

Prefer rewardConfigurableBigDecimal(Function).

As defined by rewardConfigurableBigDecimal(String, Function).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null

impact

@Deprecated(forRemoval=true)
default Constraint impact(String constraintName,
 Score<?> constraintWeight,
 ToIntFunction<A> matchWeigher)

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

Prefer impact(Score, ToIntFunction).

Positively or negatively impact the Score by the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.impact(String, Score).

Use penalize(...) or reward(...) instead, unless this constraint can both have positive and negative weights.

For non-int Score types use impactLong(String, Score, ToLongFunction) or impactBigDecimal(String, Score, Function) instead.

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

impact

@Deprecated(forRemoval=true)
default Constraint impact(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 ToIntFunction<A> matchWeigher)

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

Prefer impact(Score, ToIntFunction).

As defined by impact(String, Score, ToIntFunction).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

impactLong

@Deprecated(forRemoval=true)
default Constraint impactLong(String constraintName,
 Score<?> constraintWeight,
 ToLongFunction<A> matchWeigher)

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

Prefer impactLong(Score, ToLongFunction).

Positively or negatively impact the Score by the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.impact(String, Score).

Use penalizeLong(...) or rewardLong(...) instead, unless this constraint can both have positive and negative weights.

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

impactLong

@Deprecated(forRemoval=true)
default Constraint impactLong(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 ToLongFunction<A> matchWeigher)

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

Prefer impactLong(Score, ToLongFunction).

As defined by impactLong(String, Score, ToLongFunction).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

impactBigDecimal

@Deprecated(forRemoval=true)
default Constraint impactBigDecimal(String constraintName,
 Score<?> constraintWeight,
 Function<A,BigDecimal> matchWeigher)

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

Prefer impactBigDecimal(Score, Function).

Positively or negatively impact the Score by the constraintWeight multiplied by the match weight. Otherwise as defined by ConstraintStream.impact(String, Score).

Use penalizeBigDecimal(...) or rewardBigDecimal(...) instead, unless this constraint can both have positive and negative weights.

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

constraintWeight - never null

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

impactBigDecimal

@Deprecated(forRemoval=true)
default Constraint impactBigDecimal(String constraintPackage,
 String constraintName,
 Score<?> constraintWeight,
 Function<A,BigDecimal> matchWeigher)

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

Prefer impactBigDecimal(Score, Function).

As defined by impactBigDecimal(String, Score, Function).

Parameters:

constraintPackage - never null

constraintName - never null

constraintWeight - never null

matchWeigher - never null

Returns:

never null

impactConfigurable

@Deprecated(forRemoval=true)
default Constraint impactConfigurable(String constraintName,
 ToIntFunction<A> matchWeigher)

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

Prefer impactConfigurable(ToIntFunction).

Positively or negatively impact the Score by the ConstraintWeight multiplied by the match weight.

Use penalizeConfigurable(...) or rewardConfigurable(...) instead, unless this constraint can both have positive and negative weights.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use ConstraintStream.impact(String, Score) instead.

For non-int Score types use impactConfigurableLong(String, ToLongFunction) or impactConfigurableBigDecimal(String, Function) instead.

The Constraint.getConstraintPackage() defaults to ConstraintConfiguration.constraintPackage().

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

impactConfigurable

@Deprecated(forRemoval=true)
default Constraint impactConfigurable(String constraintPackage,
 String constraintName,
 ToIntFunction<A> matchWeigher)

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

Prefer impactConfigurable(ToIntFunction).

As defined by impactConfigurable(String, ToIntFunction).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null

impactConfigurableLong

@Deprecated(forRemoval=true)
default Constraint impactConfigurableLong(String constraintName,
 ToLongFunction<A> matchWeigher)

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

Prefer impactConfigurableLong(ToLongFunction).

Positively or negatively impact the Score by the ConstraintWeight multiplied by the match weight.

Use penalizeConfigurableLong(...) or rewardConfigurableLong(...) instead, unless this constraint can both have positive and negative weights.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use ConstraintStream.impact(String, Score) instead.

The Constraint.getConstraintPackage() defaults to ConstraintConfiguration.constraintPackage().

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

impactConfigurableLong

@Deprecated(forRemoval=true)
default Constraint impactConfigurableLong(String constraintPackage,
 String constraintName,
 ToLongFunction<A> matchWeigher)

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

Prefer impactConfigurableLong(ToLongFunction).

As defined by impactConfigurableLong(String, ToLongFunction).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null

impactConfigurableBigDecimal

@Deprecated(forRemoval=true)
default Constraint impactConfigurableBigDecimal(String constraintName,
 Function<A,BigDecimal> matchWeigher)

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

Prefer impactConfigurableBigDecimal(Function).

Positively or negatively impact the Score by the ConstraintWeight multiplied by the match weight.

Use penalizeConfigurableBigDecimal(...) or rewardConfigurableBigDecimal(...) instead, unless this constraint can both have positive and negative weights.

The constraintWeight comes from an ConstraintWeight annotated member on the ConstraintConfiguration, so end users can change the constraint weights dynamically. This constraint may be deactivated if the ConstraintWeight is zero. If there is no ConstraintConfiguration, use ConstraintStream.impact(String, Score) instead.

The Constraint.getConstraintPackage() defaults to ConstraintConfiguration.constraintPackage().

Parameters:

constraintName - never null, shows up in ConstraintMatchTotal during score justification

matchWeigher - never null, the result of this function (matchWeight) is multiplied by the constraintWeight

Returns:

never null

impactConfigurableBigDecimal

@Deprecated(forRemoval=true)
default Constraint impactConfigurableBigDecimal(String constraintPackage,
 String constraintName,
 Function<A,BigDecimal> matchWeigher)

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

Prefer impactConfigurableBigDecimal(Function).

As defined by impactConfigurableBigDecimal(String, Function).

Parameters:

constraintPackage - never null

constraintName - never null

matchWeigher - never null

Returns:

never null