Class ScimFilterEvaluator

java.lang.Object
com.revetsec.scim.ScimFilterEvaluator

@Immutable @CheckReturnValue public final class ScimFilterEvaluator extends Object
Optional bounded evaluation of schema-bound, policy-approved filters against application data. Each evaluation rechecks the entire filter under this evaluator's provider. All clauses and matching array elements are visited, including clauses whose truth value cannot change the verdict, so unsupported application matching cannot become a successful non-match.

String matching uses the provider's explicitly configured strategy, shared with PATCH. Missing/null values and empty multi-values are unassigned; empty strings are assigned for null comparisons but fail presence. For assigned multi-values, comparisons use any-element semantics, including ne; not negates the complete predicate. An unassigned attribute is unequal to a nonnull literal. This evaluator does not authorize a resource, execute storage queries, or establish authoritative identity uniqueness.

Since:
1.0.0
  • Method Details

    • fromServiceProvider

      Creates an evaluator using this provider's matching strategy, policies and limits.
      Parameters:
      provider - the registered semantic context
      Returns:
      an immutable evaluator
      Throws:
      IllegalArgumentException - if the provider has no application string matching strategy
      Since:
      1.0.0
    • evaluateResult

      Rebinds, approves and evaluates a complete filter with one shared work budget. A foreign registered resource context rejects; a syntax-only or foreign filter is rechecked. Parsed/bound roots retain original syntax privately so canonical expansion does not consume their input-character allowance. Original syntax is reparsed under this provider; extracted subtrees without that provenance use a bounded canonical fallback. Unsupported matching rejects with invalidFilter. Ordinary application faults are contained as fixed internalError results and redacted observer events; interruption is preserved and fatal VM errors escape.
      Parameters:
      resource - the immutable application resource
      filter - the bounded filter tree to recheck
      Returns:
      the complete verdict or fixed rejection
      Since:
      1.0.0
    • toString

      Returns a fixed redacted description.
      Overrides:
      toString in class Object
      Returns:
      the description
      Since:
      1.0.0