XML学习笔记（七）：使用freemark与apache填充xml模板

前言

1、在实际项目中，对于xml的解析的使用，除了dom4j和jaxb以外，xml模板的使用也是常有的事情，如短信模板，邮件模板，或者ESB的使用，都会涉及到xml模板的情况。

2、对于xml模板的使用与解析，dom4j当然是万能的，但是freemark与apache 有很好的封装的方法可以使用。

3、freemark：需要的jar包为，freemarker.jar（Configuration.java），spring-context-support.jar（FreeMarkerTemplateUtils.java）.

4、apache：velocity.jar（VelocityContext.java 和VelocityEngine）

一、模板

1、位置：模板user-request.xml

2、代码：xml模板的使用具有一定的格式：如${name} 或者$!{name}

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<USER>
    <AGE>${age}</AGE>
    <NAME>${name}</NAME>
    <PhoneList>
        <UserPhone>
            <num>${num1}</num>
            <type>${type1}</type>
        </UserPhone>
        <UserPhone>
            <num>${num2}</num>
            <type>${type2}</type>
        </UserPhone>
    </PhoneList>
    <UserAddress>
        <HomeAddress>${homeAddress}</HomeAddress>
        <WorkAddress>${workAddress}</WorkAddress>
    </UserAddress>
</USER>

3、模板对应的Bean数据

1）Bean数据的使用，看实际情况，正常来说可还是需要的，专门负责数据传输的DTO 。

2）这边的Bean数据，沿用了Jaxb的数据（XML学习笔记（六）：Jaxb负责xml与javaBean映射）。

package xml.code.bean;

import java.util.List;


/**
 * 
 * UserBean.java
 *
 * @title User的传输数据类
 * @description
 * @author SAM-SHO 
 * @Date 2014-11-25
 */

public class UserBean {
	private String name;
	private String key;
	private String age;
	private UserAddress userAddress;//地址
	private List<UserPhone> phoneList ;//手机

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
	}

	public String getAge() {
		return age;
	}

	public void setAge(String age) {
		this.age = age;
	}

	public UserAddress getUserAddress() {
		return userAddress;
	}

	public void setUserAddress(UserAddress userAddress) {
		this.userAddress = userAddress;
	}
	public List<UserPhone> getPhoneList() {
		return phoneList;
	}

	public void setPhoneList(List<UserPhone> phoneList) {
		this.phoneList = phoneList;
	}

	public String getKey() {
		return key;
	}

	public void setKey(String key) {
		this.key = key;
	}
	
}

package xml.code.bean;

public class UserPhone {
	
	private String type;//电话号码类型
	private String num;//电话号码
	
	public String getType() {
		return type;
	}
	public void setType(String type) {
		this.type = type;
	}
	public String getNum() {
		return num;
	}
	public void setNum(String num) {
		this.num = num;
	}
	
}

package xml.code.bean;


public class UserAddress {
	
	private String homeAddress;//家庭地址
	private String workAddress;//公司地址
	
	public String getHomeAddress() {
		return homeAddress;
	}
	public void setHomeAddress(String homeAddress) {
		this.homeAddress = homeAddress;
	}


	public String getWorkAddress() {
		return workAddress;
	}
	public void setWorkAddress(String workAddress) {
		this.workAddress = workAddress;
	}

}

二、使用 FreeMarker

1、代码

	/**
	 * 使用FreeMarker填充xml 模板
	 * 
	 * @param tUserBean
	 * @return
	 */
	public String getUserRequestXml(UserBean tUserBean) {

		// 定义局部变量
		String templatePath = "/templete/"; // 报文模板路径
		String templateFileName = "user-request.xml"; // 报文模板文件名
		String requestXml = ""; // 请求报文

		Configuration config = new Configuration();
		try {

			// 方式1 绝对路径
			// config.setDirectoryForTemplateLoading(new
			// File("D:/apache-worksapce/MyEclipseNewWork2014/JavaTool/resources/templete"));
			// Template template = config.getTemplate(templateFileName,"UTF-8");// 报文模板

			// 方式2-最常用 利用classloader
			config.setClassForTemplateLoading(this.getClass(),"/");
			Template template = config.getTemplate(templatePath + templateFileName,"UTF-8");// 报文模板

			// 方式3 需要 servletContext
			// config.setServletContextForTemplateLoading("","/ftl"); //就是/WebRoot/ftl目录。
			// Template template = config.getTemplate(templateFileName,"UTF-8");// 报文模板

			// 设置模板参数
			Map<String,Object> content = new HashMap<String,Object>();

			content.put("name",tUserBean.getName());
			content.put("age",tUserBean.getAge());
			content.put("num1",tUserBean.getPhoneList().get(0).getNum());
			content.put("num2",tUserBean.getPhoneList().get(1).getNum());
			content.put("type1",tUserBean.getPhoneList().get(0).getType());
			content.put("type2",tUserBean.getPhoneList().get(1).getType());
			content.put("homeAddress",tUserBean.getUserAddress().getHomeAddress());
			content.put("workAddress",tUserBean.getUserAddress().getWorkAddress());

			requestXml = FreeMarkerTemplateUtils.processTemplateIntoString(template,content);

			if (requestXml == null || "".equals(requestXml)) {
				return null;
			}
		} catch (IOException e) {
			e.printStackTrace();
		} catch (TemplateException e) {
			e.printStackTrace();
		}
		// 返回报文字符串
		return requestXml;
	}

2、分析：

1）模板的获取方式有三种：

①、绝对路径：
// 方式1 绝对路径
			// config.setDirectoryForTemplateLoading(new
			// File("D:/apache-worksapce/MyEclipseNewWork2014/JavaTool/resources/templete"));
			// Template template = config.getTemplate(templateFileName,"UTF-8");// 报文模板
②、相对路径，原理为类加载器。网上一些其他文章的分析都是错误的，这边的取得是类加载器的路劲，而不是这个类本身的路径。
			// 方式2-最常用 利用classloader
			config.setClassForTemplateLoading(this.getClass(),"UTF-8");// 报文模板
③、需要使用ServletContext
			// 方式3 需要 servletContext
			// config.setServletContextForTemplateLoading("","UTF-8");// 报文模板
④、获取配置文件的方式，详见文章：

Servlet学习笔记（四）：Servlet的请求与响应以及ServletContext详解

java进阶（六）：Java类加载器

2）设置模板参数，注意key 与模板${key}的一致性。

3）使用FreeMarkerTemplateUtils.processTemplateIntoString() 即可得到结合好的xml数据。FreeMarkerTemplateUtils 类是 spring 中的封装。

4）测试：

		UserBean tUserBean = new UserBean();
		tUserBean.setName("SAM-SHO");
		tUserBean.setAge("27");
		tUserBean.setKey("属性111");

		UserAddress tUserAddress = new UserAddress();
		tUserAddress.setWorkAddress("苏州园区");
		tUserAddress.setHomeAddress("苏州高新区");
		tUserBean.setUserAddress(tUserAddress);

		List<UserPhone> phoneList = new ArrayList<UserPhone>();
		UserPhone tUserPhone = new UserPhone();
		tUserPhone.setType("移动");
		tUserPhone.setNum("13612345678");
		phoneList.add(tUserPhone);

		tUserPhone = new UserPhone();
		tUserPhone.setType("联通");
		tUserPhone.setNum("13798765432");
		phoneList.add(tUserPhone);
		tUserBean.setPhoneList(phoneList);

		ObjectAndXmlHandler handler = new ObjectAndXmlHandler();
		
		// 1- FreeMarker
		String tRequestXml = handler.getUserRequestXml(tUserBean);
		System.out.println(tRequestXml);

【输出】

得到的xml文件: 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<USER>
    <AGE>27</AGE>
    <NAME>SAM-SHO</NAME>
    <PhoneList>
        <UserPhone>
            <num>13612345678</num>
            <type>移动</type>
        </UserPhone>
        <UserPhone>
            <num>13798765432</num>
            <type>联通</type>
        </UserPhone>
    </PhoneList>
    <UserAddress>
        <HomeAddress>苏州高新区</HomeAddress>
        <WorkAddress>苏州园区</WorkAddress>
    </UserAddress>
</USER>

三、使用apache的velocity

1、这边封装了一个工具类，主要是两个类型的方法

1）填充模板的方法，填充内容至工程中的模板。

2）封装的内容写入字符串模板中。

package xml.code.templete.util;

import java.io.StringReader;
import java.io.StringWriter;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;
import java.util.Properties;

import org.apache.velocity.Template;
import org.apache.velocity.VelocityContext;
import org.apache.velocity.app.VelocityEngine;

/**
 * 
 * TemplateTool.java
 * 
 * @title 封装的工具类
 * @description
 * @author SAM-SHO
 * @Date 2014-11-28
 */
public class TemplateTool {
	
	/**
	 * 填充模板的方法
	 * @param context
	 * @param tmdir
	 * @param tmFile
	 * @return
	 */
	public static String fill(VelocityContext context,String tmdir,String tmFile) {
		String result = "";
		try {
			Properties p = new Properties();

			p.setProperty("file.resource.loader.path",tmdir);
			VelocityEngine ve = new VelocityEngine();
			ve.init(p);
			Template t = ve.getTemplate(tmFile);
			StringWriter writer = new StringWriter();

			t.merge(context,writer);
			result = writer.toString();
			writer.close();
		} catch (Exception e) {
			e.printStackTrace();
		}
		return result;
	}

	/**
	 * 填充模板的方法
	 * 
	 * @param context
	 *            封装的数据
	 * @param tmdir
	 *            路径
	 * @param tmFile
	 *            文件名
	 * @param inputEncode
	 *            入编码
	 * @param ouputEncode
	 *            出编码
	 * @return
	 */
	public static String fill(VelocityContext context,String tmFile,String inputEncode,String ouputEncode) {
		String result = "";
		try {
			Properties p = new Properties();

			p.setProperty("file.resource.loader.path",tmdir);
			p.setProperty("ISO-8859-1","UTF-8");
			p.setProperty("input.encoding",inputEncode);
			p.setProperty("output.encoding",ouputEncode);

			VelocityEngine ve = new VelocityEngine();
			ve.init(p);
			Template t = ve.getTemplate(tmFile);
			StringWriter writer = new StringWriter();

			t.merge(context,writer);
			result = writer.toString();
			writer.close();
		} catch (Exception e) {
			e.printStackTrace();
		}
		return result;
	}

	/**
	 * 封装的内容写入字符串模板中
	 * 
	 * @param context
	 * @param templateString
	 * @return
	 */
	public static String fill(VelocityContext context,String templateString) {
		String result = "";
		try {
			VelocityEngine ve = new VelocityEngine();
			ve.init();
			StringWriter writer = new StringWriter();
			StringReader reader = new StringReader(templateString);
			ve.evaluate(context,writer,"temp",reader);
			result = writer.toString();
		} catch (Exception e) {
			e.printStackTrace();
		}
		return result;
	}

	public static String test(int i) {
		return "array:" + i;
	}

	/**
	 * 测试
	 * 
	 * @param args
	 * @throws Exception
	 */
	public static void main(String[] args) throws Exception {
		ArrayList<Object> list = new ArrayList<Object>();
		Map<String,String> map = new HashMap<String,String>();
		map.put("name","Cow");
		map.put("price","100.00");
		list.add(map);
		map = new HashMap<String,"Eagle");
		map.put("price","59.99");
		list.add(map);
		map = new HashMap<String,"Shark");
		map.put("price","3.99");
		list.add(map);

		VelocityContext context = new VelocityContext();
		context.put("TemplateTool",new TemplateTool());
		context.put("workAddress",list);
		context.put("num",Integer.valueOf(10));
		context.put("name","SAM-SHO");
		context.put("homeAddress","苏州高新区");
		context.put("age","27");

		// 1-写入项目中定义的模板
		String tmdir = TemplateTool.class.getClassLoader().getResource("templete/").getPath();
		String result = fill(context,tmdir,"user-request.xml","UTF-8","UTF-8");
		System.out.println("写入工程模板 ：    \r\n" + result);

		// 2-写入字符串模板
		String result2 = fill(context,"${name}，${homeAddress}");
		System.out.println("写入字符串模板:   " + result2);
	}
}

【测试输出】

写入工程模板 ：    
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<USER>
    <AGE>27</AGE>
    <NAME>SAM-SHO</NAME>
    <PhoneList>
        <UserPhone>
            <num>${num1}</num>
            <type>${type1}</type>
        </UserPhone>
        <UserPhone>
            <num>${num2}</num>
            <type>${type2}</type>
        </UserPhone>
    </PhoneList>
    <UserAddress>
        <HomeAddress>苏州高新区</HomeAddress>
        <WorkAddress>[{price=100.00,name=Cow},{price=59.99,name=Eagle},{price=3.99,name=Shark}]</WorkAddress>
    </UserAddress>
</USER>



写入字符串模板:   SAM-SHO，苏州高新区

2、使用TemplateTool 填充模板。

1）方法：

	/**
	 * 利用apache 填充xml 模板
	 * @param tUserBean
	 * @return
	 */
	public String getRequestMsg(UserBean tUserBean) {
		// 定义局部变量
		String templatePath = "/templete/"; // 报文模板路径
		String templateFileName = "user-request.xml"; // 报文模板文件名
		String requestXml = "";

		// 构建请求报文，并转换成报文字符串
		VelocityContext content = new VelocityContext();
		
		content.put("name",tUserBean.getName());
		content.put("age",tUserBean.getAge());
		content.put("num1",tUserBean.getPhoneList().get(0).getNum());
		content.put("num2",tUserBean.getPhoneList().get(1).getNum());
		content.put("type1",tUserBean.getPhoneList().get(0).getType());
		
		content.put("type2",tUserBean.getPhoneList().get(1).getType());
		content.put("homeAddress",tUserBean.getUserAddress().getHomeAddress());
		content.put("workAddress",tUserBean.getUserAddress().getWorkAddress());

		requestXml = TemplateTool.fill(content,this.getClass().getResource(templatePath).getPath(),templateFileName,"GBK","GBK");

		if (requestXml == null || "".equals(requestXml)) {
			return null;
		}

		// 返回报文字符串
		return requestXml;
	}

2）测试：

		// 2-apache.velocity
		String tRequestXml = handler.getRequestMsg(tUserBean);
		System.out.println("apache.velocity 得到的xml文件: \r\n" +tRequestXml);

【输出】

		// 2-apache.velocity
		String tRequestXml = handler.getRequestMsg(tUserBean);
		System.out.println("apache.velocity 得到的xml文件: \r\n" +tRequestXml);

四、把两种类型的解析方式进行封装。

package xml.code.templete.util;

import java.io.IOException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.apache.log4j.Logger;
import org.apache.velocity.VelocityContext;
import org.springframework.stereotype.Component;
import org.springframework.ui.freemarker.FreeMarkerTemplateUtils;

import xml.code.bean.UserAddress;
import xml.code.bean.UserBean;
import xml.code.bean.UserPhone;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;

/**
 * 
 * ObjectAndXmlHandler.java
 * 
 * @title xml模板使用
 * @description 利用 freemarker 和 apache.velocity
 * @author SAM-SHO
 * @Date 2014-11-27
 */
@Component
public class ObjectAndXmlHandler {

	Logger logger = Logger.getLogger(this.getClass());

	public static void main(String[] args) {

		UserBean tUserBean = new UserBean();
		tUserBean.setName("SAM-SHO");
		tUserBean.setAge("27");
		tUserBean.setKey("属性111");

		UserAddress tUserAddress = new UserAddress();
		tUserAddress.setWorkAddress("苏州园区");
		tUserAddress.setHomeAddress("苏州高新区");
		tUserBean.setUserAddress(tUserAddress);

		List<UserPhone> phoneList = new ArrayList<UserPhone>();
		UserPhone tUserPhone = new UserPhone();
		tUserPhone.setType("移动");
		tUserPhone.setNum("13612345678");
		phoneList.add(tUserPhone);

		tUserPhone = new UserPhone();
		tUserPhone.setType("联通");
		tUserPhone.setNum("13798765432");
		phoneList.add(tUserPhone);
		tUserBean.setPhoneList(phoneList);

		ObjectAndXmlHandler handler = new ObjectAndXmlHandler();
		
		// 1- FreeMarker
//		String tRequestXml = handler.getUserRequestXml(tUserBean);
//		System.out.println("FreeMarker 得到的xml文件: \r\n" + tRequestXml);
		
		// 2-apache.velocity
		String tRequestXml = handler.getRequestMsg(tUserBean);
		System.out.println("apache.velocity 得到的xml文件: \r\n" +tRequestXml);

	}

	/**
	 * 使用FreeMarker填充xml 模板
	 * 
	 * @param tUserBean
	 * @return
	 */
	public String getUserRequestXml(UserBean tUserBean) {

		// 定义局部变量
		String templatePath = "/templete/"; // 报文模板路径
		String templateFileName = "user-request.xml"; // 报文模板文件名
		String requestXml = ""; // 请求报文

		Configuration config = new Configuration();
		try {

			// 方式1 绝对路径
			// config.setDirectoryForTemplateLoading(new
			// File("D:/apache-worksapce/MyEclipseNewWork2014/JavaTool/resources/templete"));
			// Template template = config.getTemplate(templateFileName,content);

			if (requestXml == null || "".equals(requestXml)) {
				return null;
			}
		} catch (IOException e) {
			e.printStackTrace();
		} catch (TemplateException e) {
			e.printStackTrace();
		}
		// 返回报文字符串
		return requestXml;
	}

	/**
	 * 利用apache 填充xml 模板
	 * @param tUserBean
	 * @return
	 */
	public String getRequestMsg(UserBean tUserBean) {
		// 定义局部变量
		String templatePath = "/templete/"; // 报文模板路径
		String templateFileName = "user-request.xml"; // 报文模板文件名
		String requestXml = "";

		// 构建请求报文，并转换成报文字符串
		VelocityContext content = new VelocityContext();
		
		content.put("name","GBK");

		if (requestXml == null || "".equals(requestXml)) {
			return null;
		}

		// 返回报文字符串
		return requestXml;
	}

}

XML学习笔记（七）：使用freemark与apache填充xml模板

猜你在找的XML相关文章