oracle.rules.rl.extensions.trace

Class TraceAnalysis

java.lang.Object

oracle.rules.rl.extensions.trace.TraceAnalysis

public class TraceAnalysis
extends java.lang.Object

Assist in the navigation and analysis of a decision trace.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	AGGREGATE
static java.lang.String	FACT_UNAVAIL
static java.lang.String	INITIAL_FACT
static java.lang.String	NOT

Constructor Summary

Constructors

Constructor and Description
TraceAnalysis(DecisionTrace trace) Create a navigable representation of a decision trace so that it may be analyzed.

Method Summary

Modifier and Type	Method and Description
java.util.List<FactTrace>	getActivationMatchedFacts(ActivationTrace activationTrace) Get a list of traces for the facts that matched resulting in the activation trace.
java.util.List<FactTrace>	getFactTraces(int factId) Get a list of the fact traces for the fact with the ID factId.
java.util.List<java.lang.String>	getFactTypes() Get a list of the fact types that appear in the trace.
FactTrace	getLastFactTrace(int factId) Get the last fact trace for the fact with the ID factId.
java.util.List<FactTrace>	getLastFactTraces(java.lang.String factType) Get a list, for each fact of the specified type, of the last fact trace available in the trace.
RuleEngineState	getRuleEngineState(TraceEntry traceEntry)
java.util.List<FactTrace>	getRuleMatchedFacts(RuleTrace ruleTrace) Get a list of traces for the facts that matched resulting in the rule trace.
java.util.List<java.lang.String>	getRules() Get a list of the rules that appear in the trace.
java.util.List<RuleTrace>	getRuleTraces(java.lang.String ruleName) Get a list of the rule traces for the named rule.
RootGroup	getTraceGroups()
TraceEntry	nextTraceEntry(TraceEntry entry) Return the trace entry immediately following the entry entry.
TraceEntry	previousTraceEntry(TraceEntry entry) Return the trace entry immediately preceding the entry entry.
RuleTrace	whichRule(FactTrace factTrace) Get the rule trace for the rule whose action affected the fact in the fact trace.

Methods inherited from class java.lang.Object

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

Field Detail

INITIAL_FACT

public static final java.lang.String INITIAL_FACT

See Also:

Constant Field Values

NOT

public static final java.lang.String NOT

See Also:

Constant Field Values

AGGREGATE

public static final java.lang.String AGGREGATE

See Also:

Constant Field Values

FACT_UNAVAIL

public static final java.lang.String FACT_UNAVAIL

See Also:

Constant Field Values

Constructor Detail

TraceAnalysis

public TraceAnalysis(DecisionTrace trace)

Create a navigable representation of a decision trace so that it may be analyzed.

Parameters:

trace - the decision trace.

Method Detail

nextTraceEntry

public TraceEntry nextTraceEntry(TraceEntry entry)

Return the trace entry immediately following the entry entry. Returns null if entry is the last entry in the trace.

Parameters:

entry - the current trace entry

Returns:

the next trace entry

previousTraceEntry

public TraceEntry previousTraceEntry(TraceEntry entry)

Return the trace entry immediately preceding the entry entry. Returns null if entry is the first entry in the trace.

Parameters:

entry - the current trace entry

Returns:

the previous trace entry

getRules

public java.util.List<java.lang.String> getRules()

Get a list of the rules that appear in the trace.

Returns:

a list of the names of the rules that appear in the trace.

getRuleTraces

public java.util.List<RuleTrace> getRuleTraces(java.lang.String ruleName)

Get a list of the rule traces for the named rule.

Parameters:

ruleName - the name of the rule

Returns:

a list of rule traces for the specified rule.

getFactTypes

public java.util.List<java.lang.String> getFactTypes()

Get a list of the fact types that appear in the trace.

Returns:

a list of the fact types that appear in the trace.

getLastFactTraces

public java.util.List<FactTrace> getLastFactTraces(java.lang.String factType)

Get a list, for each fact of the specified type, of the last fact trace available in the trace.

Parameters:

factType - the fact type name.

Returns:

a list, for each fact of the specified type, of the last fact trace available in the trace.

getLastFactTrace

public FactTrace getLastFactTrace(int factId)

Get the last fact trace for the fact with the ID factId.

Parameters:

factId - the fact ID.

Returns:

the last fact trace for the fact with the ID factId else null if no such fact exists in the trace.

getFactTraces

public java.util.List<FactTrace> getFactTraces(int factId)

Get a list of the fact traces for the fact with the ID factId.

Parameters:

factId - the fact ID.

Returns:

a list of the fact traces for the fact with the ID.

whichRule

public RuleTrace whichRule(FactTrace factTrace)

Get the rule trace for the rule whose action affected the fact in the fact trace. Null is returned if the fact trace was not a result of a rule action.

Parameters:

factTrace - the fact trace

Returns:

the rule trace or null if the fact trace was not a result of a rule action.

getRuleMatchedFacts

public java.util.List<FactTrace> getRuleMatchedFacts(RuleTrace ruleTrace)

Get a list of traces for the facts that matched resulting in the rule trace.

Parameters:

ruleTrace - the rule trace

Returns:

a list of fact traces for the facts that matched for this rule trace.

getActivationMatchedFacts

public java.util.List<FactTrace> getActivationMatchedFacts(ActivationTrace activationTrace)

Get a list of traces for the facts that matched resulting in the activation trace.

Parameters:

activationTrace - the activation trace

Returns:

a list of fact traces for the facts that matched for this activation trace.

getRuleEngineState

public RuleEngineState getRuleEngineState(TraceEntry traceEntry)

getTraceGroups

public RootGroup getTraceGroups()