Jakarta Velocity - 正式リファレンス表記と沈黙リファレンス表記

リファレンスの記述方法には、以下のようなパターンが存在する。

$name

$[name]

前者が沈黙リファレンス表記で、後者が正式リファレンス表記である。沈黙リファレンス表記だと、場合によっては不都合が発生するため（後述）、よほどの理由がない限りは正式リファレンス表記を利用するほうがよい。

沈黙リファレンス表記の不都合

たとえば「hello! ???san.」と表示したい場合に、沈黙リファレンス表記で書くと以下のようになる。

hello! $namesan.

$nameという変数を認識させたいが、テンプレートエンジンは$namesanという変数を参照する。正式リファレンス表記を利用すれば、この問題を回避できる。

hello! $[name]san.