You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@velocity.apache.org by ge...@apache.org on 2001/09/13 21:09:19 UTC
cvs commit: jakarta-velocity/docs/ymtd ymtd-changes.html ymtd-conclusion.html ymtd-embedded.html ymtd-error-handling.html ymtd-generation.html ymtd-hosting.html ymtd-implementation.html ymtd-javabeans.html ymtd-sampleapp.html ymtd-saying-hello.html ymtd-taglibs.html ymtd.html
geirm 01/09/13 12:09:19
Modified: docs anakia.html casestudy1.html changes.html
code-standards.html contributors.html design.html
developer-guide.html devtools.html differences.html
getting-started.html index.html install.html
license.html migration.html powered.html
specification-ast.html specification-bnf.html
specification.html texen.html todo.html
user-guide.html veltag.html
vtl-reference-guide.html
docs/ymtd ymtd-changes.html ymtd-conclusion.html
ymtd-embedded.html ymtd-error-handling.html
ymtd-generation.html ymtd-hosting.html
ymtd-implementation.html ymtd-javabeans.html
ymtd-sampleapp.html ymtd-saying-hello.html
ymtd-taglibs.html ymtd.html
Added: docs casestudy2.html
Log:
follows changes to xml
Revision Changes Path
1.27 +3 -1 jakarta-velocity/docs/anakia.html
Index: anakia.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/anakia.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- anakia.html 2001/08/14 02:40:22 1.26
+++ anakia.html 2001/09/13 19:09:17 1.27
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.5 +3 -1 jakarta-velocity/docs/casestudy1.html
Index: casestudy1.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/casestudy1.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- casestudy1.html 2001/08/14 02:40:22 1.4
+++ casestudy1.html 2001/09/13 19:09:17 1.5
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.57 +3 -1 jakarta-velocity/docs/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/changes.html,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -r1.56 -r1.57
--- changes.html 2001/09/10 10:46:38 1.56
+++ changes.html 2001/09/13 19:09:17 1.57
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.32 +3 -1 jakarta-velocity/docs/code-standards.html
Index: code-standards.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/code-standards.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- code-standards.html 2001/08/14 02:40:22 1.31
+++ code-standards.html 2001/09/13 19:09:17 1.32
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.35 +3 -1 jakarta-velocity/docs/contributors.html
Index: contributors.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/contributors.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- contributors.html 2001/08/15 17:57:49 1.34
+++ contributors.html 2001/09/13 19:09:17 1.35
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.31 +3 -1 jakarta-velocity/docs/design.html
Index: design.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/design.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- design.html 2001/08/14 02:40:22 1.30
+++ design.html 2001/09/13 19:09:17 1.31
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.73 +22 -2 jakarta-velocity/docs/developer-guide.html
Index: developer-guide.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/developer-guide.html,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -r1.72 -r1.73
--- developer-guide.html 2001/08/20 12:29:09 1.72
+++ developer-guide.html 2001/09/13 19:09:17 1.73
@@ -92,8 +92,10 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
+</li>
</ul>
<p><strong>Tools</strong></p>
<ul>
@@ -571,7 +573,8 @@
</p>
<p>
This is the legacy pattern, where there is only one instance of the Velocity
- engine in the JVM that is shared by all. This is very convenient as it
+ engine in the JVM (or web application, depending) that is shared by all.
+ This is very convenient as it
allows localized configuration and sharing of resources. For example, this
is a very appropriate model for use in a Servlet 2.2+ compliant web application
as each web application can have it's own instance of Velocity, allowing
@@ -660,6 +663,23 @@
As you can see, this is very simple and straightforward. Except for some simple
syntax changes, using Velocity as a singleton or as separate instances requires
no changes to the high-level structure of your application or templates.
+</p>
+ <p>
+As a programmer, the classes you should use to interact with the Velocity
+internals are the <code>org.apache.velocity.app.Velocity</code> class if
+using the Singlton model, or <code>org.apache.velocity.app.VelocityEngine</code>
+if using the non-singleton model ('separate instance').
+</p>
+ <p>
+At no time should an application use the internal <code>Runtime, RuntimeConstants,
+RuntimeSingleton or RuntimeInstance</code> classes in the
+<code>org.apache.velocity.runtime</code> package, as these are intended for
+internal use only and may change over time. As mentioned above,
+the classes you should use
+are located in the <code>org.apache.velocity.app</code> package, and are the
+<code>Velocity</code> and <code>VelocityEngine</code> classes. If anything is
+missing or needed from those classes, do not hesitate to suggest changes - these
+classes are intended for the application developer.
</p>
</blockquote>
</p>
1.5 +3 -1 jakarta-velocity/docs/devtools.html
Index: devtools.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/devtools.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- devtools.html 2001/08/28 10:39:15 1.4
+++ devtools.html 2001/09/13 19:09:17 1.5
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.19 +3 -1 jakarta-velocity/docs/differences.html
Index: differences.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/differences.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- differences.html 2001/08/14 02:40:22 1.18
+++ differences.html 2001/09/13 19:09:17 1.19
@@ -94,7 +94,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.35 +3 -1 jakarta-velocity/docs/getting-started.html
Index: getting-started.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/getting-started.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- getting-started.html 2001/08/14 02:40:22 1.34
+++ getting-started.html 2001/09/13 19:09:17 1.35
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.52 +3 -1 jakarta-velocity/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/index.html,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -r1.51 -r1.52
--- index.html 2001/08/14 15:05:47 1.51
+++ index.html 2001/09/13 19:09:17 1.52
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.37 +3 -1 jakarta-velocity/docs/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/install.html,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- install.html 2001/08/14 02:40:22 1.36
+++ install.html 2001/09/13 19:09:17 1.37
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.34 +3 -1 jakarta-velocity/docs/license.html
Index: license.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/license.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- license.html 2001/08/14 16:40:19 1.33
+++ license.html 2001/09/13 19:09:17 1.34
@@ -93,7 +93,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.28 +3 -1 jakarta-velocity/docs/migration.html
Index: migration.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/migration.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- migration.html 2001/08/14 02:40:22 1.27
+++ migration.html 2001/09/13 19:09:17 1.28
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.12 +3 -1 jakarta-velocity/docs/powered.html
Index: powered.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/powered.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- powered.html 2001/08/14 22:43:20 1.11
+++ powered.html 2001/09/13 19:09:17 1.12
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.13 +3 -1 jakarta-velocity/docs/specification-ast.html
Index: specification-ast.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/specification-ast.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- specification-ast.html 2001/08/14 02:40:22 1.12
+++ specification-ast.html 2001/09/13 19:09:17 1.13
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.13 +3 -1 jakarta-velocity/docs/specification-bnf.html
Index: specification-bnf.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/specification-bnf.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- specification-bnf.html 2001/08/14 02:40:22 1.12
+++ specification-bnf.html 2001/09/13 19:09:17 1.13
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.13 +3 -1 jakarta-velocity/docs/specification.html
Index: specification.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/specification.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- specification.html 2001/08/14 02:40:22 1.12
+++ specification.html 2001/09/13 19:09:17 1.13
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.25 +3 -1 jakarta-velocity/docs/texen.html
Index: texen.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/texen.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- texen.html 2001/08/14 02:40:22 1.24
+++ texen.html 2001/09/13 19:09:17 1.25
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.31 +3 -1 jakarta-velocity/docs/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/todo.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- todo.html 2001/08/14 02:40:22 1.30
+++ todo.html 2001/09/13 19:09:17 1.31
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.48 +3 -1 jakarta-velocity/docs/user-guide.html
Index: user-guide.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/user-guide.html,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- user-guide.html 2001/08/14 02:40:22 1.47
+++ user-guide.html 2001/09/13 19:09:17 1.48
@@ -94,7 +94,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.7 +3 -1 jakarta-velocity/docs/veltag.html
Index: veltag.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/veltag.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- veltag.html 2001/08/15 17:57:49 1.6
+++ veltag.html 2001/09/13 19:09:17 1.7
@@ -92,7 +92,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.38 +3 -1 jakarta-velocity/docs/vtl-reference-guide.html
Index: vtl-reference-guide.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/vtl-reference-guide.html,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- vtl-reference-guide.html 2001/08/14 02:40:22 1.37
+++ vtl-reference-guide.html 2001/09/13 19:09:17 1.38
@@ -94,7 +94,9 @@
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
- <li> <a href="./casestudy1.html">Case Study 1</a>
+ <li> <a href="./casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.1 jakarta-velocity/docs/casestudy2.html
Index: casestudy2.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Velocity Documentation Team">
<meta name="email" value="geirm@apache.org">
<title>Velocity - Case Study: XMLC vs. Velocity</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/velocity/"><img src="./images/logo.gif" alt="Velocity" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td width="20%" valign="top" nowrap="true">
<p><strong>About</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./getting-started.html">Getting Started</a>
</li>
<li> <a href="http://jakarta.apache.org/builds/jakarta-velocity/">Download</a>
</li>
<li> <a href="./install.html">Install</a>
</li>
<li> <a href="./design.html">Design</a>
</li>
<li> <a href="./contributors.html">Contributors</a>
</li>
<li> <a href="./changes.html">ChangeLog</a>
</li>
<li> <a href="./code-standards.html">Coding Standards</a>
</li>
<li> <a href="./license.html">License</a>
</li>
<li> <a href="./todo.html">TODO</a>
</li>
<li> <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Velocity">Report Issues</a>
</li>
</ul>
<p><strong>Community</strong></p>
<ul>
<li> <a href="./powered.html">Powered By Velocity</a>
</li>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
</ul>
<p><strong>Docs</strong></p>
<ul>
<li> <a href="./user-guide.html">User's Guide</a>
</li>
<li> <a href="./developer-guide.html">Developer's Guide</a>
</li>
<li> <a href="./vtl-reference-guide.html">VTL Reference Guide</a>
</li>
<li> <a href="./specification.html">Specification</a>
</li>
<li> <a href="./api/index.html">Javadoc</a>
</li>
</ul>
<p><strong>Comparisons</strong></p>
<ul>
<li> <a href="./ymtd/ymtd.html">YMTD</a>
</li>
<li> <a href="./differences.html">VM/WM Differences</a>
</li>
<li> <a href="./casestudy1.html">JSP vs. Velocity</a>
</li>
<li> <a href="./casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
<ul>
<li> <a href="./anakia.html">Anakia</a>
</li>
<li> <a href="./texen.html">Texen</a>
</li>
<li> <a href="./migration.html">Migration to Velocity</a>
</li>
<li> <a href="./devtools.html">Editors and IDEs</a>
</li>
<li> <a href="./veltag.html">IT Manager wants JSP?</a>
</li>
</ul>
</td>
<td width="80%" align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Case Study: XMLC vs. Velocity"><strong>Case Study: XMLC vs. Velocity</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
A while ago, a question was asked on a Jakarta Tomcat mailing list about
XMLC and Velocity. Bojan Smojver <bojan@binarix.com> gave this thoughtful
reply, and gave us permission to present it here on the Velocity site.
</p>
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#ffffff"><pre>
I found this in the tutorial for XMLC:
------------------
XMLC is a Java-based compiler that takes a document written in the
Hypertext Markup Language (HTML) or the eXtensible Markup Language (XML)
and creates Java classes that will faithfully recreate the document. The
resulting Java classes can be used to insert dynamic content into the
document framework at run time. XMLC, therefore, is a wonderful way to
create dynamic HTML or XML documents from Java.
------------------
This sounds awfully like JSP to me, which is reason #1 why someone would
use Velocity.
Although I use Velocity for my web work, Velocity is a generic template
engine, it doesn't really care about the rest of the content. And that's
great!
I use XSLT (sorry Jon, promise to give Anakia another look :-) to
prepare my documents from XML into XHTML (this is not done at run time,
not like Cocoon) and Velocity doesn't get upset much by that (except for
the fact that you can't have '&&' (VTL and) in XSLT without applying a
few tricks) but I've overcome that through Ant's nice replacement
techniques...
Anyway, the first bad point to XMLC goes for the pains of code
generation, which Velocity avoids so neatly.
The second is the actual process of designing the complete solution
which is pictured here:
http://xmlc.enhydra.org/project/aboutProject/index.html
Designer designs the page and then engineer puts in the logic? This
sounds very bad to me. There should be a 'box full of Lego's' designers
can choose their functionality from, not the other way around. If
engineers have to be involved in simple projects, it comes back to
employing engineers to do everything in the first place. And why
wouldn't you use even JSP or ECS in such a case? You're are mucking
around with Java again... The XMLC cycle is just too long and it doesn't
make sense at all - what happens when a designer (by mistake or
intentionally) screws up the id's in the page? All of the engineers code
becomes unusable. Now that's a nice separation between presentation and
functionality!
Second bad point.
An example from my 'production line', which illustrates how Velocity
handles the above. I have a few classes that handle all inquiry forms:
one class handles the fields from the form and stores those into a
database, the other one picks the fields and mails them to designated
e-mail address. These classes are beans and are loaded from the only
servlet I ever use (licensed GPL, but could contain any number of bugs
since I wrote it), which handles ALL Velocity pages: 331 lines long
including comments. Beans have scope and all, just like with JSP's.
Once the first ever form is created and debugged, an imaginary web
designer on my 'production line' would copy and existing Velocity page
from a previous project, change the fields (their names, their number...
whatever) in it and the other content. Once they post the page on the
site, that's it. It just works. They didn't even have to talk to an
engineer to get things done. Now that's MUCH better then XMLC!
I think the biggest problem XMLC, JSP and servlets are facing is more of
a philosophical nature: the document is data, not code - and Velocity
treats it exactly like that. Why would you convert your HTML into a Java
class when you want to send it to the browser as text?
My 2 cents. Velocity rocks!
Bojan
</pre></td>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
</table>
</div>
</blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
1.18 +3 -1 jakarta-velocity/docs/ymtd/ymtd-changes.html
Index: ymtd-changes.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-changes.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- ymtd-changes.html 2001/08/14 02:40:23 1.17
+++ ymtd-changes.html 2001/09/13 19:09:18 1.18
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.17 +3 -1 jakarta-velocity/docs/ymtd/ymtd-conclusion.html
Index: ymtd-conclusion.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-conclusion.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- ymtd-conclusion.html 2001/08/14 02:40:23 1.16
+++ ymtd-conclusion.html 2001/09/13 19:09:18 1.17
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.16 +3 -1 jakarta-velocity/docs/ymtd/ymtd-embedded.html
Index: ymtd-embedded.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-embedded.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- ymtd-embedded.html 2001/08/14 02:40:23 1.15
+++ ymtd-embedded.html 2001/09/13 19:09:19 1.16
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.17 +3 -1 jakarta-velocity/docs/ymtd/ymtd-error-handling.html
Index: ymtd-error-handling.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-error-handling.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- ymtd-error-handling.html 2001/08/14 02:40:23 1.16
+++ ymtd-error-handling.html 2001/09/13 19:09:19 1.17
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.17 +3 -1 jakarta-velocity/docs/ymtd/ymtd-generation.html
Index: ymtd-generation.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-generation.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- ymtd-generation.html 2001/08/14 02:40:23 1.16
+++ ymtd-generation.html 2001/09/13 19:09:19 1.17
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.16 +3 -1 jakarta-velocity/docs/ymtd/ymtd-hosting.html
Index: ymtd-hosting.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-hosting.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- ymtd-hosting.html 2001/08/14 02:40:23 1.15
+++ ymtd-hosting.html 2001/09/13 19:09:19 1.16
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.19 +3 -1 jakarta-velocity/docs/ymtd/ymtd-implementation.html
Index: ymtd-implementation.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-implementation.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- ymtd-implementation.html 2001/08/14 02:40:23 1.18
+++ ymtd-implementation.html 2001/09/13 19:09:19 1.19
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.18 +3 -1 jakarta-velocity/docs/ymtd/ymtd-javabeans.html
Index: ymtd-javabeans.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-javabeans.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- ymtd-javabeans.html 2001/08/14 02:40:23 1.17
+++ ymtd-javabeans.html 2001/09/13 19:09:19 1.18
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.19 +3 -1 jakarta-velocity/docs/ymtd/ymtd-sampleapp.html
Index: ymtd-sampleapp.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-sampleapp.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- ymtd-sampleapp.html 2001/08/14 02:40:23 1.18
+++ ymtd-sampleapp.html 2001/09/13 19:09:19 1.19
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.19 +3 -1 jakarta-velocity/docs/ymtd/ymtd-saying-hello.html
Index: ymtd-saying-hello.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-saying-hello.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- ymtd-saying-hello.html 2001/08/14 02:40:23 1.18
+++ ymtd-saying-hello.html 2001/09/13 19:09:19 1.19
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.19 +3 -1 jakarta-velocity/docs/ymtd/ymtd-taglibs.html
Index: ymtd-taglibs.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd-taglibs.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- ymtd-taglibs.html 2001/08/14 02:40:23 1.18
+++ ymtd-taglibs.html 2001/09/13 19:09:19 1.19
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>
1.18 +3 -1 jakarta-velocity/docs/ymtd/ymtd.html
Index: ymtd.html
===================================================================
RCS file: /home/cvs/jakarta-velocity/docs/ymtd/ymtd.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- ymtd.html 2001/08/14 02:40:23 1.17
+++ ymtd.html 2001/09/13 19:09:19 1.18
@@ -92,7 +92,9 @@
</li>
<li> <a href="../differences.html">VM/WM Differences</a>
</li>
- <li> <a href="../casestudy1.html">Case Study 1</a>
+ <li> <a href="../casestudy1.html">JSP vs. Velocity</a>
+</li>
+ <li> <a href="../casestudy2.html">XMLC vs. Velocity</a>
</li>
</ul>
<p><strong>Tools</strong></p>