默認值操作符:
使用形式例如:
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 />