04.Beetl經常使用內置函數以及安全輸出---《Beetl視頻課程》

本期視頻實現了三個功能，模糊搜索、標籤分類、登陸/註銷功能；

內容簡介：使用了經常使用內置函數，以及安全輸出，實現了上面提到的三個業務

一塊兒學beetl目錄：https://my.oschina.net/u/1590490?tab=newest&catalogId=6214598

做者：GK

---

經常使用內置方法

• 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
• 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();

---

字符串相關方法

• 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

• 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

---

數組相關方法

• 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,''])

正則表達式相關方法

• 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是最多返回個數

---

安全輸出

變量後面加一個感嘆號標識安全輸出，佔位符，定界符均可以使用，感嘆號後面能夠寫默認值 例如：

${userName!}
${userName!"默認值"}
<%if(userName!"xxxx"=="xxxx"){......}%>

安全輸出是任何一個模板引擎必須重視的問題，不然，將極大困擾模板開發者。Beetl中，若是要輸出的模板變量爲null，則beetl將不作輸出，這點不一樣於JSP，JSP輸出null，也不一樣於Freemarker，若是沒有用!,它會報錯.

模板中還有倆種狀況會致使模板輸出異常

有時候模板變量並不存在（譬如子模板裏） 模板變量爲null，但輸出的是此變量的一個屬性，如${user.wife.name} 針對前倆種狀況，能夠在變量引用後加上！以提醒beetl這是一個安全輸出的變量。

如${user.wife.name! },即便user不存在，或者user爲null，或者user.wife爲null，或者user.wife.name爲null beetl都不將輸出

能夠在!後增長一個常量（字符串，數字類型等），或者另一個變量，方法，本地調用，做爲默認輸出，譬如：

${user.wife.name!」單身」}，若是user爲null，或者user.wife爲null，或者user.wife.name爲null，輸出」單身」

譬如

${user.birthday!@System.constants.DefaultBir}， 表示若是user爲null，或者user. birthday爲null，輸出System.constants.DefaultBir

還有一種狀況不多發生，但也有可能，輸出模板變量發生的任何異常，如變量內部拋出的一個異常

這須要使用格式${!(變量)},這樣，在變量引用發生任何異常狀況下，都不做輸出，譬如

${!(user.name)},，beetl將會調用user.getName()方法，若是發生異常，beetl將會忽略此異常，繼續渲染

值得注意的是，在變量後加上!不單單能夠應用於佔位符輸出(但主要是應用於佔位符輸出)，也能夠用於表達式中，如：

<%
var k = user.name!'N/A'+user.age!;
%>
<%
${k}
%>
若是user爲null，則k值將爲N/A

項目git地址：https://gitee.com/gavink/beetl-blog

視頻地址：下載下來會更清晰，視頻比較長，可以使用倍速看，主要實現業務比較的地方耗費時間長

百度網盤下載: https://pan.baidu.com/s/1LyxAxlKpVXgVjwSXIbzBuA 提取碼: 68im

bilibili (能夠調節清晰度): https://www.bilibili.com/video/av36278644/?p=4

博客目錄：https://my.oschina.net/u/1590490?tab=newest&catalogId=6214598