- 浏览: 57597 次
- 性别:
- 来自: 长春
最新评论
-
qiuzhiqun0406:
写的什么啊.power还没初始化呢, 调用个圈圈啊?
子类重写父类方法访问权只能变大不能变小 -
ibio:
总结的很好。这 3 个模式确实很容易搞混淆的。对于你的最后一个 ...
工厂方法---抽象工厂之我见
学习Velocity Tools的一个例子2008年04月19日 星期六 22:36Apache官方网站Velocity Tools自带的例子(位置:\velocity-tools-1.4-src\examples\simple)。
新建一个Web Project,名称为Velocity。
在src下面实现一个ToyTool类,如下所示:
public class ToyTool
{
private String message = "Hello from ToyTool!";
public String getMessage()
{
return message;
}
public void setMessage(String m)
{
message = m;
}
/** To test exception handling in templates. */
public boolean whine() {
throw new IllegalArgumentException();
}
}
这个类实现了一个简单的JavaBean,带setter和getter,操作的属性是message。
模板文件为index.vm,内容如下所示:
<html>
<body>
I'm a velocity template.
#if( $XHTML )
#set( $br = "<br />" )
#else
#set( $br = "<br>" )
#end
$br
$br
Here we use a custom tool: $toytool.message
$br
$br
Here we get the date from the DateTool: $date.medium
</body>
</html>
在这个自带的例子中,并没有实际实现一个自己的Servlet,而是直接使用了org.apache.velocity.tools.view.servlet.VelocityViewServlet,该类位于\velocity-tools-1.4-src\src\java\org\apache\velocity\tools\view\servlet下面。
用到org.apache.velocity.tools.view.servlet.VelocityViewServlet,在该类中实现了对toolbox.xml的解析。可以在web.xml中对应的配置来了解到都配置了哪些项。
web.xml中配置如下所示:
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<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>
<load-on-startup>10</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>velocity</servlet-name>
<url-pattern>*.vm</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.vm</welcome-file>
</welcome-file-list>
</web-app>
其中,toolbox.xml的内容如下所示:
<toolbox>
<xhtml>true</xhtml>
<tool>
<key>toytool</key>
<class>ToyTool</class>
</tool>
<data type="number">
<key>version</key>
<value>1.1</value>
</data>
<data type="boolean">
<key>isSimple</key>
<value>true</value>
</data>
<data type="string">
<key>foo</key>
<value>this is foo.</value>
</data>
<data type="string">
<key>bar</key>
<value>this is bar.</value>
</data>
<tool>
<key>map</key>
<class>java.util.HashMap</class>
</tool>
<tool>
<key>date</key>
<scope>application</scope>
<class>org.apache.velocity.tools.generic.DateTool</class>
</tool>
</toolbox>
将对应的jar包文件加入到CLASSPATH中,启动Tomcat Web Server ,在浏览器地址栏中键入http://localhost:8080/Velocity/index.vm就可以看到这个简单的例子运行的效果了:
I'm a velocity template.
Here we use a custom tool: Hello from ToyTool!
Here we get the date from the DateTool: 2008-4-19 21:23:50
既然,web.xml中指定了初始化参数:key为org.apache.velocity.toolbox,value为/WEB-INF/toolbox.xml文件,那么,在Web Server(这里使用Tomcat)启动的时候,就要解析/WEB-INF/toolbox.xml。
其实,这里隐藏了很多细节,需要解析的不仅仅是/WEB-INF/toolbox.xml,在解析它之前还有很多工作要做。
可以在VelocityViewServlet的源代码中看到实际的过程。VelocityViewServlet继承了HttpServlet,表现出了它是有生命周期的。其中在init方法中可以看到初始化过程:
public void init(ServletConfig config) throws ServletException
{
super.init(config);
// 根据config信息初始化Velocity,这时Web Server启动的时候要做的第一件事
initVelocity(config);
// 初始化toolbox
initToolbox(config);
// 当Velocity已经初始化完成之后,下面要做的一些事情:设置ContentType和编码等等等
defaultContentType =
(String)getVelocityProperty(CONTENT_TYPE, DEFAULT_CONTENT_TYPE);
String encoding =
(String)getVelocityProperty(RuntimeConstants.OUTPUT_ENCODING,
DEFAULT_OUTPUT_ENCODING);
// For non Latin-1 encodings, ensure that the charset is
// included in the Content-Type header.
if (!DEFAULT_OUTPUT_ENCODING.equalsIgnoreCase(encoding))
{
int index = defaultContentType.lastIndexOf("charset");
if (index < 0)
{
// the charset specifier is not yet present in header.
// append character encoding to default content-type
defaultContentType += "; charset=" + encoding;
}
else
{
// The user may have configuration issues.
velocity.warn("VelocityViewServlet: Charset was already " +
"specified in the Content-Type property. " +
"Output encoding property will be ignored.");
}
}
velocity.info("VelocityViewServlet: Default content-type is: " +
defaultContentType);
}
上面代码中,第一件事是initVelocity,即窄initVelocity方法中注册Velocity引擎
protected void initVelocity(ServletConfig config) throws ServletException
{
velocity = new VelocityEngine(); // 实例化一个VelocityEngine
setVelocityEngine(velocity); // 将已经创建的VelocityEngine设置到当前Velocity上下文中
// 注册
LogSystemCommonsLog.setVelocityEngine(velocity);
velocity.setApplicationAttribute(SERVLET_CONTEXT_KEY, getServletContext());
// 尝试读取VelocityTools 默认配置信息
try
{
/** 这里要读取Velocity的默认配置文件了,即org/apache/velocity/tools/view/servlet/velocity.properties文件,该文件默认设置如下所示:
# default to servletlogger, which logs to the servlet engines log
runtime.log.logsystem.class = org.apache.velocity.tools.view.servlet.ServletLogger
# by default, load resources with webapp resource loader
resource.loader = webapp
webapp.resource.loader.class = org.apache.velocity.tools.view.servlet.WebappLoader
*/
ExtendedProperties defaultProperties = loadDefaultProperties();
velocity.setExtendedProperties(defaultProperties);
}
catch(Exception e)
{
log("VelocityViewServlet: Unable to read Velocity Servlet configuration file: ", e);
throw new ServletException(e);
}
// velocity.properties文件是可以由用户自己根据需要配置的,如果用户自己重新设置了该文件,在这里解析
try
{
ExtendedProperties p = loadConfiguration(config);
velocity.setExtendedProperties(p);
}
catch(Exception e)
{
log("VelocityViewServlet: Unable to read Velocity configuration file: ", e);
log("VelocityViewServlet: Using default Velocity configuration.");
}
// 当velocity.properties文件加载完成,初始化VeloccityEngine
try
{
velocity.init();
}
catch(Exception e)
{
log("VelocityViewServlet: PANIC! unable to init()", e);
throw new ServletException(e);
}
}
接着就是initToolbox,开始解析/WEB-INF/toolbox.xml文件,initToolbox方法实现如下:
protected void initToolbox(ServletConfig config) throws ServletException
{
// 获取在web.xml中设置的toolbox.xml
String file = findInitParameter(config, TOOLBOX_KEY);
if (file == null)
{
// ok, look in the default location
file = DEFAULT_TOOLBOX_PATH;
velocity.debug("VelocityViewServlet: No toolbox entry in configuration."
+ " Looking for '" + DEFAULT_TOOLBOX_PATH + "'");
}
// 获取一个管理toolbox.xml的管理toolboxManager
toolboxManager =
ServletToolboxManager.getInstance(getServletContext(), file);
}
ToolboxManager是一个接口:
package org.apache.velocity.tools.view;
import java.util.Map;
public interface ToolboxManager
{
void addTool(ToolInfo info);
void addData(ToolInfo info);
Map getToolbox(Object initData);
}
它有一个实现子类XMLToolboxManager,可以完成对XML配置文件(比如toolbox.xml文件)的一些操作,其中,XMLToolboxManager类方法load实现了对XML文件的加载和解析:
public void load(InputStream input) throws Exception
{
LOG.trace("Loading toolbox...");
Digester digester = new Digester();
digester.setValidating(false);
digester.setUseContextClassLoader(true);
digester.push(this);
digester.addRuleSet(getRuleSet());
digester.parse(input);
LOG.trace("Toolbox loaded.");
}
新建一个Web Project,名称为Velocity。
在src下面实现一个ToyTool类,如下所示:
public class ToyTool
{
private String message = "Hello from ToyTool!";
public String getMessage()
{
return message;
}
public void setMessage(String m)
{
message = m;
}
/** To test exception handling in templates. */
public boolean whine() {
throw new IllegalArgumentException();
}
}
这个类实现了一个简单的JavaBean,带setter和getter,操作的属性是message。
模板文件为index.vm,内容如下所示:
<html>
<body>
I'm a velocity template.
#if( $XHTML )
#set( $br = "<br />" )
#else
#set( $br = "<br>" )
#end
$br
$br
Here we use a custom tool: $toytool.message
$br
$br
Here we get the date from the DateTool: $date.medium
</body>
</html>
在这个自带的例子中,并没有实际实现一个自己的Servlet,而是直接使用了org.apache.velocity.tools.view.servlet.VelocityViewServlet,该类位于\velocity-tools-1.4-src\src\java\org\apache\velocity\tools\view\servlet下面。
用到org.apache.velocity.tools.view.servlet.VelocityViewServlet,在该类中实现了对toolbox.xml的解析。可以在web.xml中对应的配置来了解到都配置了哪些项。
web.xml中配置如下所示:
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<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>
<load-on-startup>10</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>velocity</servlet-name>
<url-pattern>*.vm</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.vm</welcome-file>
</welcome-file-list>
</web-app>
其中,toolbox.xml的内容如下所示:
<toolbox>
<xhtml>true</xhtml>
<tool>
<key>toytool</key>
<class>ToyTool</class>
</tool>
<data type="number">
<key>version</key>
<value>1.1</value>
</data>
<data type="boolean">
<key>isSimple</key>
<value>true</value>
</data>
<data type="string">
<key>foo</key>
<value>this is foo.</value>
</data>
<data type="string">
<key>bar</key>
<value>this is bar.</value>
</data>
<tool>
<key>map</key>
<class>java.util.HashMap</class>
</tool>
<tool>
<key>date</key>
<scope>application</scope>
<class>org.apache.velocity.tools.generic.DateTool</class>
</tool>
</toolbox>
将对应的jar包文件加入到CLASSPATH中,启动Tomcat Web Server ,在浏览器地址栏中键入http://localhost:8080/Velocity/index.vm就可以看到这个简单的例子运行的效果了:
I'm a velocity template.
Here we use a custom tool: Hello from ToyTool!
Here we get the date from the DateTool: 2008-4-19 21:23:50
既然,web.xml中指定了初始化参数:key为org.apache.velocity.toolbox,value为/WEB-INF/toolbox.xml文件,那么,在Web Server(这里使用Tomcat)启动的时候,就要解析/WEB-INF/toolbox.xml。
其实,这里隐藏了很多细节,需要解析的不仅仅是/WEB-INF/toolbox.xml,在解析它之前还有很多工作要做。
可以在VelocityViewServlet的源代码中看到实际的过程。VelocityViewServlet继承了HttpServlet,表现出了它是有生命周期的。其中在init方法中可以看到初始化过程:
public void init(ServletConfig config) throws ServletException
{
super.init(config);
// 根据config信息初始化Velocity,这时Web Server启动的时候要做的第一件事
initVelocity(config);
// 初始化toolbox
initToolbox(config);
// 当Velocity已经初始化完成之后,下面要做的一些事情:设置ContentType和编码等等等
defaultContentType =
(String)getVelocityProperty(CONTENT_TYPE, DEFAULT_CONTENT_TYPE);
String encoding =
(String)getVelocityProperty(RuntimeConstants.OUTPUT_ENCODING,
DEFAULT_OUTPUT_ENCODING);
// For non Latin-1 encodings, ensure that the charset is
// included in the Content-Type header.
if (!DEFAULT_OUTPUT_ENCODING.equalsIgnoreCase(encoding))
{
int index = defaultContentType.lastIndexOf("charset");
if (index < 0)
{
// the charset specifier is not yet present in header.
// append character encoding to default content-type
defaultContentType += "; charset=" + encoding;
}
else
{
// The user may have configuration issues.
velocity.warn("VelocityViewServlet: Charset was already " +
"specified in the Content-Type property. " +
"Output encoding property will be ignored.");
}
}
velocity.info("VelocityViewServlet: Default content-type is: " +
defaultContentType);
}
上面代码中,第一件事是initVelocity,即窄initVelocity方法中注册Velocity引擎
protected void initVelocity(ServletConfig config) throws ServletException
{
velocity = new VelocityEngine(); // 实例化一个VelocityEngine
setVelocityEngine(velocity); // 将已经创建的VelocityEngine设置到当前Velocity上下文中
// 注册
LogSystemCommonsLog.setVelocityEngine(velocity);
velocity.setApplicationAttribute(SERVLET_CONTEXT_KEY, getServletContext());
// 尝试读取VelocityTools 默认配置信息
try
{
/** 这里要读取Velocity的默认配置文件了,即org/apache/velocity/tools/view/servlet/velocity.properties文件,该文件默认设置如下所示:
# default to servletlogger, which logs to the servlet engines log
runtime.log.logsystem.class = org.apache.velocity.tools.view.servlet.ServletLogger
# by default, load resources with webapp resource loader
resource.loader = webapp
webapp.resource.loader.class = org.apache.velocity.tools.view.servlet.WebappLoader
*/
ExtendedProperties defaultProperties = loadDefaultProperties();
velocity.setExtendedProperties(defaultProperties);
}
catch(Exception e)
{
log("VelocityViewServlet: Unable to read Velocity Servlet configuration file: ", e);
throw new ServletException(e);
}
// velocity.properties文件是可以由用户自己根据需要配置的,如果用户自己重新设置了该文件,在这里解析
try
{
ExtendedProperties p = loadConfiguration(config);
velocity.setExtendedProperties(p);
}
catch(Exception e)
{
log("VelocityViewServlet: Unable to read Velocity configuration file: ", e);
log("VelocityViewServlet: Using default Velocity configuration.");
}
// 当velocity.properties文件加载完成,初始化VeloccityEngine
try
{
velocity.init();
}
catch(Exception e)
{
log("VelocityViewServlet: PANIC! unable to init()", e);
throw new ServletException(e);
}
}
接着就是initToolbox,开始解析/WEB-INF/toolbox.xml文件,initToolbox方法实现如下:
protected void initToolbox(ServletConfig config) throws ServletException
{
// 获取在web.xml中设置的toolbox.xml
String file = findInitParameter(config, TOOLBOX_KEY);
if (file == null)
{
// ok, look in the default location
file = DEFAULT_TOOLBOX_PATH;
velocity.debug("VelocityViewServlet: No toolbox entry in configuration."
+ " Looking for '" + DEFAULT_TOOLBOX_PATH + "'");
}
// 获取一个管理toolbox.xml的管理toolboxManager
toolboxManager =
ServletToolboxManager.getInstance(getServletContext(), file);
}
ToolboxManager是一个接口:
package org.apache.velocity.tools.view;
import java.util.Map;
public interface ToolboxManager
{
void addTool(ToolInfo info);
void addData(ToolInfo info);
Map getToolbox(Object initData);
}
它有一个实现子类XMLToolboxManager,可以完成对XML配置文件(比如toolbox.xml文件)的一些操作,其中,XMLToolboxManager类方法load实现了对XML文件的加载和解析:
public void load(InputStream input) throws Exception
{
LOG.trace("Loading toolbox...");
Digester digester = new Digester();
digester.setValidating(false);
digester.setUseContextClassLoader(true);
digester.push(this);
digester.addRuleSet(getRuleSet());
digester.parse(input);
LOG.trace("Toolbox loaded.");
}
发表评论
-
扩展Velocity
2010-09-07 10:06 3188扩展Velocity,实现模板的继承 文章分类:Java编程 ... -
Spring整合velocity
2010-08-31 13:51 6523关键字:Spring中使用Velocity模板 使用Vel ... -
Spring velocity
2010-08-31 13:34 2720默认情况下,velocity macro文件修改没有被应用服务 ... -
velocity在spring中的使用
2010-08-31 13:31 2619velocity在spring中的使用 关键字: spring ... -
Velocity 的macro(2)
2010-08-31 13:19 5394上篇举了一个比较简单得了例子,用来说明他的macro的用途,这 ... -
Velocity 的macro(1)
2010-08-31 11:52 1745Velocity 的macro(1) macro 是Veloc ... -
velocity eclipse插件
2010-08-31 09:17 1199下载地址:http://sourceforge.net/pro ... -
velocity
2010-08-30 17:06 1104Velocity教程 关键词: velocity 教程 ...
相关推荐
赠送jar包:velocity-tools-generic-3.1.jar; 赠送原API文档:velocity-tools-generic-3.1-javadoc.jar; 赠送源代码:velocity-tools-generic-3.1-sources.jar; 赠送Maven依赖信息文件:velocity-tools-generic-...
velocity-tools-2.0.jar velocity-tools-2.0.jar velocity-tools-2.0.jar velocity-tools-2.0.jar velocity-tools-2.0.jar
赠送jar包:velocity-tools-generic-3.1.jar 赠送原API文档:velocity-tools-generic-3.1-javadoc.jar 赠送源代码:velocity-tools-generic-3.1-sources.jar 包含翻译后的API文档:velocity-tools-generic-3.1-...
velocity-tools-1.4.jar
velocity例子和Spring结合的例子
velocity-tools-view-1.4.jar
velocity-tools-view-2.0.jar
velocity-tools.jar对应的源代码
还在为找不到jar文件烦心吗,不用了到我空间来有你想要的,持续更新。。。 velocity-1.5.jar,velocity-1.6.2-dep.jar,velocity-tools-1.3.jar
velocity-tools-view-2.0-beta1.jar, 供大家使用
velocity-tools-generic-2.0.jar
velocity-tools2.0 velocity
velocity-tools-view-1.1.jar
本课程从velocity engine也就是velocity引擎开始, 先讲解velocity的基本使用以及基础语法 , 然后再讲解velocity 的进阶内容velocity Tools , 以及velocity作为web项目的视图改如何使用 , 每一部分都会有一个综合案例...
JAVAEE Velocity例子工程,一个简单的Velocity例子,用的都是代码,没有用Velocity配置文件
velocity-tools-view-1.2.jar
Spring4+Velocity2+Maven整合例子,idea开发。直接运行。
velocity-tools-generic-1.2.jar
SpringMVC3+velocity最简单配置例子,入门级的demo