Chinaunix首页 | 论坛 | 博客
  • 博客访问: 981830
  • 博文数量: 152
  • 博客积分: 4937
  • 博客等级: 上校
  • 技术积分: 1662
  • 用 户 组: 普通用户
  • 注册时间: 2007-10-05 16:55
文章分类

全部博文(152)

文章存档

2013年(12)

2012年(6)

2011年(58)

2010年(43)

2009年(1)

2008年(15)

2007年(17)

我的朋友

分类: Java

2010-07-09 11:05:48

Velocity之Web实践 收藏
 

之前的文章《Velocity初体验》,介绍了Velocity的工作原理和一些演示样例,但有朋友觉得不和Web结合起来针对性不够突出,所以下面结合Web开发来进一步说明,Velocity+Servlet(+JavaBean)是怎样工作的。
通过下面的说明,仅提出Velocity在Web方面的简单示例,为大家献上一个原始但清晰的认识,来了解Velocity在Web方面的工作原理,未来还有深入的主题贡献给大家。
Web环境要求Tomcat,我是用5.5版本。
首先我们还是使用VTL(Velocity Template Language)编一个.vm模版,考察在网页设计师的角度是不是很容易理解和编辑,首先创建sample.vm内容如下:
 
 
   

   
Welcom to Velocity!
    Here's the list of people
   
    Names:
    
    $name
   
 
然后打开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 演示
 *
 */
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,内容:

  Welcome to Javayou.com
 
     SampleServlet
     com.javayou.velocity.servlet.SampleServlet
 
 
      SampleServlet
      /SampleServlet
 
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上输入:,页面显示和数据列表:第一位:LiuDong、第二位:Liang.xf 2正确,大功告成!
注意上面的显示数据含中文,所以在设置进装载容器时注意进行编码,稍显麻烦,这可以用更自动化的办法,如使用Util工具类等。
以上看来Servlet+Velocity的结合还是挺容易和简单的,而至于引伸到Servlet+Velocity+JavaBean 也不是很困难的事,稍为扩展即可达到,在这里就不再多述。
 
本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/sharky77/archive/2006/07/10/900322.aspx
阅读(4018) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~