What
解釋器模式(Interpreter Pattern)為某個語言定義它的語法(或者叫文法)表示,并定義一個解釋器用來處理這個語法。它屬于行為型模式。這種模式被用在 SQL 解析、符號處理引擎等。
Why
- 可擴(kuò)展性比較好,靈活。
- 增加了新的解釋表達(dá)式的方式。
- 易于實現(xiàn)簡單文法。
When
解釋器模式大多用在以下場景:
- 可以將一個需要解釋執(zhí)行的語言中的句子表示為一個抽象語法樹。
- 一些重復(fù)出現(xiàn)的問題可以用一種簡單的語言來進(jìn)行表達(dá)。
- 一個簡單語法需要解釋的場景。
How
解釋器模式主要包括Expression接口(內(nèi)含interpret方法)和實現(xiàn)該接口的實體類。
今天,我們一起來實現(xiàn)一個自定義告警規(guī)則的解釋器。在我們平時的項目開發(fā)中,監(jiān)控系統(tǒng)非常重要,它可以時刻監(jiān)控業(yè)務(wù)系統(tǒng)的運行情況,及時將異常報告給開發(fā)者。比如,如果每分鐘接口出錯數(shù)超過 100,監(jiān)控系統(tǒng)就通過短信、微信、郵件等方式發(fā)送告警給開發(fā)者。一般來講,監(jiān)控系統(tǒng)支持開發(fā)者自定義告警規(guī)則,比如我們可以用下面這樣一個表達(dá)式,來表示一個告警規(guī)則,它表達(dá)的意思是:每分鐘 API 總出錯數(shù)超過 100 或者每分鐘 API 總調(diào)用數(shù)超過 10000 就觸發(fā)告警。
規(guī)則舉例:api_error_per_minute > 100 || api_count_per_minute > 10000
接下來, 我們實現(xiàn)一個解釋器,能夠根據(jù)規(guī)則,針對用戶輸入的數(shù)據(jù),判斷是否觸發(fā)告警。利用解釋器模式,我們把解析表達(dá)式的邏輯拆分到各個小類中,避免大而復(fù)雜的大類的出現(xiàn)。
首先,我們定義Expression接口。
public interface Expression {
boolean interpret(Map<String, Long> stats);
}
public class GreaterExpression implements Expression {
private String key;
private long value;
public GreaterExpression(String strExpression) {
String[] elements = strExpression.trim().split("\\s+");
if (elements.length != 3 || !elements[1].trim().equals(">")) {
throw new RuntimeException("Expression is invalid: " + strExpression);
}
this.key = elements[0].trim();
this.value = Long.parseLong(elements[2].trim());
}
public GreaterExpression(String key, long value) {
this.key = key;
this.value = value;
}
@Override
public boolean interpret(Map<String, Long> stats) {
if (!stats.containsKey(key)) {
return false;
}
long statValue = stats.get(key);
return statValue > value;
}
}
// LessExpression 和 EqualsExpression 實體類和GreaterExpression 類相似,因此省略
public class OrExpression implements Expression {
private List<Expression> expressions = new ArrayList<>();
public OrExpression(String strAndExpression) {
String[] strExpressions = strAndExpression.split("\\|\\|");
for (String strExpr : strExpressions) {
if (strExpr.contains(">")) {
expressions.add(new GreaterExpression(strExpr));
} else if (strExpr.contains("<")) {
expressions.add(new LessExpression(strExpr));
} else if (strExpr.contains("==")) {
expressions.add(new EqualExpression(strExpr));
} else {
throw new RuntimeException("Expression is invalid: " + strAndExpression);
}
}
}
public OrExpression(List<Expression> expressions) {
this.expressions.addAll(expressions);
}
@Override
public boolean interpret(Map<String, Long> stats) {
for (Expression expr : expressions) {
if (expr.interpret(stats)) {
return true;
}
}
return false;
}
}
然后,定義告警規(guī)則解釋器。
public class AlertRuleInterpreter {
private Expression expression;
public AlertRuleInterpreter(String ruleExpression) {
this.expression = new OrExpression(ruleExpression);
}
public boolean interpret(Map<String, Long> stats) {
return expression.interpret(stats);
}
}
最后,來個測試類:
public class TestMain {
public static void main(String[] args) {
String rule = "key1 > 100 || key2 < 30 || key3 < 100 || key4 == 88";
AlertRuleInterpreter interpreter = new AlertRuleInterpreter(rule);
Map<String, Long> stats = new HashMap<>();
stats.put("key1", 101L);
stats.put("key3", 121L);
stats.put("key4", 88L);
boolean alert = interpreter.interpret(stats);
System.out.println(alert);
}
}
結(jié)果為true。
Done
代碼地址
寫在最后
如果你覺得我寫的文章幫到了你,歡迎點贊、評論、分享、贊賞哦,你們的鼓勵是我不斷創(chuàng)作的動力~