在appfuse构建的项目中集成velocity的步骤和碰到的问题

在appfuse构建的项目中集成velocity的步骤和碰到的问题

使用Velocity无非也就是为了能够真正的实现mvc分层,使得各个团队成员(美工,程序员)可以各尽所长。

在appfuse构建的项目中集成velocity的步骤和碰到的问题 :

1:修改web.xml使得项目支持velocity

(1)定义名为velocity的servlet:

< servlet >
        
< servlet-name > velocity </ servlet-name >
        
< servlet-class >
            org.apache.velocity.tools.view.servlet.VelocityViewServlet
        
</ servlet-class >
        
< init-param >
            
< param-name > org.apache.velocity.toolbox </ param-name >
            
< param-value > /WEB-INF/toolbox.xml </ param-value >
        
</ init-param >
        
< init-param >
            
< param-name > org.apache.velocity.properties </ param-name >
            
< param-value >
                /WEB-INF/classes/velocity.properties
            
</ param-value >
        
</ init-param >
        
< load-on-startup > 10 </ load-on-startup >
    
</ servlet >

(2)定义对应velocity的servlet-mapping:

   < servlet-mapping >
        
< servlet-name > velocity </ servlet-name >
        
< url-pattern > *.vm </ url-pattern >
    
</ servlet-mapping >

(3)将velocity纳入到编码过滤的filter(一般都已经定义经典SetCharacterEncoding):

  < filter-mapping >
        
< filter-name > SetCharacterEncoding </ filter-name >
        
< url-pattern > *.vm </ url-pattern >
    
</ filter-mapping >
2:在项目的web/WEB-INF文件夹中创建并编辑文件toolbox.xml,通常的内容如下:
<? xml version="1.0" encoding="UTF-8" ?>
< toolbox >
  
< tool >
     
< key > link </ key >
     
< scope > request </ scope >
     
< class > org.apache.velocity.tools.struts.StrutsLinkTool </ class >
  
</ tool >
  
< tool >
     
< key > text </ key >
     
< scope > request </ scope >
     
< class > org.apache.velocity.tools.struts.MessageTool </ class >
  
</ tool >
  
< tool >
     
< key > errors </ key >
     
< scope > request </ scope >
     
< class > org.apache.velocity.tools.struts.ErrorsTool </ class >
  
</ tool >
  
< tool >
     
< key > form </ key >
     
< scope > request </ scope >
     
< class > org.apache.velocity.tools.struts.FormTool </ class >
  
</ tool >
  
< tool >
     
< key > tiles </ key >
     
< scope > request </ scope >
     
< class > org.apache.velocity.tools.struts.TilesTool </ class >
  
</ tool >
  
< tool >
     
< key > validator </ key >
     
< scope > request </ scope >
     
< class > org.apache.velocity.tools.struts.ValidatorTool </ class >
  
</ tool >
</ toolbox >

3:在项目的build/web/classes文件夹中创建并编辑文件velocity.properties,通常的内容:
input.encoding = UTF-8
#out.encoding = UTF-8
default.contentType=text/html; charset=UTF-8

---以上三步其实就是普通java web项目集成velocity的必须要做的工作了。
---下面是使用appfuse中的appgen生成velocity代码的要做的工作,这里只做了从table出发的生成过程。

4:在项目中extras/appgen/src中创建模板,这里假设创建的两个文件是List_vm.xdt和Form_vm.xdt
模板的具体内容就要结合xdoclet,velocity和html来编写,不是一个简单的工作!

5:编辑extras/appgen下的build.xml文件,使得在使用ant install-detailed的时候能生成数据表对应的vm文件.

(1):在名为gen的target中添加template,原文件有以下的代码:


<!--  Form JSP  -->
            
< template  templateFile ="${template.dir}/Form_jsp.xdt"
                      acceptAbstractClasses
="false"
                      prefixWithPackageStructure
="false"
                      destinationFile
="${gen.dir}/web/pages/{0}FormTemp.jsp" />
            
<!--  List JSP  -->
            
< template  templateFile ="${template.dir}/List_jsp.xdt"
                      acceptAbstractClasses
="false"
                      prefixWithPackageStructure
="false"
                      destinationFile
="${gen.dir}/web/pages/{0}ListTemp.jsp" />
我们要在这个后面添加以下代码(如果不使用jsp作为view层可以使用替换的方式把原文件的这部分内容处理掉):
<!--  Form VM  -->
            
< template  templateFile ="${template.dir}/Form_vm.xdt"
              acceptAbstractClasses
="false"
              prefixWithPackageStructure
="false"
              destinationFile
="${gen.dir}/web/vms/{0}FormTemp.vm" />
            
<!--  List VM  -->
               
< template  templateFile ="${template.dir}/List_VM.xdt"
              acceptAbstractClasses
="false"
              prefixWithPackageStructure
="false"
              destinationFile
="${gen.dir}/web/vms/{0}ListTemp.vm" />

这里,templateFile里指定模板文件,destinationFile指定生成的临时文件。

(2):在名字同样为gen的target中添加move任务,原文件中有以下代码:


<!--  Make first character of JSP filenames lowercase  -->
        
< move  file ="${build.dir}/${gen.dir}/web/pages/${model.name}ListTemp.jsp"
            tofile
="${build.dir}/${gen.dir}/web/pages/${app.module.slash.after}${model.name.lowercase}List.jsp" />
        
< move  file ="${build.dir}/${gen.dir}/web/pages/${model.name}FormTemp.jsp"
            tofile
="${build.dir}/${gen.dir}/web/pages/${app.module.slash.after}${model.name.lowercase}Form.jsp" />

我们要在这个后面添加以下代码(如果不使用jsp作为view层可以使用替换的方式把原文件的这部分内容处理掉):
<!--  Make first character of Velocity filenames lowercase  -->
        
< move  file ="${build.dir}/${gen.dir}/web/vms/${model.name}ListTemp.vm"
            tofile
="${build.dir}/${gen.dir}/web/vms/${app.module.slash.after}${model.name.lowercase}List.vm" />
        
< move  file ="${build.dir}/${gen.dir}/web/vms/${model.name}FormTemp.vm"
            tofile
="${build.dir}/${gen.dir}/web/vms/${app.module.slash.after}${model.name.lowercase}Form.vm" />

这样生成的临时文件就会被重命名(有点怀疑这样做的必要性,暂且先这样做吧)。

(3):在名为merge-common的target中添加copy任务,原文件中有如下代码


   <!--  copy jsp files  -->
        
< echo > Copying all web files into main project, overwrite="${overwrite}" </ echo >
        
< copy  todir ="../../web/pages" >
            
< fileset  dir ="${generated.dir}/web/pages"  includes ="**/${model.name.lowercase}*.jsp" />
        
</ copy >

我们要在这个后面添加以下代码(如果不使用jsp作为view层可以使用替换的方式把原文件的这部分内容处理掉):
  <!--  copy velocity files  -->
        
< echo > Copying all velocity files into main project, overwrite="${overwrite}" </ echo >
        
< copy  todir ="../../web/vms" >
            
< fileset  dir ="${generated.dir}/web/vms"  includes ="**/${model.name.lowercase}*.vm" />
        
</ copy >

这样在使用ant install-detailed命令时就会把生成的文件复制到项目的web/vms文件夹下了。

7:修改项目的根目录下的build.xml:

(1)修改名为copy-web-files的target,使得运行ant deploy时可以将vm文件复制到部署项目的WEB-INFO文件夹下(放在WEB-INF下是为了防止直接访问 )。
参考的源代码:


  <!--  Copy JSP Pages under WEB-INF/pages  -->
        
< copy  todir ="${webapp.target}/WEB-INF" >
            
< fileset  dir ="${basedir}/web" >
                
< include  name ="pages/**/*.jsp" />
            
</ fileset >
            
< fileset  dir ="${struts.dir}"  includes ="*.xml" />
            
< fileset  dir ="${basedir}/web/WEB-INF"  includes ="**/*-resources.xml" />
            
< filterset  refid ="db.variables" />
        
</ copy >

可以在这个任务后面添加一个任务:
< fileset  dir ="${basedir}/web" >
                
< include  name ="vms/**/*.vm" />
            
</ fileset >

另外,如果不再使用jsp做为view层可以把匹配jsp的fileset节点去掉,这样就不会复制多余的文件到部署的项目中了。

(2)同名的target 中修改另外一个copy任务(顺数第二个),源代码:

  < copy  todir ="${webapp.target}"  includeEmptyDirs ="no" >
            
< fileset  dir ="${basedir}/web" >
                
< include  name ="**" />
                
< exclude  name ="pages/**" />
                
< exclude  name ="**/classes/**" />
                
< exclude  name ="**/*-resources.xml" />
            
</ fileset >
        
</ copy >

在fileset中添加一个节点:
< exclude  name ="vms/**" />

这样就不会把vms文件夹下的文件当成是普通文件那样复制了

8:在struts-config.xml修改forwards,使得它们指向特定的vm。

ps:基本上就是这么多的步骤,遗漏的地方,欢迎补充!



Let life be beautiful like summer flowers and death like autumn leaves.

你可能感兴趣的:(在appfuse构建的项目中集成velocity的步骤和碰到的问题)