Easy Rules 规则引擎详解

Easy Rules 规则引擎详解

Easy Rules 是一个轻量级的 Java 规则引擎，它提供了一种简单而强大的方式来定义和执行业务规则。以下是 Easy Rules 的详细介绍：

1. 核心概念

1.1 规则 (Rule)

• 条件 (Condition): 当条件为 true 时执行动作
• 动作 (Action): 条件满足时执行的操作

1.2 规则引擎 (RulesEngine)

• 负责评估规则条件并执行相应动作
• 两种类型：DefaultRulesEngine 和 InferenceRulesEngine

2. 基本使用

2.1 添加依赖

<dependency>
    <groupId>org.jeasy</groupId>
    <artifactId>easy-rules-core</artifactId>
    <version>4.1.0</version>
</dependency>

2.2 定义规则

方式1: 注解方式

@Rule(name = "weather rule", description = "if it rains then take an umbrella")
public class WeatherRule {

    @Condition
    public boolean itRains(@Fact("rain") boolean rain) {
        return rain;
    }
    
    @Action
    public void takeAnUmbrella() {
        System.out.println("It rains, take an umbrella!");
    }
}

方式2: 流式API

Rule weatherRule = new RuleBuilder()
    .name("weather rule")
    .description("if it rains then take an umbrella")
    .when(facts -> facts.get("rain").equals(true))
    .then(facts -> System.out.println("It rains, take an umbrella!"))
    .build();

方式3: 使用表达式语言 (MVEL/SpEL)

Rule weatherRule = new MVELRule()
    .name("weather rule")
    .description("if it rains then take an umbrella")
    .when("rain == true")
    .then("System.out.println(\"It rains, take an umbrella!\");");

2.3 执行规则

// 创建事实
Facts facts = new Facts();
facts.put("rain", true);

// 创建规则引擎
RulesEngine rulesEngine = new DefaultRulesEngine();

// 注册规则
rulesEngine.fire(rules, facts);

3. 高级特性

3.1 规则优先级

@Rule(priority = 1) // 数字越小优先级越高
public class HighPriorityRule {
    // ...
}

3.2 规则监听器

rulesEngine.registerRuleListener(new RuleListener() {
    @Override
    public boolean beforeEvaluate(Rule rule, Facts facts) {
        // 在评估条件前调用
        return true; // 返回false跳过此规则
    }
    
    @Override
    public void afterExecute(Rule rule, Facts facts) {
        // 在动作执行后调用
    }
});

3.3 规则组

@Rule(name = "rule1", priority = 1)
public class Rule1 { /* ... */ }

@Rule(name = "rule2", priority = 2)
public class Rule2 { /* ... */ }

Rules rules = new Rules();
rules.register(new Rule1());
rules.register(new Rule2());

// 创建规则引擎参数
Parameters parameters = new Parameters()
    .skipOnFirstAppliedRule(true); // 第一个规则应用后跳过其余规则

RulesEngine rulesEngine = new DefaultRulesEngine(parameters);

3.4 推理引擎

RulesEngine rulesEngine = new InferenceRulesEngine();

// 会持续应用规则直到没有规则可应用
rulesEngine.fire(rules, facts);

4. 与其他规则引擎比较

5. 最佳实践

1. 保持规则简单：每个规则只关注一个特定条件
2. 使用合理的优先级：明确规则执行顺序
3. 避免规则循环：特别是在使用推理引擎时
4. 合理使用事实：确保事实对象是不可变的
5. 考虑规则的可维护性：为规则添加清晰的描述