預設值操作符: 使用形式例如: userName!default_expr 或 userName! 或 (userName)!default_expr 或 (userName)! 這個操作符允許你為可能不存在的變數指定一個預設值(default_expr),'!'後沒有參數預設返回一個空。 例如,假 ...
預設值操作符:
使用形式例如:
userName!default_expr
或 userName!
或 (userName)!default_expr
或 (userName)!
這個操作符允許你為可能不存在的變數指定一個預設值(default_expr),'!'後沒有參數預設返回一個空。
例如,假設下麵展示的代碼中沒有名為 mouse 的變數:
${mouse!"No mouse."}
<#assign mouse="Jerry">
${mouse!"No mouse."}
將會輸出:
No mouse.
Jerry
如果預設值被省略了,那麼結果將會是空串,空序列或空哈希表。 (這是 FreeMarker 允許多類型值的體現)請註意,如果想讓預設值為 0 或 false,則不能省略它。例如:
${mouse!})
<#assign mouse = "Jerry">
(${mouse!})
將會輸出:
()
(Jerry)
預設值可以是任何類型的表達式,也可以不必是字元串。 也可以這麼寫:hits!0 或 colors!["red", "green", "blue"]。 預設值表達式的複雜程度沒有
嚴格限制,還可以這麼來寫: cargo.weight!(item.weight * itemCount + 10)。
用於非頂層變數時,預設值操作符可以有兩種使用方式:
1. product.color!"red"
2. (product.color)!"red"
兩種使用方式區別:
第一種方式,當product為null,這會解析出錯(java中的空指針),只有當product有值,color為null時能顯示預設值 "red" 而不會報錯,
第二種方式:當product為null或者product存在而color為null,都能顯示預設值"red"而不會報錯
本例和上例寫法的重要區別在於用括弧時,就允許其中表達式的任意部分可以未定義。而沒有括弧時,僅允許表達式的最後部分可以不被定義。
警告!
如果在 !後面有複合表達式, 如 1 + x,通常 使用括弧,如 ${x!(1 + y)} 或 ${(x!1) + y)},這樣就根據你的意圖來確定優先順序。 由於FreeMarker 2.3.x 版本的源碼中的小失誤所以必須這麼來做。 ! (作為預設值操作) 右側的優先順序非常低。 這就意味著 ${x!1 + y} 會被 FreeMarker 誤解為 ${x!(1 + y)},而真實的意義是 ${(x!1) + y}。 這個源碼錯誤在FreeMarker 2.4中會得到修正。 在編程中註意這個錯誤,要麼就使用FreeMarker 2.4!
因為語法的含糊 <@something a=x! b=y /> 將會解釋為 <@something a=x!(b=y) />,那就是說 b=y 將會被視為是比較運算,然後結果作為 x的預設值,而不是想要的參數 b。 為了避免這種情況,如下編寫代碼即可: <@something a=(x!) b=y />