Velocity Engine

Docs

Developers

Community

Translations (outdated)

Velocity News Feed

Upgrading from earlier versions

Release with the same major number (1.x) are intended to be drop-in replacements. However, in most cases the versions of dependency jars must be adjusted because newer versions of Velocity might require updates.

Upgrading from Velocity 1.7

VTL Syntax changes:

  • the hypen ( - ) cannot be used in variable names anymore
  • method arguments can be arithmetic expressions

Dependencies changes:

  • commons-lang, commons-collections and commons-logging aren't needed any more at runtime.
  • there's a new runtime dependency, slf4j-api 1.7.12
  • you'll need an SLF4J binding

Upgrading from Velocity 1.6

There are no changes in the dependencies since Velocity 1.6

  • Deprecated $velocityCount; please use $foreach.count or $foreach.index
  • Deprecated $velocityHasNext; please use $foreach.hasNext, $foreach.first or $foreach.last
  • Deprecated velocimacro.context.localscope setting; please get/set local #macro references as members of the provided $macro scope control instead. (e.g. #set( $macro.foo = 'bar' ) and $macro.foo )
  • Deprecated directive.evaluate.context.class setting; please get/set local #evaluate references as members of the provided $evaluate scope control instead. (e.g. #set( $evaluate.foo = 'bar' ) and $evaluate.foo )
  • Deprecated #literal directive; please use #[[this syntax]]# instead.
  • Changed #stop to end template rendering rather than template parsing.
  • Removed obsolete Veltag (use VelocityViewTag in VelocityTools project)
  • Removed obsolete WebMacro conversion code.

Upgrading from Velocity 1.5

Upgrading from Velocity 1.4 or earlier

Optional: + Apache Ant 1.6 or better is required for rebuilding. + JavaCC 3.2 is recommended to compile the parser files. + HSQLDB 1.7.1 is required for running unit tests.