什么是velocity

velocity是一个基于Java的模板引擎,它可以实现彻底的前后端,前端不允许像jsp那样出现Java代码,而是利用context容器传递变量,在java代码里面我们可以往容器中存值,然后在vm文件中使用特定的语法获取(不知道和ajax+restful实现的前后端分离有没有差别,有时间看下底层代码)。velocity除了作为mvc的展现层以外,还可以实现一些特殊的功能,比如源代码生成,自动email和转换xml等,详情见使用 Velocity 模板引擎快速生成代码,velocity最新版本是17年发布的2.0版本

如何使用velocity

引入jar包

  • velocity-engine-core-x.x.x.jar: Velocity的核心jar包,它必须被引用.
  • velocity-engine-commons-logging-x.x.x.jar: 它用来绑定通用的日志信息Logging, 所有的日志信息将指向它. 用在连接Logging (包括”lib” 目录).
  • velocity-engine-slf4j-x.x.x.jar:它主要用来绑定SLF4J,所有的日志信息将指向它. 用在连接SLF4J (包括”lib” 目录).
  • velocity-engine-log4j-x.x.x.jar: 它主要是绑定Log4j日志,所有的日志消息将使用它. 用在连接Log4j (包括 “lib” 的目录).
  • velocity-engine-servlet-x.x.x.jar: 它主要用来绑定服务器日志. 使用在服务器容器中.

maven工程

在pom文件中引入依赖

<dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-engine-core</artifactId>
<version>x.x.x</version>
</dependency>

如果想将velocity与Logging,SLF4J,log4j以及服务器logger日志集成,可以再pom文件中继续加入下面这些依赖

<dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-engine-commons-logging</artifactId>
<version>x.x.x</version>
</dependency> <dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-engine-slf4j</artifactId>
<version>x.x.x</version>
</dependency> <dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-engine-log4j</artifactId>
<version>x.x.x</version>
</dependency> <dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-engine-servlet</artifactId>
<version>x.x.x</version>
</dependency>

非maven工程

非maven工程我们需要把jar包直接放入到工程的classpath中(lib文件夹下)

基本用法

引入jar包后,我们就可以使用velocity实现我们的前后端分离了。

初始化velocity引擎

前面我们说过,velocity允许我们在后台把数据放入到context容器里面,从而实现从在前端直接取出。编写VelocityTest.java如下

package pers.marscheng.spring.test;

import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;
import org.apache.velocity.app.VelocityEngine;
import org.apache.velocity.runtime.RuntimeConstants;
import org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader; import java.io.StringWriter;
import java.util.ArrayList;
import java.util.List; /**
* velocity测试类
*
* @author: marscheng
* @date: 2018-04-02 下午3:47
*/
public class VelocityTest {
public static void main(String[] args){
// 初始化模板引擎
VelocityEngine ve = new VelocityEngine();
ve.setProperty(RuntimeConstants.RESOURCE_LOADER, "classpath");
ve.setProperty("classpath.resource.loader.class", ClasspathResourceLoader.class.getName());
ve.init();
// 获取模板文件
Template t = ve.getTemplate("test.vm");
// 将变量放入context容器
VelocityContext ctx = new VelocityContext();
ctx.put("name", "MarsCheng");
List list = new ArrayList();
list.add("1");
list.add("2");
ctx.put("list", list);
// 输出
StringWriter sw = new StringWriter();
t.merge(ctx,sw);
System.out.println(sw.toString()); }
}

编写vm文件

test.vm文件如下:

#set($greet = 'hello')
$greet $name
#foreach($i in $list)
$i
#end

注意要把文件放在classpath目录下。如何确定classpath路径?可以调用以下命令打印出来

System.out.println(ClassLoader.getSystemResource(""));



执行VelocityTest.main,控制台会打印出:

集成web工程

velocity与spring集成时候还要加上velocity-tools的jar包,否则在加载bean的时候会报错

<dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-tools</artifactId>
<version>2.0</version>
</dependency>

配置视图解析器,这么配置系统只能解析vm文件,可以配置多视图解析器(待研究,初步尝试了用order,但是貌似没有生效)

<!-- 视图模式配置,velocity配置文件-->
<bean id="velocityConfig" class="org.springframework.web.servlet.view.velocity.VelocityConfigurer">
<property name="resourceLoaderPath" value="/WEB-INF/views" />
<property name="configLocation" value="classpath:properties/velocity.properties" />
</bean> <!-- 配置后缀 -->
<bean id="velocityViewResolver" class="org.springframework.web.servlet.view.velocity.VelocityViewResolver">
<property name="suffix" value=".vm" />
</bean>

配置properties文件

#encoding
input.encoding=UTF-8
output.encoding=UTF-8 #autoreload when vm changed
file.resource.loader.cache=false
file.resource.loader.modificationCheckInterval=2
velocimacro.library.autoreload=false

在/WEB-INF/views路劲下写vm文件showUser.vm

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" pageEncoding="UTF-8">
<title>User Index</title>
</head>
<body>
<h3>hello ${user.name}</h3> </body>
</html>

其对应的controller层代码如下UserControllerImpl.java,这里的User是我们定义的一个用户javabean

package pers.marscheng.spring.controller.impl;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import pers.marscheng.spring.controller.UserController;
import pers.marscheng.spring.dto.User; import javax.servlet.http.HttpServletRequest; /**
* @author: marscheng
* @date: 2018-04-03 下午3:05
*/
@Controller
@RequestMapping("/user")
public class UserControllerImpl implements UserController { @Override
@RequestMapping("/showUser")
public String showUser(HttpServletRequest request, Model model) {
User user = new User();
user.setName("Mars");
//存vm需要的参数
model.addAttribute("user",user); return "showUser";
}
}

然后我们访问http://localhost:8080/user/showUser,就可以看到对应的页面了

velocity语法

Velocity使用模板语言——VTL,用于前端的开发,接下来就来总结下常见的一些VTL语法。具体可以参考官方的翻译文档

变量

velocity中的变量用$作为前缀,它可以获取你在后台用Java定义的变量值,也可以在前端定义,然后使用。在vtl语法中用set表达式来定义(注意在表达式前面会有个#,这是velocity命令的写法,后面你会看到更多的如#if等)

##velocity的变量是弱类型,可以写成$a或者${a},右边可以是(变量引用,字面字符串,属性引用,方法引用,字面数字,数组列表)
#set( $a = "Velocity" )

循环

velocity的循环结构如下所示,$list是个集合,$item表示遍历的每一项,$velocityCount是velocity的默认的变量,用来统计循环的次数

#foreach($item in $list)
$item
$velocityCount
#end

条件控制

条件控制的结构如下所示

#if(condition)
...dosonmething...
#elseif(condition)
...dosomething...
#else
...dosomething...
#end

语句嵌套

循环语句内可以嵌套循环语句,也可以嵌套条件语句#if

#foreach ($element in $list)
#foreach ($element in $list)
This is $element. $velocityCount <br>inner<br>
#end
## inner foreach 内循环结束
## outer foreach
This is $element.
$velocityCount <br>outer<br>
#end

注释

velocity的注释用##表示

关系和逻辑操作符

velocity 也有表示与或非的操作符,和Java一样,都是&& || !,用法也同Java,如下面非的用法

##logical NOT

#if( !$foo )
<strong>NOT that</strong>
#end

velocity的宏相当于Java的函数

宏定义

#macro(宏的名称 $参数1 $参数2 …)
语句体(即函数体)
#end

宏调用

##参数用空格隔开
#宏的名称($参数1 $参数2 …)

#stop

这个命令可以停止执行模板引擎并返回,可以用来debug

#include与#parse

#include和#parse的作用都是引入本地文件, 为了安全的原因,被引入的本地文件只能在TEMPLATE_ROOT目录下。

区别在于:

1.#include可以引入多个文件,#parse只能引入一个,如

#include ("one.gif", "two.txt", "three.htm" )
##也可以使用变量名
#include ( “greetings.txt”, $seasonalstock )

2.#include引入的内容不会被模板引擎解析,而#parse引入的内容会被解析

内置对象

velocity和jsp一样,内置了一些对象,可以在vm模板中调用,如:$request、$response、$session等

velocity学习总结的更多相关文章

  1. Velocity学习

    原创:转载需注明原创地址 https://www.cnblogs.com/fanerwei222/p/11790482.html Velocity学习: 1. velocity对大小写敏感 2. ve ...

  2. Velocity学习笔记

    一.为什么要使用velocity? 很多人下载了EasyJWeb的开源应用示例,但是对动态页面模板文件中的标签使用不是很熟悉,这里简单介绍一下.EasyJWeb特定把视图限定为Velocity,因为我 ...

  3. Velocity学习4

    Velocity是一个基于java的模板引擎(template engine).它允许任何人仅仅简单的使用模板语言(template language)来引用由java代码定义的对象. 当Veloci ...

  4. Velocity学习3

    Velocity快速入门教程 Apache的速度是一个基于Java的的模板引擎(模板引擎),它允许任何人仅仅简单的使用模板语言(模板语言)来引用由java的代码定义的对象. 官网介绍如下: Veloc ...

  5. Velocity学习2

    Velocity是一个基于java的模板引擎(template engine).它允许任何人仅仅简单的使用模板语言(template language)来引用由java代码定义的对象. 当Veloci ...

  6. 模板引擎Velocity学习系列-#set指令

    #set指令 #set指令用于向一个变量或者对象赋值. 格式: #set($var = value) LHS是一个变量,不要使用特殊字符例如英文句号等,不能用大括号括起来.测试发现#set($user ...

  7. velocity学习记录

    一.引入文件 静态引入:#include("./footer.vm.html") 动态引入:#parse("./header.vm.html") 说明:./为v ...

  8. velocity模板引擎学习(1)

    velocity与freemaker.jstl并称为java web开发三大标签技术,而且velocity在codeplex上还有.net的移植版本NVelocity,(注:castle团队在gith ...

  9. 一个Velocity Template Language学习的框架

    Velocity Template Language(VTL)使得数据展示和后台代码的开发分离开来,最初用在基于servlet的网站开发上,它的这一特性使得它在应付MVC Web开发模式时显得尤其合适 ...

随机推荐

  1. 【BZOJ3626】LCA(树链剖分,Link-Cut Tree)

    [BZOJ3626]LCA(树链剖分,Link-Cut Tree) 题面 Description 给出一个n个节点的有根树(编号为0到n-1,根节点为0).一个点的深度定义为这个节点到根的距离+1. ...

  2. 【BZOJ3932】任务查询系统(主席树)

    [BZOJ3923]任务查询系统(主席树) 题面 Description 最近实验室正在为其管理的超级计算机编制一套任务管理系统,而你被安排完成其中的查询部分.超级计算机中的 任务用三元组(Si,Ei ...

  3. [BZOJ1207] [HNOI2004] 打鼹鼠 (dp)

    Description 鼹鼠是一种很喜欢挖洞的动物,但每过一定的时间,它还是喜欢把头探出到地面上来透透气的.根据这个特点阿Q编写了一个打鼹鼠的游戏:在一个n*n的网格中,在某些时刻鼹鼠会在某一个网格探 ...

  4. Android视频直播:流媒体服务器搭建

    一.前言 实时视频直播是这两年非常火的技术形态,已经渗透到教育.在线互娱等各种业务场景中.但要搭建一套实时视频直播系统,并非易事,下面针对直播系统的的搭建做一下说明: 1.1 通常的直播系统的技术模型 ...

  5. Matcher类的简单使用

    今天工作时遇到一个问题, 用正则处理html标签时不知该如何下手.还好有Matcher帮助解决了问题. 需求如下: 例如有如下html文章内容: <p><a href="w ...

  6. SDN资料

    深入浅出SDN 华为SDN PPT 基于分类的软件定义网络流表更新一致性方案 SDN-网络变革的探讨 Openflow交换机初步安装测试 floodlight源码解读. Floodlight核心包源码 ...

  7. java中equals方法和hashcode方法的区别和联系,以及为什么要重写这两个方法,不重写会怎样

    一.在Object类中的定义为:public native int hashCode();是一个本地方法,返回的对象的地址值.但是,同样的思路,在String等封装类中对此方法进行了重写.方法调用得到 ...

  8. Cloudera Manager及CDH最新版本安装全程记录

    大家都知道,Apache Hadoop的配置很繁琐,而且很零散,为此Cloudera公司提供了Clouder Manager工具,而且还封装了Apache Hadoop,flume,spark,hiv ...

  9. git远程提交失败

    同步仓库并解决403报错 这时候对本地仓库和github进行同步 # git push -u origin master error: The requested URL returned error ...

  10. LNMP+FARM+DNS

    LNMP 1.安装Nginx前的环境. # yum -y install gcc gcc-c++ pcre-devel zlib-devel openssl-devel   2.添加www系统用户,在 ...