Skip navigation links

Overview

Package

Class

Tree

Deprecated

Index

Help

Rule Execution Server API

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

ilog.rules.engine
Class IlrContext

java.lang.Object
  ilog.rules.engine.IlrContext

All Implemented Interfaces:: Serializable

public class IlrContext
extends Object
implements Serializable
extends Object
implements Serializable

IlrContext is the base class of all the execution contexts. Rules can be executed only within an execution context.

Overview

In IBM Decision server, the rule engine is an instance of IlrContext, the rule engine is simply a Java object.

An IlrContext instance is always attached to an IlrRuleset. If the context is created without a ruleset passed as an argument, it creates its own ruleset.

An IlrContext instance contains all the methods required to control the rule engine. IlrRuleset is responsible for rule management, IlrContext is responsible for rule execution.

Deprecations and warnings

Since version 5.0, the derivation of IlrContext has been deprecated. You should use ruleset variables to add new fields to the execution context.

An execution context is serializable.

Warning: Serialized objects of this class will not be compatible with future releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of IBM Decision Server.

See Also:: IlrRuleset, Serialized Form

Field Summary
`static String`	`firedRulesCountConstant` Deprecated. use instead `IlrPropertyNames.FIRED_RULES_COUNT`
`PrintWriter`	`out` Deprecated. As of ODM 8.0.1, the method `note(String)` should be used

Constructor Summary
`IlrContext()` Deprecated. As of JRules 7.1, this way of constructing a context with an empty ruleset is deprecated. See other constructors for replacement.
`IlrContext(IlrRuleset ruleset)` Constructs an `IlrContext` with an `IlrRuleset` object.
`IlrContext(IlrRuleset ruleset, com.ibm.rules.engine.connector.DataConnectorFactory dcf)`

Method Summary
`void`	`activatePacket(String packet)` Deprecated.
`void`	`activateRule(IlrRule rule)` Deprecated.
`void`	`activateRules(IlrRule[] rules)` Deprecated.
`void`	`addNoteHandler(IlrNoteHandler handler)` Adds a note handler to the context.
`Object`	`assertLogical(Object object)` Deprecated. As of IBM Decision Server 8.0.1, truth maintenance system is deprecated.
`void`	`cleanRulesetVariables()` Resets the values of the ruleset variables: either the 'in' parameters, or the 'out' or the local variables.
`int`	`connectTool(IlrTool tool)` Connects an `IlrTool` to the context.
`int`	`connectTool(IlrToolFactory toolFactory)` Connects an `IlrTool` created by an `IlrToolFactory` to the context.
`int`	`connectTool(IlrToolFactory toolFactory, String name)` Connects an `IlrTool` created by an `IlrToolFactory` to the context.
`void`	`deactivatePacket(String packet)` Deprecated.
`void`	`deactivateRule(IlrRule rule)` Deprecated.
`void`	`deactivateRules(IlrRule[] rules)` Deprecated.
`void`	`disconnectTool(int toolID)` Disconnects a connected `IlrTool`.
`void`	`disconnectTools()` Disconnects all connected `IlrTool`.
`void`	`end()` Prepares this context for garbage collection.
`void`	`endCurrentTask()` Ends the context's current task by executing its potential final actions and declaring it as Completed.
`Enumeration`	`enumerateInstances()` Enumerates all the rule instances currently in the agenda of the context, without changing the contents of the agenda.
`Enumeration`	`enumerateObjects()` Enumerates all the objects in working memory of the context without any discrimination on their types.
`IlrParameterMap`	`execute()` Executes the ruleflow defined in the context's ruleset.
`IlrParameterMap`	`execute(String name)` Executes the task passed as the argument.
`void`	`executeInitialRule()` Deprecated.
`Object`	`executeMain(Object arg)` Invokes the `ilrmain` function with an argument.
`Object`	`executeMain(String pkgName, Object arg)` Invokes the `ilrmain` function of the specified package with an argument.
`IlrParameterMap`	`executeTask()` Provides a step-by-step execution of the ruleflow.
`int`	`fireAllRules()` Fires all the rules in the agenda.
`int`	`fireAllRules(IlrAgendaFilter filter)` Fires all the rules in the agenda using an agenda filter.
`IlrRuleInstance`	`fireRule()` Fires the rule in the agenda that has the highest priority.
`IlrRuleInstance`	`fireRule(IlrAgendaFilter filter)` Fires the next rule instance in the agenda that passes the filter.
`int`	`fireRules(IlrRule[] rules)` Adds the rules passed as its argument to the context, fires all the rules in the agenda, and removes the rules that were passed as its argument.
`IlrRule[]`	`getActivatedRules()` Deprecated.
`int`	`getConnectedToolNumber()` Gives the number of connected `IlrTool`(s) to the context.
`IlrTask`	`getCurrentTask()` Returns the task that is currently executing or the task that is in a suspended state in the ruleflow.
`static IlrNoteHandler`	`getDefaultNoteHandler()` Returns the default note handler.
`IlrEvent`	`getEvent(Object object)` Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.
`IlrExceptionHandler`	`getExceptionHandler()` Gets the exception handler of this execution context.
`IlrRuleInstance`	`getFirstInstance()` Gets the first rule instance of the agenda.
`IlrTask`	`getMainTask()` Returns the task defined as the main task in the context's ruleset ruleflow.
`Object[]`	`getObjects(IlrClass clazz)` Gets all the objects in working memory that are instances of the passed XOM class.
`Object`	`getParameterValue(String name)` Gets the value of the ruleset parameter.
`IlrParameterMap`	`getReturnValues()` Returns the values of the "out" ruleset variables (those defined either with the "inout" or "out" modifier).
`IlrRuleset`	`getRuleset()` Gets the ruleset to which the context is attached.
`IlrTask`	`getTask(String name)` Returns the task defined in the ruleflow and whose name is the one passed as the parameter.
`boolean`	`hasInstances(IlrRule rule)` Tests whether the agenda contains instances of a rule.
`void`	`insert(Object object)` Inserts the object passed as the argument.
`IlrEvent`	`insertEvent(long timestamp, Object object)` Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.
`IlrEvent`	`insertEvent(Object object)` Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.
`Object`	`insertLogical(Object object)` Deprecated. As of IBM Decision Server 8.0.1, truth maintenance system is deprecated.
`Object`	`invokeFunction(String name, Object[] arguments)` Invokes a function of the context giving its name and the argument values.
`boolean`	`isAgendaNotEmpty()` Tests whether the agenda contains at least one fireable rule instance.
`boolean`	`isCacheRuleflowData()` Tests whether or not the ruleflow data is cached when `resetRuleflow()` is called.
`boolean`	`isRuleActivated(IlrRule rule)` Deprecated.
`boolean`	`isRuleflowCompleted()` Tests whether the ruleflow execution is completed, which means that the ruleflow execution is not interrupted because of either a suspended task or a task by task execution.
`boolean`	`isRuleSelected(IlrRule rule)` Tests whether the rule is selected to be part of the executable rules.
`boolean`	`isTaskCompleted(String name)` Tests whether the specified task is completed.
`boolean`	`isUsingFlow()` Returns a boolean to indicate whether a ruleflow has been defined in the context's ruleset.
`long`	`nextTime()` Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.
`long`	`nextTime(long increment)` Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.
`void`	`note(String note)` Sends a note to the context's note handlers.
`void`	`refreshAgenda()` Adds in the agenda all the rule instances that have been refracted.
`void`	`removeAllInstances()` Removes all the instances currently in the agenda without firing them.
`void`	`removeAllNoteHandlers()` Removes all note handlers from the context.
`void`	`removeInstance(IlrRuleInstance instance)` Removes a particular rule instance from the agenda.
`void`	`removeInstances(IlrRule rule)` Removes all the instances of a rule currently in the agenda without firing them.
`void`	`removeNoteHandler(IlrNoteHandler handler)` Removes a note handler from the context.
`void`	`reset()` Called by Rule Studio to prepare a context for another execution.
`void`	`resetRuleflow()` Resets ruleflow execution in the context.
`void`	`retract(Object object)` Retracts an object from working memory, if the object has been asserted.
`void`	`retractAll()` Retracts all the objects from working memory.
`void`	`retractEvent(Object object)` Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.
`void`	`send(Object object)` Throws an `IlrUserActionException` exception.
`void`	`send(String message, Object object)` Throws an `IlrUserActionException` exception using a message and an object.
`void`	`setCacheRuleflowData(boolean cache)` Sets whether or not to keep the cached ruleflow data when `resetRuleflow()` is called.
`void`	`setExceptionHandler(IlrExceptionHandler handler)` Sets the exception handler of this execution context.
`void`	`setMainTask(String name)` Sets the ruleflow main task by giving its name.
`void`	`setParameters(IlrParameterMap parameters)` Sets the values of the declared ruleset variables contained in the passed `IlrParameterMap` (defined either with the "in" or "inout" modifier).
`void`	`setParameterValue(String name, Object value)` Sets the value of the ruleset parameter.
`void`	`setRuleflowExceptionHandler(IlrExceptionHandler handler)` Sets the exception handler responsible for catching runtime exceptions thrown during the execution of a ruleflow.
`void`	`setTime(long time)` Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.
`long`	`time()` Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.
`void`	`update(Object object)` Updates an object in working memory, if the object has been asserted.
`void`	`update(Object object, boolean refresh)` Updates an object in working memory if the object has been asserted.
`void`	`updateContext()` Updates the references to the context object.
`void`	`updateContext(boolean refresh)` Updates references to the context object to ensure that the agenda is in a consistent state with the objects referenced by this context.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

out

public transient PrintWriter out

Deprecated. As of ODM 8.0.1, the method note(String) should be used

This field is intended to be used in rules to print errors or messages. It is initialized to a PrintWriter which prints to System.out. The destination, of course, can be changed. This field provides an easy way to redirect the printing of messages.

firedRulesCountConstant

public static String firedRulesCountConstant

Deprecated. use instead IlrPropertyNames.FIRED_RULES_COUNT

This constant is the key used in the parameter map returned by the execute and getReturnValues methods to store the number of rules fired during this execution. Its value is ilog.rules.firedRulesCount.

Constructor Detail

IlrContext

@Deprecated
public IlrContext()

Deprecated. As of JRules 7.1, this way of constructing a context with an empty ruleset is deprecated. See other constructors for replacement.

Constructs an IlrContext with no argument. This method creates an empty IlrRuleset attached to the context. The ruleset can then be obtained using the getRuleset() method.

The creation of a context, ordinarily fires the Initial Actions. Since this constructor creates its own ruleset, and the ruleset has no rules initially, then there is no Initial Actions to fire.

See Also:: getRuleset()

IlrContext

public IlrContext(IlrRuleset ruleset)

Constructs an IlrContext with an IlrRuleset object. The ruleset must have the same context class as the created context. If not, an IlrBadContextException is thrown.

If the ruleset has an Initial Action, and if the instance being constructed is a direct instance of IlrContext, the action is executed. In the case that the context is derived, the user must call executeInitialRule() explicitly in the body of the derived class constructor, after all the fields have been initialized.

Parameters:: ruleset - The ruleset to which the context is attached.
See Also:: IlrBadContextException

IlrContext

public IlrContext(IlrRuleset ruleset,
                  com.ibm.rules.engine.connector.DataConnectorFactory dcf)

Method Detail

connectTool

public int connectTool(IlrTool tool)
                throws IlrToolConnectionException

Connects an IlrTool to the context. An IlrToolConnectionException is thrown if the connection fails.

Throws:: IlrToolConnectionException
Parameters:: tool - The IlrTool to connect.
Returns:: the connected IlrTool's identifier.
See Also:: IlrTool, IlrToolConnectionException

connectTool

public int connectTool(IlrToolFactory toolFactory)
                throws IlrToolConnectionException

Connects an IlrTool created by an IlrToolFactory to the context. An IlrToolConnectionException is thrown if the connection fails.

Throws:: IlrToolConnectionException
Parameters:: toolFactory - The IlrToolFactory used to create a new IlrTool.
Returns:: the connected IlrTool's identifier.
See Also:: IlrTool, IlrToolConnectionException, IlrLocalTracerToolFactory, ilog.rules.debug.IlrBuilderToolFactory

connectTool

public int connectTool(IlrToolFactory toolFactory,
                       String name)
                throws IlrToolConnectionException

Connects an IlrTool created by an IlrToolFactory to the context. An IlrToolConnectionException is thrown if the connection fails.

Throws:: IlrToolConnectionException
Parameters:: toolFactory - The IlrToolFactory used to create a new IlrTool.; name - A user context name. This name can be used by each created IlrTool to identify the context.
Returns:: the connected IlrTool's identifier.
See Also:: IlrTool, IlrToolConnectionException, IlrLocalTracerToolFactory, ilog.rules.debug.IlrBuilderToolFactory

getConnectedToolNumber

public int getConnectedToolNumber()

Gives the number of connected IlrTool(s) to the context.

Returns:: the number of connected IlrTool(s).

disconnectTool

public void disconnectTool(int toolID)

Disconnects a connected IlrTool.

Parameters:: toolID - The IlrTool's identifier.

disconnectTools

public void disconnectTools()

Disconnects all connected IlrTool.

note

public void note(String note)

Sends a note to the context's note handlers.

When a context is created, a default note handler is set (see getDefaultNoteHandler(). This default note handler may be removed by a call to removeAllNoteHandlers(). Other note handlers may be added by calling addNoteHandler(IlrNoteHandler).

This method is multi-thread safe at the context level, yet the note handlers that are called may not be multi-thread safe themselves.

Since:: JRules 7.0
Parameters:: note - The note.

addNoteHandler

public void addNoteHandler(IlrNoteHandler handler)

Adds a note handler to the context. This method is multi-thread safe.

Since:: JRules 7.0
Parameters:: handler - The note handler.
See Also:: note(String), removeNoteHandler(IlrNoteHandler), removeAllNoteHandlers()

removeNoteHandler

public void removeNoteHandler(IlrNoteHandler handler)

Removes a note handler from the context. This method is multi-thread safe.

Since:: JRules 7.0
Parameters:: handler - The note handler.
See Also:: note(String), addNoteHandler(IlrNoteHandler), removeAllNoteHandlers()

removeAllNoteHandlers

public void removeAllNoteHandlers()

Removes all note handlers from the context. This method is multi-thread safe. After this method, calling note(String) has no effect.

Since:: JRules 7.0
See Also:: note(String), addNoteHandler(IlrNoteHandler), removeNoteHandler(IlrNoteHandler), removeAllNoteHandlers()

getDefaultNoteHandler

public static IlrNoteHandler getDefaultNoteHandler()

Returns the default note handler. The default note handler printlns the notes to the context's out.

Since:: JRules 7.0
See Also:: note(String)

getRuleset

public final IlrRuleset getRuleset()

Gets the ruleset to which the context is attached.

Returns:: the ruleset to which the context is attached.

end

public final void end()

Prepares this context for garbage collection. After this call, the engine will not keep any reference to this context. The context will be detached from the ruleset and will no longer be notified of modifications on the rules. The context will also disconnect all its tools and all the related resources will be released. If the application does not keep this object, it is then subject to garbage collection.

reset

public void reset()

Called by Rule Studio to prepare a context for another execution. When a context is debugged in Rule Studio, and when the user chooses reset, Rule Studio calls this method to make the context ready for another run. By default, this method is defined as:

 public synchronized void reset() {
        retractAll();
        cleanRulesetVariables();
        resetRuleflow();
        executeInitialRule();
 }

A derived context class may override this method to perform additional preparations for the execution of the context.

send

public void send(Object object)
          throws IlrUserActionException

Throws an IlrUserActionException exception. This method is intended to be used in a rule action to exit from the firing loop. The method can catch the exception and process the result. An object is passed along with the exception. It may contain a result or the cause.

Throws:: IlrUserActionException
Parameters:: object - The object used to construct the exception.
See Also:: send(java.lang.String,java.lang.Object)

send

public void send(String message,
                 Object object)
          throws IlrUserActionException

Throws an IlrUserActionException exception using a message and an object.

Throws:: IlrUserActionException
Parameters:: message - The message used to construct the exception.; object - The object used to construct the exception.
See Also:: send(Object)

getExceptionHandler

public final IlrExceptionHandler getExceptionHandler()

Gets the exception handler of this execution context. At its creation, an execution context has no exception handler.

Returns:: an exception handler, or null if no exception handler has been set.

setExceptionHandler

public void setExceptionHandler(IlrExceptionHandler handler)

Sets the exception handler of this execution context. An exception handler is an object implementing java.io.Serializable. Note that the exception handler mechanism is restricted to the tasks running the Rete+ algorithm. Even if set, the exception handler will not be called from a task running the Sequential algorithm or the Fastpath algorithm.

Parameters:: handler - The new exception handler for this context. If this parameter is null, the context will be set without an exception handler.

executeInitialRule

@Deprecated
public void executeInitialRule()

Deprecated.

Executes the Initial Actions of the ruleset to which the context is attached, if any. If there is an Initial Action when the context is created, and if the constructed context is a direct instance of IlrContext, the action(s) is/are automatically executed.

invokeFunction

public Object invokeFunction(String name,
                             Object[] arguments)
                      throws IlrNoSuchFunctionException

Invokes a function of the context giving its name and the argument values. The error messages are written to the standard output of the context.

Throws:: IlrNoSuchFunctionException - in case the function is not known.
Parameters:: name - The function name.; arguments - The argument array.
Returns:: the result of this invocation. If the invoked function is void, this method returns null.

executeMain

public Object executeMain(Object arg)
                   throws IlrNoSuchFunctionException

Invokes the ilrmain function with an argument.

Throws:: IlrNoSuchFunctionException - if the ilrmain is not defined.
Parameters:: arg - The argument of the function.
Returns:: the result of this invocation. If the invoked function is void, this method returns null.

executeMain

public Object executeMain(String pkgName,
                          Object arg)
                   throws IlrNoSuchFunctionException

Invokes the ilrmain function of the specified package with an argument.

Throws:: IlrNoSuchFunctionException - if the ilrmain is not defined in this package.
Parameters:: arg - The argument of the function.
Returns:: the result of this invocation. If the invoked function is void, this method returns null.

time

@Deprecated
public final long time()

Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.

Gets the time of the engine. A rule engine runs a time counter used to trigger the watchdogs and the event conditions. The time counter is driven by the application using the methods of this class.

Returns:: the current time.
See Also:: nextTime(), nextTime(long), setTime(long)

nextTime

@Deprecated
public final long nextTime()

Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.

Increments the time by one unit.

Returns:: the time of the engine after the increment has been done.
See Also:: time(), nextTime(long), setTime(long)

nextTime

@Deprecated
public final long nextTime(long increment)

Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.

Changes the time using an increment.

Parameters:: increment - A positive time increment.
Returns:: the time of the engine after the increment has occurred.
See Also:: time(), nextTime(), setTime(long)

setTime

@Deprecated
public final void setTime(long time)

Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.

Sets the time of the engine. The time passed as the argument must be greater than the current time.

Parameters:: time - The new time of the engine.
See Also:: time(), nextTime(), nextTime(long)

insert

public void insert(Object object)

Inserts the object passed as the argument. If the object implements the IlrEvent interface, it is inserted as an event; its timestamp is obtained by calling the time method specified by this interface. If the object is already in working memory, a normal update is performed.

Since:: 4.0
Parameters:: object - The object to insert.

insertLogical

public Object insertLogical(Object object)

Deprecated. As of IBM Decision Server 8.0.1, truth maintenance system is deprecated.

Inserts a logical object. The engine first examines the objects in working memory to find one that is equal to the object passed as the argument using the equals method. If such an object is found, the passed object is not inserted and the object in working memory is returned. If no such object is found, the provided object is inserted and returned. In both cases, the object in working memory is stated: it is not maintained by any rule.

Parameters:: object - The logical object to be inserted.
Returns:: the object if no matching object has been found. If there is a matching object, it is returned.

assertLogical

public Object assertLogical(Object object)

Deprecated. As of IBM Decision Server 8.0.1, truth maintenance system is deprecated.

An alias for insertLogical(Object) method.

Parameters:: object - The logical object to be inserted.
Returns:: the object if no matching object has been found. If there is a matching object, it is returned.

insertEvent

@Deprecated
public IlrEvent insertEvent(Object object)

Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.

Inserts an object as an event.

If the object implements the IlrEvent interface, its timestamp is obtained by calling the time method specified by this interface. The method then returns the inserted object itself.

If the object does not implement the IlrEvent interface, the current value of the context internal clock is taken for the object timestamp. This method builds an instance of the IlrDefaultEvent class encapsulating the inserted object, and returns it.

In all cases, if the event is already in working memory, a normal update is performed instead of the insert operation. Otherwise, the returned object is added to working memory.

Parameters:: object - The object to be inserted as an event.
Returns:: the object inserted or updated in working memory.
See Also:: time()

insertEvent

@Deprecated
public IlrEvent insertEvent(long timestamp,
                                       Object object)

Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.

Asserts an object as an event. The object must not implement the IlrEvent interface. (If it does, the method throws an IllegalArgumentException.) This method builds an instance of the IlrDefaultEvent encapsulating the asserted object, taking the provided date for the object timestamp, adds the created instance to working memory, and returns it. If the event is already in working memory, a normal update is performed instead of the assert operation.

Throws:: IllegalArgumentException - If object implements the IlrEvent interface.
Parameters:: timestamp - The timestamp of the object to be asserted as an event.; object - The object to be asserted as an event.
Returns:: The object asserted or updated in working memory.

retract

public void retract(Object object)

Retracts an object from working memory, if the object has been asserted. If the object has been asserted as an event and does not implement the IlrEvent interface, then this method must be provided with the instance of IlrDefaultEvent that has been created and returned upon assertion, and that can also be retrieved using the getEvent(java.lang.Object) method.

Parameters:: object - The object to retract.
See Also:: retractEvent(Object)

retractEvent

@Deprecated
public void retractEvent(Object object)

Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.

Retracts an object from working memory, if the object has been asserted as an event. This method can be provided with objects that do not implement the IlrEvent interface.

Parameters:: object - The object to retract.
See Also:: retract(Object), getEvent(Object)

update

public final void update(Object object)

Updates an object in working memory, if the object has been asserted. This method is equivalent to calling update(Object,boolean) with the second argument set to false.

Parameters:: object - The object to update.

update

public void update(Object object,
                   boolean refresh)

Updates an object in working memory if the object has been asserted. If the Boolean argument is false, this method does the same thing as the previous method. If the Boolean argument is true, the update will cause the agenda to be refreshed: if a rule that uses this object is true, a rule instance is inserted into the agenda. In this case, the rule applies as long as it can be fired.

Parameters:: object - The object to update.; refresh - The update flag. It is false for a normal update and true for a looping rule behavior.

updateContext

public final void updateContext()

Updates the references to the context object. Calling this method is equivalent to calling updateContext(boolean) with false as argument.

updateContext

public void updateContext(boolean refresh)

Updates references to the context object to ensure that the agenda is in a consistent state with the objects referenced by this context. Call this method when the following critearia are matched:

The rules of this execution context contain references to objects accessed using this context object, that is, the ?context variable in the rules.
The objects have been modified.

Parameters:: refresh - Set to true if a rule instance must be created for each combination of objects that satisfies a rule. This flag has the same interpretation as update(Object,boolean).

retractAll

public void retractAll()

Retracts all the objects from working memory. The context becomes empty as if it had just been created (without the execution of the Initial Actions). The agenda is also emptied. The rules are not affected by this method.

getObjects

public final Object[] getObjects(IlrClass clazz)

Gets all the objects in working memory that are instances of the passed XOM class. The returned objects can be direct instances of the XOM class, or instances of a sub-class of the XOM class.

Parameters:: clazz - The XOM class.
Returns:: An array of objects.

getEvent

@Deprecated
public final IlrEvent getEvent(Object object)

Deprecated. As of IBM Decision Server 7.5, event processing is deprecated.

Returns the event object in working memory if the object provided has been asserted as an event. If object implements the IlrEvent interface, the returned object will be the object itself. Otherwise, the returned object will be the instance of IlrDefaultEvent which was created on assertion. If the object has not been asserted as an event, the method returns null.

Parameters:: object - The object to look for in working memory as an event.
Returns:: the event object in working memory, or null if the object has not been asserted as an event.

enumerateObjects

public final Enumeration enumerateObjects()

Enumerates all the objects in working memory of the context without any discrimination on their types.

Returns:: an enumeration of objects.