jadex.rules.eca.Rulebase Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jadex-rules-eca Show documentation

Small Java annotation-based event-condition-action rule engine.

There is a newer version: 4.0.267

package jadex.rules.eca;

import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 *  Rulebase implementation.
 */
public class Rulebase implements IRulebase
{
	//-------- attributes --------
	
	/** The rules per name. */
	protected Map> rules;
	
	/** The rule matcher node. */
	protected MatcherNode matcher;

	//-------- methods --------
	
	/**
	 *  Add a new rule.
	 *  @param rule The rule.
	 */
	public void addRule(IRule rule)
	{
		if(rule.getEvents()==null || rule.getEvents().size()==0)
			throw new RuntimeException("Rule must have events: "+rule);
		
		if(rules==null)
			rules = new HashMap>();
		if(matcher==null)
			matcher = new MatcherNode();
		
		if(rules.containsKey(rule.getName()))
			throw new IllegalArgumentException("Rule names must be unique: "+rule.getName());
		
		rules.put(rule.getName(), rule);
		
		matcher.addRule(rule);
		
//		System.out.println("added rule: "+rule+" "+rule.getEvents());
		
//		System.out.println("evrules: "+evrules);
	}
	
	/**
	 *  Remove a rule.
	 *  @param rule The rule.
	 */
	public void removeRule(String rulename)
	{
		IRule rule = null;
		if(rules!=null)
		{
			rule = rules.remove(rulename);
			if(rule==null)
				throw new RuntimeException("Rule not contained: "+rulename);
		}
		
		if(matcher!=null)
			matcher.removeRule(rule);
	}
	
	/**
	 *  Update a rule.
	 *  @param rule The rule.
	 */
	public void updateRule(IRule rule)
	{
		if(containsRule(rule.getName()))
			removeRule(rule.getName());
		addRule(rule);
	}
	
	/**
	 *  Get all rules that are relevant for an event type.
	 *  @param event The event type.
	 *  @return The rules.
	 */
	public List> getRules(EventType event)
	{
//		if(event.equals("factchanged.environment"))
//			System.out.println("ff");
		
		return matcher==null? null: matcher.getRules(event);
	}
	
	/**
	 *  Get the rule.
	 *  @param event The rule name.
	 *  @return The rule.
	 */
	public IRule getRule(String name)
	{
		IRule ret = null;
		
		if(rules!=null)
		{
			ret = rules.get(name);
		}
		
		return ret;
	}
	
	/**
	 *  Test if a rule is contained in the rule base.
	 *  @param name The rule name.
	 *  @return True, if contained.
	 */
	public boolean containsRule(String name)
	{
		return rules!=null && rules.containsKey(name);
	}
	
	/**
	 *  Get all rules.
	 *  @return The rules.
	 */
	public Collection> getRules()
	{
		return rules!=null? rules.values(): Collections.EMPTY_LIST;
	}
}