默認值操做符:
使用形式例如:
userName!default_expr
或 userName!
或 (userName)!default_expr
或 (userName)!
這個操做符容許你爲可能不存在的變量指定一個默認值(default_expr),'!'後沒有參數默認返回一個空。java
例如,假設下面展現的代碼中沒有名爲 mouse 的變量:
${mouse!"No mouse."}
<#assign mouse="Jerry">
${mouse!"No mouse."}
將會輸出:編程
No mouse.
Jerryspa
若是默認值被省略了,那麼結果將會是空串,空序列或空哈希表。 (這是 FreeMarker 容許多類型值的體現)請注意,若是想讓默認值爲 0 或 false,則不能省略它。例如:指針
${mouse!})
<#assign mouse = "Jerry">
(${mouse!})
將會輸出:字符串
()
(Jerry)源碼
默認值能夠是任何類型的表達式,也能夠沒必要是字符串。 也能夠這麼寫:hits!0 或 colors!["red", "green", "blue"]。 默認值表達式的複雜程度沒有it
嚴格限制,還能夠這麼來寫: 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 />