jtp.frame.fc
Class RuleInstantiator

java.lang.Object
  |
  +--java.beans.beancontext.BeanContextChildSupport
        |
        +--jtp.util.PropertyImporter
              |
              +--jtp.frame.fc.RuleInstantiator

All Implemented Interfaces:

BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, EventListener, Reasoner, Serializable

Direct Known Subclasses:

OptimizedRuleInstantiator

public class RuleInstantiator

extends PropertyImporter

implements Reasoner

See Also:

Serialized Form

Field Summary

TriggerLiteralMatcher

tm

Fields inherited from class java.beans.beancontext.BeanContextChildSupport

beanContext, beanContextChildPeer, pcSupport, rejectedSetBCOnce, vcSupport

Constructor Summary

RuleInstantiator()

Method Summary

boolean	acceptable(Object goal) decides if the goal is suitable for being processed by this reasoner.
void	addTrigger(Literal trigger, Literal target, TriggerValidator validator)
Reasoner	getAskingReasoner()
UndoManager	getUndoManager()
ReasoningStepIterator	process(Object o) This method attempts to find proof for the goal.
boolean	removeTrigger(Literal trigger, Symbol ruleSym)
void	setAskingReasoner(Reasoner v)
void	setUndoManager(UndoManager u)

Methods inherited from class jtp.util.PropertyImporter

getImportedProperties, initializeBeanContextResources, setImportedProperties

Methods inherited from class java.beans.beancontext.BeanContextChildSupport

addPropertyChangeListener, addVetoableChangeListener, firePropertyChange, fireVetoableChange, getBeanContext, getBeanContextChildPeer, isDelegated, releaseBeanContextResources, removePropertyChangeListener, removeVetoableChangeListener, serviceAvailable, serviceRevoked, setBeanContext, validatePendingSetBeanContext

Methods inherited from class java.lang.Object

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

Field Detail

tm

public TriggerLiteralMatcher tm

Constructor Detail

RuleInstantiator

public RuleInstantiator()

Method Detail

getAskingReasoner

public Reasoner getAskingReasoner()

setAskingReasoner

public void setAskingReasoner(Reasoner v)

getUndoManager

public UndoManager getUndoManager()

setUndoManager

public void setUndoManager(UndoManager u)

addTrigger

public void addTrigger(Literal trigger,
                       Literal target,
                       TriggerValidator validator)

removeTrigger

public boolean removeTrigger(Literal trigger,
                             Symbol ruleSym)

acceptable

public boolean acceptable(Object goal)

Description copied from interface: Reasoner

decides if the goal is suitable for being processed by this reasoner. This method should be fast; if there are doubts as to whether a goal is acceptable, and it looks like determining it might take some time, the method should return true and let the process method figure it out.

Example. Many reasoners only process literals with certain predicates and arity. These reasoners will use those criteria to determine acceptability, for example a reasoner dealing with equality could accept goals that are:

1. Literals,
2. have = as their relation predicate,
3. have exactly two arguments.

Specified by:

acceptable in interface Reasoner

Returns:

true if the goal is suitable for this reasoner, false otherwise.

process

public ReasoningStepIterator process(Object o)

Description copied from interface: Reasoner

This method attempts to find proof for the goal. It returns an enumeration of reasoning steps that correspond to alternative proofs for the goal. Consequently, the items of the enumeration can actually belong to different models of the goal sentence, and have incompatible variable assignments.

Example. A reasoner that performs unification of the goal with facts in a knowledge base can return the following enumeration for the goal (parent joe ?x):

1. A reasoning step proving (parent joe fred) with variable assignment ?x=fred,
2. A reasoning step proving (parent joe mary) with variable assignment ?x=mary.

Specified by:

process in interface Reasoner

Parameters:

o - the goal: either a query or an assertion

Returns:

the iterator of reasoning steps - proofs for the query, or consequences of the assertion.