《Velocityjava开发指南》中文版.docVIP

《Velocity java开发指南》中文版 本文档来自网络,本人将其收集整理了一下,主要调整了一下格式.如有出入,请参照网络原版,原版地址记不清了! O(∩_∩)O哈哈~ 目录 开始入门 3 参考资源： 4 它是如何工作的？ 5 单实例还是多实例(To Singleton Or Not To Singleton...)? 7 The Context 9 Using Velocity In Servlets 12 Using Velocity In General Applications 15 Application Attributes 19 EventCartridge and Event Handlers(事件分发和处理) 20 Velocity Configuration Keys and Values(配置参数名字和值说明) 23 Configuring the Log System(日志记录配置) 26 Configuring Resource Loaders(资源装载器配置) 29 Template Encoding for Internationalization(字符编码和国际化) 32 Velocity and XML 33 FAQ (Frequently Asked Questions)开发中常见的问题解答. 36 Summary 37 Appendix 1 : Deploying the Example Servlet 38 开始入门 Velocity是一基于java语言的模板引擎，使用这个简单、功能强大的开发工具，可以很容易的将数据对象灵活的与格式化文档组装到一起；希望本文能指引使用velocity在开发基于servlet或一般java应用程序的应用上快速起步。 Getting Started 取得Velocity并在你的机器上开始运行很容易,以下是全部详细的说明: 取得Velocity发布版本，go here。 目录及文件说明: Velocity-X.jar 完整的velocity jar包一般命名格式为velocity-X.jar，其中X是当前版本号。注意这个jar包不包含Velocity所必须依赖的其它jar包(具体见后)。 SRC:完整的源文件代码目录 Examples. 完整的aplication或web App例子。 docs :Veocity文档目录 build: 使用ant编译源码时所需的lib. OK，现在就可以开始使用了.请将Velocity-x.jar放到你的classpath中或webapp的lib下。 当然，我们强烈建议你先运行其中的例子，以感受Velocity的优异之处. Dependencies 依赖资源 Velocity可运行于JDK1.4或JRE1.4及其以上版本. Velocity也依赖于其它一些jar包，在分发版本的 build/lib 有,如果你下载的是二进制分发版本，需要到以下地址下载其它依赖包. Jakarta Commons Collections – 必须. Jakarta Avalon Logkit – 可选，但强列建议加上，以便输出日志信息. Jakarta ORO – 可选，仅当用到org.apache.velocity.convert.WebMacro template 这个模板转换工具时. 参考资源： 一些优秀的资源和例程列表如下： 开发者邮件列表 mail-lists. 邮件档案表 : 是很好的一个资源库.可以以’Velocity’为关键字进行搜索。 源代码(源码分发版本) : src/java/... : 含有Velocity project的所有源码 应用程序例程1 : examples/app_example1 : 一个很简单的示例如何在一般应用程序中使用Velocity. 应用程序例程1 2 : examples/app_example2 : 如何在应用程序中使用Velocity工具类. servlet example : examples/servlet_example1 :示例如何在servlet中用Velocity 输出模板. logger example : examples/logger_example : 如何定制Velocity的日志工具. XML example : examples/xmlapp_example : 使用 JDOM 从 Velocity 模板读取内容. 还包含一个递归调用宏的示例. event example : examples/event_example : 在Velocity 1.1 中使用事件处理API