## 4.1 內置方法
[TOC]
### 4.1.1 常用內置方法
- **date** 返回一個java.util.Date類型的變量,如 date() 返回一個當前時間(對應java的java.util.Date); ${date( "2011-1-1" , "yyyy-MM-dd" )} 返回指定日期
- **print** 打印一個對象 print(user.name);
- **println** 打印一個對象以及回車換行符號,回車換號符號使用的是模板本身的,而不是本地系統的.如果僅僅打印一個換行符,則直接調用println() 即可
- **printFile** 直接答應文件,文件路徑以模板根目錄為相對目錄,printFile(‘‘/common/header.html’’);
- **nvl** 函數nvl,如果對象為null,則返回第二個參數,否則,返回自己 nvl(user,"不存在")
- **isEmpty** 判斷變量或者表達式是否為空,變量不存在,變量為null,變量是空字符串,變量是空集合,變量是空數組,此函數都將返回true
- **isNotEmpty** 同上,判斷對象是否不為空
- has 變量名為參數,判斷是否存在此全局變量,如 has(userList),類似于1.x版本的exist("userList"),但不需要輸入引號了
- **assert** 如果表達式為false,則拋出異常
- trim 截取數字或者日期,返回字符,如trim(12.456,2)返回"12.45",trim(date,'yyyy')返回"2017"
- **trunc** 截取數字,保留指定的小數位,如trunc(12.456,2) 輸出是12.45.不推薦使用,因為處理float有問題,兼容原因保留了
- **decode** 一個簡化的if else 結構,如 ${decode(a,1,"a=1",2,"a=2","不知道了")},如果a是1,這decode輸出"a=1",如果a是2,則輸出"a==2", 如果是其他值,則輸出"不知道了"
- debug 在控制臺輸出debug指定的對象以及所在模板文件以及模板中的行數,如debug(1),則輸出1 [在3行@/org/beetl/core/lab/hello.txt],也可以輸出多個,如debug("hi",a),則輸出hi,a=123,[在3行@/org/beetl/core/lab/hello.txt]
- **parseInt** 將數字或者字符解析為整形 如 parseInt("123");
- **parseLong** 將數字或者字符解析為長整形,parseInt(123.12);
- **parseDouble** 將數字或者字符解析為浮點類型 如parseDouble("1.23")
- **range** 接收三個參數,初始值,結束值,還有步增(可以不需要,則默認為1),返回一個Iterator,常用于循環中,如for(var i in range(1,5)) {print(i)},將依次打印1234.
- **flush** 強制io輸出。
- **json**,將對象轉成json字符串,如 var data = json(userList) 可以跟一個序列化規則 如,var data = json(userList,"[*].id:i"),具體參考?[https://git.oschina.net/xiandafu/beetl-json](https://git.oschina.net/xiandafu/beetl-json)
- **pageCtx** ,僅僅在web開發中,設置一個變量,然后可以在頁面渲染過程中,調用此api獲取,如pageCtx("title","用戶添加頁面"),在其后任何地方,可以pageCtx("title") 獲取該變量
- **type.new** 創建一個對象實例,如 var user = type.new("com.xx.User"); 如果配置了IMPORT_PACKAGE,則可以省略包名,type.new("User")
- **type.name** 返回一個實例的名字,var userClassName = type.name(user),返回"User"
- **global** 返回一個全局變量值,參數是一個字符串,如 var user = global("user_"+i);
- **cookie** 返回指定的cookie對象 ,如var userCook = cookie("user"),allCookies = cookie();
### 4.1.2 字符串相關方法
> strutil方法對參數均不做空指針檢測,你可自定義方法來覆蓋這些內置的方法
- **strutil.startWith** ${ strutil.startWith("hello","he")} 輸出是true
- **strutil.endWith** ${ strutil.endWith("hello","o")} 輸出是true
- **strutil.length** ${ strutil. length ("hello")},輸出是5
- **strutil.subString** ${ strutil.subString ("hello",1)},輸出是"ello"
- strutil.subStringTo ${ strutil.subStringTo ("hello",1,2)},輸出是"e"
- **strutil.split** ${ strutil.split ("hello,joeli",",")},參數第一個是字符串,第二個是正則表達式。輸出是數組:返回第一個是"hello",第二個是"joelli"
- strutil.contain ${ strutil.contain ("hello,"el")},輸出是true
- **strutil.toUpperCase** ${ strutil.toUpperCase ("hello")},輸出是HELLO
- **strutil.toLowerCase** ${ strutil.toLowerCase ("hello")},輸出是hello
- **strutil.replace** ${ strutil.replace ("hello","lo","loooo")},輸出是helloooo
- strutil.format ${ strutil.format ("hello,{0}, my age is {1}","joeli",15)},輸出是hello,joeli, my age is 15. 具體請參考[http://docs.oracle.com/javase/6/docs/api/java/text/MessageFormat.html](http://docs.oracle.com/javase/6/docs/api/java/text/MessageFormat.html)
- **strutil.trim** 去掉字符串的尾部空格
- **strutil.formatDate** var a = strutil.formatDate(user.bir,'yyyy-MM-dd')};
- **strutil.index** var index = strutil.index("abc","a");返回 索引0
- **strutil.lastIndex** var index = strutil.lastIndex("aba","a");返回索引2
### 4.1.3 數組相關方法
- **array.range** 返回數組或者Collection一部分,接受三個參數,第一個是數組或者Collection子類,第二,三個參數分別是起始位置
- **array.remove** 刪除某個數組或者Collection的一個元素,并返回該數組或者Collection.第一個是數組或者Collection子類,第二個參數是元素
- **array.add** 向數組或者Collection添加一個元素,并返回該數組或者Collection。第一個是數組或者Collection子類,第二個參數是元素
- array.contain 判斷數組或者元素是否包含元素,如果包含,返回true。否則false。第一個是數組或者Collection子類,第二個參數是元素
- **array.toArray** 轉化成數組,如array.toArray(1,2,"a");
- **array.collection2Array** 將java集合轉化為數組 array.collection2Array([1,2,''])
### 4.1.4 正則表達式相關方法
- **reg.match(str,regex)** str為需要處理的字符串,regex是表達式
- **reg.replace(str,regex,replace)**,str為需要處理的字符串,regex是表達式,替換的字符串替換字符串
- **reg.find(str,regex)** 返回找到的符合表達式的第一個字符串,否則返回空字符串
- **reg.findList(str,regex)** 找到所有符合表達式的字符串,否則返回空列表
- **reg.split(str,regex)**,對字符串進行切分,返回列表
- **reg.split(str,regex,limit)** 同上,limit是最多返回個數
- 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 性能測試對比