## 2.15 定制模板引擎
Beetl在線體驗([http://ibeetl.com/beetlonline/](http://ibeetl.com/beetlonline/))面臨一個挑戰,允許用戶輸入任何腳本做練習或者分享代碼。但又需要防止用戶輸入惡意的代碼,如
```javascript
<%
while(true){
//其他代碼
}
%>
```
此時,需要定制模板引擎,遇到while循環的時候,應該限制循環次數,譬如,在線體驗限制最多循環5次,這是通過定義擴展模板引擎來實現的,以jar包自帶的實例代碼OnlineTemplateEngine來說明
```java
public class OnlineTemplateEngine extends DefaultTemplateEngine {
public static int MAX = 5;
public static String ERROR = "錯誤:在線引擎不允許循環次數超過 " + MAX;
@Override
protected GrammarCreator getGrammerCreator(GroupTemplate gt) {
GrammarCreator grammar = new OnlineGrammarCreator();
return grammar;
}
}
```
擴展DefaultTemplateEngine,重載getGrammerCreator方法,返回一個我們自己的語法定義類OnlineGrammarCreator
OnlineGrammarCreator繼承了默認的
```java
static class OnlineGrammarCreator extends GrammarCreator {
@Override
public WhileStatement createWhile(Expression exp, Statement whileBody, GrammarToken token) {
WhileStatement whileStat = new RestrictWhileStatement(exp, whileBody, token);
return whileStat;
}
}
```
需要對for循環重新定義,使用新的 RestrictWhileStatement,定義如下
~~~java
static class RestrictWhileStatement extends WhileStatement {
public RestrictWhileStatement(Expression exp, Statement whileBody, GrammarToken token) {
super(exp, whileBody, token);
}
@Override
public void execute(Context ctx) {
int i = 0;
while (i < OnlineTemplateEngine.MAX) {
Object result = exp.evaluate(ctx);
if (result instanceof Boolean) {
if ((Boolean) result) {
whileBody.execute(ctx);
} else {
break;
}
} else {
BeetlException be = new BeetlException(BeetlException.BOOLEAN_EXPECTED_ERROR);
be.token = exp.token;
throw be;
}
i++;
}
if (i >= OnlineTemplateEngine.MAX) {
try {
ctx.byteWriter.writeString(ERROR);
} catch (IOException e) {
// ignore
}
}
}
}
~~~
完成這些代碼后,在配置文件中申明使用新的引擎
```properties
ENGINE=org.beetl.core.engine.OnlineTemplateEngine
```
這樣就完成了模板引擎定制。
> BeetlSQL 正是支持定制,所以才把## 占位符輸出"?",而不是字面值,${} 負責輸出字面值,可以查看BeetlSQL的org.beetl.sql.core.engine.SQLTemplateEngine
- Beetl 3 中文文檔
- 第一部分 基礎用法
- 1.1 安裝
- 1.2 快速開始
- 1.3 模板基礎配置
- 1.4 模板加載器
- 1.5 定界符與占位符
- 1.6 注釋
- 1.7 變量定義
- 1.8 屬性
- 1.9 數學表達式
- 1.10 循環語句
- 1.11 條件語句
- 1.12 異常捕獲
- 1.13 虛擬屬性
- 1.14 函數調用
- 1.15 安全輸出(重要)
- 1.16 輸出格式化
- 1.17 標簽
- 1.18 調用Java方法與屬性
- 1.19 嚴格MVC控制
- 1.20 指令
- 1.21 錯誤處理
- 1.22 Beetl小工具
- 1.23 Escape
- 第二部分 高級用法
- 2.1 配置GroupTemplate
- 2.2 自定義方法
- 2.3 自定義格式化函數
- 2.4 自定義標簽
- 2.5 自定義虛擬屬性
- 2.6 使用額外的資源加載器
- 2.7 自定義資源加載器
- 2.8 使用CompositeResourceLoader
- 2.9 自定義錯誤處理器
- 2.10 自定義安全管理器
- 2.11 注冊全局共享變量
- 2.12 自定義布局
- 2.13 性能優化
- 2.14 定制輸出
- 2.15 定制模板引擎
- 2.16 直接運行Beetl腳本
- 2.17 模板校驗
- 第三部分 Web 集成
- 3.1 Web提供的全局變量
- 3.2 集成技術開發指南
- 3.3 Servlet集成
- 3.4 SpringMVC集成
- 3.5 Spring Boot集成
- 3.6 Jodd集成
- 3.7 JFinal4 集成方案
- 3.8 Nutz集成
- 3.9 Struts2集成
- 3.10 整合ajax的局部渲染技術
- 3.11 在頁面輸出錯誤提示信息
- 附錄
- 4.1 內置方法
- 4.2 Spring相關函數
- 4.3 Spring security
- 4.4 shiro
- 4.5 內置格式化方法
- 4.6 內置標簽函數
- 4.7 內置html標簽
- 4.8 性能優化
- 4.9 Eclipse 插件
- 4.10 性能測試對比