org.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog org.apache.commons.logging.simplelog.log.org.apache.commons.digester.Digester=debug org.apache.commons.logging.simplelog.log.org.apache.commons.digester.Digester.sax=info

***********Example.xml**********
<address-book>
??<person?id="1"?category="acquaintance"?try="would?be?ignored">
????<name>Gonzo</name>
????<email?type="business"> gonzo@muppets.com</email>
????<gender?result="the?whole?tag?would?be?ignored">male</gender>
??</person>
??<person?id="2"?category="rolemodel">
????<name>Kermit</name>
????<email?type="business">kermit@muppets.com</email>
????<email?type="home">kermie@acme.com</email>
??</person>
</address-book>**********Person.java************
import?java.util.HashMap;
import?java.util.Iterator;
public?class?Person?{
??private?int?id;
??private?String?category;
??private?String?name;
??private?HashMap?emails?=?new?HashMap();
??//下面的兩個方法的名字中set以后的部分，與<person>的屬性名字對映。當(dāng)從xml文件中識別出<person> 的屬性時，如果有要求(即調(diào)用過addSetProperties方法),Digester會依據(jù)這種對映關(guān)系自動調(diào)用相應(yīng)的方法。
??public?void?setId(int?id)?{
??????this.id?=?id;
??}
??public?void?setCategory(String?category)?{
??????this.category?=?category;
??}
? ?//對name而言，因?yàn)槠渲祦碜?lt;name>標(biāo)簽的內(nèi)容而非屬性值，需要用addCallMethod指定識別< name>后的要調(diào)用此方法(想自動調(diào)用也要可以，需要addBeanPropertySetter，參見第下一個例子)。
??public?void?setName(String?name)?{
??????this.name?=?name;
??}
??//同name，此時還要一一指定addEmail的參數(shù)值的來源。
??public?void?addEmail(String?type,?String?address)?{
??????emails.put(type,?address);
??}
??public?void?print()?{
??????System.out.println("Person?#"?+?id);
??????System.out.println("??category="?+?category);
??????System.out.println ("??name="?+?name);
??????for(Iterator?i?=?emails.keySet().iterator();?i.hasNext();?)?{
??????????String?type?=?(String)?i.next();
??????????String?address?=?(String)?emails.get(type);
??????????System.out.println("??email?(type?"?+?type?+?")?:?"?+?address);
??????}
??}
}
**********AddressBook.java***********
import?java.util.LinkedList;
import?java.util.Iterator;
public?class?AddressBook?{
????LinkedList?people?=?new?LinkedList();
????public?void?addPerson(Person?p)?{
????????people.addLast(p);
????}
????public?void?print()?{
????????System.out.println("Address?book?has?"?+?people.size()?+?"?entries");

????????for(Iterator?i?=?people.iterator();?i.hasNext();?)?{
????????????Person?p?=?(Person)?i.next();
????????????p.print();
????????}
????}
}
************AddressBookDigester*********
import?org.apache.commons.digester.Digester;
/**
?*?Usage:?java?Example1?example.xml
?*/
public?class?AddressBookDigester?{
????public?static?void?main(String[]?args)?{
????????if?(args.length?!=?1)?{
????????????usage();
????????????System.exit(-1);
????????}
????????String?filename?=?args[0];
????????//?創(chuàng)建一個Digester實(shí)例
????????Digester?d?=?new?Digester();
????????//?創(chuàng)建AddressBook實(shí)例，并將其壓入棧頂。
????????AddressBook?book?=?new?AddressBook();
????????d.push(book);
????????//?增加規(guī)則
????????addRules(d);
????????//?處理輸入的xml文件
????????try?{
????????????java.io.File?srcfile?=?new?java.io.File(filename);
????????????d.parse(srcfile);
????????}
????????catch(java.io.IOException?ioe)?{
????????????System.out.println("Error?reading?input?file:"?+?ioe.getMessage());
????????????System.exit(-1);
????????}
????????catch( org.xml.sax.SAXException?se)?{
????????????System.out.println("Error?parsing?input?file:"?+?se.getMessage());
????????????System.exit(-1);
????????}
????????
????????
????????//?將解析出的地址數(shù)據(jù)打印出來
????????book.print();
????}
????
????private?static?void?addRules(Digester?d)?{
????????//?當(dāng)遇到<person>時，創(chuàng)建類Person的一個實(shí)例，并將其壓入棧頂
????????d.addObjectCreate("address-book/person",?Person.class);
????????
????????//?將<person>標(biāo)簽的屬性(attribute)與棧頂Person類對象的屬性(property)設(shè)置方法根據(jù)各自的名字進(jìn)行映射，(例如，將標(biāo)簽屬性id與屬性設(shè)置方法setId進(jìn)行映射，將標(biāo)簽屬性category與屬性設(shè)置方法setCategory進(jìn)行映射)，然后將屬性的值作參數(shù)傳遞給執(zhí)行相應(yīng)的方法。
????????//?如果某標(biāo)簽屬性沒法通過名字找到相應(yīng)的屬性設(shè)置方法，則此標(biāo)簽屬性被忽略(如example.xml中第一個<person>的try屬性)。
????????d.addSetProperties("address-book/person");

????????//?調(diào)用第二棧頂對象(AddressBook實(shí)例)的addPerson方法，以棧對象(Person實(shí)例)的對象為參數(shù)
????????d.addSetNext("address-book/person",?"addPerson");????????
????????
????????//?當(dāng)遇到<person>的子元素<name>時，調(diào)用棧頂對象(Person實(shí)例)的setName方法。
????????//?此處addCallMethod方法的第一參數(shù)是規(guī)則，第二個參數(shù)是方法的名字，第三個是參數(shù)的數(shù)量(為0時，表示只有一個參數(shù)，且參數(shù)的值是元素的內(nèi)容)
????????d.addCallMethod("address-book/person/name",?"setName",?0);
????????
????????//?當(dāng)遇到<person>的子元素<email>時，調(diào)用棧頂對象(Person實(shí)例)的addEmail 方法,addEmail方法有兩個參數(shù)，取值分別來自<email>的屬性type的值和<email>本身的內(nèi)容。
????????//?此處addCallParam方法的第一參數(shù)是規(guī)則，第二個參數(shù)是指明被調(diào)用方法(addEmail)參數(shù)的序號，第三個是參數(shù)為字符串時指屬性的名字)
????????d.addCallMethod("address-book/person/email",?"addEmail",?2);
????????d.addCallParam("address-book/person/email",?0,?"type");
????????d.addCallParam("address-book/person/email",?1);
????}

????private?static?void?usage()?{
????????System.out.println("Usage:?java?Example1?example.xml");
????}
}

Address?book?has?2?entries
Person?#1
??category=acquaintance
??name=Gonzo
??email?(type?business)?:?gonzo@muppets.com
Person?#2
??category=rolemodel
??name=Kermit
??email?(type?business)?:?kermit@muppets.com
??email?(type?home)?:?kermie@acme.com

Digester學(xué)習(xí)筆記(三)

　　總覺得，Digester不僅僅能作配置文件解析，而且可以作得更多。

配置屬性

　　Digester用來解析應(yīng)用系統(tǒng)的配置文件，其本身也有很可配置的屬性。

屬性	描述
classLoader	指定類裝載器(class loader)。ObjectCreateRule 和 FactoryCreateRule兩個規(guī)則中，需要動態(tài)加載一些類（如那些盛放XML解析出來的數(shù)據(jù)的javaBean等），裝載器可以在次指定。如果不指定，對這此類的加載將會利用線程上下文中的加載器（當(dāng)useContextClassLoader值為真時）或利用加載Digester的那個加載器。
errorHandler	指定 SAX ErrorHandler，以在出現(xiàn)此類錯誤時調(diào)用。默認(rèn)情況下，任何解析錯誤都會被記入日志，Digest會繼續(xù)進(jìn)行解析。
namespaceAware	一個布爾值，為真時對XML文件的解析時會考慮元素的域名空間（如不同的域名空間的同名元素會視為不同的元素）
ruleNamespaceURI	指定后續(xù)加入的規(guī)則所屬的命名空間，如果此值為null,則加入的規(guī)則不與任何命名空間相聯(lián)系。
rules	設(shè)定規(guī)則模板與XML元素的匹配處理程序。由于這個匹配程序是插件式的，所以匹配工作的完成可以用用戶定義的匹配程序未完成。默認(rèn)情況下，使用Digester提供的匹配器。
useContextClassLoader	一個布爾值，為真時FactoryCreateRule 和 ObjectCreateRule 兩個規(guī)則中對類的裝載將會采用當(dāng)前線程上下文中指定的加載器。默認(rèn)情況下，對類的動態(tài)加載會利用加載 Digester的那個裝載器。
validating	一個布爾值，為真時解析器會根據(jù)DTD內(nèi)容對XML文檔進(jìn)行合法性檢查，默認(rèn)值是假，解析器只是檢查XML是否格式良好(well formed).

　　除了上述屬性外，還可以注冊一個本地DTD，以供DOCTYPE聲明引用。這樣的注冊告訴XML解析器，當(dāng)遇到DOCTYPE聲明時，應(yīng)使用剛注冊的DTD的內(nèi)容，而不是DOCTYPE聲明中的標(biāo)識符(identifier)。
　　例如，Struect框架控制器中，使用下述的注冊，告訴Structs使用一個本地的DTD中的相關(guān)內(nèi)容來處理Structs配置文件，這樣可以適用于那些沒有連接到互聯(lián)網(wǎng)的應(yīng)用環(huán)境，而在連到互聯(lián)網(wǎng)的環(huán)境中可以加快運(yùn)行速度(因?yàn)樗苊饬送ㄟ^網(wǎng)絡(luò)去取相關(guān)的資源)。URL url = new URL("/org/apache/struts/resources/struts-config_1_0.dtd");
digester.register("-//Apache Software Foundation//DTD Struts Configuration 1.0//EN",url.toString());

規(guī)則集打包

　　通常情況下，一個規(guī)則被創(chuàng)建后，接著便注冊，然后等在event時被調(diào)用，這些規(guī)則集很難為其它應(yīng)用程序直接復(fù)用。一個解決方法是將所有規(guī)則都放在一個類中，此由這些規(guī)則可以很簡單地被裝載然后被注冊使用。RuleSet接口就是為些而設(shè)計，一般是通過擴(kuò)展RuleSetBase類來開發(fā)規(guī)則集類。如例： 可以這樣使用這個規(guī)則集

帶命名空間的XML解析

　　這種情況下，使用Digester的步驟為：

1. 在Digester初始化部分，指明要考慮命名空間。
   digester.setNamespaceAware(true);
   
   
2. 指明一些規(guī)則的命名空間,如
   digester.setRuleNamespaceURI(" http://www.mycompany.com/MyNamespace");
   
   
3. 接下來定義一些與此命名空間有關(guān)的規(guī)則，此時可以省卻前綴，如
   digester.addObjectCreate("foo/bar", "com.mycompany.MyFoo");
   digester.addSetProperties("foo/bar");
   
   
4. 對其它命名空間，重復(fù)前面的2步

　　另外，在指明要digester考慮命名空間之后，在定義匹配模板時，可以將命名空間別名加"："作為元素名稱的一部分使用。這與無命名空間時是一致的。

開發(fā)定制的匹配處理過程

　　通過實(shí)現(xiàn) org.apache.commons.digester.Rules接口或擴(kuò)展org.apache.commons.digester.RulesBase類來達(dá)到定制匹配過程的目的。
　　Digester提供ExtendedBaseRules來擴(kuò)展了匹配模板的定義，引入了特殊通配字符?和＊以及!,提供RegexRules來支持以正則式的語法定義匹配模板，提供WithDefaultsRulesWrapper來支持默認(rèn)規(guī)則（即其它規(guī)則都不匹配時的處理規(guī) 則）。

一些認(rèn)識

　　通過看說明材料，尤其在學(xué)習(xí)Digester包中的Catalog例子以后，有一些認(rèn)識：
　　1、由于xml對屬性名字的定義要求，與Java中對方法名字的定義要求不一致，導(dǎo)致出現(xiàn)不能自動映射的情況，如year-made標(biāo)簽屬性，就不可能有方法setYear-made;
　　2、對于根元素，與其子元素建立聯(lián)系，有幾種辦法：一種是先生成根元素實(shí)例，壓入棧，然后解析，將調(diào)用方法規(guī)則建立聯(lián)系；另一種是解析的過程中第一個創(chuàng)建它，然后用getRoot的方法得到。
　　3、如果某對象類構(gòu)造都要參數(shù)，則此時需要擴(kuò)展AbstractObjectCreationFactory類為這種對象建立一個Factory,在這個Factory中取得初始化參數(shù)值然后再創(chuàng)建一個對象實(shí)例。
　　4、設(shè)有某個標(biāo)簽，要想自動用該標(biāo)簽子元素的內(nèi)容填充該標(biāo)簽對應(yīng)的對象的屬性，則需要用digester.setRules(new ExtendedBaseRules()),然后addRules(),然后再調(diào)用addBeanPropertySetter ("bala/lala/?");進(jìn)行規(guī)則定義,注意此模板中有通配符。
　　5、如果對象的屬性是整型，則Digester自動將xml文件中字符串值轉(zhuǎn)換為整型。
　　6、在指明要digester考慮命名空間之后，如果不會引起歧義，完全可以忽略命名空間的存在，除非你要針對特定的命名空間進(jìn)行特定的處理。