de.ipcon.db.core

Class BOPredicateEquals

java.lang.Object

de.ipcon.db.core.BOPredicateEquals

All Implemented Interfaces:

java.util.function.Predicate<BO>

public class BOPredicateEquals
extends java.lang.Object
implements java.util.function.Predicate<BO>

A predicate function for comparing a BO to a Attribute-value pair. Values are looked up and compared using BO.nullSafeEquals. predicate = BOPredicateEquals.ofAttrs(['Tid', 'Name'], [Object null, 'WantedName'], [boolean 1]) tidNotNull = boList.stream().filter(predicate).collect(Collectors.toList())

Constructor Summary

Constructors

Constructor and Description
BOPredicateEquals(java.lang.String attributeName, java.lang.Object value)
BOPredicateEquals(java.lang.String attributeName, java.lang.Object value, boolean allowThrowIfInvalid)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAttributeName()
java.lang.Object	getExpectedValue()
static java.util.function.Predicate<BO>	ofAttr(java.lang.String attributeName, java.lang.Object value)
static java.util.function.Predicate<BO>	ofAttr(java.lang.String attributeName, java.lang.Object value, boolean notValue)
static java.util.function.Predicate<BO>	ofAttr(java.lang.String attributeName, java.lang.Object value, boolean notValue, boolean implicitNotLdelCheck)
static java.util.function.Predicate<BO>	ofAttr(java.lang.String attributeName, java.lang.Object value, boolean notValue, boolean implicitNotLdelCheck, boolean allowThrow)
static java.util.function.Predicate<BO>	ofAttrs(java.lang.String[] attributeNames, java.lang.Object[] values) Returns an optimized Predicate for comparing multiple attrs-values pairs.
static java.util.function.Predicate<BO>	ofAttrs(java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValues)
static java.util.function.Predicate<BO>	ofAttrs(java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValues, boolean onlyNotDeleted)
static java.util.function.Predicate<BO>	ofAttrs(java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValues, boolean onlyNotDeleted, boolean allowThrow)
static java.util.function.Predicate<BO>	ofAttrsChained(java.lang.String[] attributeNames, java.lang.Object[] values) Builds a predicate for each attribute-value pairs and links then using Predicate.and(java.util.function.Predicate).
static java.util.function.Predicate<BO>	ofAttrsChained(java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValues)
static java.util.function.Predicate<BO>	ofAttrsChained(java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValues, boolean onlyNotDeleted)
static java.util.function.Predicate<BO>	ofAttrsChained(java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValues, boolean onlyNotDeleted, boolean allowThrow)
static java.util.function.Predicate<BO>	ofAttrsNoSkipDeleted(java.lang.String[] attributeNames, java.lang.Object[] values)
static java.util.function.Predicate<BO>	ofAttrsNoSkipDeleted(java.lang.String[] attributeNames, java.lang.Object[] values, boolean[] notValues)
boolean	test(BO bo)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.function.Predicate

and, isEqual, negate, or

Constructor Detail

BOPredicateEquals

public BOPredicateEquals(java.lang.String attributeName,
                         java.lang.Object value)

BOPredicateEquals

public BOPredicateEquals(java.lang.String attributeName,
                         java.lang.Object value,
                         boolean allowThrowIfInvalid)

Method Detail

getAttributeName

public java.lang.String getAttributeName()

getExpectedValue

public java.lang.Object getExpectedValue()

test

public boolean test(BO bo)

Specified by:

test in interface java.util.function.Predicate<BO>

ofAttrsChained

public static java.util.function.Predicate<BO> ofAttrsChained(java.lang.String[] attributeNames,
                                                              java.lang.Object[] values)

Builds a predicate for each attribute-value pairs and links then using Predicate.and(java.util.function.Predicate). A predicate of a pair is negated if the notValues parameter is true at the same index and exists. If no attributes are provided and no implicitLdel check is needed, then a not-null Predicate is returned. Will automatically add a check to return false if Synchable.isDeleted() returns true, unless onlyNotDeleted is false.

Parameters:

attributeNames -

values -

notValues -

onlyNotDeleted - if true (default), then the predicate will always return false for deleted BOs. If false, deletion is not checked explicitly.

allowThrow - if true (default), then throws an exception if the class of a wanted value is incompatible with the class of the Attribute chain. If false, returns false in that case.

Returns:

a Predicate that will return true if the BO matches the given attr-value pairs. false otherwise. If attrs is empty, then matches all nonnull BOs and ignores access to a Schema, deleted-state is checked depending on onlyNotDeleted.

ofAttrsChained

public static java.util.function.Predicate<BO> ofAttrsChained(java.lang.String[] attributeNames,
                                                              java.lang.Object[] values,
                                                              boolean[] notValues)

ofAttrsChained

public static java.util.function.Predicate<BO> ofAttrsChained(java.lang.String[] attributeNames,
                                                              java.lang.Object[] values,
                                                              boolean[] notValues,
                                                              boolean onlyNotDeleted)

ofAttrsChained

public static java.util.function.Predicate<BO> ofAttrsChained(java.lang.String[] attributeNames,
                                                              java.lang.Object[] values,
                                                              boolean[] notValues,
                                                              boolean onlyNotDeleted,
                                                              boolean allowThrow)

ofAttr

public static java.util.function.Predicate<BO> ofAttr(java.lang.String attributeName,
                                                      java.lang.Object value)

Parameters:

attributeName - the attribute (path) to check, nonnull.

value - the expected value of that path, nullable.

notValue - false, the value should be equal to the found value. true if the value has to be different from found value.

implicitNotLdelCheck - if true and attr is not 'Ldel', then an explicit check to filter out deleted BOs is added before this comparison. If either false or attr is Ldel, this check is not added. This slightly differs in behaviour from the other factories, which either always add an Ldel check or don't. For a simple predicate to filter out deleted BOs, please see LambdaTools.not(BO::isDeleted). Defaults to true.

@param - allowThrow if true (default), then throws an exception if the class of a wanted value is incompatible with the class of the Attribute chain. If false, returns false in that case.

Returns:

a Predicate for a single attr-value comparison, disallowing deleted BOs unless specified explicitly.

ofAttr

public static java.util.function.Predicate<BO> ofAttr(java.lang.String attributeName,
                                                      java.lang.Object value,
                                                      boolean notValue)

ofAttr

public static java.util.function.Predicate<BO> ofAttr(java.lang.String attributeName,
                                                      java.lang.Object value,
                                                      boolean notValue,
                                                      boolean implicitNotLdelCheck)

ofAttr

public static java.util.function.Predicate<BO> ofAttr(java.lang.String attributeName,
                                                      java.lang.Object value,
                                                      boolean notValue,
                                                      boolean implicitNotLdelCheck,
                                                      boolean allowThrow)

ofAttrs

public static java.util.function.Predicate<BO> ofAttrs(java.lang.String[] attributeNames,
                                                       java.lang.Object[] values)

Returns an optimized Predicate for comparing multiple attrs-values pairs. Will always skip not deleted BOs by default, unless this behaviour is explicitly disabled by setting the onlyNotDeleted parameter to false. Will always return false if onlyNotDeleted is true and attrs contain with a comparison to 'true', because both checks are disjunctive.

Parameters:

attributeNames - a nonnull list of attributes to check.

values - a nonnull list of values to compare the attribute of the same index to.

notValues - a nullable list of booleans, with 'true' inverting the comparison check for that index to "not equals". If notValues is null, doesn't have the same index or contains false, then the attr is compared to "equals". Can be smaller than the attrs and values array.

onlyNotDeleted - if true (default), then deleted BOs are always skipped. If false, then deleted BOs are checked against the attr-value pairs as well.

allowThrow - if true and an attribute references a class that cannot be assigned to an expected value, then an exception is thrown. This situation points to a broken call and an predicate that is executed on unexpected objects. If false, then false is returned in this situation.

Returns:

a Predicate that will return true if the BO matches the given attr-value pairs. false otherwise. If attrs is empty, then matches all BOs with access to a schema, deleted-state is checked depending on onlyNotDeleted.

ofAttrs

public static java.util.function.Predicate<BO> ofAttrs(java.lang.String[] attributeNames,
                                                       java.lang.Object[] values,
                                                       boolean[] notValues)

ofAttrs

public static java.util.function.Predicate<BO> ofAttrs(java.lang.String[] attributeNames,
                                                       java.lang.Object[] values,
                                                       boolean[] notValues,
                                                       boolean onlyNotDeleted)

ofAttrs

public static java.util.function.Predicate<BO> ofAttrs(java.lang.String[] attributeNames,
                                                       java.lang.Object[] values,
                                                       boolean[] notValues,
                                                       boolean onlyNotDeleted,
                                                       boolean allowThrow)

ofAttrsNoSkipDeleted

public static java.util.function.Predicate<BO> ofAttrsNoSkipDeleted(java.lang.String[] attributeNames,
                                                                    java.lang.Object[] values)

ofAttrsNoSkipDeleted

public static java.util.function.Predicate<BO> ofAttrsNoSkipDeleted(java.lang.String[] attributeNames,
                                                                    java.lang.Object[] values,
                                                                    boolean[] notValues)