testinferenceengine.java

Mandarax是一个规则引擎的纯Java实现。它支持多类型的事实和基于反映的规则

/*
 * Copyright (C) 1999-2004 <A href="http://www-ist.massey.ac.nz/JBDietrich" target="_top">Jens Dietrich</a>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
package test.org.mandarax.reference;


import org.mandarax.kernel.InferenceEngine;
import org.mandarax.kernel.InferenceException;
import org.mandarax.kernel.KnowledgeBase;
import org.mandarax.kernel.Query;
import org.mandarax.kernel.ResultSet;

/**
 * An abstract test case class to test features of an inference engine.
 * @author <A href="http://www-ist.massey.ac.nz/JBDietrich" target="_top">Jens Dietrich</A>
 * @version 3.4 <7 March 05>
 * @since 1.1
 */
public abstract class TestInferenceEngine extends MandaraxTestCase {
	public static final String QUERY_VARIABLE = "x"; 
	
    protected KnowledgeBase   kb = null;
    protected InferenceEngine ie = null;
    /**
     * Constructor.
     * @param aKnowledgeBase a new, uninitialized knowledge base that will be used
     * @param anInferenceEngine the inference engine that will be tested
     */
    public TestInferenceEngine(KnowledgeBase aKnowledgeBase,InferenceEngine anInferenceEngine) {
        super ("testInferenceEngine");

        kb = aKnowledgeBase;
        ie = anInferenceEngine;
    }

    /**
     * Populate the knowledge base.
     * @param knowledge the knowledge base
     */
    public abstract void feedKnowledgeBase(KnowledgeBase knowledge);

    /**
     * Get the cardinality constraint (how many solutions
     * should be compouted). Default is <code>InferenceEngine.ONE</code>
     * @return the number of expected results
     */
    public int getCardinalityConstraint() {
        return InferenceEngine.ONE;
    }

    /**
     * Get a description of this test case.
     * This is used by the <code>org.mandarax.demo</code>
     * package to display the test cases.
     * @return java.lang.String
     */
    public String getDescription() {
        return "test case " + getClass ().getName ();
    }

    /**
     * Get the name of the person we are looking for.
     * More precisely, this is the name of the person expected to
     * replace the query variable as a result of the query.
     * @return the name of the person
     */
    abstract String getPersonName();

    /**
     * Get a query. The query should use the query variable QUERY_VARIABLE!
     * @return a query
     */
    public abstract Query getQuery();

    /**
     * Sets up the fixture.
     */
    protected void setUp() {
        feedKnowledgeBase (kb);
    }

    /**
     * Run the test.
     */
    public void testInferenceEngine() {
        LOG_TEST.info ("Start Testcase " + getClass ().getName () + " , test method: " + "testInferenceEngine()");
		try {
        	ResultSet rs    = ie.query (getQuery(),kb,getCardinalityConstraint(),InferenceEngine.BUBBLE_EXCEPTIONS);
        	Person expected = Person.get(getPersonName());
        	boolean succ = rs.next();
        	Person computed = (Person)rs.getResult(Person.class,QUERY_VARIABLE);
        	succ = succ && expected.equals(computed);
	        assertTrue (succ);
		}
		catch (InferenceException x) {
			assertTrue(false);
		}
        LOG_TEST.info ("Finish Testcase " + getClass ().getName () + " , test method: " + "testInferenceEngine()");
    }
    /**
     * Convert this object to a string.
     * @return the string representation of the object
     */
    public String toString() {        
        StringBuffer buf = new StringBuffer();
        buf.append(super.toString());
        buf.append(" (");
        buf.append(kb.getClass().getName());
        buf.append(" / ");
        buf.append(ie.getClass().getName());
        buf.append(")");
        return buf.toString();        
    }
}