Bug: 268527498

Clone this repo:
  1. 1ac9c00 [automerge] Merge of apache-velocity-engine from aosp/master 2p: 757677e884 am: dbb091f02e by Andrew Vuong · 1 year ago android14-qpr1-release android14-qpr1-s2-release main master android-14.0.0_r16 android-14.0.0_r17 android-14.0.0_r18 android-14.0.0_r19 android-14.0.0_r20 android-14.0.0_r21 android-14.0.0_r22 android-14.0.0_r23 android-14.0.0_r24 android-14.0.0_r25 android-14.0.0_r26 android-14.0.0_r27
  2. dbb091f [automerge] Merge of apache-velocity-engine from aosp/master 2p: 757677e884 by Andrew Vuong · 1 year ago android14-dev
  3. 757677e Merge of apache-velocity-engine from aosp/master by Andrew Vuong · 1 year ago
  4. 3a93ff2 Add java_library to Android.bp and manually generated_sources. am: f2461dce3a am: 2ccb9641e1 am: 67603ab6a1 by Andrew Vuong · 1 year ago
  5. 67603ab Add java_library to Android.bp and manually generated_sources. am: f2461dce3a am: 2ccb9641e1 by Andrew Vuong · 1 year ago

Title: Apache Velocity Engine

Apache Velocity

Welcome to Apache Velocity Engine! Apache Velocity is a general purpose template engine written in Java. For more information about Velocity, please look at the HTML documentation on the Velocity web site.

Here's a description of the top level directories:

velocity-engine-core/       The Velocity Engine core module
velocity-engine-examples/   Several simple examples
velocity-engine-scripting/  JSR-223 implementation for Velocity scripting
spring-velocity-support     Velocity Engine factory bean for Spring framework
src/                        Source for parent modules, mainly changelog


Apache Velocity 2.2 will run with any Java runtime engine v1.8 or greater.

Building from source requires Java development kit v1.8 or greater and Maven 3 (3.0.5+).

At compile time, Maven should fetch all engine needed dependencies, which are:

  • commons-lang v3.9
  • slf4j-api v1.7.30

plus the following ones, needed for the integrated tests:

  • slf4j-simple v1.7.30
  • junit v4.13
  • hsqldb v2.5.0
  • commons-io 2.8.0

At runtime, Velocity only needs:

  • commons-lang v3.9+
  • slf4j-api and an slf4j binding, v1.7.30+


In order to use the latest version of Apache Velocity, you may want to build it.

Building is easy. All components necessary to build are included or get downloaded from the internet during the build, except for the Java SDK and the Maven build tool. You can find details online on how to build Velocity.

IMPORTANT As the Apache Velocity build process wants to download a number of jars from the internet, you must be online when you are building for the first time.

To build Velocity's jar, just run maven using the command:


This will create a target/ directory containing the Velocity .jar file in each sub-module directory.

Be sure to update your classpath to include Velocity's .jar file, or when using a modern servlet container, put it in the WEB-INF/lib directory.


Since 2.2, it's possible to build a custom parser, to change some of the characters used by in the VTL syntax: *, @, $ and #.

Let's say you want to merge some templatized jQuery code full of $ characters, you can for instance build you own parser which will use the § character as references prefix instead of $.


After building Velocity, you can also build the examples that are included with the Velocity distribution. These examples show how to use Velocity in your Java applications.

For more information, please see the examples README in the velocity-engine-examples directory.

  • The Apache Velocity Team