拙文：Digester3小记

缘起：

之前一段时间在复习以前学习的Digester使用的时候，由于机器上没有备份Digester的相关包，所以就直接去咱们apache的官网上找Digester的包，一般我都喜欢下最新版的jar包，虽然新版本有可能不稳定，但是迫于追求新东西的欲望，我一般会尝试下载最新jar包（当然最新的版本也可能是几年前发布的了）。所以理所当然就下载了Version: 3.3的Digester包。

惑起：

既然jar包下载完毕，就立马导入到项目中，期盼着红xx能够快点消失，可是等了一会却没有动静。如下代码的第二行是主要问题，其实我就是个Digester初学者而已，一时兴起来玩下，谁知玩出了火来，把以前的代码玩完了。

URL url = MyOldCode.class.getResource("rule.xml");

Digester digester = DigesterLoader.createDigester(url);

原因：

可能会用Digester的朋友见到上面的代码也许会感到陌生或者奇怪，说来也巧、也怪，偏偏我学的时候就是学得这种写法，看来下源代码，DigesterLoader.createDigester内部原本是这么写的：

public static Digester createDigester(URL rulesXml) {

    RuleSet ruleSet = new FromXmlRuleSet(rulesXml);

    Digester digester = new Digester();

    digester.addRuleSet(ruleSet);

    return digester;

}

可见这仅仅是封装了一点点‘繁琐’的代码而已，可是这代码在Digester3中消失不见了……（PS：并不是说以前的代码在Digester3中完全无法使用了，只是说部分少数有些变动了，如关于xml文件读取规则的有些改变了，其他我不怎么了解。）

新发现：

苦于对Digester使用的孤陋寡闻，而在网上搜索Digester3的使用无果（因为网上搜到的都是之前版本的使用），因此我只能硬着头皮去其官网上看那些外星文字了，一个个闪闪发亮的，好在现在科技发达了，有高科技能够为我们翻译了。一个个翻译下勉强了解个大概（别指望我翻译了，能讲个大概不错了，当然我也在努力中~）。

终于在http://commons.apache.org/digester/guide/binder.html这发现了Digester3的新特性了，在新版本中引入了RuleModule和RulesBinder。从名字可了解一个是规则模型，一个是规则捆绑者，似乎是用来代替老版本中的RuleSet的概念，当然在Digester3中是兼容RuleSet的大部分使用的。

使用对比：

Digester3之前的使用一般是这样的

    try {

      Digester digester = new Digester();

      digester.addObjectCreate("emp", Emp.class);

      digester.addSetProperties("emp");

      digester.addBeanPropertySetter("emp/name");

      digester.addBeanPropertySetter("emp/id");

      Emp emp = (Emp) digester.parse(TestOld.class.getResource("emp.xml"));

      System.out.println(emp);

    } catch (IOException e) {

      e.printStackTrace();

    } catch (SAXException e) {

      e.printStackTrace();

    }

如果使用RuleSet的话，如下所示，即在RuleSet中添加规则，如果每次创建一个Digester都需要再次执行一遍

public class EmpRuleSet implements RuleSet {

  //...略

  @Override

  public void addRuleInstances(Digester digester) {

    digester.addObjectCreate("emp", Emp.class);

    digester.addSetProperties("emp");

    digester.addBeanPropertySetter("emp/name");

    digester.addBeanPropertySetter("emp/id");

  }

}

  public static void main(String[] args) {

    try {

      Digester digester = new Digester();

      EmpRuleSet ruleset = new EmpRuleSet();

      ruleset.addRuleInstances(digester);

      Emp emp = (Emp) digester.parse(TestOld.class.getResource("emp.xml"));

      System.out.println(emp);

    } catch (IOException e) {

      e.printStackTrace();

    } catch (SAXException e) {

      e.printStackTrace();

    }

  }

而在Digester3中，提供了工厂的方式来创建Digester，即通过DigesterLoader来创建（DigesterLoader在老版本中似乎主要是用来加载xml规则文件用的），通过传入规则模型来生产Digester对象，使用如下，其中AbstractRulesModule是对RulesModule的封装，原本需要通过cinfigure传进的RulesBinder来设置规则，经过封装直接调用相应的方法就可以设置规则了。

public class EmpRuleModule extends AbstractRulesModule {

  @Override

  protected void configure() {

    System.out.println("type");

    //根据具体类创建对象

    forPattern("emp").createObject().ofType(Emp.class);//.then().setProperties();//要一条龙的写法则通过then方法！

    //设置标签上的全部对应属性

    forPattern("emp").setProperties();

    //将子节点set到其父节点

    forPattern("emp/name").setBeanProperty();

    forPattern("emp/id").setBeanProperty();

  }

}

public class FirstTest {

  public static void main(String[] args) {

    try {

      // 1、创建规则模型类，实现config方法来配置解析规则。然后new该实例来使用

      EmpRuleModule empRuleModule = new EmpRuleModule();

      // 2、根据规则模型类，创建解析器的工厂类

      DigesterLoader loader = DigesterLoader.newLoader(empRuleModule);

      // 3、通过工厂类创建解析器

      Digester digester = loader.newDigester();// 同时调用了RuleModule的config方法添加规则

      // 4、解析xml文件

      Emp emp = digester.parse(FirstTest.class.getResource("emp.xml"));// 这里貌似用了泛型了，不需要转型了

      System.out.println(emp);

      Digester digester2 = loader.newDigester();// RuleModule的config不会再被调用了，只解析了一次

    } catch (IOException e) {

      e.printStackTrace();

    } catch (SAXException e) {

      e.printStackTrace();

    }

  }

}

其实该方式的底层还是用了RuleSet，只不过是只是存放了一份，而不是像之前那样每次都创建一份。

Over了吧，行吗？

写在结尾，My God，这文章真得好难写啊，毕竟对Digester内部实现不咋了解，写这个还主要是学习和记录下Digester3的使用，很多不足，请看者见谅。

噩梦结束了…… 拜