simple-xml2object组件禁止用于商业用途,作者:左潇龙。

前段时间公司的WebService接口需要处理xml数据,主要就是和对象之间的互相转换,传输的时候用xml,后台使用的时候转换成对象,所以就有了xml和object之间经常的互相转换。

因为我们的项目使用的JDK是1.5,所以并没有JAXB,如果要使用的话需要加入JAXB相关的jar包,但是感觉有点过大,而且使用起来有很多限制,而这些限制对我们的项目来说,毫无意义。比如在解析XML时,必须含有相关的命名空间,这使得我不得不在解析之前加入命名空间,因为WEBSERVICE的服务端并没有帮我们加入命名空间。

所以自己基于DOM开发了一个简易组件,可以实现xml和object的互相转换,功能简单实用,带有中文异常处理,虽说没英文显得专业,但感觉中文更实用,其中提示了所有异常产生最有可能的原因,还附带纯中文CHM文档,并保留了扩展性,有兴趣的也可以自己实现自己的转换机制。

simple-xml2object适用于项目JDK版本为1.5的。

在此分享给各位,如果有同样需求的,可以考虑,jar包大小26KB,因为全部基于JDK自带的类库,所以无需其余依赖包。

另外如果哪位在使用过程中有发现bug或者其他问题,可以在此留言,或者发我邮箱150349407@qq.com,我会及时更改。

目前最初始的版本1.0.0主要支持的功能有:

1.xml转换成object,并且可扩展实现自己的解析器,另外目前还不支持直接转换成一个对象的list,但是可以重复调用解析方法,同样可以产生一个list,有时间的话,下一版本会考虑直接支持此功能。

2.object转换成xml,支持xml格式的配置,包含无格式,只带换行的格式以及标准格式(也就是格式化以后的样子)。

3.日期格式采用注解方式,可直接在属性上面设置日期格式。

4.考虑到我们平时项目中对象的一个序列属性大部分是list或者是set的,所以此版本只支持属性为list或者set的,相信足够了。

jar包和CHM文档我已经打包,在我的资源里面可以免费下载,地址:。

下面是我专门为此组件写的一个测试类,用法简单明了,有详细的注释。

import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;

import com.xml2object.simple.annotation.ADate;
import com.xml2object.simple.container.ConfigurableContainer;
import com.xml2object.simple.container.Container;
import com.xml2object.simple.processor.XmlBulider;
import com.xml2object.simple.processor.XmlBulider.Format;
import com.xml2object.simple.support.DefaultConfigurableContainer;


public class Test {
	
	String stringParam = "stringValue";
	
	@ADate(format = "yyyy-MM-dd hh")//日期注解,设置日期格式
	Date dateParam = new Date();
	
	Test testParam;
	
	List<Test> testListParam;

	public static void main(String[] args) throws IOException {
		//不可配置的容器
		Container container = new DefaultConfigurableContainer(Test.class);
		//向容器中添加一个复杂的Test对象
		container.add(createTest());
		//获取容器自动解析的xml内容
		String xml = container.getXml();
		//将xml内容存放在一个文件中
		write("E:/test1.xml", xml);
		//可配置的容器,使用可配置的容器接口,推荐此种方式,比较灵活
		ConfigurableContainer configurableContainer = new DefaultConfigurableContainer(Test.class);
		XmlBulider xmlBulider = configurableContainer.getXmlBulider();
		//设置构建器的xml格式
		xmlBulider.setFormat(Format.TAB_AND_LINE);
		//改变容器中的构建器
		configurableContainer.setXmlBulider(xmlBulider);
		//向可配置容器添加复杂对象
		configurableContainer.add(createTest());
		//获取容器自动解析的xml内容,比较下不能配置的容器构建的xml格式和日期格式
		String configXml = configurableContainer.getXml(0);//等同于getXml()
		//将xml内容存放在一个文件中
		write("E:/test2.xml", configXml);
		//再将xml从test2.xml中读取出来
		String readableConfigXml = read("E:/test2.xml");
		//向容器中再加入一个xml
		configurableContainer.add(readableConfigXml);
		//获取容器自动解析的对象
		//因为之前已经加入了一个对象,所以在加入xml之前,容器中已包含一对xml和object,此时索引为1
		//容器维护了两个保持一致的数组,分别存放xml和object,索引规则与数组一致,从0开始
		Test test = configurableContainer.getObject(1);
		//打印容器大小
		System.out.println("size:" + configurableContainer.size());
		//打印解析的对象,打印的可能不太清楚
		//要想打印格式清晰,与我当初构建xml时相似,过程比较复杂,就不写那么详细了,各位可以自己加断点看对象内容
		System.out.println(test);
	}
	
	public static Test createTest(){
		//构造一个复杂的Test,没什么特别的,复杂就好。。。
		Test t = new Test();
		Test t1 = new Test();
		Test t2 = new Test();
		Test t3 = new Test();
		Test t4 = new Test();
		Test t5 = new Test();
		Test t6 = new Test();
		Test t7 = new Test();
		Test t8 = new Test();
		Test t9 = new Test();
		Test t10 = new Test();
		List<Test> testList2 = new ArrayList<Test>();
		testList2.add(t1);
		testList2.add(t2);
		List<Test> testList = new ArrayList<Test>();
		t10.testListParam = testList2;
		testList.add(t10);
		testList.add(t9);
		testList.add(t8);
		testList.add(t7);
		testList.add(t6);
		t5.testListParam = testList;
		t5.testParam = t4;
		t3.testParam = t5;
		t.testParam = t3;
		return t;
	}
	
	public String toString(){
		StringBuffer stringBuffer = new StringBuffer();
		stringBuffer.append("stringParam:" + (stringParam == null? "" : stringParam) + "\r\n")
		.append("dateParam:" + (dateParam == null ? "" : dateParam) + "\r\n")
		.append("testParam:" + (testParam == null ? "" : testParam) + "\r\n");
		if (testListParam != null) {
			stringBuffer.append("testListParam:\r\n");
			for (Test temp : testListParam) {
				stringBuffer.append(temp + "\r\n");
			}
		}
		return stringBuffer.toString();
	}
	
	public static String read(String fileName) throws IOException{
		File file = new File(fileName);
		FileInputStream fileInputStream = new FileInputStream(file);
		byte[] bytes = new byte[(int) file.length()];
		fileInputStream.read(bytes);
		return new String(bytes);
	}
	
	public static void write(String fileName,String xml) throws IOException{
		OutputStream outputStream = new FileOutputStream(new File(fileName));
		ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(xml.getBytes());
		int len = -1;
		byte[] bytes = new byte[1024];
		while ((len = byteArrayInputStream.read(bytes)) != -1) {
			outputStream.write(bytes, 0, len);
		}
		outputStream.flush();
		outputStream.close();
		byteArrayInputStream.close();
	}
	
}

新建一个java工程,将下载的jar包导入,再直接将测试类代码贴到一个java文件中,运行即可得到E盘下两个xml,可以看下我们配置的日期格式注解是否有效,另外两个xml,一个是不可配置的容器生成的,一个是我们采用可配置容器,调整格式后生成的,可以比对下其中的xml格式,是不是test2已经被格式化了呢?

xml格式化功能一般只是用于测试的时候使用,其主要意义是为了方便测试,因为在测试的时候,我们经常会把生成的xml打印到控制台,控制台不像编辑器可以格式化,所以这样的话看起来效果很差。当然,如果你不嫌麻烦,也可以写入一个文件,然后用编辑器打开手动格式化。

至于只换行的功能,一般在层级太多的时候使用,这个我想道理很简单,层次太多,打印出来的xml横向宽度会很长,也不便于观察。但是只换行的话如果层次太多其实也不太便于观察,所以从这个角度来看,这个格式貌似有些鸡肋,但我觉得完全格式化与空格式总要有个过渡,保证程序的完整性,所以就加进去了。

在数据传输过程中,建议使用无格式,节省传输流量。