org.jeasy.rules.core

Class BasicRule

java.lang.Object

org.jeasy.rules.core.BasicRule

All Implemented Interfaces:

java.lang.Comparable<Rule>, Rule

public class BasicRule
extends java.lang.Object
implements Rule

Basic rule implementation class that provides common methods. You can extend this class and override evaluate(Facts) and execute(Facts) to provide rule conditions and actions logic.

Author:

Mahmoud Ben Hassine (mahmoud.benhassine@icloud.com)

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	description Rule description.
protected java.lang.String	name Rule name.
protected int	priority Rule priority.

Fields inherited from interface org.jeasy.rules.api.Rule

DEFAULT_DESCRIPTION, DEFAULT_NAME, DEFAULT_PRIORITY

Constructor Summary

Constructors

Constructor and Description
BasicRule() Create a new BasicRule.
BasicRule(java.lang.String name) Create a new BasicRule.
BasicRule(java.lang.String name, java.lang.String description) Create a new BasicRule.
BasicRule(java.lang.String name, java.lang.String description, int priority) Create a new BasicRule.

Method Summary

Modifier and Type	Method and Description
int	compareTo(Rule rule)
boolean	equals(java.lang.Object o)
boolean	evaluate(Facts facts) This method implements the rule's condition(s).
void	execute(Facts facts) This method implements the rule's action(s).
java.lang.String	getDescription() Getter for rule description.
java.lang.String	getName() Getter for rule name.
int	getPriority() Getter for rule priority.
int	hashCode()
void	setDescription(java.lang.String description)
void	setPriority(int priority)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

name

protected java.lang.String name

Rule name.

description

protected java.lang.String description

Rule description.

priority

protected int priority

Rule priority.

Constructor Detail

BasicRule

public BasicRule()

Create a new BasicRule.

BasicRule

public BasicRule(java.lang.String name)

Create a new BasicRule.

Parameters:

name - rule name

BasicRule

public BasicRule(java.lang.String name,
                 java.lang.String description)

Create a new BasicRule.

Parameters:

name - rule name

description - rule description

BasicRule

public BasicRule(java.lang.String name,
                 java.lang.String description,
                 int priority)

Create a new BasicRule.

Parameters:

name - rule name

description - rule description

priority - rule priority

Method Detail

evaluate

public boolean evaluate(Facts facts)

This method implements the rule's condition(s). Implementations should handle any runtime exception and return true/false accordingly

Specified by:

evaluate in interface Rule

Returns:

true if the rule should be applied given the provided facts, false otherwise

execute

public void execute(Facts facts)
             throws java.lang.Exception

This method implements the rule's action(s).

Specified by:

execute in interface Rule

Throws:

java.lang.Exception - thrown if an exception occurs when performing action(s)

getName

public java.lang.String getName()

Description copied from interface: Rule

Getter for rule name.

Specified by:

getName in interface Rule

Returns:

the rule name

getDescription

public java.lang.String getDescription()

Description copied from interface: Rule

Getter for rule description.

Specified by:

getDescription in interface Rule

Returns:

rule description

setDescription

public void setDescription(java.lang.String description)

getPriority

public int getPriority()

Description copied from interface: Rule

Getter for rule priority.

Specified by:

getPriority in interface Rule

Returns:

rule priority

setPriority

public void setPriority(int priority)

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

compareTo

public int compareTo(Rule rule)

Specified by:

compareTo in interface java.lang.Comparable<Rule>