org.jeasy.rules.api

Interface Rule

All Superinterfaces:

java.lang.Comparable<Rule>

All Known Implementing Classes:

BasicRule

public interface Rule
extends java.lang.Comparable<Rule>

Abstraction for a rule that can be fired by the rules engine. Rules are registered in a rule set of type Rules in which they must have a unique name.

Author:

Mahmoud Ben Hassine ([email protected])

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_DESCRIPTION Default rule description.
static java.lang.String	DEFAULT_NAME Default rule name.
static int	DEFAULT_PRIORITY Default rule priority.

Method Summary

Modifier and Type	Method and Description
boolean	evaluate(Facts facts) Rule conditions abstraction : this method encapsulates the rule's conditions.
void	execute(Facts facts) Rule actions abstraction : this method encapsulates the rule's actions.
java.lang.String	getDescription() Getter for rule description.
java.lang.String	getName() Getter for rule name.
int	getPriority() Getter for rule priority.

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

DEFAULT_NAME

static final java.lang.String DEFAULT_NAME

Default rule name.

See Also:

Constant Field Values

DEFAULT_DESCRIPTION

static final java.lang.String DEFAULT_DESCRIPTION

Default rule description.

See Also:

Constant Field Values

DEFAULT_PRIORITY

static final int DEFAULT_PRIORITY

Default rule priority.

See Also:

Constant Field Values

Method Detail

getName

java.lang.String getName()

Getter for rule name.

Returns:

the rule name

getDescription

java.lang.String getDescription()

Getter for rule description.

Returns:

rule description

getPriority

int getPriority()

Getter for rule priority.

Returns:

rule priority

evaluate

boolean evaluate(Facts facts)

Rule conditions abstraction : this method encapsulates the rule's conditions. Implementations should handle any runtime exception and return true/false accordingly

Returns:

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

execute

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

Rule actions abstraction : this method encapsulates the rule's actions.

Throws:

java.lang.Exception - thrown if an exception occurs during actions performing