我的书签
添加书签
移除书签8.1.2 account-persist的主代码
account-persist的Java主代码位于默认的src/main/java目录，包含Account.java、AccountPersistService.java、AccountPersistServiceImpl.java和AccountPersistException.java四个文件，它们的包名都是com.juvenxu.mvnbook.account.persist，该包名与account-persist的groupId com.juvenxu.mvnbook.account及artifactId account-persist对应。
Account类定义了账户的简单模型，它包含id、name等字段，并为每个字段提供了一组getter和setter方法，见代码清单8-2。
代码清单8-2 Account.java
package com.juvenxu.mvnbook.account.persist；
public class Account
{
private String id；
private String name；
private String email；
private String password；
private boolean activated；
public String getId（）
{
return id；
}
public void setId（String id）
{
this.id=id；
}
public String getName（）
{
return name；
}
public void setName（String name）
{
this.name=name；
}
//getter and setter methods for email,password and activated
}
account-persist对外提供的服务在接口AccountPersistService中定义，其方法对应了账户的增、删、改、查，见代码清单8-3。
代码清单8-3 AccountPersistService.java
package com.juvenxu.mvnbook.account.persist；
public interface AccountPersistService
{
Account createAccount（Account account）throws AccountPersistException；
Account readAccount（String id）throws AccountPersistException；
Account updateAccount（Account account）throws AccountPersistException；
void deleteAccount（String id）throws AccountPersistException；
}
当增、删、改、查操作发生异常的时候，该服务则抛出AccountPersistException。
AccountPersistService对应的实现为AccountPersistServiceImpl，它通过操作XML文件实现账户数据的持久化。首先看一下该类的两个私有方法：readDocument（）和writeDocument（），见代码清单8-4。
代码清单8-4 AccountPersistServiceImpl.java第1部分
private String file；
private SAXReader reader=new SAXReader（）；
private Document readDocument（）throws AccountPersistException
{
File dataFile=new File（file）；
if（！dataFile.exists（））
{
dataFile.getParentFile（）.mkdirs（）；
Document doc=DocumentFactory.getInstance（）.createDocument（）；
Element rootEle=doc.addElement（ELEMENT_ROOT）；
rootEle.addElement（ELEMENT_ACCOUNTS）；
writeDocument（doc）；
}
try
{
return reader.read（new File（file））；
}
catch（DocumentException e）
{
throw new AccountPersistException（"Unable to read persist data xml"，e）；
}
}
private void writeDocument（Document doc）throws AccountPersistException
{
Writer out=null；
try
{
out=new OutputStreamWriter（new FileOutputStream（file），"utf-8"）；
XMLWriter writer=newk XMLWriter（out,OutputFormat.createPrettyPrint（））；
writer.write（doc）；
}
catch（IOException e）
{
throw new AccountPersistException（"Unable to write persist data xml"，e）；
}
finally
{
try
{
if（out！=null）
{
out.close（）；
}
}
catch（IOException e）
{
throw new AccountPersistException（"Unable to close persist data xml
writer"，e）；
}
}
}
先看writeDocument（）方法。该方法首先使用变量file构建一个文件输出流，file是AccountPersistServiceImpl的一个私有变量，它的值通过SpringFramework注入。得到输出流后，该方法再使用DOM4J创建一个XMLWriter，这里的OutputFormat.createPrettyPrint（）用来创建一个带缩进及换行的友好格式。得到XMLWriter后，就调用其write（）方法，将Document写入到文件中。该方法的其他代码用做处理流的关闭及异常处理。
readDocument（）方法与writeDocument（）对应，它负责从文件中读取XML数据，也就是Document对象。不过，在这之前，该方法首先会检查文件是否存在，如果不存在，则需要初始化一个XML文档，于是借助DocumentFactory创建一个Document对象，接着添加XML元素，再把这个不包含任何账户数据的XML文档写入到文件中。如果文件已经被初始化了，则该方法使用SAXReader读取文件至Document对象。
用来存储账户数据的XML文件结构十分简单，如下是一个包含一个账户数据的文件，见代码清单8-5。
代码清单8-5 账户数据的XML文件
＜?xml version="1.0"encoding="UTF-8"?＞
＜account-persist＞
＜accounts＞
＜account＞
＜id＞juven＜/id＞
＜name＞Juven Xu＜/name＞
＜email＞juven@changeme.com＜/email＞
＜password＞this_should_be_encrypted＜/password＞
＜activated＞false＜/activated＞
＜/account＞
＜/accounts＞
＜/account-persist＞
这个XML文件的根元素是account-persist，其下是accounts元素，accounts可以包含零个或者多个account元素，每个account元素代表一个账户，其子元素表示该账户的id、姓名、电子邮件、密码以及是否被激活等信息。
现在看一下readAccount（）方法是如何从XML文档读取并构建Account对象的，见代码清单8-6。
代码清单8-6 AccountPersistServiceImpl.java第2部分
public Account readAccount（String id）throws AccountPersistException
{
Document doc=readDocument（）；
Element accountsEle=doc.getRootElement（）.element（ELEMENT_ACCOUNTS）；
for（Element accountEle：（List＜Element＞）accountsEle.elements（））
{
if（accountEle.elementText（ELEMENT_ACCOUNT_ID）.equals（id））
{
return buildAccount（accountEle）；
}
}
return null；
}
private Account buildAccount（Element element）
{
Account account=new Account（）；
account.setId（element.elementText（ELEMENT_ACCOUNT_ID））；
account.setName（element.elementText（ELEMENT_ACCOUNT_NAME））；
account.setEmail（element.elementText（ELEMENT_ACCOUNT_EMAIL））；
account.setPassword（element.elementText（ELEMENT_ACCOUNT_PASSWORD））；
account.setActivated（（"true".equals（element.elementText（ELEMENTACCOUNT
ACTIVATED））?true:false））；
return account；
}
readAccount（）方法首先获取XML文档的Document对象，接着获取根元素的accounts子元素，这里的ELEMENT_ACCOUNTS是一个静态常量，其值就是accounts。接着遍历accounts的子元素，如果当前子元素的id与要读取的账户的id一致，并且基于该子元素构建Account对象，这也就是buildAccount（）方法。
在buildAccount（）方法中，先创建一个Account对象，然后当前XML元素的子元素的值设置该对象。Element的elementText（）方法能够根据子元素名称返回子元素的值，与ELEMENT_ACCOUNTS类似，这里使用了一些静态常量表示id、name、email等XML中的元素名称。Account对象设置完后就直接返回，如果XML文档中没有匹配的id，则返回null。
为了使本章内容不致过于冗长，这里就不再介绍createAccount（）、updateAccount（）和deleteAccount（）几个方法的实现。感兴趣的读者可以参照DOM4J的文档实现这几个方法，过程应该非常简单。
除了Java代码，account-persist模块还需要一个SpringFramework的配置文件，它位于src/main/resources目录，其内容见代码清单8-7。
代码清单8-7 account-persist的Spring配置文件
＜?xml version="1.0"encoding="UTF-8"?＞
＜beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd"＞
＜bean id="propertyConfigurer"
class="org.springframework.beans.factory.config.PropertyPlaceholderCo-
nfigurer"＞
＜property name="location"value="classpath:account-service.proper-
ties"/＞
＜/bean＞
＜bean id="accountPersistService"
class="com.juvenxu.mvnbook.account.persist.AccountPersistServiceI-
mpl"＞
＜property name="file"value="${persist.file}"/＞
＜/bean＞
＜/beans＞
该配置文件首先配置了一个id为propertyConfigurer的bean，其实现为PropertyPlace-holderConfigurer，作用是从项目classpath载入名为account-service.properties的配置文件。随后的bean是accountPersistService，实现为AccountPersistServiceImpl，同时这里使用属性persist.file配置其file字段的值。也就是说，XML数据文档的位置是由项目classpath下account-serv-ice.properties文件中persist.file属性的值配置的。
