Velocity之Web实践

最新推荐文章于 2024-10-07 08:36:59 发布

zyk220

最新推荐文章于 2024-10-07 08:36:59 发布

阅读量1.1k

点赞数

分类专栏： Java---Velocity 文章标签： velocity web servlet import tomcat path

Java---Velocity 专栏收录该内容

4 篇文章 0 订阅

订阅专栏

之前的文章《Velocity初体验》，介绍了Velocity的工作原理和一些演示样例，但有朋友觉得不和Web结合起来针对性不够突出，所以下面结合Web开发来进一步说明，Velocity+Servlet（+JavaBean）是怎样工作的。

通过下面的说明，仅提出Velocity在Web方面的简单示例，为大家献上一个原始但清晰的认识，来了解Velocity在Web方面的工作原理，未来还有深入的主题贡献给大家。

Web环境要求Tomcat，我是用5.5版本。

首先我们还是使用VTL（Velocity Template Language）编一个.vm模版，考察在网页设计师的角度是不是很容易理解和编辑，首先创建sample.vm内容如下：

< html >
   < head >< title > Velocity </ title ></ head >
   < body bgcolor = " #ffffff " >
     < center >
     < h2 > Welcom to Velocity !</ h2 >
     < i > Here ' s the list of people</i>
     < table cellspacing = " 0 " cellpadding = " 5 " width = " 20% " >
     < tr >
     < td bgcolor = " #eeeeee " align = " center " >
    Names：
     </ td >
     </ tr >
    #foreach ($name in $theList)
     < tr >
     < td bgcolor = " #eeeeee " align = " center " > $name </ td >
     </ tr >
    #end
     </ table >
     </ center >
   </ body >
</ html >

然后打开FrontPage（或其他类似工具）网页编辑器，点击"工具－选项－配置编辑器"，上面列出了FrontPage能打开的文件，点击添加，填入文件类型：vm，编辑器名称：FrontPage，命令：C:/Program Files/Microsoft Office/Office/frontpg.exe（FrontPage运行的完整路径，可从已有的文件类型中Copy出完整路径），点击打开界面的确定后，我们从FrontPage的文件菜单中选择打开文件，选择上面新建的sample.vm，怎么样，编辑、预览和修改都一目了然吧（如下图），即使不清楚VTL的，也可以通过简单的手册查询知道（一般都不会用到吧），这样对于网页设计师、开发人员和维护人员来说，都是很容易的事。而如果你使用了一些开发工具，如Jbuilder则在tools－proference的编辑类型里，在Html档增加.vm的支持，则就可以进行编辑和用html预览器预览了，其他的开发工具自己摸索吧。

接下来看看最简单的Servlet是怎么和Velocity结合工作的，创建SampleServlet.java，由于VelocityServlet提供了统一的Servlet入口和封装了大部分工作，以及把展示数据合并到模版中，所以SampleServlet通过继承VelocityServlet，工作将简便很多，代码如下：

package com.javayou.velocity.servlet;

/**/ /*
* @author Liang.xf 2004-12-15
* Velocity + Servlet 演示
* www.javayou.com
*/

import java.io.IOException;
import java.io.FileNotFoundException;

import java.util.Properties;
import java.util.Vector;

import javax.servlet.ServletConfig;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.velocity.Template;
import org.apache.velocity.context.Context;
import org.apache.velocity.servlet.VelocityServlet;
import org.apache.velocity.app.Velocity;
import org.apache.velocity.exception.ResourceNotFoundException;
import org.apache.velocity.exception.ParseErrorException;

public class SampleServlet extends VelocityServlet {
     /** */ /**
     *   由VelocityServlet.init()调用， We want to set a set of properties
     *   在此找出模版的路径
      */
     protected Properties loadConfiguration(ServletConfig config )
         throws IOException, FileNotFoundException {
        Properties p = new Properties();
         /**/ /*
         *  first, we set the template path for the
         *  FileResourceLoader to the root of the
         *  webapp.  This probably won't work under
         *  in a WAR under WebLogic, but should
         *  under tomcat :)
          */
        String path = config.getServletContext().getRealPath( " / " );

         if (path == null ) {
            System.out.println( " SampleServlet.loadConfiguration() : unable to "
                     + " get the current webapp root.  Using '/'. Please fix. " );
            path = " / " ;
        }

        p.setProperty( Velocity.FILE_RESOURCE_LOADER_PATH,  path );
         // 同样设置log
        p.setProperty( " runtime.log " , path + " velocity.log " );
         return p;
    }

     /** */ /**
     *  Velocity主要的商业逻辑处理方法，由VelocityServlet自动调用
     *   @param ctx a Velocity Context object to be filled with
     *             data.  Will be used for rendering this
     *             template
     *   @return Template to be used for request
      */
     public Template handleRequest( HttpServletRequest request,
       HttpServletResponse response, Context ctx ) {

         // 主要在此设置演示用的数据，开发中在此调用相应的业务处理流程，

         //        并设置返回到页面的数据

        System.out.println( " ------SampleVelocity.handleRequest------- " );
         // 待展示的列表数据
        String p1 = " 第一位：LiuDong " ;
        String p2 = " 第二位：Liang.xf " ;
        Vector personList = new Vector();
         // 中文需要转换
         try {
            personList.addElement( new String(p1.getBytes(), " ISO-8859-1 " ) );
            personList.addElement( new String(p2.getBytes(), " ISO-8859-1 " ) );
        } catch (Exception e) {
            System.out.println( " 数据转换异常： " + e);
        }
         // 设置数据，供页面模版替换成显示的数据
        ctx.put( " theList " , personList );
         /**/ /*
         *  get the template.  There are three possible
         *  exceptions.  Good to know what happened.
          */
        Template outty = null ;
         try {
            outty =   getTemplate( " sample.vm " );
        } catch ( ParseErrorException pee ) {
            System.out.println( " SampleServlet: parse error for template " + pee);
        } catch ( ResourceNotFoundException rnfe ) {
            System.out.println( " SampleServlet: template not found " + rnfe);
        } catch ( Exception e ) {
            System.out.println( " Error " + e);
        }
         return outty;
    }
}

编译需要velocity-1.4.jar和j2ee.jar，这里演示手工编译命令（所有资源放在同一目录）：
javac -classpath ./velocity-1.4.jar;./j2ee.jar SampleServlet.java

编译通过后，我们接着需要发布了，以Tomcat5.5为例，新建Web应用简易说明如下：
1、/tomcat55/webapps目录下新建目录test，把上述sample.vm Copy进test目录，在test内新建目录WEB-INF，在WEB-INF内分别新建目录：classes和lib，在WEB-INF目录下新建文件web.xml，内容：

<? xml version = " 1.0 " encoding = " ISO-8859-1 " ?>
< web - app >
   < display - name > Welcome to Javayou.com </ display - name >
   < servlet >
      < servlet - name > SampleServlet </ servlet - name >
      < servlet - class > com.javayou.velocity.servlet.SampleServlet </ servlet - class >
   </ servlet >
   < servlet - mapping >
       < servlet - name > SampleServlet </ servlet - name >
       < url - pattern >/ SampleServlet </ url - pattern >
   </ servlet - mapping >
</ web - app >

2、在classes内建立类包目录：com/javayou/velocity/servlet/，copy上面编译后的SampleServlet.class；
3、在lib目录内分别copy进：commons-collections.jar、logkit-1.0.1.jar、velocity-1.4.jar；
OK，Tomcat运行环境搭建完毕。
启动Tomcat，在IE上输入：http://localhost:8080/test/SampleServlet，页面显示和数据列表：第一位：LiuDong、第二位：Liang.xf 2正确，大功告成！
注意上面的显示数据含中文，所以在设置进装载容器时注意进行编码，稍显麻烦，这可以用更自动化的办法，如使用Util工具类等。
以上看来Servlet+Velocity的结合还是挺容易和简单的，而至于引伸到Servlet+Velocity+JavaBean 也不是很困难的事，稍为扩展即可达到，在这里就不再多述。