You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@velocity.apache.org by nb...@apache.org on 2005/10/20 18:43:08 UTC
svn commit: r326941 - in /jakarta/velocity/tools/trunk/xdocs: ./ generic/
struts/ view/
Author: nbubna
Date: Thu Oct 20 09:42:54 2005
New Revision: 326941
URL: http://svn.apache.org/viewcvs?rev=326941&view=rev
Log:
repair and upgrade the xdocs in prep for a 1.2 release
Modified:
jakarta/velocity/tools/trunk/xdocs/changes.xml
jakarta/velocity/tools/trunk/xdocs/generic/EscapeTool.xml
jakarta/velocity/tools/trunk/xdocs/generic/index.xml
jakarta/velocity/tools/trunk/xdocs/generic/menu.xml
jakarta/velocity/tools/trunk/xdocs/index.xml
jakarta/velocity/tools/trunk/xdocs/menu.xml
jakarta/velocity/tools/trunk/xdocs/struts/ActionMessagesTool.xml
jakarta/velocity/tools/trunk/xdocs/struts/ErrorsTool.xml
jakarta/velocity/tools/trunk/xdocs/struts/FormTool.xml
jakarta/velocity/tools/trunk/xdocs/struts/MessageTool.xml
jakarta/velocity/tools/trunk/xdocs/struts/index.xml
jakarta/velocity/tools/trunk/xdocs/struts/menu.xml
jakarta/velocity/tools/trunk/xdocs/struts/userguide.xml
jakarta/velocity/tools/trunk/xdocs/view/ParameterParser.xml
jakarta/velocity/tools/trunk/xdocs/view/index.xml
jakarta/velocity/tools/trunk/xdocs/view/menu.xml
Modified: jakarta/velocity/tools/trunk/xdocs/changes.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/changes.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/changes.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/changes.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -29,6 +29,17 @@
<subsection name="1.2-dev">
<p>This section describes changes after the 1.1 release.</p>
<ul>
+ <li>Updated documentation to cover new features and sync to many infrastructure changes. (ndb)</li>
+ <li>Fixed incomplete escaping in ValidatorTool (patch from Christopher Schultz. Jira Issue VELTOOLS-52). (ndb)</li>
+ <li>Fixed infinite loop logging problem with Tomcat 5.5 in the "simple" example webapp. (ndb)</li>
+ <li>Upgraded jars to Struts 1.2.7, Commons-Logging 1.0.4, Commons-Validator 1.1.4, Digester 1.7, Commons-Collections 3.1, Beanutils 1.7.0, Struts SSL Extension for 1.2, and Commons-Lang 2.1. (ndb)</li>
+ <li>Added VelocityStruts support for non-resource and session-scoped action messages (patch and help from Niall Pemberton. See Jira issues VELTOOLS-1 and VELTOOLS-51). (ndb)</li>
+ <li>Factored generic parsing code out of ParameterParser into new ValueParser for parsing strings pulled from any Map. (ndb)</li>
+ <li>Improved error handling/recovery in toolbox xml parsing by adding validation of tool info. (henning)</li>
+ <li>Added BrowserSnifferTool for identifying browsers and their features (contributed by Claude Brisson). This
+ depends on Java 1.4's regexp support for use. (ndb)</li>
+ <li>Added EscapeTool for commons escaping needs (contributed by Shinobu Kawai). This requires commons-lang for use. (ndb)</li>
+ <li>Added ListTool as utility for using arrays like Lists in templates (contributed by Shinobu Kawai). (ndb)</li>
<li>Added DateTool methods to provide easy access to date values (e.g. month, year, day). (ndb)</li>
<li>Converted VelocityView and VelocityStruts to use a VelocityEngine instead of the Velocity singleton.
This means only the servlets log directly to the VelocityEngine instance; the tools and other
Modified: jakarta/velocity/tools/trunk/xdocs/generic/EscapeTool.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/generic/EscapeTool.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/generic/EscapeTool.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/generic/EscapeTool.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Modified: jakarta/velocity/tools/trunk/xdocs/generic/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/generic/index.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/generic/index.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/generic/index.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -46,14 +46,34 @@
<dt><a href="../javadoc/org/apache/velocity/tools/generic/NumberTool.html"><strong>NumberTool</strong></a></dt>
<dd>A tool for formatting numbers.</dd>
+ <dt><a href="RenderTool.html"><strong>RenderTool</strong></a></dt>
+ <dd>A tool to evaluate and render arbitrary strings of VTL (Velocity
+ Template Language).</dd>
+
+ <dt><a href="EscapeTool.html"><strong>EscapeTool</strong></a></dt>
+ <dd>A tool to help with common escaping needs in Velocity templates.</dd>
+
+ <dt><a href="../javadoc/org/apache/velocity/tools/generic/Alternator.html"><strong>Alternator</strong></a>
+ and <a href="../javadoc/org/apache/velocity/tools/generic/AlternatorTool.html"><strong>AlternatorTool</strong></a></dt>
+ <dd>Utility class for easily alternating over values in a list and tool for easy creation of Alternators in templates.</dd>
+
+ <dt><a href="../javadoc/org/apache/velocity/tools/generic/ValueParser.html"><strong>ValueParser</strong></a></dt>
+ <dd>A tool to retrieve and parse String values pulled from a map. This provides
+ the basis for the <a href="../view/ParameterParser.html">ParameterParser</a> in
+ <a href="../view/index.html">VelocityView</a>.</dd>
+
+ <dt><a href="../javadoc/org/apache/velocity/tools/generic/ListTool.html"><strong>ListTool</strong></a></dt>
+ <dd>A tool to help when working with arrays or Lists. This tool transparently handles both the same way.</dd>
+
+ <dt><a href="../javadoc/org/apache/velocity/tools/generic/SortTool.html"><strong>SortTool</strong></a></dt>
+ <dd>A tool that allows a user to sort a collection (or array, iterator, etc)
+ on any arbitary set of properties exposed by the objects contained within
+ the collection.</dd>
+
<dt><a href="../javadoc/org/apache/velocity/tools/generic/IteratorTool.html"><strong>IteratorTool</strong></a></dt>
<dd>A convenience tool to use with #foreach loops. It wraps a list
to let the designer specify a condition to terminate the loop,
and reuse the same list in different loops.</dd>
-
- <dt><a href="RenderTool.html"><strong>RenderTool</strong></a></dt>
- <dd>A tool to evaluate and render arbitrary strings of VTL (Velocity
- Template Language).</dd>
</dl>
<br clear="all"/>
<strong>Utilities:</strong>
@@ -73,13 +93,13 @@
<section name="Contributions">
<p>We welcome your contributions to this library. Patches can be sent to the
mailing list or attached to a
- <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Velocity&component=Tools">bugzilla</a>
- ticket. The <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?VelocityTools">Wiki</a>
+ <a href="http://issues.apache.org/jira/browse/VELTOOLS">JIRA</a>
+ issue. The <a href="http://wiki.apache.org/jakarta-velocity/VelocityTools">Wiki</a>
can also be a good place to discuss and develop ideas.</p>
<p><strong>Checklist for Contributions</strong></p>
<ul>
- <li><a href="http://jakarta.apache.org/velocity/code-standards.html">Velocity coding conventions</a></li>
+ <li><a href="http://wiki.apache.org/jakarta-velocity/CodeStandards">Velocity coding conventions</a></li>
<li>JavaDoc included (the more detailed the better)</li>
<li>Examples included (in JavaDoc or as stand-alone template example)</li>
</ul>
Modified: jakarta/velocity/tools/trunk/xdocs/generic/menu.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/generic/menu.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/generic/menu.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/generic/menu.xml Thu Oct 20 09:42:54 2005
@@ -33,12 +33,17 @@
</menu>
<menu name="Tool Documentation">
- <item name="DateTool" href="../javadoc/org/apache/velocity/tools/generic/DateTool.html"/>
- <item name="IteratorTool" href="../javadoc/org/apache/velocity/tools/generic/IteratorTool.html"/> />
- <item name="MathTool" href="MathTool.html"/>
- <item name="NumberTool" href="../javadoc/org/apache/velocity/tools/generic/NumberTool.html"/>
- <item name="RenderTool" href="RenderTool.html"/>
- <item name="EscapeTool" href="EscapeTool.html"/>
+ <item name="DateTool" href="../javadoc/org/apache/velocity/tools/generic/DateTool.html"/>
+ <item name="MathTool" href="MathTool.html"/>
+ <item name="NumberTool" href="../javadoc/org/apache/velocity/tools/generic/NumberTool.html"/>
+ <item name="RenderTool" href="RenderTool.html"/>
+ <item name="EscapeTool" href="EscapeTool.html"/>
+ <item name="Alternator" href="../javadoc/org/apache/velocity/tools/generic/Alternator.html"/> />
+ <item name="AlternatorTool" href="../javadoc/org/apache/velocity/tools/generic/AlternatorTool.html"/> />
+ <item name="ValueParser" href="../javadoc/org/apache/velocity/tools/generic/ValueParser.html"/>
+ <item name="ListTool" href="../javadoc/org/apache/velocity/tools/generic/ListTool.html"/>
+ <item name="SortTool" href="../javadoc/org/apache/velocity/tools/generic/SortTool.html"/>
+ <item name="IteratorTool" href="../javadoc/org/apache/velocity/tools/generic/IteratorTool.html"/> />
</menu>
<menu name="Other Subprojects">
Modified: jakarta/velocity/tools/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/index.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/index.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/index.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -60,7 +60,7 @@
<subsection name="VelocityStruts" >
<p><a href="struts/">VelocityStruts</a> is a set of tools for using the
Velocity template engine as the view layer for a web application built upon the
- <a href="http://jakarta.apache.org/struts/">Jakarta Struts</a> framework.</p>
+ <a href="http://struts.apache.org/">Apache Struts</a> framework.</p>
<p>This work leverages the <strong>VelocityViewServlet</strong> and
additional tools which make it easy to integrate the Velocity with
Struts. Several example hybrid applications are included.</p>
@@ -109,9 +109,9 @@
<section name="Download">
<p><strong>Releases</strong></p>
<p>
- VelocityTools 1.1 is now available in
- <a href="http://jakarta.apache.org/site/sourceindex.cgi#velocity-tools">source</a> or
- <a href="http://jakarta.apache.org/site/binindex.cgi#velocity-tools">binary</a> form.
+ VelocityTools 1.2 is now available for
+ <a href="http://jakarta.apache.org/site/downloads/downloads_velocity-tools.cgi">download</a>
+ in source or binary form.
</p>
<br clear="all"/>
@@ -135,18 +135,18 @@
<p>Those interested in furthering the development of this project are
especially welcome to jump in and help out. Patches can be sent to the
mailing list or attached to a
- <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Velocity&component=Tools">bugzilla</a>
- ticket. The <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?VelocityTools">Wiki</a>
+ <a href="http://issues.apache.org/jira/browse/VELTOOLS">JIRA</a>
+ issue. The <a href="http://wiki.apache.org/jakarta-velocity/VelocityTools">Wiki</a>
can also be a good place to discuss and develop ideas.</p>
<p>A few good places to get started include:
<ul>
<li>Documentation (patches for the site or additions to the Wiki)</li>
<li>Improving the example apps</li>
- <li>Contributing to the <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?VelocimacroLibraries">VelocimacroLibraries</a></li>
+ <li>Contributing to the <a href="http://wiki.apache.org/jakarta-velocity/VelocimacroLibrary">VelocimacroLibrary</a></li>
</ul>
Other project goals and proposals can be found in the project
- <a href="http://svn.apache.org/viewcvs.cgi/jakarta/velocity-tools/trunk/STATUS">STATUS</a>
+ <a href="http://svn.apache.org/viewcvs.cgi/jakarta/velocity/tools/trunk/STATUS?view=markup">STATUS</a>
file.</p>
</section>
</body>
Modified: jakarta/velocity/tools/trunk/xdocs/menu.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/menu.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/menu.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/menu.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -31,7 +31,7 @@
<item name="Javadoc" href="javadoc/index.html"/>
<item name="Wiki" href="http://wiki.apache.org/jakarta-velocity/VelocityTools"/>
<item name="FAQ" href="http://wiki.apache.org/jakarta-velocity/VelocityFAQ"/>
- <item name="Report Issues" href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=Velocity&component=Tools"/>
+ <item name="Report Issues" href="http://issues.apache.org/jira/browse/VELTOOLS"/>
</menu>
<menu name="Subprojects">
Modified: jakarta/velocity/tools/trunk/xdocs/struts/ActionMessagesTool.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/struts/ActionMessagesTool.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/struts/ActionMessagesTool.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/struts/ActionMessagesTool.xml Thu Oct 20 09:42:54 2005
@@ -43,7 +43,7 @@
</ul>
<p>See the Struts User's Guide, section
- <a href="http://jakarta.apache.org/struts/userGuide/building_view.html">Building View Components</a>
+ <a href="http://struts.apache.org/struts-doc-1.2.7/userGuide/building_view.html">Building View Components</a>
for more information on this topic.</p>
<toolinfo>
Modified: jakarta/velocity/tools/trunk/xdocs/struts/ErrorsTool.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/struts/ErrorsTool.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/struts/ErrorsTool.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/struts/ErrorsTool.xml Thu Oct 20 09:42:54 2005
@@ -14,7 +14,7 @@
See the License for the specific language governing permissions and
limitations under the License.
- $Id: ErrorsTool.xml,v 1.6 2004/11/11 00:57:40 nbubna Exp $
+ $Id$
-->
<document>
@@ -47,7 +47,7 @@
</ul>
<p>See the Struts User's Guide, section
- <a href="http://jakarta.apache.org/struts/userGuide/building_view.html">Building View Components</a>
+ <a href="http://struts.apache.org/struts-doc-1.2.7/userGuide/building_view.html">Building View Components</a>
for more information on this topic.</p>
<toolinfo>
Modified: jakarta/velocity/tools/trunk/xdocs/struts/FormTool.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/struts/FormTool.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/struts/FormTool.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/struts/FormTool.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
See the License for the specific language governing permissions and
limitations under the License.
- $Id: FormTool.xml,v 1.2 2004/02/18 20:22:36 nbubna Exp $
+ $Id$
-->
<document>
@@ -105,7 +105,7 @@
</abstract>
<signature>
- int getCancelName()
+ String getCancelName()
</signature>
<returns>
@@ -131,6 +131,25 @@
value="Cancel"></sourcecode>
</description>
+
+ </method>
+ </section>
+
+ <section name="getName()">
+ <method name="getName()">
+
+ <abstract>
+ Returns the form bean name associated with this action mapping.
+ </abstract>
+
+ <signature>
+ String getName()
+ </signature>
+
+ <returns>
+ The name of the ActionForm associated with this request or
+ <code>null</code> if there is no form bean associated with this mapping.
+ </returns>
</method>
</section>
Modified: jakarta/velocity/tools/trunk/xdocs/struts/MessageTool.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/struts/MessageTool.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/struts/MessageTool.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/struts/MessageTool.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
See the License for the specific language governing permissions and
limitations under the License.
- $Id: MessageTool.xml,v 1.4 2004/02/18 20:22:36 nbubna Exp $
+ $Id$
-->
<document>
@@ -58,7 +58,7 @@
</abstract>
<signature>
- String get(String key)
+ TextKey get(String key)
</signature>
<signature>
@@ -114,21 +114,26 @@
message. The third, fourth, fifth and sixth signatures take a list
of up to five replacement parameters. The third and fourth signatures
are provided for compatibility with existing applications. The fifth and
- sixth signatures are Velocity-friendlier.</p>
+ sixth signatures are more Velocity friendly.</p>
<p>Assuming that the message resource files contain the following messages:</p>
<sourcecode>title=Welcome to Velocity for Struts
-test=This message has five replacement parameters: {0}, {1}, {2}, {3}, {4}</sourcecode>
+test=This message has five replacement parameters: {0}, {1}, {2}, {3}, {4}
+label.one=foobar
+label.two=woogie!</sourcecode>
<p>then the following Velocity script:</p>
-<sourcecode>$text.get("title")
-$text.title
-$text.get("test", ["bear", "wolf", "tiger"])</sourcecode>
+<sourcecode>$text.title
+$text.get('test', ['bear', 'wolf', 'tiger'])
+$text.label.one
+$text.label.two</sourcecode>
<p>produces this output:</p>
<sourcecode>Welcome to Velocity for Struts
Welcome to Velocity for Struts
-This message has five replacement parameters: bear, wolf, tiger, {3}, {4}</sourcecode>
+This message has five replacement parameters: bear, wolf, tiger, {3}, {4}
+foobar
+woogie!</sourcecode>
</description>
</method>
@@ -171,42 +176,6 @@
</method>
</section>
-
- <section name="getLocale()">
- <method name="getLocale()">
-
- <abstract>
- Returns the user's locale. If a locale is not found, the default
- locale is returned (deprecated - will be removed in VelocityTools 1.2).
- </abstract>
-
- <signature>
- Locale getLocale()
- </signature>
-
- <returns>
- An instance of class <code>java.util.Locale</code>.
- </returns>
-
- <description>
-<sourcecode>$text.getLocale()
-$text.locale
-$text.getLocale().getDisplayLanguage()</sourcecode>
-
-<p>produces:</p>
-<sourcecode>en
-en
-English</sourcecode>
-
-<p>The returned object of class <code>Locale</code> is automatically rendered by Velocity by
-calling its <code>toString()</code> method. The third example calls method
-<code>getDisplayLanguage()</code> of class <code>Locale</code></p>
-
- </description>
-
- </method>
- </section>
-
</body>
</document>
Modified: jakarta/velocity/tools/trunk/xdocs/struts/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/struts/index.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/struts/index.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/struts/index.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version= "1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -31,12 +31,12 @@
<section name="Overview">
<p>The VelocityStruts sub-project integrates Velocity with the
- <a href="http://jakarta.apache.org/struts/">Jakarta Struts</a>
- Web application framework and enables the use of velocity templates
+ <a href="http://struts.apache.org/">Apache Struts</a>
+ web application framework and enables the use of Velocity templates
interchangeably with JSP pages for the view layer.</p>
<p>Various other
- <a href="http://jakarta.apache.org/velocity/powered.html#Frameworks%20that%20support%20Velocity">web application frameworks</a>
+ <a href="http://wiki.apache.org/jakarta-velocity/PoweredByVelocity">web application frameworks</a>
offer built-in support for Velocity templates. This project
provides the minimal glue necessary to give Struts developers
an alternative to JSP. </p>
@@ -130,7 +130,7 @@
Struts than another other presentation technology, bar none. In fact,
most of the tools work just as well with any other framework you might
care to name.</i>"
- --<a href="http://nagoya.apache.org/eyebrowse/ReadMsg?listName=velocity-user@jakarta.apache.org&msgNo=11255">Ted Husted</a>
+ --<a href="http://marc.theaimsgroup.com/?l=velocity-user&m=106520662105461&w=25">Ted Husted</a>
(author of <a href="http://husted.com/struts/book.html">Struts in Action</a>)</p>
</blockquote>
</p>
@@ -138,7 +138,7 @@
<section name="License">
<p>This software is licensed under the
- <a href="http://jakarta.apache.org/velocity/license.html">Apache Software License</a></p>
+ <a href="http://jakarta.apache.org/velocity/license.html">Apache Software License 2.0</a></p>
</section>
</body>
Modified: jakarta/velocity/tools/trunk/xdocs/struts/menu.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/struts/menu.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/struts/menu.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/struts/menu.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Modified: jakarta/velocity/tools/trunk/xdocs/struts/userguide.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/struts/userguide.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/struts/userguide.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/struts/userguide.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
See the License for the specific language governing permissions and
limitations under the License.
- $Id: userguide.xml,v 1.7 2004/11/10 20:23:32 nbubna Exp $
+ $Id$
-->
<document>
@@ -493,6 +493,7 @@
<sourcecode>
title=Struts Example Application
test=This string has 4 replacement parameters: {1}, {2}, {3}, {4}
+foo.bar=whatever
</sourcecode>
<p>Then, the following script...</p>
@@ -501,6 +502,7 @@
$text.title
$text.get('test', ['bear', 'dog', 'cat'])
$text.exists('tutle')
+$text.foo.bar
</sourcecode>
<p>..will produce this output:</p>
@@ -509,6 +511,7 @@
Struts Example Application
This string has 4 replacement parameters: bear, dog, cat, {4}
false
+whatever
</sourcecode>
<p>Please see the <a href="StrutsTools.html">Tool Reference Documentation</a>
Modified: jakarta/velocity/tools/trunk/xdocs/view/ParameterParser.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/view/ParameterParser.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/view/ParameterParser.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/view/ParameterParser.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
See the License for the specific language governing permissions and
limitations under the License.
- $Id: ParameterParser.xml,v 1.2 2004/02/18 20:21:49 nbubna Exp $
+ $Id$
-->
<document>
@@ -287,6 +287,37 @@
A array of Strings that represent all the values of the desired
request parameter or <code>null</code> if the parameter does not
exist.
+ </returns>
+
+ </method>
+ </section>
+
+
+
+
+ <section name="getBooleans()">
+ <method name="getBooleans()">
+
+ <abstract>
+ Returns an array of Booleans of all the values of the specified servlet
+ request parameter
+ </abstract>
+
+ <signature>
+ Boolean[] getBooleans(String key)
+ </signature>
+
+ <parameters>
+ <parameter name="key">
+ The key of the desired string parameter
+ </parameter>
+
+ </parameters>
+
+ <returns>
+ A array of <code>java.lang.Boolean</code> that represent all the
+ values of the desired request parameter or <code>null</code> if
+ the parameter does not exist.
</returns>
</method>
Modified: jakarta/velocity/tools/trunk/xdocs/view/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/view/index.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/view/index.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/view/index.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
See the License for the specific language governing permissions and
limitations under the License.
- $Id: index.xml,v 1.6 2004/02/18 20:21:49 nbubna Exp $
+ $Id$
-->
<document>
<properties>
@@ -30,7 +30,7 @@
<section name="Overview">
<p>VelocityView provides support for rapidly and cleanly building web applications
using Velocity templates as the view layer. The project is designed with the
- <a href="http://jakarta.apache.org/turbine/turbine-2.3/pullmodel.html">Pull-MVC Model</a>
+ <a href="http://jakarta.apache.org/turbine/further-reading/pullmodel.html">Pull-MVC Model</a>
in mind and works well in conjunction with web application frameworks that act
as the controller (e.g. <a href="../struts/index.html">Struts</a>), but can be used
quite effectively on its own for those creating simpler applications.
@@ -164,6 +164,7 @@
<toolbox>
<tool>
<key>wrench</key>
+ <scope>application</scope>
<class>PipeWrench</class>
</tool>
</toolbox></sourcecode>
@@ -215,6 +216,29 @@
<br clear="all"/>
+ <p><b>Tool Parameters</b></p>
+
+ <p>The toolbox support built into the VelocityViewServlet also provides
+ support for passing configuration parameters to tools that implement
+ the <a href="../javadoc/org/apache/velocity/tools/view/tools/Configurable.html">Configurable</a>
+ interface. This interface consists of only a
+ <code>void configure(java.util.Map params)</code> method which will only be called
+ if parameters have been specified for the tool.</p>
+
+ <p>You can specify parameters for your tools by adding a <parameter>
+ element to your toolbox.xml entries like this:</p>
+
+ <sourcecode><tool>
+ <key>math</key>
+ <scope>application</scope>
+ <class>com.foo.tools.MyTool</class>
+ <parameter name="my.parameter.name" value="my.parameter.value"/>
+</tool></sourcecode>
+
+ <br clear="all"/>
+
+ <p><b>Toolbox Data</b></p>
+
<p>In addition to specifiying arbitrary Java classes as <b>tools</b>
to be automatically available to your templates, the toolbox support
also includes the ability to specify arbitrary strings, booleans, and
@@ -247,10 +271,9 @@
<section name="VelocityLayoutServlet">
<p>One derivative of the VelocityViewServlet is the
- <a href="layoutservlet.html"><strong>VelocityLayoutServlet</strong></a>
- written by Nathan Bubna. 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.</p>
+ <a href="layoutservlet.html"><strong>VelocityLayoutServlet</strong></a>.
+ 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.</p>
<p>The Struts "template" tag library does something similar,
but requires a separate file to define which 'layout' file to use and
@@ -274,7 +297,7 @@
<p>A simple application example has been included to demonstrate the use
of the VelocityViewServlet with automatically loaded view tools.</p>
- <p>To run the examples you need Tomcat 4.X (note: Tomcat 3.x may work)
+ <p>To run the examples you need Tomcat 4.x, Tomcat 5.0.x, Tomcat 5.5.x,
or a compatible servlet runner.</p>
<p>The build process automatically generates a ready-to-deploy <b>simple.war</b>
Modified: jakarta/velocity/tools/trunk/xdocs/view/menu.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/tools/trunk/xdocs/view/menu.xml?rev=326941&r1=326940&r2=326941&view=diff
==============================================================================
--- jakarta/velocity/tools/trunk/xdocs/view/menu.xml (original)
+++ jakarta/velocity/tools/trunk/xdocs/view/menu.xml Thu Oct 20 09:42:54 2005
@@ -1,6 +1,6 @@
<?xml version="1.0"?>
<!--
- Copyright 2003-2004 The Apache Software Foundation.
+ Copyright 2003-2005 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
See the License for the specific language governing permissions and
limitations under the License.
- $Id: menu.xml,v 1.6 2004/02/18 20:21:49 nbubna Exp $
+ $Id$
-->
<project href="index.html">
@@ -34,7 +34,9 @@
</menu>
<menu name="VelocityView Tools">
+ <item name="AbstractPagerTool" href="../javadoc/org/apache/velocity/tools/view/tools/AbstractPagerTool.html"/>
<item name="AbstractSearchTool" href="../javadoc/org/apache/velocity/tools/view/tools/AbstractSearchTool.html"/>
+ <item name="BrowserSnifferTool" href="../javadoc/org/apache/velocity/tools/view/tools/BrowserSnifferTool.html"/>
<item name="CookieTool" href="CookieTool.html"/>
<item name="ImportTool" href="ImportTool.html"/>
<item name="LinkTool" href="LinkTool.html"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org