blob: 4afcde4b02553ed6173f47876f2d84c42adfe9a3 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>Apache Velocity - Velocity dependencies</title>
<style type="text/css" media="all">
@import url("./css/maven-base.css");
@import url("./css/maven-theme.css");
@import url("./css/site.css");
</style>
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
<link rel="alternate" href="http://feeds.feedburner.com/ApacheVelocitySiteNews" type="application/rss+xml" title="Apache Velocity - Velocity dependencies News" />
<meta name="author" content="Velocity Documentation Team" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body class="composite">
<div id="banner">
<a href="../../../" id="bannerLeft">
<img src="images/velocity_project_wide.png" alt="" />
</a>
<span id="bannerRight">
<img src="images/velocity-logo.png" alt="" />
</span>
<div class="clear">
<hr/>
</div>
</div>
<div id="breadcrumbs">
<div class="xleft">
<a href="http://www.apache.org/">Apache</a>
&gt;
<a href="../../../">Velocity</a>
&gt;
Velocity Engine
</div>
<div class="xright"> <a href="../../devel/">Engine</a>
|
<a href="../../../tools/devel/">Tools</a>
|
<a href="../../../anakia/devel/">Anakia</a>
|
<a href="../../../texen/devel/">Texen</a>
|
<a href="../../../docbook/">DocBook</a>
|
<a href="../../../dvsl/devel/">DVSL</a>
</div>
<div class="clear">
<hr/>
</div>
</div>
<div id="leftColumn">
<div id="navcolumn">
<h5>Velocity</h5>
<ul>
<li class="none">
<a href="index.html">General</a>
</li>
<li class="none">
<a href="overview.html">Overview</a>
</li>
<li class="none">
<a href="getting-started.html">Getting Started</a>
</li>
<li class="none">
<a href="webapps.html">Web Applications</a>
</li>
<li class="none">
<a href="../../../download.cgi">Download</a>
</li>
<li class="none">
<a href="http://wiki.apache.org/velocity/VelocityFAQ">FAQ (Wiki)</a>
</li>
</ul>
<h5>Docs</h5>
<ul>
<li class="none">
<a href="user-guide.html">User Guide</a>
</li>
<li class="none">
<a href="developer-guide.html">Developer Guide</a>
</li>
<li class="none">
<a href="vtl-reference-guide.html">VTL Reference</a>
</li>
<li class="none">
<a href="glossary.html">Glossary</a>
</li>
</ul>
<h5>Developers</h5>
<ul>
<li class="none">
<a href="license.html">License</a>
</li>
<li class="none">
<a href="apidocs/index.html">Javadoc</a>
</li>
<li class="none">
<a href="changes-report.html">Changes</a>
</li>
<li class="none">
<a href="jira-report.html">Resolved Issues</a>
</li>
<li class="none">
<a href="upgrading.html">Upgrading</a>
</li>
<li class="none">
<strong>Dependencies</strong>
</li>
<li class="none">
<a href="http://svn.apache.org/viewvc/velocity/engine/trunk/">Source Code Repository</a>
</li>
<li class="none">
<a href="build.html">Building from Source</a>
</li>
</ul>
<h5>Community</h5>
<ul>
<li class="none">
<a href="http://wiki.apache.org/velocity/">Wiki</a>
</li>
<li class="none">
<a href="../../../news.html">Recent News</a>
</li>
<li class="none">
<a href="http://wiki.apache.org/velocity/PoweredByVelocity">Powered By Velocity</a>
</li>
<li class="none">
<a href="http://wiki.apache.org/velocity/VelocityEditors">IDE/Editor Plugins</a>
</li>
<li class="none">
<a href="http://wiki.apache.org/velocity/PublishedArticlesAndBooks">Articles and Books</a>
</li>
<li class="none">
<a href="http://wiki.apache.org/velocity/GetInvolved">Get Involved</a>
</li>
<li class="none">
<a href="../../../contact.html">Mailing Lists</a>
</li>
</ul>
<h5>Velocity Development</h5>
<ul>
<li class="none">
<a href="http://wiki.apache.org/velocity/RoadMap">Road Map</a>
</li>
<li class="none">
<a href="http://wiki.apache.org/velocity/CodeStandards">Coding Standards</a>
</li>
<li class="none">
<a href="http://wiki.apache.org/velocity/DocumentationGuidelines">Documentation Guidelines</a>
</li>
<li class="none">
<a href="https://issues.apache.org/jira/browse/VELOCITY">Issues</a>
</li>
<li class="none">
<a href="../../../who-we-are.html">Who we are</a>
</li>
</ul>
<h5>Translations</h5>
<ul>
<li class="none">
<a href="http://www.jajakarta.org/velocity/">Site (Japanese)</a>
</li>
<li class="none">
<a href="translations/user-guide_fi.html">User's Guide (Finnish)</a>
</li>
<li class="none">
<a href="translations/user-guide_fr.html">User's Guide (French)</a>
</li>
<li class="none">
<a href="translations/user-guide_es.html">User's Guide (Spanish)</a>
</li>
</ul>
<h5>Project Documentation</h5>
<ul>
<li class="collapsed">
<a href="project-info.html">Project Information</a>
</li>
<li class="collapsed">
<a href="project-reports.html">Project Reports</a>
</li>
</ul>
<a class="poweredBy" href="../../../" title="Apache Velocity" ><img class="poweredBy" alt="Apache Velocity" src="images/pbv90x30.png" /></a>
<a class="poweredBy" href="../../../rss/news.rss" title="Velocity News Feed" ><img class="poweredBy" alt="Velocity News Feed" src="images/feed-icon-24x24.jpg" /></a>
<iframe src="http://www.apache.org/ads/buttonbar.html"
style="border-width:0; float: left" frameborder="0" scrolling="no"
width="135"
height="265" ></iframe>
</div>
</div>
<div id="bodyColumn">
<div id="contentBox">
<div class="section"><h2><a name="Velocity_dependencies"></a>
Velocity dependencies</h2>
<p>
Velocity has a number of external jar dependencies. However, not all of these
are needed every time. This document should help you do decide which jars must
also be present if you want to integrate Velocity into your application.
</p>
<p>
All of these jars must be present when building Apache Velocity. The build process
downloads all of them automatically from the Internet.
</p>
<table class="bodyTable"><tr class="a"><th>jar name</th>
<th>Required</th>
<th>Explanation</th>
</tr>
<tr class="b"><td>commons-collections</td>
<td>Yes</td>
<td>Needed for all parts of Velocity</td>
</tr>
<tr class="a"><td>commons-lang</td>
<td>Yes</td>
<td>Needed for all parts of Velocity</td>
</tr>
<tr class="b"><td>commons-logging</td>
<td>No</td>
<td>Must be present if log system is configured to use
<a href="apidocs/org/apache/velocity/runtime/log/CommonsLogLogChute.html">CommonsLogLogChute</a>
.
Otherwise, it is not needed.
</td>
</tr>
<tr class="a"><td>oro</td>
<td>Yes</td>
<td>Must be present if you have Velocity configured to
<a href="developer-guide.html#Configuring_Event_Handlers">automatically escape references</a>
.
Otherwise, it is not needed.
</td>
</tr>
<tr class="b"><td>log4j</td>
<td>No</td>
<td>Must be present if log4j Logging has been selected.
Not needed if any other logging style has been selected.</td>
</tr>
<tr class="a"><td>logkit (or avalon-logkit)</td>
<td>No</td>
<td>Must be present if Avalon Logging has been selected.
Not needed if any other logging style has been selected.</td>
</tr>
<tr class="b"><td>servletapi</td>
<td>No</td>
<td>Only needed when the <a href="apidocs/org/apache/velocity/servlet/VelocityServlet.html">VelocityServlet</a>
or <a href="apidocs/org/apache/velocity/runtime/log/ServletLogChute.html">ServletLogChute</a>
are used.
Should normally be supplied by the servlet container.
<b>VelocityServlet is deprecated and should
be replaced with VelocityViewServlet from the
<a class="externalLink" href="http://velocity.apache.org/tools/devel/">velocity-tools</a>
distribution.</b>
</td>
</tr>
<tr class="a"><td>jdom</td>
<td>No</td>
<td>Only required for the deprecated Anakia tool / ant task</td>
</tr>
<tr class="b"><td>werken-xpath</td>
<td>No</td>
<td>Only required for the deprecated Anakia tool / ant task</td>
</tr>
<tr class="a"><td>antlr</td>
<td>No</td>
<td>Only required for the deprecated Anakia tool / ant task</td>
</tr>
<tr class="b"><td>ant</td>
<td>No</td>
<td>Only needed for compilation.</td>
</tr>
<tr class="a"><td>junit</td>
<td>No</td>
<td>Only needed for running the tests during compilation.</td>
</tr>
<tr class="b"><td>hsqldb</td>
<td>No</td>
<td>Only needed for running the tests during compilation.</td>
</tr>
</table>
<p>
The most common case is the integration of the Velocity runtime into your
application. In this case, you must add commons-collections and commons-lang
to your application (and optional Oro or commons-logging if
required). If you already have one or more of these libraries in your application,
you should check if you need to update their versions.
</p>
<p>The <a href="dependencies.html">auto-generated dependency report</a>
lists all mandatory
dependencies as <b>compile</b>
and all optional dependencies as <b>provided</b>
, though
it fails to properly reflect the optional nature of the Oro and Commons-Logging dependencies.
</p>
</div>
</div>
</div>
<div class="clear">
<hr/>
</div>
<div id="footer">
<div class="xright">&#169;
2000-2008
The Apache Software Foundation
Last Published: 2008-12-15 08:38:22
</div>
<div class="clear">
<hr/>
</div>
</div>
</body>
</html>