13.40. Convenience Methods using the Kcontext Variable

The call kcontext.getKnowledgeRuntime().halt() terminates rule execution immediately.

The accessor getAgenda() returns a reference to the session's Agenda, which in turn provides access to the various rule groups: activation groups, agenda groups, and rule flow groups. A fairly common paradigm is the activation of some agenda group, which could be done with the lengthy call:

// give focus to the agenda group CleanUp
kcontext.getKnowledgeRuntime().getAgenda().getAgendaGroup( "CleanUp" ).setFocus();

(You can achieve the same using drools.setFocus( "CleanUp" ).)

To run a query, you call getQueryResults(String query), whereupon you may process the results.

A set of methods dealing with event management lets you add and remove event listeners for the Working Memory and the Agenda.

MethodgetKnowledgeBase() returns the KnowledgeBase object, the backbone of all the Knowledge in your system, and the originator of the current session.

You can manage globals with setGlobal(...), getGlobal(...) and getGlobals().

Method getEnvironment() returns the runtime's Environment.