Raible's Wiki: AppFuseVelocity

-       Raible's Wiki




    Raible Designs

Wiki Home

News

Recent Changes

AppFuse
Homepage

  -  Korean

  -  Chinese

  -  Italian

  -  Japanese

QuickStart Guide

  - Chinese
 
  - French

  - German

  - Italian

  - Korean

  - Portuguese

  - Spanish

  - Japanese


User Guide

  - Korean

  - Chinese
 

Tutorials

  -  Chinese

  -  German

  -  Italian

  -  Korean

  -  Portuguese

  -  Spanish


FAQ

  -  Korean


Latest Downloads

Other Applications
Struts Resume

Security Example

Struts Menu



    




    

    
         
        Set your name in

        UserPreferences
            
    





       
       
       
       




    

Referenced by

AppFuseSupport
Articles
Articles_cn
Articles_de
Articles_pt
Articles_zh



    




   



   
   JSPWiki v2.2.33 
   



       
           

           

           
           
           


           Hide Menu
+            AppFuseVelocity
            



  
    Search Wiki:
    
    
  



         
         
            Your trail: 
         
      

      


      

      
         



      
          Difference between 
          version 8 
          and 
          version 7:
          

          
At line 13 added 1 line.
* [7] Build your Velocity Templates
At line 112 changed 1 line.
</pre>    
</pre>
The pattern can be anything you like.  Velocity usually uses .vm, but I used .jst for Java Server Templates.

!!Configure the Toolbox and VelocityEngine
With me so far?  Good, the last step is easy.  We need to create two files in the web/WEB-INF directory to configure Velocity.
More information about configuring Velocity can be found on their [site|http://jakarta.apache.org/velocity/user-guide.html].

First is the velocity.properties:
<pre>
  velocimacro.library = /WEB-INF/VM_global_library.vm
  velocimacro.permissions.allow.inline = true
  velocimacro.permissions.allow.inline.to.replace.global = false
  velocimacro.permissions.allow.inline.local.scope = false  
  velocimacro.context.localscope = false
</pre>
Very simple, the only thing you may wish to change is velocimacro.library to match where you wish to put your global macros file.

Last is toolbox.xml (this configures the Struts tools):
<pre>
&lt;?xml version="1.0"?&gt;

&lt;toolbox&gt;
  &lt;tool&gt;
     &lt;key&gt;link&lt;/key&gt;
     &lt;scope&gt;request&lt;/scope&gt;
     &lt;class&gt;org.apache.velocity.tools.struts.StrutsLinkTool&lt;/class&gt;
  &lt;/tool&gt;
  &lt;tool&gt;
     &lt;key&gt;msg&lt;/key&gt;
     &lt;scope&gt;request&lt;/scope&gt;
     &lt;class&gt;org.apache.velocity.tools.struts.MessageTool&lt;/class&gt;
  &lt;/tool&gt;
  &lt;tool&gt;
     &lt;key&gt;errors&lt;/key&gt;
     &lt;scope&gt;request&lt;/scope&gt;
     &lt;class&gt;org.apache.velocity.tools.struts.ErrorsTool&lt;/class&gt;
  &lt;/tool&gt;
  &lt;tool&gt;
     &lt;key&gt;form&lt;/key&gt;
     &lt;scope&gt;request&lt;/scope&gt;
     &lt;class&gt;org.apache.velocity.tools.struts.FormTool&lt;/class&gt;
  &lt;/tool&gt;
&lt;/toolbox&gt;
</pre>

!!Modify and ActionForward to point to Velocity [#6]
I haven't got my head around where webdoclet looks for this yet.  But basically if you forward out from an Action to anything matching the Velocity uri-pattern.  The above tools will contain all the struts resources you'll need.  They're embedded in the context as $key, for example $link, $errors, $form and so on.

!!Build your Velocity Templates [#7]
See the [User Guide|http://jakarta.apache.org/velocity/user-guide.html] for Velocity for help with VTL.


          

      

      

      
      Back to AppFuseVelocity,
       or to the Page History.
       

      

      

      

      

      

      

      

      Show Menu
-AppFuseVelocity
+    Search Wiki:
 At line 13 added 1 line.
+* [7] Build your Velocity Templates
 At line 112 changed 1 line.
-</pre>
+</pre>
+The pattern can be anything you like.  Velocity usually uses .vm, but I used .jst for Java Server Templates.
+!!Configure the Toolbox and VelocityEngine
+With me so far?  Good, the last step is easy.  We need to create two files in the web/WEB-INF directory to configure Velocity.
+More information about configuring Velocity can be found on their [site|http://jakarta.apache.org/velocity/user-guide.html].
+First is the velocity.properties:
+<pre>
+  velocimacro.library = /WEB-INF/VM_global_library.vm
+  velocimacro.permissions.allow.inline = true
+  velocimacro.permissions.allow.inline.to.replace.global = false
+  velocimacro.permissions.allow.inline.local.scope = false
+  velocimacro.context.localscope = false
+</pre>
+Very simple, the only thing you may wish to change is velocimacro.library to match where you wish to put your global macros file.
+Last is toolbox.xml (this configures the Struts tools):
+<pre>
+&lt;?xml version="1.0"?&gt;
+&lt;toolbox&gt;
+  &lt;tool&gt;
+     &lt;key&gt;link&lt;/key&gt;
+     &lt;scope&gt;request&lt;/scope&gt;
+     &lt;class&gt;org.apache.velocity.tools.struts.StrutsLinkTool&lt;/class&gt;
+  &lt;/tool&gt;
+  &lt;tool&gt;
+     &lt;key&gt;msg&lt;/key&gt;
+     &lt;scope&gt;request&lt;/scope&gt;
+     &lt;class&gt;org.apache.velocity.tools.struts.MessageTool&lt;/class&gt;
+  &lt;/tool&gt;
+  &lt;tool&gt;
+     &lt;key&gt;errors&lt;/key&gt;
+     &lt;scope&gt;request&lt;/scope&gt;
+     &lt;class&gt;org.apache.velocity.tools.struts.ErrorsTool&lt;/class&gt;
+  &lt;/tool&gt;
+  &lt;tool&gt;
+     &lt;key&gt;form&lt;/key&gt;
+     &lt;scope&gt;request&lt;/scope&gt;
+     &lt;class&gt;org.apache.velocity.tools.struts.FormTool&lt;/class&gt;
+  &lt;/tool&gt;
+&lt;/toolbox&gt;
+</pre>
+!!Modify and ActionForward to point to Velocity [#6]
+I haven't got my head around where webdoclet looks for this yet.  But basically if you forward out from an Action to anything matching the Velocity uri-pattern.  The above tools will contain all the struts resources you'll need.  They're embedded in the context as $key, for example $link, $errors, $form and so on.
+!!Build your Velocity Templates [#7]
+See the [User Guide|http://jakarta.apache.org/velocity/user-guide.html] for Velocity for help with VTL.