org.evrete.api

Interface RuleSession<S extends RuleSession<S>>

All Superinterfaces:

Environment, EvaluatorsContext, FluentEnvironment<S>, FluentImports<RuntimeContext<?>>, RuleSet<RuntimeRule>, RuntimeContext<S>

All Known Subinterfaces:

StatefulSession, StatelessSession

public interface RuleSession<S extends RuleSession<S>>
extends RuntimeContext<S>, RuleSet<RuntimeRule>

Base interface for both stateful and stateless sessions

Field Summary

Fields inherited from interface org.evrete.api.RuntimeContext

SALIENCE_COMPARATOR

Method Summary

Modifier and Type	Method and Description
S	addEventListener(SessionLifecycleListener listener)
<T> Collector<T,?,S>	asCollector() A convenience method that returns an instance of Collector for inserting streams of facts.
Object	fire()
ActivationManager	getActivationManager()
Knowledge	getParentContext()
default S	insert(Collection<?> objects) Inserts a collection of facts.
default S	insert(Object... objects) Inserts an array of facts.
FactHandle	insert(Object fact) Inserts a fact in working memory and returns a serializable fact handle.
default S	insert(String type, Collection<?> objects) Inserts a collection of facts, marking them as being of a specific type.
FactHandle	insert(String type, Object fact) Inserts a fact and explicitly specifies its Type name.
S	removeEventListener(SessionLifecycleListener listener)
S	setActivationManager(ActivationManager activationManager)
S	setExecutionPredicate(BooleanSupplier criteria) Session call's the supplier's BooleanSupplier.getAsBoolean() method prior to each activation cycle.
default S	setFireCriteria(BooleanSupplier criteria) Deprecated.

Methods inherited from interface org.evrete.api.RuntimeContext

getActivationManagerFactory, getClassLoader, getConfiguration, getExpressionResolver, getRuleComparator, getService, getTypeResolver, newRule, newRule, setActivationManagerFactory, setActivationManagerFactory, setActivationMode, setClassLoader, setRuleComparator, wrapTypeResolver

Methods inherited from interface org.evrete.api.EvaluationListeners

addListener, removeListener

Methods inherited from interface org.evrete.api.FluentImports

addImport, addImport, getImports, getJavaImports

Methods inherited from interface org.evrete.api.FluentEnvironment

set

Methods inherited from interface org.evrete.api.Environment

get, get, getPropertyNames

Methods inherited from interface org.evrete.api.EvaluatorsContext

addEvaluator, addEvaluator, replaceEvaluator

Methods inherited from interface org.evrete.api.RuleSet

compileRule, getRule, getRule, getRules, ruleExists

Method Detail

insert

FactHandle insert(Object fact)

Inserts a fact in working memory and returns a serializable fact handle.

Parameters:

fact - object to insert

Returns:

fact handle assigned to the fact

Throws:

NullPointerException - if argument is null

See Also:

FactHandle

asCollector

<T> Collector<T,?,S> asCollector()

A convenience method that returns an instance of Collector for inserting streams of facts.

Returns:

collector

setFireCriteria

@Deprecated
default S setFireCriteria(BooleanSupplier criteria)

Deprecated.

Method renamed, use the setExecutionPredicate(BooleanSupplier) instead.

setExecutionPredicate

S setExecutionPredicate(BooleanSupplier criteria)

Session call's the supplier's BooleanSupplier.getAsBoolean() method prior to each activation cycle. If the provided value is false then the cycle gets interrupted and session exits its fire(...) method.

Along with the ActivationManager, this method can be used to debug rules, to avoid infinite activation loops, or to prevent excessive consumption of computer resources.

Parameters:

criteria - - boolean value supplier

Returns:

this session

insert

FactHandle insert(String type,
                  Object fact)

Inserts a fact and explicitly specifies its Type name.

Parameters:

type - type name

fact - fact to insert

Returns:

fact handle assigned to the fact

Throws:

NullPointerException - if argument is null

insert

default S insert(String type,
                 Collection<?> objects)

Inserts a collection of facts, marking them as being of a specific type.

Parameters:

type - type name

objects - objects to insert

See Also:

insert(String, Object)

insert

default S insert(Collection<?> objects)

Inserts a collection of facts.

Parameters:

objects - objects to insert

See Also:

insert(Object)

insert

default S insert(Object... objects)

Inserts an array of facts.

Parameters:

objects - objects to insert

See Also:

insert(Object)

getActivationManager

ActivationManager getActivationManager()

setActivationManager

S setActivationManager(ActivationManager activationManager)

addEventListener

S addEventListener(SessionLifecycleListener listener)

removeEventListener

S removeEventListener(SessionLifecycleListener listener)

getParentContext

Knowledge getParentContext()

fire

Object fire()