engine/devel/webapps.html - velocity-site - Git at Google

 <!DOCTYPE html>
 <!--
     Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information
     regarding copyright ownership.  The ASF licenses this file
     to you under the Apache License, Version 2.0 (the
     "License"); you may not use this file except in compliance
     with the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.
   -->
 <html lang="en">
   <head>
     <title>Apache Velocity Engine - Webapps Integration</title>

     <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
     <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />

     <link rel="stylesheet" type="text/css" href="/css/site.css">


   </head>

   <body>
     <div id="page">
       <div id="header">

         <div id="logo2"><img src="/engine/devel/images/velocity-logo.png"/></div>

         <a href="/">
 <svg height="60" width="50%" viewBox="20 20 800 110" preserveAspectRatio="xMinYMin">
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="1395.619" x2="-4570.1162" y1="697.55487" x1="-5167.0962" gradientUnits="userSpaceOnUse" id="SVGID_1_">
     <stop id="stop3521" style="stop-color:#F69923" offset="0" />
     <stop id="stop3523" style="stop-color:#F79A23" offset="0.3123" />
     <stop id="stop3525" style="stop-color:#E97826" offset="0.8383" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="620.50482" x2="-5326.209" y1="620.50482" x1="-9585.3418" gradientUnits="userSpaceOnUse" id="SVGID_2_">
     <stop id="stop3546" style="stop-color:#9E2064" offset="0.3233" />
     <stop id="stop3548" style="stop-color:#C92037" offset="0.6302" />
     <stop id="stop3550" style="stop-color:#CD2335" offset="0.7514" />
     <stop id="stop3552" style="stop-color:#E97826" offset="1" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="1047.6898" x2="-6533.1782" y1="1047.6898" x1="-9071.207" gradientUnits="userSpaceOnUse" id="SVGID_3_">
     <stop id="stop3557" style="stop-color:#282662" offset="0" />
     <stop id="stop3559" style="stop-color:#662E8D" offset="9.548390e-02" />
     <stop id="stop3561" style="stop-color:#9F2064" 1  offset="0.7882" />
     <stop id="stop3563" style="stop-color:#CD2032" offset="0.9487" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="580.81702" x2="-5086.9941" y1="580.81702" x1="-9346.126" gradientUnits="userSpaceOnUse" id="SVGID_4_">
     <stop id="stop3568" style="stop-color:#9E2064" offset="0.3233" />
     <stop id="stop3570" style="stop-color:#C92037" offset="0.6302" />
     <stop id="stop3572" style="stop-color:#CD2335" offset="0.7514" />
     <stop id="stop3574" style="stop-color:#E97826" offset="1" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="638.4408" x2="-6797.2012" y1="638.4408" x1="-9035.5029" gradientUnits="userSpaceOnUse" id="SVGID_5_">
     <stop id="stop3579" style="stop-color:#282662" offset="0" />
     <stop id="stop3581" style="stop-color:#662E8D" offset="9.548390e-02" />
     <stop id="stop3583" style="stop-color:#9F2064" offset="0.7882" />
     <stop id="stop3585" style="stop-color:#CD2032" offset="0.9487" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="1021.6218" x2="-5086.9941" y1="1021.6218" x1="-9346.126" gradientUnits="userSpaceOnUse" id="SVGID_6_">
     <stop id="stop3590" style="stop-color:#9E2064" offset="0.3233" />
     <stop id="stop3592" style="stop-color:#C92037" offset="0.6302" />
     <stop id="stop3594" style="stop-color:#CD2335" offset="0.7514" />
     <stop id="stop3596" style="stop-color:#E97826" offset="1" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="999.73297" x2="-5351.2017" y1="999.73297" x1="-9610.334" gradientUnits="userSpaceOnUse" id="SVGID_7_">
     <stop id="stop3601" style="stop-color:#9E2064" offset="0.3233" />
     <stop id="stop3603" style="stop-color:#C92037" offset="0.6302" />
     <stop id="stop3605" style="stop-color:#CD2335" offset="0.7514" />
     <stop id="stop3607" style="stop-color:#E97826" offset="1" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="1152.7261" x2="-5086.9941" y1="1152.7261" x1="-9346.126" gradientUnits="userSpaceOnUse" id="SVGID_8_">
     <stop id="stop3616" style="stop-color:#9E2064" offset="0.3233" />
     <stop id="stop3618" style="stop-color:#C92037" offset="0.6302" />
     <stop id="stop3620" style="stop-color:#CD2335" offset="0.7514" />
     <stop id="stop3622" style="stop-color:#E97826" offset="1" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="1137.7247" x2="-5086.9941" y1="1137.7247" x1="-9346.126" gradientUnits="userSpaceOnUse" id="SVGID_9_">
     <stop id="stop3631" style="stop-color:#9E2064" offset="0.3233" />
     <stop id="stop3633" style="stop-color:#C92037" offset="0.6302" />
     <stop id="stop3635" style="stop-color:#CD2335" offset="0.7514" />
     <stop id="stop3637" style="stop-color:#E97826" offset="1" />
   </linearGradient>
   <linearGradient gradientTransform="matrix(0.07810935,0.01915457,0.02093045,-0.07148201,452.38809,497.7395)" y2="1134.7161" x2="-6011.9995" y1="1134.7161" x1="-6953.4072" gradientUnits="userSpaceOnUse" id="SVGID_10_">
     <stop id="stop3646" style="stop-color:#9E2064" offset="0.3233" />
     <stop id="stop3648" style="stop-color:#C92037" offset="0.6302" />
     <stop id="stop3650" style="stop-color:#CD2335" offset="0.7514" />
     <stop id="stop3652" style="stop-color:#E97826" offset="1" />
   </linearGradient>
   <g transform="translate(275,-230)" id="g3735">
     <path d="m 95.030525,353.34688 c -5.868388,1.89866 -18.455097,2.86966 -35.232972,2.68962 l -7.844759,-17.69411 c 11.922072,0.96277 23.155947,1.27149 33.446456,0.7785 0.806681,-0.0278 1.205437,-0.0597 1.205437,-0.0597 -0.39975,0.0215 -0.805689,0.0382 -1.205437,0.0597 -3.380984,0.11837 -13.97859,0.22097 -32.909158,-1.88263 6.824373,-6.72909 18.288583,-16.31958 28.008861,-23.85834 18.433387,9.69185 21.017957,20.51606 21.017957,20.51606 0,0 5.61321,15.54576 -6.486385,19.4509 z" id="path3527" style="fill:url(#SVGID_1_)" />
     <path d="m 3.8322454,303.07135 c 0.059217,-0.0415 0.1120778,-0.0878 0.1712971,-0.12929 l -1.0221478,0.89604 c -0.088131,0.0386 -0.1658908,0.0658 -0.2478563,0.10915 0.3676459,-0.29732 0.7362578,-0.58424 1.098707,-0.8759 z" id="path3529" style="fill:none" />
     <path d="m -27.876072,290.63399 c -0.650899,0.45658 -1.281214,0.94828 -1.904317,1.45519 0.623103,-0.50691 1.259608,-0.99386 1.904317,-1.45519 z" id="path3531" style="fill:none" />
     <path d="m -128.18492,294.56272 c 0.27819,0.088 0.55639,0.17608 0.82938,0.26978 5.73136,1.8314 11.32321,3.58465 16.79937,5.26839 6.14427,1.88764 12.119072,3.68379 17.941982,5.39228 6.136306,1.80423 12.096924,3.5122 17.888098,5.1287 6.074555,1.69886 11.961044,3.29193 17.65531,4.79537 4.634037,1.22062 9.141965,2.38304 13.528979,3.48159 1.458542,0.36649 2.910894,0.72823 4.350865,1.08046 2.85092,0.70149 5.659501,1.38013 8.402938,2.03773 2.537553,0.60576 5.026574,1.18393 7.479394,1.74394 0.816212,0.19205 1.625242,0.36892 2.435266,0.55621 0.129295,0.0317 0.263817,0.0577 0.393113,0.0893 l -0.868431,0.76291 0.823816,1.77257 c -0.199639,-0.047 -0.398312,-0.0837 -0.603148,-0.12504 -3.709945,-0.80082 -7.434286,-1.63202 -11.17299,-2.49357 -2.160061,-0.49944 -4.326285,-1.00361 -6.493528,-1.51823 -6.008289,-1.42577 -12.02773,-2.90842 -18.046963,-4.44886 -6.083384,-1.55106 -12.155172,-3.16085 -18.201961,-4.8094 -5.94027,-1.61506 -11.850346,-3.27456 -17.722022,-4.95287 -5.860317,-1.67925 -11.671838,-3.38866 -17.421218,-5.10831 -6.00377,-1.79907 -11.9226,-3.61019 -17.74509,-5.43429 -1.31344,-0.40964 -2.62686,-0.81925 -3.9351,-1.23456 -4.69313,-1.47853 -9.30551,-2.95301 -13.84851,-4.42253 l -1.30665,-2.80027 0.97437,-0.85544 c 0.1365,0.0469 0.27298,0.0937 0.4033,0.1358 5.95137,1.97137 11.76945,3.86936 17.45943,5.68831 z" id="path3533" style="fill:none" />
     <path d="m -30.254972,292.46861 0,0 c 0.0052,-0.006 0.01127,-0.001 0.01647,-0.007 0,0 -0.0052,0.006 -0.01647,0.007 z" id="path3535" style="fill:none" />
     <path d="m -44.667842,285.26517 c -0.973928,0.73986 -1.967656,1.51281 -2.988395,2.30367 -0.0052,0.006 -0.01647,0.007 -0.02166,0.0123 0.500572,-0.40778 0.995948,-0.80989 1.498505,-1.19683 0.50256,-0.38694 1.00094,-0.75776 1.511673,-1.1191 z" id="path3537" style="fill:#be202e" />
     <path d="m -44.667842,285.26517 c -0.973928,0.73986 -1.967656,1.51281 -2.988395,2.30367 -0.0052,0.006 -0.01647,0.007 -0.02166,0.0123 0.500572,-0.40778 0.995948,-0.80989 1.498505,-1.19683 0.50256,-0.38694 1.00094,-0.75776 1.511673,-1.1191 z" id="path3539" style="opacity:0.35;fill:#be202e" />
     <path d="m -30.2218,292.45544 c 0,0 -0.0052,0.006 -0.01127,10e-4 -0.0052,0.006 -0.01127,9.9e-4 -0.01647,0.007 0.153662,-0.13318 0.314646,-0.25108 0.463195,-0.37852 0.628302,-0.51257 1.264807,-0.99953 1.904289,-1.45521 -0.763241,0.60216 -1.549259,1.20616 -2.339509,1.82623 l 0,0 0,0 z" id="path3541" style="fill:#be202e" />
     <path d="m -30.2218,292.45544 c 0,0 -0.0052,0.006 -0.01127,10e-4 -0.0052,0.006 -0.01127,9.9e-4 -0.01647,0.007 0.153662,-0.13318 0.314646,-0.25108 0.463195,-0.37852 0.628302,-0.51257 1.264807,-0.99953 1.904289,-1.45521 -0.763241,0.60216 -1.549259,1.20616 -2.339509,1.82623 l 0,0 0,0 z" id="path3543" style="opacity:0.35;fill:#be202e" />
     <path d="m -3.0502818,330.5069 c 6.1572269,1.1827 12.247534,2.26571 18.2471238,3.24041 6.227231,1.01426 12.356561,1.90504 18.357978,2.65895 0.348762,0.0456 0.708911,0.0903 1.063863,0.1407 5.913525,0.73472 11.699134,1.33257 17.339307,1.78976 l 7.844762,17.69411 c -1.160612,-0.0121 -2.333632,-0.0338 -3.529455,-0.0536 -4.497401,-0.0917 -9.271992,-0.26093 -14.266831,-0.51239 -5.629411,-0.28469 -11.556567,-0.6821 -17.699796,-1.1778 -5.67533,-0.46487 -11.549098,-1.02415 -17.5529729,-1.68334 -5.1106845,-0.5626 -10.3308648,-1.18997 -15.622198,-1.90096 -0.197654,-0.0262 -0.3953057,-0.0524 -0.5929873,-0.0786 L -20.52484,326.94198 c 5.866009,1.25856 11.69707,2.45163 17.4745582,3.56492 z" id="path3554" style="fill:url(#SVGID_2_)" />
     <path d="m -148.64432,287.87492 c -4.62455,-1.5418 -9.31626,-3.12551 -14.09367,-4.76537 -0.0714,-0.0258 -0.13651,-0.0469 -0.20787,-0.0727 -0.67629,-0.2295 -1.34737,-0.46467 -2.02369,-0.69419 -3.21697,-1.10818 -6.09263,-2.12815 -12.63913,-4.44059 1.0996,-3.6285 -0.41103,-8.38228 -2.49019,-13.37944 3.85283,3.31605 6.24773,7.77315 6.52364,12.94094 11.22895,-13.43253 25.02773,-21.83891 40.65304,-19.66506 1.39603,0.1929 2.79384,0.46445 4.21819,0.83367 -6.03156,-0.16844 -10.5525,1.89547 -15.78323,8.30262 -0.0165,0.007 -0.0384,0.0188 -0.0549,0.0255 0.0165,-0.007 0.0384,-0.0188 0.0549,-0.0255 12.65883,-5.62036 21.02643,-6.89439 31.69203,-5.50534 2.52825,0.32813 5.18536,0.80351 8.06151,1.40845 -16.05366,1.09099 -26.93227,8.28126 -33.83488,19.35554 l -7.46769,6.54422 c -0.87076,-0.28223 -1.73631,-0.57012 -2.60806,-0.86277 z" id="path3565" style="fill:url(#SVGID_3_)" />
     <path d="m -127.92557,298.05617 c 5.82769,1.81842 11.74652,3.62955 17.74512,5.43431 5.74415,1.7253 11.554681,3.42428 17.421188,5.10828 5.866507,1.68401 11.775562,3.33306 17.722022,4.95287 6.046789,1.64856 12.123776,3.25267 18.201961,4.8094 6.013043,1.53569 12.038702,3.02311 18.046963,4.44886 2.167243,0.51462 4.333467,1.0188 6.493528,1.51824 3.738705,0.86155 7.463045,1.69274 11.172991,2.49357 0.199636,0.047 0.398312,0.0837 0.603147,0.12503 l 11.0633797,23.68219 c -0.3953333,-0.0524 -0.7854697,-0.11047 -1.1807777,-0.16285 -5.606921,-0.76978 -11.295338,-1.6118 -17.027898,-2.55534 -5.790549,-0.94943 -11.619023,-1.99561 -17.461681,-3.12996 -4.930086,-0.95526 -9.854792,-1.97402 -14.768868,-3.06189 -0.99728,-0.22482 -1.97698,-0.44581 -2.962873,-0.67154 -6.150175,-1.40914 -11.974938,-2.89686 -17.487932,-4.42532 -6.244233,-1.73255 -12.086525,-3.52355 -17.517683,-5.33696 -3.574927,-1.18983 -6.978977,-2.39336 -10.215327,-3.58405 -2.73994,-1.04133 -5.46008,-2.11577 -8.13662,-3.21469 -6.31977,-2.58273 -12.45563,-5.34303 -18.38577,-8.29314 l -11.10848,-23.79411 c 4.54303,1.46954 9.15538,2.94401 13.84853,4.42255 1.30203,0.41054 2.62167,0.82493 3.93508,1.23455 z" id="path3576" style="fill:url(#SVGID_4_)" />
     <path d="m -135.39748,315.78421 c -7.2115,-3.62494 -14.10198,-7.55402 -20.5914,-11.85137 -0.2272,-0.15514 -0.45863,-0.29422 -0.68582,-0.44936 2.3312,6.55285 0.24599,17.70369 0.21823,17.65338 -3.57467,-11.87432 -8.27251,-22.40852 -15.98628,-29.36565 -3.27442,2.37386 -5.94744,7.01608 -8.28358,12.96033 -0.41103,-8.38228 1.53485,-12.94527 2.45003,-14.5997 -4.28418,4.11989 -11.70198,6.14259 -19.64656,7.81875 9.09151,-4.3892 15.21177,-8.8767 17.7976,-13.46995 -24.55723,-8.42409 -51.09999,-18.3439 -78.93127,-29.25317 2.33282,-1.41596 4.74343,-1.47765 7.19121,-0.67033 5.0236,1.99314 38.05928,14.98608 83.16344,30.23283 1.28124,0.43321 2.57389,0.86552 3.8727,1.30257 0.36193,0.12335 0.72908,0.24106 1.08481,0.35966 4.73826,1.59047 9.59244,3.19267 14.55737,4.81229 1.13136,0.36642 2.26272,0.73284 3.40026,1.10401 0.0237,0.009 0.0476,0.0172 0.0652,0.021 l 11.11272,23.77804 c -0.25321,-0.12682 -0.52301,-0.24705 -0.7886,-0.38338 z" id="path3587" style="fill:url(#SVGID_5_)" />
     <path d="m -20.879529,324.31241 c -0.803833,-0.18253 -1.613855,-0.36983 -2.435266,-0.5562 -2.447621,-0.56569 -4.936644,-1.14385 -7.479421,-1.74397 -2.748608,-0.6519 -5.5458,-1.33146 -8.402911,-2.03771 -1.439971,-0.35222 -2.880933,-0.71488 -4.350864,-1.08045 -4.387015,-1.09855 -8.894942,-2.26097 -13.528979,-3.48159 -5.694267,-1.50344 -11.580756,-3.09652 -17.65531,-4.79538 -5.791175,-1.61649 -11.75182,-3.32448 -17.888098,-5.1287 -5.82291,-1.70849 -11.803902,-3.50939 -17.941982,-5.39227 -5.47616,-1.68374 -11.06801,-3.43699 -16.79937,-5.26839 -0.27821,-0.088 -0.55639,-0.17608 -0.82938,-0.26978 -5.68998,-1.81895 -11.50806,-3.71694 -17.44804,-5.68923 -0.13651,-0.0469 -0.27299,-0.0937 -0.40331,-0.1358 l 7.4677,-6.54423 c -0.099,0.16552 -0.21555,0.32718 -0.31452,0.4927 9.07173,-7.71799 26.60886,-13.7657 42.082402,-14.50031 7.130974,-0.33982 14.689435,0.18964 22.840099,1.56994 6.067741,1.02703 12.461933,2.52695 19.257152,4.49905 5.938834,1.72022 12.180797,3.78914 18.773426,6.22395 -2.953943,1.10323 -5.869407,2.7287 -8.744022,4.78162 -0.499373,0.3604 -1.009112,0.73216 -1.511672,1.1191 -0.502585,0.38691 -1.004151,0.78427 -1.498505,1.19683 l 0,0 0,0 c 0.0052,-0.006 0.01647,-0.007 0.02166,-0.0123 10.741665,-5.44059 21.911677,-5.49972 33.275347,-3.05294 -3.512293,0.90633 -8.725108,2.75774 -13.490013,6.1124 -0.650869,0.45659 -1.281184,0.9483 -1.904287,1.4552 -0.160021,0.1283 -0.314677,0.25106 -0.463195,0.37852 l 0,0 0,0 c 0.0052,-0.006 0.01127,-9.9e-4 0.01647,-0.007 0,0 0.0052,-0.006 0.01127,-9.9e-4 l 0,0 c 3.833524,-1.80927 7.415482,-3.06785 10.971709,-3.81484 0.75953,-0.16062 1.521076,-0.30038 2.285595,-0.40887 1.160272,-0.17169 2.320337,-0.28559 3.490588,-0.35301 0.747698,-0.0441 1.497407,-0.0674 2.255322,-0.065 1.7736055,-1.9e-4 3.5809872,0.11249 5.4459147,0.34666 0.5691898,0.07 1.1394009,0.1504 1.7219926,0.24033 0.8080111,0.16642 1.5932437,0.33468 2.3670894,0.50385 3.4947139,0.7708 6.5151055,1.56378 9.1028098,2.33365 1.2938545,0.38493 2.4717831,0.75813 3.5461715,1.12911 0.427069,0.1444 0.842778,0.28973 1.24088,0.4312 1.189109,0.43009 2.22612,0.83033 3.11722,1.20547 1.333581,0.56035 2.345383,1.05716 3.054216,1.4469 l 0,0 0,0 c -0.484902,0.0914 -1.006187,0.22239 -1.55767,0.39787 -3.810562,1.20862 -9.0630554,4.26613 -12.8155016,7.10372 l 6.8589836,-6.00695 -6.8589836,6.00695 c -0.059219,0.0415 -0.1120802,0.0878 -0.1712972,0.1293 -0.3686395,0.2869 -0.73626,0.58424 -1.1100962,0.87681 0.088156,-0.0386 0.1659184,-0.0658 0.2478563,-0.10915 l -23.4688293,20.55321 c -0.123105,-0.0269 -0.246211,-0.0538 -0.380705,-0.0798 z" id="path3598" style="fill:url(#SVGID_6_)" />
     <path d="m 52.489098,337.22784 c -5.221409,-0.58001 -11.072737,-1.32494 -17.582802,-2.29555 -0.337345,-0.0465 -0.687098,-0.10255 -1.030661,-0.15384 -5.631475,-0.8466 -11.74798,-1.84346 -18.359704,-3.03705 -5.7115598,-1.02402 -11.780866,-2.1875 -18.2388704,-3.51423 -5.6261705,-1.15166 -11.5511356,-2.4265 -17.7644676,-3.83584 L 2.9813947,303.8381 c 9.3594193,-4.04821 15.0606363,-4.69376 22.0219053,-4.22681 1.892116,0.15844 3.845172,0.35401 5.836389,0.58854 6.095793,0.72012 12.552647,1.79478 18.766426,3.08853 5.997499,1.25326 11.744739,2.71043 16.714058,4.25614 3.159483,0.98674 6.000949,2.00943 8.377522,3.03258 2.095388,0.90383 4.020884,1.83177 5.804442,2.7763 -9.724453,7.55488 -21.194854,17.14061 -28.013039,23.87446 z" id="path3609" style="fill:url(#SVGID_7_)" />
     <path d="m -46.179514,286.38427 c -0.502558,0.38693 -1.004124,0.78429 -1.498506,1.19682 l 0,0 c 0.494382,-0.41253 0.995948,-0.80989 1.498506,-1.19682 z" id="path3611" style="fill:#be202e" />
     <path d="m -46.179514,286.38427 c -0.502558,0.38693 -1.004124,0.78429 -1.498506,1.19682 l 0,0 c 0.494382,-0.41253 0.995948,-0.80989 1.498506,-1.19682 z" id="path3613" style="opacity:0.35;fill:#be202e" />
     <path d="m -46.179514,286.38427 c -0.502558,0.38693 -1.004124,0.78429 -1.498506,1.19682 l 0,0 c 0.494382,-0.41253 0.995948,-0.80989 1.498506,-1.19682 z" id="path3624" style="fill:url(#SVGID_8_)" />
     <path d="m -30.254972,292.46861 c 0.153663,-0.13318 0.314647,-0.25107 0.463193,-0.37852 -0.148463,0.12751 -0.303257,0.25016 -0.463193,0.37852 l 0,0 z" id="path3626" style="fill:#be202e" />
     <path d="m -30.254972,292.46861 c 0.153663,-0.13318 0.314647,-0.25107 0.463193,-0.37852 -0.148463,0.12751 -0.303257,0.25016 -0.463193,0.37852 l 0,0 z" id="path3628" style="opacity:0.35;fill:#be202e" />
     <path d="m -30.254972,292.46861 c 0.153663,-0.13318 0.314647,-0.25107 0.463193,-0.37852 -0.148463,0.12751 -0.303257,0.25016 -0.463193,0.37852 l 0,0 z" id="path3639" style="fill:url(#SVGID_9_)" />
     <path d="m -30.233189,292.45636 c 0,0 0.0052,-0.006 0.01127,-0.001 l 0,0 0,0 0,0 c 0,0 -0.0052,0.006 -0.01127,0.001 z" id="path3641" style="fill:#be202e" />
     <path d="m -30.233189,292.45636 c 0,0 0.0052,-0.006 0.01127,-0.001 l 0,0 0,0 0,0 c 0,0 -0.0052,0.006 -0.01127,0.001 z" id="path3643" style="opacity:0.35;fill:#be202e" />
     <path d="m -30.233189,292.45636 c 0,0 0.0052,-0.006 0.01127,-0.001 l 0,0 0,0 0,0 c 0,0 -0.0052,0.006 -0.01127,0.001 z" id="path3654" style="fill:url(#SVGID_10_)" />
   </g>
   <text id="text3761" y="61.094482" x="290" style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:40px;line-height:125%;font-family:Oswald;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" xml:space="preserve">
     <tspan y="61.094482" x="290" id="tspan3763">The</tspan>
   </text>
   <text id="text3416" y="72.094482" x="356" style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:57.5px;line-height:125%;font-family:Oswald;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" xml:space="preserve">
     <tspan y="72.094482" x="356" id="tspan3418">Apache Velocity Project</tspan>
   </text>
   <path id="path3557" d="m 897.15,23.54449 0,1.58889 3.72099,0 0,10.51111 1.72469,0 0,-10.51111 3.74815,0 0,-1.58889 -9.19383,0 z m 21.49753,0 -4.15555,8.44691 -4.18272,-8.44691 -2.07778,0 0,12.1 1.58889,0 0,-9.60123 4.11482,8.32469 1.1,0 4.11481,-8.32469 0,9.60123 1.58889,0 0,-12.1 -2.09136,0 z" style="fill:#6d6e71" />
   <text id="text3599" y="114.09448" x="400" style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:35px;line-height:125%;font-family:Arial;text-align:start;letter-spacing:0.03em;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" xml:space="preserve">
     <tspan y="114.09448" x="400" id="tspan3601">http://velocity.apache.org/</tspan>
   </text>
 </svg>
 </a>

       </div>
       <div id="breadcrumb">
         <ul><li><a href="http://www.apache.org">apache</a></li><li><a href="/">velocity</a></li><li><a href="/engine/">engine</a></li><li><a href="/engine/devel/">devel</a></li><li><a href="#">webapps</a></li></ul>
       </div>
       <div id="middle">
         <div id="leftnav">

           <style type="text/css">
 /* The following code is added by mdx_elementid.py
    It was originally lifted from http://subversion.apache.org/style/site.css */
 /*
  * Hide class="elementid-permalink", except when an enclosing heading
  * has the :hover property.
  */
 .headerlink, .elementid-permalink {
   visibility: hidden;
 }
 h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
 <h2 id="velocity-engine">Velocity Engine<a class="headerlink" href="#velocity-engine" title="Permanent link">&para;</a></h2>
 <ul>
 <li><a href="index.html">Welcome</a></li>
 <li><a href="overview.html">Overview</a></li>
 <li><a href="getting-started.html">Getting Started</a></li>
 <li><a href="webapps.html">Web Applications</a></li>
 <li><a href="/download.cgi#engine">Downloads</a></li>
 <li><a href="http://wiki.apache.org/velocity/VelocityFAQ">FAQ</a></li>
 </ul>
 <h2 id="docs">Docs<a class="headerlink" href="#docs" title="Permanent link">&para;</a></h2>
 <ul>
 <li><a href="user-guide.html">User Guide</a></li>
 <li><a href="developer-guide.html">Developer Guide</a></li>
 <li><a href="vtl-reference.html">VTL Reference</a></li>
 <li><a href="configuration.html">Configuration</a></li>
 <li><a href="glossary.html">Glossary</a></li>
 <li><a href="apidocs/index.html">Javadoc</a></li>
 <li><a href="upgrading.html">Upgrading</a></li>
 </ul>
 <h2 id="developers">Developers<a class="headerlink" href="#developers" title="Permanent link">&para;</a></h2>
 <ul>
 <li><a href="license.html">License</a></li>
 <li><a href="changes.html">Changes</a></li>
 <li><a href="dependencies.html">Dependencies</a></li>
 <li><a href="source-repository.html">Sources</a></li>
 <li><a href="build.html">Building</a></li>
 <li><a href="https://issues.apache.org/jira/browse/VELOCITY">Issues</a></li>
 <li><a href="http://wiki.apache.org/velocity/RoadMap">Road Map</a></li>
 <li><a href="http://wiki.apache.org/velocity/CodeStandards">Coding Standards</a></li>
 <li><a href="http://wiki.apache.org/velocity/DocumentationGuidelines">Doc Guidelines</a></li>
 </ul>
 <h2 id="community">Community<a class="headerlink" href="#community" title="Permanent link">&para;</a></h2>
 <ul>
 <li><a href="http://wiki.apache.org/velocity/">Wiki</a></li>
 <li><a href="/news.html">News</a></li>
 <li><a href="http://wiki.apache.org/velocity/PoweredByVelocity">Powered by Velocity</a></li>
 <li><a href="http://wiki.apache.org/velocity/VelocityEditors">IDE/Editor Plugins</a></li>
 <li><a href="http://wiki.apache.org/velocity/PublishedArticlesAndBooks">Articles and Books</a></li>
 <li><a href="/contact.html">Mailing Lists</a></li>
 </ul>
 <h2 id="translations-outdated">Translations (outdated)<a class="headerlink" href="#translations-outdated" title="Permanent link">&para;</a></h2>
 <ul>
 <li><a href="http://www.jajakarta.org/velocity/">Site (Japanese)</a></li>
 <li><a href="translations/user-guide_fi.html">User's Guide (Finnish)</a></li>
 <li><a href="translations/user-guide_fr.html">User's Guide (French)</a></li>
 <li><a href="translations/user-guide_es.html">User's Guide (Spanish)</a></li>
 </ul>

           <div id="bottom-nav">
             <img src="/images/pbv90x30.png"/>
             <div id="rss">
               <a class="poweredBy" href="/rss/news.rss" title="Velocity News Feed"><img class="poweredBy" alt="Velocity News Feed" src="/images/feed-icon-24x24.jpg"></a>
             </div>
             <iframe src="http://www.apache.org/ads/buttonbar.html" style="border-width:0; float: left" frameborder="0" scrolling="no" width="135" height="265"></iframe>
           </div>
         </div>
         <div id="content"><div class="section-content"><style type="text/css">
 /* The following code is added by mdx_elementid.py
    It was originally lifted from http://subversion.apache.org/style/site.css */
 /*
  * Hide class="elementid-permalink", except when an enclosing heading
  * has the :hover property.
  */
 .headerlink, .elementid-permalink {
   visibility: hidden;
 }
 h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
 <h2 id="building-a-web-application-with-velocity">Building a Web Application with Velocity<a class="headerlink" href="#building-a-web-application-with-velocity" title="Permanent link">&para;</a></h2>
 <p>Velocity is often used to generate web pages in applications, usually as a direct replacement for JSP. Some of the benefits of using Velocity to generate web pages are:</p>
 <ul>
 <li><strong>Simplicity</strong> -  The pages can be written and maintained by non-technical web designers.</li>
 <li><strong>Ease of maintainance</strong> - Scripting is removed from web pages with the recommended MVC approach.</li>
 <li><strong>Access both methods and properties</strong> - Web designers can reference methods as well as properties of objects in a context.</li>
 <li><strong>Consistency</strong> - Velocity can be used for other text generation tasks (such as sending email)
 providing a consistent way to mark up text.</li>
 </ul>
 <p>This document provides some basic info on getting started with Velocity in a web application.</p>
 <h2 id="use-a-famework">Use a Famework<a class="headerlink" href="#use-a-famework" title="Permanent link">&para;</a></h2>
 <p>The primary purpose of the Velocity engine is simply to generate text based on a template.  Consequently, Velocity does not contain any web-related functionality in and of itself. To make a web application, you will need a framework to respond to HTTP requests, handle user authentication, make business logic calls, and generate a response. There are several strong contenders.</p>
 <ol>
 <li><strong>Velocity Tools / VelocityViewServlet</strong> - The easiest way to get started is to download the companion <a href="http://velocity.apache.org/tools/devel/" class="externalLink">Velocity Tools</a> subproject and use the <a href="http://velocity.apache.org/tools/devel/view/">VelocityViewServlet</a>. This servlet is easy to configure and install. You create a directory of templates on your web server, optionally edit an XML file that lists various "Tools" to place in the context and you are off. More details can be found in the tutorial below.</li>
 <li><strong>Velocity Tools / VelocityStruts</strong> - You may be familiar with the popular <a href="http://struts.apache.org/" class="externalLink">Struts</a> framework, originally designed to provide much needed application functionality to JSP.  With the <a href="http://velocity.apache.org/tools/devel/struts/">VelocityStruts</a> module of Velocity Tools you can substitute Velocity for JSP as the page template language.  This allows you to take advantage of the large base of Struts infrastructure while designing pages using Velocity.</li>
 <li><strong>Third party frameworks</strong> - There are a number of third party frameworks listed on the <a href="http://wiki.apache.org/velocity/PoweredByVelocity">PoweredByVelocity</a> wiki page. Of these, <a href="http://www.springframework.org/">Spring</a> is probably the most sophisticated and well known. <a href="http://turbine.apache.org/">Turbine</a> has many features and can also be very useful. It was built with Velocity as the primary page language, which is not surprising since many of the original Velocity developers were involved in creating it. Simpler alternatives are the <a href="http://click.sourceforge.net/">Click</a> or <a href="http://mav.sourceforge.net/">Maverick</a> frameworks, which provide a simple Controller architecture that integrates nicely with Velocity.</li>
 <li><strong>Build your own</strong> - A final alternative is to build your own framework. Create a dispatcher servlet, retrieve templates from a file or database, integate with your business logic and send the results back to the user. Often you'll have an easier time starting with one of the existing frameworks and customizing it.  In particular you can add new functionality to the VelocityViewServlet simply by creating a subclass.</li>
 </ol>
 <p>As a side note, you may also come across references to VelocityServlet, which is a deprecated servlet that was included in the Velocity Engine up to version 1.4.  Since VelocityServlet is no longer being maintained we strongly recommend you use VelocityViewServlet in Velocity Tools instead.</p>
 <h2 id="web-specific-issues">Web-Specific Issues<a class="headerlink" href="#web-specific-issues" title="Permanent link">&para;</a></h2>
 <p>There are a few issues with Velocity that are specific to web applications.  Here is a brief discussion of the most commonly encountered issues.</p>
 <h3 id="resource-loading-headaches">Resource Loading Headaches<a class="headerlink" href="#resource-loading-headaches" title="Permanent link">&para;</a></h3>
 <p>The default Velocity Engine settings make use of the FileResourceLoader. This is great for most applications that are not deployed to a servlet engine.  Once you need to build a web application and ship or deploy it as a WAR file, the FileResourceLoader can become your worst enemy.  So, we explicitly recommend you do NOT use the FileResourceLoader for your web applications.</p>
 <p>Really, any of the other ResourceLoader implementations out there are preferred, but all the other ResourceLoaders shipped with Velocity Engine will require you to store your templates somewhere besides the standard file system (e.g. in the classpath, in a database, or on a remote server).  If that works for you, then great!  However, we recognize that these are not convenient for most people's development cycle.</p>
 <p>The simplest replacement for FileResourceLoader in a web application is actually a part of the VelocityTools project.  It is the <a href="/tools/devel/apidocs/org/apache/velocity/tools/view/WebappResourceLoader.html">WebappResourceLoader</a> This ResourceLoader implementation is specifically designed to work just like the FileResourceLoader, but it is aware of the servlet context and allows you to configure resource paths relative to the servlet root, rather than the local file system.</p>
 <p>If you are using the VelocityViewServlet, then it is automatically configured and ready to use the WebappResourceLoader. So if you want to change the configured path(s), you need only add a line like the following to your velocity.properties:</p>
 <div class="codehilite"><pre><span class="na">resource.loader.webapp.path</span><span class="o">=</span><span class="s">/WEB-INF/mytemplates/</span>
 </pre></div>


 <p>If you need to set the WebappResourceLoader up on your own, then you can make your properties something like this:</p>
 <div class="codehilite"><pre><span class="na">resource.loader</span> <span class="o">=</span> <span class="s">webapp</span>
 <span class="na">resource.loader.webapp.class</span> <span class="o">=</span> <span class="s">org.foo.WebappResourceLoader</span>
 <span class="na">resource.loader.webapp.path</span> <span class="o">=</span> <span class="s">/WEB-INF/mytemplates/</span>
 </pre></div>


 <p>You will <strong>also need to put the ServletContext into your VelocityEngine's application attributes</strong> before initializing that Engine. This is how the WebappResourceLoader knows how to find templates.</p>
 <div class="codehilite"><pre><span class="n">myVelocityEngine</span><span class="o">.</span><span class="na">setApplicationAttribute</span><span class="o">(</span><span class="s">&quot;javax.servlet.ServletContext&quot;</span><span class="o">,</span> <span class="n">servletContext</span><span class="o">);</span>
 </pre></div>


 <h3 id="changing-object-state-dont">Changing Object State - Don't!<a class="headerlink" href="#changing-object-state-dont" title="Permanent link">&para;</a></h3>
 <p>Velocity provides the ability to call any method of an object acting as a reference.  This can be useful when displaying information into the page but is dangerous when object or application state is modified.</p>
 <p>For example, the following code safely calls the size() method of a list and displays the result.</p>
 <div class="codehilite"><pre><span class="x">There are </span><span class="p">$</span><span class="nv">users</span><span class="p">.</span><span class="nv">size</span><span class="p">()</span><span class="x"> currently logged in.</span>
 </pre></div>


 <p>An example of an unsafe operation concerns a financial web page with an object in the context that calculates data year by year.  The method calculateNextYear() calculates data for the next year and advances an internal counter:</p>
 <div class="codehilite"><pre><span class="x">2005 data: </span><span class="p">$</span><span class="nv">table</span><span class="p">.</span><span class="nv">data</span><span class="x"></span>
 <span class="p">$</span><span class="nv">table</span><span class="p">.</span><span class="nv">calculateNextYear</span><span class="p">()</span><span class="x"></span>
 <span class="x">2006 data: </span><span class="p">$</span><span class="nv">table</span><span class="p">.</span><span class="nv">data</span><span class="x"></span>
 </pre></div>


 <p>The problem with this approach is that the code cannot be repeated in multiple parts of the page.  You may not intend to do so, but it's easy to forget this when cutting and pasting or writing control statements (such as #if or #foreach). This becomes more of an issue when you are dealing with application or session-level state.</p>
 <p>The (strongly) recommended practice is to only use Velocity for inserting information into text.  Method calls can be useful to retrieve information.  However, it's generally a bad idea to use a method call to change object state, and it's always a bad idea to change application state.</p>
 <p>If you find yourself needing to change object state (as in the previous example) try precalculating all the possible values in the controller and putting them in a List or Map.  Any changes to application state should always be done by the controller.</p>
 <p>On a related note, you should always put a List or Set into the context instead of an Iterator or Enumeration.  This allows the collection to be used more than once in the page with no change in behavior.</p>
 <h3 id="escaping-htmlxml-entities">Escaping HTML/XML Entities<a class="headerlink" href="#escaping-htmlxml-entities" title="Permanent link">&para;</a></h3>
 <p>Any user-entered text that contains special HTML or XML entities (such as &lt;, &gt;, or &amp;) needs to be escaped before included in the web page.  This is required, both to ensure the text is visible, and also to prevent dangerous <a href="http://en.wikipedia.org/wiki/Cross_site_scripting">cross-site scripting</a>. Unlike, for example, JSTL (the Java Standard Tag Language found in Java Server Pages), Velocity does not escape references by default.</p>
 <p>However, Velocity provides the ability to specify a <code>ReferenceInsertionEventHandler</code> which will alter the value of a reference before it is inserted into the page. Specifically, you can configure the <code>EscapeHtmlReference</code> handler into your <code>velocity.properties</code> file to escape all references (optionally) matching a regular expression. The following example will escape HTML entities in any reference that starts with "msg" (e.g. <code>$msgText</code>).</p>
 <div class="codehilite"><pre><span class="na">eventhandler.reference_insertion.class</span> <span class="o">=</span> <span class="s">org.apache.velocity.app.event.implement.EscapeHtmlReference</span>
 <span class="na">eventhandler.escape.html.match</span> <span class="o">=</span> <span class="s">/msg.*/</span>
 </pre></div>


 <p>Note that other kinds of escaping are sometimes required.  For example, in style sheets the @ character needs to be escaped, and in Javascript strings the single apostrophe ' needs to be escaped.</p>
 <h3 id="securing-the-application">Securing the Application<a class="headerlink" href="#securing-the-application" title="Permanent link">&para;</a></h3>
 <p>Since a web application is running on a central server, that typically has multiple users and confidential resources, care must be taken to make certain that the web application is secure.  Most standard web security principles apply to a web application built with Velocity.  A few specific issues (such as system configuration, more on cross-site scripting, and method introspection) are written up in this article on <a href="http://wiki.apache.org/velocity/BuildingSecureWebApplications">Building Secure Applications with Velocity</a>. In particular, you may want to prevent template designers from including "dangerous" reflection-related methods by specifying the <code>SecureUberspector</code> to get/set properties and execute method calls.</p>
 <div class="codehilite"><pre><span class="na">runtime.introspector.uberspect.class</span> <span class="o">=</span> <span class="s">org.apache.velocity.util.introspection.SecureUberspector</span>
 </pre></div>


 <h3 id="logging">Logging<a class="headerlink" href="#logging" title="Permanent link">&para;</a></h3>
 <p>Since Velocity logging uses the SLF4J logging facade, you will need to provide an SLF4J binding. Check the <a href="#dependencies">dependecies</a> section in the developer guide for a list of SLF4J bindings.</p>
 <h2 id="tutorial">Tutorial<a class="headerlink" href="#tutorial" title="Permanent link">&para;</a></h2>
 <p>What follows is a brief tutorial on building a simple web app with VelocityViewServlet.  Note that it suggests you compile VelocityViewServlet from the source.  This isn't actually required to use VelocityViewServlet but we recommend it in this case in order to see the source and then compile the example files.</p>
 <p>Prerequisites for doing the following include the Java Developer's Kit (JDK) and <a href="http://ant.apache.org/">Apache Ant</a>.</p>
 <p>For more information, consult the <a href="http://velocity.apache.org/tools/devel/">Velocity Tools</a> documentation.</p>
 <ol>
 <li>
 <p>Download the Velocity Tools project source (you need the source for the examples) from the <a href="http://velocity.apache.org/download.cgi#tools">download page</a>.</p>
 </li>
 <li>
 <p>Build the Velocity Tools jar and the "simple" example by typing:</p>
 <div class="codehilite"><pre>ant example.simple
 </pre></div>


 </li>
 </ol>
 <p>3.Take a look at the "examples" directory. You will see a file "index.vm".  Here's an excerpt:</p>
 <div class="codehilite"><pre>    :::html+velocity
     <span class="nt">&lt;html&gt;</span>
     <span class="nt">&lt;body&gt;</span>
     I&#39;m a velocity template.

     #if( $XHTML )
       #set( $br = &quot;<span class="nt">&lt;br</span> <span class="nt">/&gt;</span>&quot; )
     #else
       #set( $br = &quot;<span class="nt">&lt;br&gt;</span>&quot; )
     #end

     $br
     $br

     Here we use a custom tool: $toytool.message

     $br
     $br

     Here we get the date from the DateTool:  $date.medium
     <span class="nt">&lt;/body&gt;</span>
     <span class="nt">&lt;/html&gt;</span>
 </pre></div>


 <p>You can copy any additional velocity files into this same directory.  In <code>examples/WEB-INF</code> you will see a file "tools.xml".  This specifies a list of "Tools" that are automatically included in the context.</p>
 <div class="codehilite"><pre>    :::xml
     <span class="nt">&lt;tools&gt;</span>
         <span class="nt">&lt;data</span> <span class="na">type=</span><span class="s">&quot;boolean&quot;</span> <span class="na">key=</span><span class="s">&quot;xhtml&quot;</span> <span class="na">value=</span><span class="s">&quot;true&quot;</span><span class="nt">/&gt;</span>
         <span class="nt">&lt;data</span> <span class="na">type=</span><span class="s">&quot;boolean&quot;</span> <span class="na">key=</span><span class="s">&quot;isSimple&quot;</span> <span class="na">value=</span><span class="s">&quot;true&quot;</span><span class="nt">/&gt;</span>
         <span class="nt">&lt;data</span> <span class="na">type=</span><span class="s">&quot;number&quot;</span> <span class="na">key=</span><span class="s">&quot;version&quot;</span> <span class="na">value=</span><span class="s">&quot;2.0&quot;</span><span class="nt">/&gt;</span>
         <span class="nt">&lt;data</span> <span class="na">key=</span><span class="s">&quot;foo&quot;</span><span class="nt">&gt;</span>this is foo<span class="nt">&lt;/data&gt;</span>
         <span class="nt">&lt;data</span> <span class="na">key=</span><span class="s">&quot;bar&quot;</span><span class="nt">&gt;</span>this is bar.<span class="nt">&lt;/data&gt;</span>
         <span class="nt">&lt;toolbox</span> <span class="na">scope=</span><span class="s">&quot;request&quot;</span><span class="nt">&gt;</span>
             <span class="nt">&lt;tool</span> <span class="na">key=</span><span class="s">&quot;toytool&quot;</span> <span class="na">class=</span><span class="s">&quot;ToyTool&quot;</span> <span class="na">restrictTo=</span><span class="s">&quot;index*&quot;</span><span class="nt">/&gt;</span>
         <span class="nt">&lt;/toolbox&gt;</span>
         <span class="nt">&lt;toolbox</span> <span class="na">scope=</span><span class="s">&quot;session&quot;</span><span class="nt">&gt;</span>
             <span class="nt">&lt;tool</span> <span class="na">key=</span><span class="s">&quot;map&quot;</span> <span class="na">class=</span><span class="s">&quot;java.util.HashMap&quot;</span><span class="nt">/&gt;</span>
         <span class="nt">&lt;/toolbox&gt;</span>
     <span class="nt">&lt;/tools&gt;</span>
 </pre></div>


 <p>And finally the web.xml file specifies the name of the servlet and location of toolbox.properties.</p>
 <div class="codehilite"><pre>    :::xml
     <span class="nt">&lt;web-app&gt;</span>
       <span class="nt">&lt;servlet&gt;</span>
         <span class="nt">&lt;servlet-name&gt;</span>velocity<span class="nt">&lt;/servlet-name&gt;</span>
         <span class="nt">&lt;servlet-class&gt;</span>org.apache.velocity.tools.view.VelocityViewServlet<span class="nt">&lt;/servlet-class&gt;</span>
       <span class="nt">&lt;/servlet&gt;</span>
       <span class="nt">&lt;servlet-mapping&gt;</span>
         <span class="nt">&lt;servlet-name&gt;</span>velocity<span class="nt">&lt;/servlet-name&gt;</span>
         <span class="nt">&lt;url-pattern&gt;</span>*.vm<span class="nt">&lt;/url-pattern&gt;</span>
       <span class="nt">&lt;/servlet-mapping&gt;</span>
       <span class="nt">&lt;welcome-file-list&gt;</span>
         <span class="nt">&lt;welcome-file&gt;</span>index.vm<span class="nt">&lt;/welcome-file&gt;</span>
       <span class="nt">&lt;/welcome-file-list&gt;</span>
     <span class="nt">&lt;/web-app&gt;</span>
 </pre></div>


 <ol>
 <li>
 <p>Copy this directory into your "webapps" directory on Tomcat.  You could also copy "simple.war", but copying in the entire directory will let you experiment with changes. You should now be able to access your simple one-page webapp with this URL.  (or something similar):</p>
 <div class="codehilite"><pre>http://localhost:8080/simple/index.vm
 </pre></div>


 </li>
 <li>
 <p>Experiment with adding new Velocity pages.  Note that you can access any velocity page just by changing the URL.  Try changing the entries in tools.xml or creating your own tools.  Consult the <a href="http://velocity.apache.org/tools/devel/" class="externalLink">Velocity Tools</a> documentation, the "showcase" example application, and the <a href="http://wiki.apache.org/velocity/">Wiki</a> for more info on the wide variety of tools available.</p>
 </li>
 </ol></div></div>
         <hr/>
         <div id="copyright">
           Copyright &#169; 2020 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.
         </div>
       </div>
     </div>
   </body>
 </html>