Velocity学习笔记(1)

记下我做的第一个小例子:

velocity的文档写得的确不是很好,废话一大堆,
看了大半天了连个小例子都做不出来,还抛异常...
网上一搜,居然有人因为这个原因转投freemarker门下了,velocity真是失败

步骤:
1.了解Dependencies:
Jakarta Commons Collections - required.
Jakarta Commons Lang - required.
Excalibur (ex-Avalon) Logkit - optional
Jakarta ORO - optional.

我们只需要前两个就可以了.
再加上velocity-1.6.3.jar

2.开发第一个例子:
basic/Basic.java

	public static void singletonUsage(){
		try {
			Properties props=new Properties();
			//set some properties to configure the velocity. 


			Velocity.init(props);

			VelocityContext context = new VelocityContext();

			context.put("name", new String("Velocity"));
			context.put("project", new String("Jakarta"));

			Template template = null;

			template = Velocity.getTemplate("./src/basic/BasicUsage.vm");
//默认模板的路径是当前目录,在eclipse运行时就是工程的根目录了
//为了方便查看,把模板放在跟类同一个文件夹
//开头的说明里也不提下哪个参数可以改变这个配置.唉

			StringWriter sw = new StringWriter();			
			template.merge(context, sw);

	        /* lets make our own string to render */
	        String s = "We are using $project $name to render this.";
	        Velocity.evaluate( context, sw, "logTagName", s );
	       //将template的输出加上s的输出,写到sw那里,然后打印出来.
	        System.out.println( sw );

		} catch (Exception e) {
			e.printStackTrace();
		}		
	}

运行后报错!
org.apache.velocity.exception.VelocityException: Failed to initialize an instance of org.apache.velocity.runtime.log.ServletLogChute with the current runtime configuration.
没事,作为coder,我们是一定要让自己爱上异常d,慢慢查吧
先google下,发现有几个人跟我同命相连,但是他们都没有解决..
靠自己吧,看了下velocity的例子,发现使用到了lib下的所有jar包
那我就先试试多加几个jar包进去吧,
嘿嘿,搞定,不抛异常了,输出结果:
Hi! This Velocity from the Jakarta project.
We are using Jakarta Velocity to render this.
实际上,多加commons-logging.jar一个jar就可以了,其他的不用加.


//模板位置对应的参数已经找到:file.resource.loader.path