Author: cbrisson Date: Wed Nov 9 12:23:07 2016 New Revision: 1768921 URL: http://svn.apache.org/viewvc?rev=1768921&view=rev Log: [site] update tools pages: - get rid of struts and add an end of support mention in the upgrading page - speak about static logging in tools configuration page - update dependencies page - new LogTool documentation
Removed: velocity/site/cms/trunk/content/tools/devel/struts-user-guide.mdtext velocity/site/cms/trunk/content/tools/devel/struts.mdtext Modified: velocity/site/cms/trunk/content/tools/devel/config-xml.mdtext velocity/site/cms/trunk/content/tools/devel/creating-tools.mdtext velocity/site/cms/trunk/content/tools/devel/dependencies.mdtext velocity/site/cms/trunk/content/tools/devel/index.mdtext velocity/site/cms/trunk/content/tools/devel/left.nav velocity/site/cms/trunk/content/tools/devel/maven-velocity-tools-plugin/dependency-convergence.html velocity/site/cms/trunk/content/tools/devel/tools-summary.mdtext velocity/site/cms/trunk/content/tools/devel/upgrading.mdtext velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext velocity/site/cms/trunk/content/tools/devel/view-servlet.mdtext velocity/site/cms/trunk/content/tools/devel/view.mdtext Modified: velocity/site/cms/trunk/content/tools/devel/config-xml.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/config-xml.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/config-xml.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/config-xml.mdtext Wed Nov 9 12:23:07 2016 @@ -2,7 +2,7 @@ Title: Apache Velocity Tools - Configura ## Configuration using XML -Providing an xml format configuration file is still the standard, but unlike VelocityTools 1.x, it is no longer necessary at all, thanks to the introduction of default configurations. The default configurations for [GenericTools](generic.html), [VelocityView](view.html) and [VelocityStruts](struts.html) are all defined via XML. +Providing an xml format configuration file is still the standard, but unlike VelocityTools 1.x, it is no longer necessary at all, thanks to the introduction of default configurations. The default configurations for [GenericTools](generic.html) and [VelocityView](view.html) are all defined via XML. Here's a somewhat thorough example: Modified: velocity/site/cms/trunk/content/tools/devel/creating-tools.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/creating-tools.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/creating-tools.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/creating-tools.mdtext Wed Nov 9 12:23:07 2016 @@ -112,7 +112,7 @@ Always return null on errors! No Excepti $mytool.somemethod('bad input') -This, of course, assumes that quiet notation is not being used for that reference. For this reason, it may be prudent to give your tool access to a logging facility in order to log exceptions and make sure important errors are not silently swallowed. Standard tool management for VelocityTools (even just GenericTools) makes the result of `velocityEngine.getLog()` available to tools as a property under the key "log". So log access can be added as simply as adding a `public void setLog(org.slf4j.Logger log)` method and utilizing the provided Log instance. +This, of course, assumes that quiet notation is not being used for that reference. For this reason, it may be prudent to give your tool access to a logging facility in order to log exceptions and make sure important errors are not silently swallowed. Standard tool management for VelocityTools (even just GenericTools) makes the result of `velocityEngine.getLog()` available to tools as a property under the key "log". So log access can be added as simply as adding a `public void setLog(org.slf4j.Logger log)` method and utilizing the provided Log instance. Or, simply call `LoggerFactory.getLogger(MyTool.class)` to get a static logger dedicated to your custom tool. If you wish to toggle the exception catching or, more importantly, if you prefer to catch exceptions globally with a Velocity Event Handler, then have your tool watch for the "catchExceptions" property. This is `false` by default, but if the VelocityEngine has a MethodExceptionEventHandler configured, then it will be automatically set to `true`. Again, just add a `public void setCatchExceptions(boolean catch)` method to your tool or watch for the "catchExceptions" property in your `public void configure(Map props)` method. See [RenderTool](apidocs/org/apache/velocity/tools/generic/RenderTool.html) for an example of this. Modified: velocity/site/cms/trunk/content/tools/devel/dependencies.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/dependencies.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/dependencies.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/dependencies.mdtext Wed Nov 9 12:23:07 2016 @@ -4,47 +4,40 @@ Title: Apache Velocity Tools Dependencie VelocityTools requires certain external jar dependencies at different times. These charts should help you determine which jars you need and when. -Note: Java version 1.5+ is required for compilation, testing and use of VelocityTools 2.x. +Since VelocityTools relies on Velocity Engine, please also check [Engine dependencies](/engine/2.0/dependencies.html). + +Note: Java version 1.7+ is required for compilation, testing and use of VelocityTools 3.x. {.note} ### GenericTools -Jar Name | Version | Compile | Runtime | Notes ----------|---------|---------|---------|------ -commons-beanutils | 1.7.0 | Yes | Yes | Required for core infrastructure, [MathTool](apidocs/org/apache/velocity/tools/generic/MathTool.html) and [SortTool](apidocs/org/apache/velocity/tools/generic/SortTool.html) -commons-digester | 1.8 | Yes | Yes | Required for [xml configuration](config-xml.html) -slf4j-api | 1.7.2+ | Yes | Yes | Required for Velocity Engine and Velocity Tools -jcl-over-slf4j | 1.7.12 | Yes | Yes | Required for Digester -dom4j | 1.1+ | Yes | No | Required only for [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html) -velocity | 2.0+ | Yes | Yes | Required for core infrastructure, [ClassTool](apidocs/org/apache/velocity/tools/generic/ClassTool.html), [LinkTool](apidocs/org/apache/velocity/tools/generic/LinkTool.html), [LoopTool](apidocs/org/apache/velocity/tools/generic/LoopTool.html), [RenderTool](apidocs/org/apache/velocity/tools/generic/RenderTool.html) and [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html) +Jar Name | Version | Compile | Tests | Runtime | Notes +---------|---------|---------|-------|---------|------ +commons-beanutils | 1.7.0 | Yes | Yes | Yes | Required for core infrastructure, [MathTool](apidocs/org/apache/velocity/tools/generic/MathTool.html) and [SortTool](apidocs/org/apache/velocity/tools/generic/SortTool.html) +commons-digester | 3.2 | Yes | Yes | Yes | Required for [xml configuration](config-xml.html) +dom4j | 1.6.1+ | Yes | No | Yes | Required only for [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html) +jaxen | 1.1.6+ | Yes | No | Yes | Required only for [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html) (dom4j dependency) +junit | 4.12 | No | Yes | No | Only required for tests. +velocity | 2.0+ | Yes | Yes | Yes | Required for core infrastructure, [ClassTool](apidocs/org/apache/velocity/tools/generic/ClassTool.html), [LinkTool](apidocs/org/apache/velocity/tools/generic/LinkTool.html), [LoopTool](apidocs/org/apache/velocity/tools/generic/LoopTool.html), [RenderTool](apidocs/org/apache/velocity/tools/generic/RenderTool.html) and [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html) ### VelocityView -Jar Name | Version | Compile | Runtime | Notes ----------|---------|---------|---------|------ -commons-beanutils | 1.7.0 | Yes | Yes | Required for core infrastructure, [MathTool](apidocs/org/apache/velocity/tools/generic/MathTool.html) and [SortTool](apidocs/org/apache/velocity/tools/generic/SortTool.html) -commons-digester | 1.8 | Yes | Yes | Required for [xml configuration](config-xml.html) -slf4j-api | 1.7.2+ | Yes | Yes | Required for Velocity Engine and Velocity Tools -jcl-over-slf4j | 1.7.12 | Yes | Yes | Required for Digester -dom4j | 1.1+ | Yes | No | Required only for [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html) -servletapi | 2.3+ | Yes | Yes | Required for all [VelocityView](apidocs/org/apache/velocity/tools/view/package-summary.html) tools except for [RenderTool](apidocs/org/apache/velocity/tools/generic/RenderTool.html) -velocity | 2.0+ | Yes | Yes | Required for core infrastructure, [ClassTool](apidocs/org/apache/velocity/tools/generic/ClassTool.html), [LoopTool](apidocs/org/apache/velocity/tools/generic/LoopTool.html), [RenderTool](apidocs/org/apache/velocity/tools/generic/RenderTool.html), [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html), [AbstractSearchTool](apidocs/org/apache/velocity/tools/view/AbstractSearchTool.html), [ContextTool](apidocs/org/apache/velocity/tools/view/ContextTool.html) and [LinkTool](apidocs/org/apache/velocity/tools/view/LinkTool.html) - -### VelocityStruts - -Jar Name | Version | Compile | Runtime | Notes ----------|---------|---------|---------|------ -commons-beanutils | 1.7.0 | Yes | Yes | Required for core infrastructure, [MathTool](apidocs/org/apache/velocity/tools/generic/MathTool.html) and [SortTool](apidocs/org/apache/velocity/tools/generic/SortTool.html) -commons-chain | 1.1 | No | Yes | Struts 1.3+ requires this. -commons-digester | 1.8 | Yes | Yes | Required for [xml configuration](config-xml.html) -slf4j-api | 1.7.2+ | Yes | Yes | Required for Velocity Engine and Velocity Tools -jcl-over-slf4j | 1.7.12 | Yes | Yes | Required for Struts and Digester -dom4j | 1.1+ | Yes | No | Required only for [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html) -struts-core | 1.3.8 | Yes | Yes | Required for all [VelocityStruts](apidocs/org/apache/velocity/tools/struts/package-summary.html) tools -struts-taglib | 1.3.8 | Yes | Yes | Required for [FormTool](apidocs/org/apache/velocity/tools/struts/FormTool.html), [SecureLinkTool](apidocs/org/apache/velocity/tools/struts/SecureLinkTool.html) and [StrutsLinkTool](apidocs/org/apache/velocity/tools/struts/StrutsLinkTool.html) -struts-tiles | 1.3.8 | Yes | Yes | Required for [TilesTool](apidocs/org/apache/velocity/tools/struts/TilesTool.html) -ssl-ext | 1.2 | Yes | No | Required for [SecureLinkTool](apidocs/org/apache/velocity/tools/struts/SecureLinkTool.html) -commons-validator | 1.3.1 | Yes | Yes | Required for [ValidatorTool](apidocs/org/apache/velocity/tools/struts/ValidatorTool.html) -servletapi | 2.3+ | Yes | Yes | Required for all [VelocityStruts](apidocs/org/apache/velocity/tools/struts/package-summary.html) tools and all [VelocityView](apidocs/org/apache/velocity/tools/view/package-summary.html) tools except for [RenderTool](apidocs/org/apache/velocity/tools/generic/RenderTool.html) -velocity | 2.0+ | Yes | Yes | Required for core infrastructure, [ClassTool](apidocs/org/apache/velocity/tools/generic/ClassTool.html), [LoopTool](apidocs/org/apache/velocity/tools/generic/LoopTool.html), [RenderTool](apidocs/org/apache/velocity/tools/generic/RenderTool.html), [XmlTool](apidocs/org/apache/velocity/tools/generic/XmlTool.html), [AbstractSearchTool](apidocs/org/apache/velocity/tools/view/AbstractSearchTool.html), [ContextTool](apidocs/org/apache/velocity/tools/view/ContextTool.html), [LinkTool](apidocs/org/apache/velocity/tools/view/LinkTool.html), [MultiViewsTool](apidocs/org/apache/velocity/tools/view/MultiViewsTool.html), [SecureLinkTool](apidocs/org/apache/velocity/tools/struts/SecureLinkTool.html), [StrutsLinkTool](apidocs/org/apache/velocity/tools/struts/StrutsLinkTool.html), [TilesTool](apidocs/org/apache/velocity/tools/struts/TilesTool.html) and [MessageTool](apidocs/org/apache/velocity/tools/struts/MessageTool.html) +Jar Name | Version | Compile | Tests | Runtime | Notes +---------|---------|---------|-------|---------|------ +junit | 4.12 | No | Yes | No | Only required for tests. +easymock | 3.4 | No | Yes | No | Only required for tests. +servletapi | 3.0.1+ | Yes | Yes | No | Required for all [VelocityView](apidocs/org/apache/velocity/tools/view/package-summary.html) tools except for [RenderTool](apidocs/org/apache/velocity/tools/generic/RenderTool.html). Provided by the J2EE container at runtime. +velocity-tools-generic | 3.0 | Yes | Yes | Yes | + +## SLF4J Binding + +At runtime, Velocity Tools will require an SLF4J binding to be present in the path. Typically, one of: + ++ [AVSL](http://software.clapper.org/avsl/) - âA Very Simple Loggerâ ++ [SLF4J JDK14 Adapter](http://www.slf4j.org/api/org/slf4j/impl/JDK14LoggerAdapter.html) - redirect logs towards Java 1.4+ logging framework ++ [SLF4J Log4J Adapter](http://www.slf4j.org/api/org/slf4j/impl/Log4jLoggerAdapter.html) - redirects logs towards Log4J ++ [SLF4J Simple Logger](http://www.slf4j.org/api/org/slf4j/impl/SimpleLogger.html) - minimalistic logger ++ [SLF4J Android](http://www.slf4j.org/android/) - logger for Android platforms ++ [LogBack](http://logback.qos.ch/) - full featured logging framework ++ [WebApp SLF4J Logger](https://github.com/arkanovicz/webapp-slf4j-logger) - redirects logs towards the J2EE container log Modified: velocity/site/cms/trunk/content/tools/devel/index.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/index.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/index.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/index.mdtext Wed Nov 9 12:23:07 2016 @@ -4,9 +4,9 @@ Title: Apache Velocity Tools A Velocity "tool" is just a POJO (plain old java object) that is "useful" in a template and is not meant to be rendered in the output. In other words, a "tool" (in Velocity-speak) is meant to be used but not seen themselves (e.g. for formatting dates or numbers, url building, etc). -The VelocityTools project is, first of all, a collection of such useful Java classes, as well as infrastructure to easily, automatically and transparently make these tools available to your Velocity templates. Other aims of the project include providing easy integration of Velocity into the view-layer of your web applications (via the [VelocityViewTag](view-tag.html), [VelocityViewServlet](view-servlet.html)), the [Maven Plugin](maven-velocity-tools-plugin/index.html) and integration with Struts 1.x applications. +The VelocityTools project is, first of all, a collection of such useful Java classes, as well as infrastructure to easily, automatically and transparently make these tools available to your Velocity templates. Other aims of the project include providing easy integration of Velocity into the view-layer of your web applications (via the [VelocityViewTag](view-tag.html), [VelocityViewServlet](view-servlet.html)) and the [Maven Plugin](maven-velocity-tools-plugin/index.html). -In recognition of these varying aims, the VelocityTools project is divided into three parts: [GenericTools](generic.html), [VelocityView](view.html and [VelocityStruts](struts.html). Each of these parts builds on the previous one and has its own JAR distribution. +In recognition of these varying aims, the VelocityTools project is divided into two parts: [GenericTools](generic.html) and [VelocityView](view.html. Each of these parts builds on the previous one and has its own JAR distribution. ### GenericTools @@ -16,17 +16,14 @@ In recognition of these varying aims, th [VelocityView](view.html) includes all of the [GenericTools](generic.html) structure and specialized tools for using Velocity in the view layer of web applications (Java EE projects). This includes the [VelocityViewServlet](view-servlet.html) or [VelocityLayoutServlet](view-layoutservlet.html) for processing Velocity template requests, the [VelocityViewTag](view-tag.html) for embedding Velocity in JSP and a [Maven plugin](maven-velocity-tools-plugin/index.html) to embed JSP tag libraries in Velocity templates. Popular tools here are the LinkTool and the ParameterTool. -### VelocityStruts +## What's new in 3.0 -[VelocityStruts]struts.html includes both [VelocityView](view.html and [GenericTools](generic.html) and adds tools for use in Struts 1.x applications. These tools match the functions of the key Struts taglibs and provide access to Struts resources, messages, tiles, validation functions and more. - -It is worth noting that these tools, being POJOs (though some require a little configuration) are generally useful and may be used within your java classes or even other template languages, though you may need to instantiate and configure them manually (not difficult) to do so. VelocityTools 2 has been designed with this in mind. Ask on the user mailing list if you have questions about using VelocityTools without Velocity. - -## What's new in 2.1 - -Velocity Tools 2.1 has the following new features: +Velocity Tools 3.0 new features: + A [Maven plugin](maven-velocity-tools-plugin/index.html) to allow embedding of JSP tag libraries inside Velocity templates. ++ New generic [LogTool](apidocs/org/apache/velocity/tools/generic/LogTool.html). + +See the [Upgrading section](upgrading.html) for a complete list of changes. ## Why 2.0? Modified: velocity/site/cms/trunk/content/tools/devel/left.nav URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/left.nav?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/left.nav (original) +++ velocity/site/cms/trunk/content/tools/devel/left.nav Wed Nov 9 12:23:07 2016 @@ -4,7 +4,6 @@ ## Subprojects * [GenericTools](generic.html) * [VelocityView](view.html) -* [VelocityStruts](struts.html) ## Docs * [Tools Summary](tools-summary.html) * [Javadoc](apidocs/index.html) @@ -18,11 +17,7 @@ * [Wiki](http://wiki.apache.org/velocity/) ## Development * [Changes](changes.html) -* [Participating](index.html#helping-out) * [Dependencies](dependencies.html) +* [Participating](index.html#helping-out) * [Source Code](http://velocity.apache.org/tools/releases/2.0/index.html#Subversion_Repository) * [Report Issue](http://issues.apache.org/jira/browse/VELTOOLS) -## Struts -* [Overview](struts.html) -* [User Guide](struts-user-guide.html) -* [Tools](apidocs/org/apache/velocity/tools/struts/package-summary.html) Modified: velocity/site/cms/trunk/content/tools/devel/maven-velocity-tools-plugin/dependency-convergence.html URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/maven-velocity-tools-plugin/dependency-convergence.html?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/maven-velocity-tools-plugin/dependency-convergence.html (original) +++ velocity/site/cms/trunk/content/tools/devel/maven-velocity-tools-plugin/dependency-convergence.html Wed Nov 9 12:23:07 2016 @@ -261,7 +261,7 @@ <b>Legend:</b> </caption><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td>All projects share one version of the dependency.</td></tr><tr class="b"><td><img alt="error" src="images/icon_error_sml.gif" /></td><td>At least one project has a differing version of the dependency.</td></tr></table><br /><table border="0" class="bodyTable"><caption> <b>Statistics:</b> -</caption><tr class="a"><th>Number of sub-projects:</th><td>14</td></tr><tr class="b"><th>Number of dependencies (NOD):</th><td>29</td></tr><tr class="a"><th>Number of unique artifacts (NOA):</th><td>31</td></tr><tr class="b"><th>Number of SNAPSHOT artifacts (NOS):</th><td>2</td></tr><tr class="a"><th>Convergence (NOD/NOA):</th><td><img alt="error" src="images/icon_error_sml.gif" /> <b>93%</b></td></tr><tr class="b"><th>Ready for Release (100% Convergence and no SNAPSHOTS):</th><td><img alt="error" src="images/icon_error_sml.gif" /> <b>Error</b><br />You do not have 100% convergence.<br />You have SNAPSHOT dependencies.</td></tr></table></div><div class="section"><h3>Dependencies used in sub-projects<a name="Dependencies_used_in_sub-projects"></a></h3><div class="section"><h4>commons-beanutils:commons-beanutils<a name="commons-beanutils:commons-beanutils"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" />< /td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">1.8.3</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-generic">org.apache.velocity:velocity-tools-generic</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>commons-digester:commons-digester<a name="commons-digester:commons-digester"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="error" src="images/icon_error_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">1.8.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-generic">org.apache.velocity:velocity-tools-generic</a></li></ol></td></tr><tr class="a"><td width="25%">2.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-ve locity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>commons-io:commons-io<a name="commons-io:commons-io"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">2.0</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>displaytag:displaytag<a name="displaytag:displaytag"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">1.2</td><td><ol style="list-style-type: lower-alpha"><li><a class="extern alLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/displaytag-directive">org.apache.velocity:displaytag-directive</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>dom4j:dom4j<a name="dom4j:dom4j"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">1.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-xml">org.apache.velocity:velocity-tools-xml</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>httpunit:httpunit<a name="httpunit:httpunit"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">1.6</td><td><ol style="list-style-type: lower-al pha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>javax.servlet.jsp:jsp-api<a name="javax.servlet.jsp:jsp-api"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">2.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/displaytag-directive">org.apache.velocity:displaytag-directive</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-example s/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>javax.servlet:jstl<a name="javax.servlet:jstl"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">1.2</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>javax.servlet:servlet-api<a name="javax.servlet:servlet-api"></a></h4><table border="0" class="bodyTable"><tr class="b">< td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">2.5</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-struts">org.apache.velocity:velocity-tools-examples-struts</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-struts">org.apache.velocity:velocity-tools-struts</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity- tools-view-jsp</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view">org.apache.velocity:velocity-tools-view</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>junit:junit<a name="junit:junit"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="error" src="images/icon_error_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">4.8.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-generic">org.apache.velocity:velocity-tools-generic</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view">org.apache.velocity:velocity-tools-view</a></li>< li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-xml">org.apache.velocity:velocity-tools-xml</a></li></ol></td></tr><tr class="b"><td width="25%">4.8.2</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.maven:maven-plugin-api<a name="org.apache.maven:maven-plugin-api"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.2.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apa che.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.maven:maven-project<a name="org.apache.maven:maven-project"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.2.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.struts:struts-core<a name="org.apache.struts:struts-core"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">1.3.8</td ><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" >href="http://velocity.apache.org/tools/devel/velocity-tools-struts">org.apache.velocity:velocity-tools-struts</a></li></ol></td></tr></table></td></tr></table></div><div > class="section"><h4>org.apache.struts:struts-taglib<a >name="org.apache.struts:struts-taglib"></a></h4><table border="0" >class="bodyTable"><tr class="a"><td><img alt="success" >src="images/icon_success_sml.gif" /></td><td><table border="0" >class="bodyTable"><tr class="b"><td width="25%">1.3.8</td><td><ol >style="list-style-type: lower-alpha"><li><a class="externalLink" >href="http://velocity.apache.org/tools/devel/velocity-tools-struts">org.apache.velocity:velocity-tools-struts</a></li></ol></td></tr></table></td></tr></table></div><div > class="section"><h4>org.apache.struts:struts-tiles<a >name="org.apache.struts:struts-tiles"></a></h4><table border="0" >class="bodyTable"><tr class="a"><td><img alt="success" >src="images/icon_success_sml.gif" /></td> <td><table border="0" class="bodyTable"><tr class="b"><td width="25%">1.3.8</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-struts">org.apache.velocity:velocity-tools-struts</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:displaytag-directive<a name="org.apache.velocity:displaytag-directive"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-engine-log4j< a name="org.apache.velocity:velocity-engine-log4j"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.0.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-engine-servlet-logger<a name="org.apache.velocity:velocity-engine-servlet-logger"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.0.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-gen eric">org.apache.velocity:velocity-tools-generic</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-examples-showcase<a name="org.apache.velocity:velocity-tools-examples-showcase"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-examples-simple<a name="org.apache.velocity:velocity-tools-examples-simple"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"> <tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-examples-struts<a name="org.apache.velocity:velocity-tools-examples-struts"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-generic<a name="org.apache.velocity:velocity-tools-gener ic"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view">org.apache.velocity:velocity-tools-view</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-xml">org.apache.velocity:velocity-tools-xml</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-struts<a name="org.apache.velocity:velocity-tools-struts"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href ="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-struts">org.apache.velocity:velocity-tools-examples-struts</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-uberjar">org.apache.velocity:velocity-tools-uberjar</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-uberjar<a name="org.apache.velocity:velocity-tools-uberjar"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:v elocity-tools-assembly</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-view<a name="org.apache.velocity:velocity-tools-view"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-struts">org.apache.velocity:velocity-tools-struts</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li></ol></td></tr></table></td></tr></table></div><div class="s ection"><h4>org.apache.velocity:velocity-tools-view-jsp<a name="org.apache.velocity:velocity-tools-view-jsp"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/displaytag-directive">org.apache.velocity:displaytag-directive</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velo city-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-simple">org.apache.velocity:velocity-tools-examples-simple</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-struts">org.apache.velocity:velocity-tools-examples-struts</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-uberjar">org.apache.velocity:velocity-tools-uberjar</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-xml<a name="org.apache.velocity:velocity-tools-xml"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="extern alLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-uberjar">org.apache.velocity:velocity-tools-uberjar</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.easymock:easymock<a name="org.easymock:easymock"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">3.0</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></l i><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view">org.apache.velocity:velocity-tools-view</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>sslext:sslext<a name="sslext:sslext"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">1.2-0</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-struts">org.apache.velocity:velocity-tools-struts</a></li></ol></td></tr></table></td></tr></table></div></div> +</caption><tr class="a"><th>Number of sub-projects:</th><td>14</td></tr><tr class="b"><th>Number of dependencies (NOD):</th><td>29</td></tr><tr class="a"><th>Number of unique artifacts (NOA):</th><td>31</td></tr><tr class="b"><th>Number of SNAPSHOT artifacts (NOS):</th><td>2</td></tr><tr class="a"><th>Convergence (NOD/NOA):</th><td><img alt="error" src="images/icon_error_sml.gif" /> <b>93%</b></td></tr><tr class="b"><th>Ready for Release (100% Convergence and no SNAPSHOTS):</th><td><img alt="error" src="images/icon_error_sml.gif" /> <b>Error</b><br />You do not have 100% convergence.<br />You have SNAPSHOT dependencies.</td></tr></table></div><div class="section"><h3>Dependencies used in sub-projects<a name="Dependencies_used_in_sub-projects"></a></h3><div class="section"><h4>commons-beanutils:commons-beanutils<a name="commons-beanutils:commons-beanutils"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" />< /td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">1.8.3</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-generic">org.apache.velocity:velocity-tools-generic</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>commons-digester:commons-digester<a name="commons-digester:commons-digester"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="error" src="images/icon_error_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">1.8.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-generic">org.apache.velocity:velocity-tools-generic</a></li></ol></td></tr><tr class="a"><td width="25%">2.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-ve locity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>commons-io:commons-io<a name="commons-io:commons-io"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">2.0</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>displaytag:displaytag<a name="displaytag:displaytag"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">1.2</td><td><ol style="list-style-type: lower-alpha"><li><a class="extern alLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/displaytag-directive">org.apache.velocity:displaytag-directive</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>dom4j:dom4j<a name="dom4j:dom4j"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">1.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-xml">org.apache.velocity:velocity-tools-xml</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>httpunit:httpunit<a name="httpunit:httpunit"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">1.6</td><td><ol style="list-style-type: lower-al pha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>javax.servlet.jsp:jsp-api<a name="javax.servlet.jsp:jsp-api"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">2.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/displaytag-directive">org.apache.velocity:displaytag-directive</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-example s/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>javax.servlet:jstl<a name="javax.servlet:jstl"></a></h4><table border="0" class="bodyTable"><tr class="b"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">1.2</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>javax.servlet:servlet-api<a name="javax.servlet:servlet-api"></a></h4><table border="0" class="bodyTable"><tr class="b">< td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">2.5</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view">org.apache.velocity:velocity-tools-view</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>junit:junit<a name="junit:junit"></a></h4><table border="0" class="bodyTable"><tr class="b"><td>< img alt="error" src="images/icon_error_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="a"><td width="25%">4.8.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-generic">org.apache.velocity:velocity-tools-generic</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view">org.apache.velocity:velocity-tools-view</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-xml">org.apache.velocity:velocity-tools-xml</a></li></ol></td></tr><tr class="b"><td width="25%">4.8.2</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-p lugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.maven:maven-plugin-api<a name="org.apache.maven:maven-plugin-api"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.2.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.maven:maven-project<a name="org.apache.maven:maven-project"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src= "images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.2.1</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:displaytag-directive<a name="org.apache.velocity:displaytag-directive"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li></ol></td></tr></table></td></tr></table></div><div class="sectio n"><h4>org.apache.velocity:velocity-engine-log4j<a name="org.apache.velocity:velocity-engine-log4j"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.0.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-engine-servlet-logger<a name="org.apache.velocity:velocity-engine-servlet-logger"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.0.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://v elocity.apache.org/tools/devel/velocity-tools-generic">org.apache.velocity:velocity-tools-generic</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-examples-showcase<a name="org.apache.velocity:velocity-tools-examples-showcase"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-examples-simple<a name="org.apache.velocity:velocity-tools-examples-simple"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif " /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-generic<a name="org.apache.velocity:velocity-tools-generic"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view">org.apache.velocity:velocity-tools-view</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-xml">org.apache.velocity:velocity-tools-xml</a></l i></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-uberjar<a name="org.apache.velocity:velocity-tools-uberjar"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-view<a name="org.apache.velocity:velocity-tools-view"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li ><a class="externalLink" >href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a > class="externalLink" >href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li></ol></td></tr></table></td></tr></table></div><div > class="section"><h4>org.apache.velocity:velocity-tools-view-jsp<a >name="org.apache.velocity:velocity-tools-view-jsp"></a></h4><table border="0" >class="bodyTable"><tr class="a"><td><img alt="success" >src="images/icon_success_sml.gif" /></td><td><table border="0" >class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol >style="list-style-type: lower-alpha"><li><a class="externalLink" >href="http://velocity.apache.org/tools/devel/velocity-tools-examples/displaytag-directive">org.apache.velocity:displaytag-directive</a></li><li><a > class="externalLink" href="http://velocity.apache.org/too ls/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-simple">org.apache.velocity:velocity-tools-examples-simple</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-uberjar">org.apache.velocity:velocity-tools-uberjar</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.apache.velocity:velocity-tools-xml<a name="org.apache.velocity:velocity-tools-xml"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><im g alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">2.1.0-SNAPSHOT</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-assembly">org.apache.velocity:velocity-tools-assembly</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-examples/velocity-tools-examples-showcase">org.apache.velocity:velocity-tools-examples-showcase</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-uberjar">org.apache.velocity:velocity-tools-uberjar</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>org.easymock:easymock<a name="org.easymock:easymock"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25% ">3.0</td><td><ol style="list-style-type: lower-alpha"><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/maven-velocity-tools-plugin">org.apache.velocity:maven-velocity-tools-plugin</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view-jsp">org.apache.velocity:velocity-tools-view-jsp</a></li><li><a class="externalLink" href="http://velocity.apache.org/tools/devel/velocity-tools-view">org.apache.velocity:velocity-tools-view</a></li></ol></td></tr></table></td></tr></table></div><div class="section"><h4>sslext:sslext<a name="sslext:sslext"></a></h4><table border="0" class="bodyTable"><tr class="a"><td><img alt="success" src="images/icon_success_sml.gif" /></td><td><table border="0" class="bodyTable"><tr class="b"><td width="25%">1.2-0</td><td><ol style="list-style-type: lower-alpha"></ol></td></tr></table></td></tr></table></div></div> </div> </div> <div class="clear"> Modified: velocity/site/cms/trunk/content/tools/devel/tools-summary.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/tools-summary.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/tools-summary.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/tools-summary.mdtext Wed Nov 9 12:23:07 2016 @@ -17,6 +17,7 @@ You will find here a summary of all the + [`$esc` - EscapeTool](#EscapeTool), + [`$field` - FieldTool](#FieldTool), + [`$link` - LinkTool](#LinkTool), ++ [`$log` - LogTool](#LogTool), + [`$math` - MathTool](#MathTool), + [`$number` - NumberTool](#NumberTool), + [`$render` - RenderTool](#RenderTool), @@ -36,21 +37,8 @@ You will find here a summary of all the + [`$params` - ParameterTool](#ParameterTool), + [`$search` - AbstractSearchTool](#AbstractSearchTool), -#### Struts Tools - -+ [ActionMessagesTool](apidocs/org/apache/velocity/tools/struts/ActionMessagesTool.html), -+ [ErrorsTool](apidocs/org/apache/velocity/tools/struts/ErrorsTool.html), -+ [FormTool](apidocs/org/apache/velocity/tools/struts/FormTool.html), -+ [MessageResourcesTool](apidocs/org/apache/velocity/tools/struts/MessageResourcesTool.html), -+ [MessageTool](apidocs/org/apache/velocity/tools/struts/MessageTool.html), -+ [SecureLinkTool](apidocs/org/apache/velocity/tools/struts/SecureLinkTool.html), -+ [StrutsLinkTool](apidocs/org/apache/velocity/tools/struts/StrutsLinkTool.html), -+ [TilesTool](apidocs/org/apache/velocity/tools/struts/TilesTool.html), -+ [ValidatorTool](apidocs/org/apache/velocity/tools/struts/ValidatorTool.html) - ### Generic Tools - #### [**AlternatorTool**](apidocs/org/apache/velocity/tools/generic/AlternatorTool.html){#AlternatorTool} - tool to create [alternators](apidocs/org/apache/velocity/tools/generic/Alternator.html) (variables that cycle through an array) **`$alternator`** | @@ -240,6 +228,16 @@ You will find here a summary of all the `$link.encode(` *string* `)` | performs URL encoding on the specified text `$link` | displays link +#### [**LogTool**](apidocs/org/apache/velocity/tools/generic/LogTool.html) - tool to trigger logs from withing templates{#LogTool} + +**`$log`** | +--|-- +`$log.trace(` *string* `)` | emits a trace message +`$log.debug(` *string* `)` | emits a debug message +`$log.info(` *string* `)` | emits an info message +`$log.warn(` *string* `)` | emits a warning message +`$log.error(` *string* `)` | emits an error message + #### [**MathTool**](apidocs/org/apache/velocity/tools/generic/MathTool.html) - tool providing math functions{#MathTool} **`$math`** | @@ -466,8 +464,3 @@ You will find here a summary of all the `$search.criteria` | returns or sets the current search criteria `$search.reset()` | resets the search criteria `$search.storedItems` | return selected items if valid, otherwise `null` - -### Struts Tools - -This is unfinished. [You can help fix that!](index.html#Contribution)<br> TODO: This page only covers the Generic and View subprojects, leaving aside the Struts subproject for now. -{.note} Modified: velocity/site/cms/trunk/content/tools/devel/upgrading.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/upgrading.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/upgrading.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/upgrading.mdtext Wed Nov 9 12:23:07 2016 @@ -10,6 +10,8 @@ Velocity Tools, as well as Velocity Engi All objects, methods and configuration formats deprecated in 2.0 have been suppressed. +Support for the Struts 1.x tools has been discontinued. + For custom objects refering directly to the Velocity Engine API, please refer to the [Velocity Engine 2.0 Upgrading section](http://velocity.apache.org/engine/2.0/upgrading.html). ## Upgrading to 2.0 @@ -76,7 +78,7 @@ All of the upgrades to tool management a ### Configuration in 2.0 -Since Tools 2 does lazy-loading of tools, it now makes sense to have almost all tools available by default for most uses, as there is minimal overhead for that at startup and essentially no cost at runtime unless/until the tool is used. So, in Tools 2, unless the user is doing something to trigger the "deprecation support mode" for VelocityView (using the old toolbox.xml format would do this) or explicitly telling [VelocityView](apidocs/org/apache/velocity/tools/view/VelocityView.html) not to load the default tools, then all of the supported, standard VelocityTools will be automatically made available by default. If you don't custom configure any of the provided tools and don't have any custom tools of your own, then you don't actually need a configuration at all! Tools 2 comes with a default tools.xml file each for GenericTools, VelocityView and VelocityStruts, and the [ToolManager](apidocs/org/apache/velocity/tools/ToolManager.html), [VelocityViewServlet](apidocs/org/apache/veloc ity/tools/view/VelocityViewServlet.html), [VelocityLayoutServlet](apidocs/org/apache/velocity/tools/view/VelocityLayoutServlet.html) and [VelocityViewTag](apidocs/org/apache/velocity/tools/view/jsp/VelocityViewTag.html) will all automatically look for and load those unless you are using a deprecated toolbox.xml file or explicitly tell them not to by adding the init-param `org.apache.velocity.tools.loadDefaults` with the value of false to the relevant servlet. +Since Tools 2 does lazy-loading of tools, it now makes sense to have almost all tools available by default for most uses, as there is minimal overhead for that at startup and essentially no cost at runtime unless/until the tool is used. So, in Tools 2, unless the user is doing something to trigger the "deprecation support mode" for VelocityView (using the old toolbox.xml format would do this) or explicitly telling [VelocityView](apidocs/org/apache/velocity/tools/view/VelocityView.html) not to load the default tools, then all of the supported, standard VelocityTools will be automatically made available by default. If you don't custom configure any of the provided tools and don't have any custom tools of your own, then you don't actually need a configuration at all! Tools 2 comes with a default tools.xml file each for GenericTools and VelocityView, and the [ToolManager](apidocs/org/apache/velocity/tools/ToolManager.html), [VelocityViewServlet](apidocs/org/apache/velocity/tools/view/V elocityViewServlet.html), [VelocityLayoutServlet](apidocs/org/apache/velocity/tools/view/VelocityLayoutServlet.html) and [VelocityViewTag](apidocs/org/apache/velocity/tools/view/jsp/VelocityViewTag.html) will all automatically look for and load those unless you are using a deprecated toolbox.xml file or explicitly tell them not to by adding the init-param `org.apache.velocity.tools.loadDefaults` with the value of false to the relevant servlet. If you do need a configuration, you should update your configuration to one of the new formats. Easiest would be to go from the old xml format to [the new xml format](config-xml.html). Remember, you can just leave out standard tools that you don't do any configuration of, as your configuration will just be added to the default one (again, unless the default behavior is turned off). Also, do note that all VelocityView tools have [changed packages and/or names](#Renamings-in-2.0); please avoid using the deprecated versions as those will eventually be removed. Modified: velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext Wed Nov 9 12:23:07 2016 @@ -54,11 +54,8 @@ VLS provides two ways to specify an alte 1. **Specify the layout in the request parameters** - Just add the query string "layout=MyOtherLayout.vm" to any request params and the VLS will find it and render your screen within that layout instead of the default layout. It don't matter how you get the layout param into the query data, only that it's there. If you're using the struts tools, the most common will likely be: - - <a href="$link.setRelative('MyScreen.vm').addQueryData('layout','MyOtherLayout.vm')"> - - but form post data will work just as well. + Just add the query string "layout=MyOtherLayout.vm" to any request params and the VLS will find it and render your screen within that layout instead of the default layout. It don't matter how you get the layout param into the query data, only that it's there. + 2. **Specify the layout in the requested screen.** In the requested screen, put a line like this: Modified: velocity/site/cms/trunk/content/tools/devel/view-servlet.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/view-servlet.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/view-servlet.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/view-servlet.mdtext Wed Nov 9 12:23:07 2016 @@ -7,7 +7,7 @@ This page is still unfinished. Much of t [Javadoc is here](apidocs/org/apache/velocity/tools/view/VelocityViewServlet.html). -A typical application use-case for the VelocityViewServlet is to provide the view rendering layer for a servlet-based web application framework. The [VelocityStruts](struts.html) subproject uses the approach to bring Velocity templates to the Struts 1 application framework. +A typical application use-case for the VelocityViewServlet is to provide the view rendering layer for a servlet-based web application framework. ## Installation Modified: velocity/site/cms/trunk/content/tools/devel/view.mdtext URL: http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/view.mdtext?rev=1768921&r1=1768920&r2=1768921&view=diff ============================================================================== --- velocity/site/cms/trunk/content/tools/devel/view.mdtext (original) +++ velocity/site/cms/trunk/content/tools/devel/view.mdtext Wed Nov 9 12:23:07 2016 @@ -34,9 +34,6 @@ Detailed documentation is [here](view-se One derivative of the VelocityViewServlet is the [**VelocityLayoutServlet**](view-layoutservlet.html. This servlet performs a simplified 'two-pass render' in order to apply a shared, common layout to all of the web pages in an application. -The Struts "template" tag library does something similar, but requires a separate file to define which 'layout' file to use and which .jsp files to render into that layout. The VelocityLayoutServlet takes a simpler approach. It first renders the primary template being called (example: showDetails.vm) into a content holder variable (ex. $screen_content). Next, the servlet loads a 'layout' file. It uses the existing data, including any additional variables set or changed by the first template, to render a the layout template. - - The VelocityLayoutServlet also allows you to specify an 'error' template to be displayed when an exception is thrown during the processing of a requested template. This allows you to provide a customized error screen for a more user-friendly application. Detailed documentation is [here](view-layoutservlet.html). @@ -66,7 +63,6 @@ In the VelocityTools sources tree, you w + velocity-tools-simple: a minimalist web application. + velocity-tools-showcase: a demonstration of all standard tools. -+ velocity-tools-struts: (deprecated) a demonstration of the Struts tools. To run the showcase application locally, run the following command from the velocity-tools-examples/velocity-tools-examples-showcase directory: