XMLDataObject全接觸

1、XMLDataObject全接觸文檔編號(hào)：文檔名稱：編 寫：編寫日期：審 核：審核日期：批 準(zhǔn)：批準(zhǔn)日期：神州數(shù)碼（中國）有限公司Frame技術(shù)文檔制作項(xiàng)目組修訂狀況章節(jié)編號(hào)章節(jié)名稱修訂內(nèi)容簡述修訂人修訂日期修訂前版本號(hào)批準(zhǔn)人增加內(nèi)容說明toXMLWithAttr方法。焦桐衛(wèi)20061017XMLDataObject提供游標(biāo)機(jī)制，能夠動(dòng)態(tài)操縱其中元素或?qū)傩?。在存取方法上，適應(yīng)于關(guān)系模型，提供了行、列仿照機(jī)制，便于應(yīng)用開發(fā)。同時(shí)它還實(shí)現(xiàn)了DataObject接口，提供對(duì)數(shù)據(jù)的基本操作及事件的響應(yīng)，如清除所有記錄、設(shè)置第row行第col列的值、檢索開始事件（retrieveStart）、檢索執(zhí)行完

2、畢事件（retrieveEnd）等，因此XMLDataObject廣泛用于請(qǐng)求報(bào)文的處理等方面。掌握XMLDataObject的使用需要先理解三個(gè)概念：一個(gè)是游標(biāo)機(jī)制，其次是帶子表的二維表映射，再者是相對(duì)路徑和全路徑模式。我們先看下面的XML數(shù)據(jù)片斷：<root><amasterTable><arow><col1>v11</col1><col2>v12</col2></arow><brow><adetailTable><crow><col3>v11&l

3、t;/col3><col4>v12</col4></crow><drow><col5>v21</col5><col6>v22</col6></drow></adetailTable></brow></amasterTable></root>當(dāng)我們把注意力放在<arow>節(jié)點(diǎn)上，以<arow>節(jié)點(diǎn)為基準(zhǔn)點(diǎn)來看數(shù)據(jù)就會(huì)發(fā)現(xiàn)可以按照關(guān)系型數(shù)據(jù)庫的二維表的方式來解讀數(shù)據(jù)，即認(rèn)為<arow>節(jié)點(diǎn)代表著一行，而

4、<col1>和<col2>各自代表一列。而如果我們以<brow>為基準(zhǔn)點(diǎn)來看數(shù)據(jù)就會(huì)發(fā)現(xiàn)可以把<adetailTable>節(jié)點(diǎn)理解為<amasterTable>節(jié)點(diǎn)的一個(gè)子表。我們看數(shù)據(jù)的目光所在的基準(zhǔn)點(diǎn)其實(shí)就是XMLDataObject的游標(biāo)，而我們對(duì)數(shù)據(jù)的這種理解方式即是XMLDataObject到二維表的映射。對(duì)于數(shù)據(jù)定位，我們可以有兩種模式，舉個(gè)例子，假如我們要取得<col1>節(jié)點(diǎn)的值，一種模式是將游標(biāo)移動(dòng)<arow>節(jié)點(diǎn)，再取<arow>節(jié)點(diǎn)下名為“col1”的節(jié)點(diǎn)的值；另一種模式是不管游

5、標(biāo)在哪，我們就取名為“root. amasterTable. arrow. col1”的節(jié)點(diǎn)的值，這兩種模式都能正確的取到節(jié)點(diǎn)值，區(qū)別就在于一個(gè)用相對(duì)路徑模式操作，而一個(gè)是用全路徑模式操作。到從上面的例子我們可以看出，隨著游標(biāo)的移動(dòng)，我們看到的數(shù)據(jù)是不一樣的，這種二維表映射關(guān)系是動(dòng)態(tài)的，換言之，對(duì)于同一個(gè)節(jié)點(diǎn)，游標(biāo)處于不同的位置時(shí)這個(gè)節(jié)點(diǎn)可能看上去是一列，也可能是一行或是其他，這也就引出一個(gè)重要的觀念：為便于理解和操作，我們最好將游標(biāo)停在適當(dāng)?shù)奈恢蒙?，這在XMLDataObject的實(shí)際應(yīng)用中就是移動(dòng)當(dāng)前根節(jié)點(diǎn)。XMLDataObject結(jié)合了XML和數(shù)據(jù)對(duì)象的特性，對(duì)它的操作主要就是插入節(jié)點(diǎn)

6、和刪除節(jié)點(diǎn)、讀取以及更改節(jié)點(diǎn)的屬性和節(jié)點(diǎn)的值、數(shù)據(jù)的轉(zhuǎn)換等。下面將分門別類地介紹XMLDataObject的各個(gè)常用方法。 一、 構(gòu)造函數(shù)XMLDataObject()創(chuàng)建一個(gè)不含任何數(shù)據(jù)的空的數(shù)據(jù)對(duì)象，如果需要，我們可以在這個(gè)空的數(shù)據(jù)對(duì)象上插入數(shù)據(jù)。XMLDataObject(Element t) throws NodeNotFoundException用已知的元素t來構(gòu)造數(shù)據(jù)對(duì)象并將根節(jié)點(diǎn)設(shè)為該元素節(jié)點(diǎn)。XMLDataObject(Element t,String startPath) throws NodeNotFoundException在已知的元素t中找尋startPath參數(shù)指示的

7、節(jié)點(diǎn)，以找到的節(jié)點(diǎn)作為根節(jié)點(diǎn)來構(gòu)造數(shù)據(jù)對(duì)象。二、 移動(dòng)游標(biāo)void setXmlTree(Item t)將當(dāng)前根節(jié)點(diǎn)即游標(biāo)移動(dòng)到t參數(shù)所指的節(jié)點(diǎn)上，這需要我們事先獲得該節(jié)點(diǎn)對(duì)象。void rootScrollTo(String nodeName) throws DOException將游標(biāo)移動(dòng)到nodeName參數(shù)所指的的節(jié)點(diǎn)上，nodeName參數(shù)應(yīng)為全路徑方式的節(jié)點(diǎn)名稱。void resetRoot() throws DOException重置根節(jié)點(diǎn)，將游標(biāo)移動(dòng)到原始根節(jié)點(diǎn)上。三、 插入節(jié)點(diǎn)long insert(long row,String rowName,String cols) 在

8、row參數(shù)指定的行號(hào)上插入一個(gè)名為參數(shù)rowName指定名稱的空行，該行的各個(gè)列的名稱由cols參數(shù)指定。如果row參數(shù)小于0，則將該空行插入到第0行，如果row參數(shù)大于XMLDataObject數(shù)據(jù)的行數(shù)，則將該空行插入到最后。void insertAsChild(Element e1, Element e2) throws DOException將元素e2作為元素e1的子節(jié)點(diǎn)插入到XMLDataObject中。例如：插入前數(shù)據(jù)如下：<e1></e1><e2></e2>插入后數(shù)據(jù)變?yōu)椋?lt;e1><e2></e2>

9、;</e1>void insertAsChild(int position, String nodeName, String insertName, String insertValue) throws DOException在第position個(gè)名為nodeName的節(jié)點(diǎn)處插入子節(jié)點(diǎn)，子節(jié)點(diǎn)的名稱為insertName，值為insertValue。插入前數(shù)據(jù)如下：<ROW><F1>1</F1><F2>2</F2></ROW><ROW><F1>1</F1><F2>

10、2</F2></ROW>執(zhí)行下面兩行代碼：insertAsChild(-1, "ROOT.ROW.F1", "FF1", "11");insertAsChild(0, "ROOT.ROW", "RR1", "111");數(shù)據(jù)變?yōu)椋?lt;ROW><F1>1</F1><F2>2</F2><RR1>111</RR1><RR1>111</RR1></R

11、OW><ROW><F1><FF1>11</FF1></F1><F2>2</F2></ROW>void insertAsChild(int position, String nodeName, String insertNames, String insertValues) throws DOException在第position個(gè)名為nodeName的節(jié)點(diǎn)處插入若干子節(jié)點(diǎn)，子節(jié)點(diǎn)的名稱數(shù)組為insertNames，值數(shù)組為insertValues。名稱數(shù)組與值數(shù)組的長度要一致，名/值順序要一一

12、對(duì)應(yīng)。插入前數(shù)據(jù)如下：<ROW><F1>1</F1><F2>2</F2></ROW><ROW><F1>1</F1><F2>2</F2></ROW>執(zhí)行下面兩行代碼：insertAsChild(-1, "ROOT.ROW.F1", new String "FF1","FF2","FF3", new String "11","22",&q

13、uot;33");insertAsChild(0, "ROOT.ROW", new String "RR1","RR2","RR3", new String "111","222","333");數(shù)據(jù)變?yōu)椋?lt;ROW><F1>1</F1><F2>2</F2><RR1>111</RR1><RR2>222</RR2><RR3>333&

14、lt;/RR3></ROW><ROW><F1><FF1>11</FF1><FF2>22</FF2><FF3>33</FF3></F1><F2>2</F2></ROW>void insertAsParent(Element e1, Item item) throws DOException將item作為e1的父節(jié)點(diǎn)插入到XMLDataObject中。例如：插入前數(shù)據(jù)如下：<parent><e1></e1&g

15、t;</parent><item><item>插入后數(shù)據(jù)變?yōu)椋?lt;parent><item><e1></e1><item></parent>void insertAsSibling(Element e1, Element e2) throws DOException將e2作為e1的兄弟節(jié)點(diǎn)插入到XMLDataObject中。例如：插入前數(shù)據(jù)如下：<parent><e1></e1></parent><e2></e2>插入

16、后數(shù)據(jù)變?yōu)椋?lt;parent><e1></e1><e2></e2></parent>void insertDo(XMLDataObject xdo1)throws Exception將xdo1代表的XML數(shù)據(jù)對(duì)象插入本數(shù)據(jù)對(duì)象的根節(jié)點(diǎn)下，并設(shè)置當(dāng)前數(shù)據(jù)對(duì)象的根為原始根節(jié)點(diǎn)。例如：a是一個(gè)XMLDataObject對(duì)象，它的內(nèi)容為<root><clientinfo><custname>神州數(shù)碼5</custname><creditlevel>1</creditl

17、evel><custbirth>20021012</custbirth><occptypecode>1</occptypecode><certtype>1</certtype><certnum>5555555</certnum></clientinfo></root>b也是一個(gè)XMLDataObject對(duì)象，它的內(nèi)容為<userbasicinfo><svcnum>lt;/svcnum><password>

18、222452</password><custid>xinc0300000389</custid><corrtype>1</corrtype></userbasicinfo>執(zhí)行a.insertDo(b)后，a的數(shù)據(jù)為<root><clientinfo><custname>神州數(shù)碼5</custname><creditlevel>1</creditlevel><custbirth>20021012</custbirth><o

19、ccptypecode>1</occptypecode><certtype>1</certtype><certnum>5555555</certnum></clientinfo><userbasicinfo><svcnum>lt;/svcnum><password>222452</password><custid>xinc0300000389</custid><corrtype>1</corrtyp

20、e></userbasicinfo></root>void insertDo(XMLDataObject xdo1,String nodePath)throws Exception將xdo1代表的XML數(shù)據(jù)對(duì)象插入第一個(gè)名為nodePath的節(jié)點(diǎn)下，并設(shè)置當(dāng)前數(shù)據(jù)對(duì)象的根為原始根節(jié)點(diǎn)。例如：a是一個(gè)XMLDataObject對(duì)象，它的內(nèi)容為<root><clientinfo><custname>神州數(shù)碼5</custname><creditlevel>1</creditlevel><cu

21、stbirth>20021012</custbirth><occptypecode>1</occptypecode><certtype>1</certtype><certnum>5555555</certnum></clientinfo></root>b也是一個(gè)XMLDataObject對(duì)象，它的內(nèi)容為<userbasicinfo><svcnum>lt;/svcnum><password>222452</pas

22、sword><custid>xinc0300000389</custid><corrtype>1</corrtype></userbasicinfo>執(zhí)行a.insertDo(b,"clientinfo")后，a的數(shù)據(jù)為<root><clientinfo><custname>神州數(shù)碼5</custname><creditlevel>1</creditlevel><custbirth>20021012</custbirth

23、><occptypecode>1</occptypecode><certtype>1</certtype><certnum>5555555</certnum><userbasicinfo><svcnum>lt;/svcnum><password>222452</password><custid>xinc0300000389</custid><corrtype>1</corrtype></

24、userbasicinfo></clientinfo></root>void insertDo(XMLDataObject xdo1,String nodePath,int n)throws Exception將xdo1代表的XML數(shù)據(jù)對(duì)象插入第n個(gè)(從零開始計(jì)數(shù)）名為nodePath的節(jié)點(diǎn)下，并設(shè)置當(dāng)前數(shù)據(jù)對(duì)象的根為原始根節(jié)點(diǎn)。例如：a是一個(gè)XMLDataObject對(duì)象，它的內(nèi)容為<root><clientinfo><custname>神州數(shù)碼5</custname><creditlevel>1<

25、;/creditlevel><custbirth>20021012</custbirth><occptypecode>1</occptypecode><certtype>1</certtype><certnum>5555555</certnum></clientinfo><clientinfo><custname>神州數(shù)碼5</custname><creditlevel>1</creditlevel><custbir

26、th>20021012</custbirth><occptypecode>1</occptypecode><certtype>1</certtype><certnum>5555555</certnum></clientinfo></root>b也是一個(gè)XMLDataObject對(duì)象，它的內(nèi)容為<userbasicinfo><svcnum>lt;/svcnum><password>222452</password

27、><custid>xinc0300000389</custid><corrtype>1</corrtype></userbasicinfo>執(zhí)行a.insertDo(b,"clientinfo",1)后，a的數(shù)據(jù)為<root><clientinfo><custname>神州數(shù)碼5</custname><creditlevel>1</creditlevel><custbirth>20021012</custbirth>

28、;<occptypecode>1</occptypecode><certtype>1</certtype><certnum>5555555</certnum></clientinfo><clientinfo><custname>神州數(shù)碼5</custname><creditlevel>1</creditlevel><custbirth>20021012</custbirth><occptypecode>1</o

29、ccptypecode><certtype>1</certtype><certnum>5555555</certnum><userbasicinfo><svcnum>lt;/svcnum><password>222452</password><custid>xinc0300000389</custid><corrtype>1</corrtype></userbasicinfo></clientinf

30、o></root>四、 刪除節(jié)點(diǎn)void delete(Element e1) throws DOException將e1節(jié)點(diǎn)及該節(jié)點(diǎn)以下節(jié)點(diǎn)從XMLDataObject中刪除。例如：刪除前數(shù)據(jù)如下：<parent><e1></e1></parent>刪除后數(shù)據(jù)變?yōu)椋?lt;parent></parent>void deleteAndTakeOverTheChildren(Element e1) throws DOException將e1節(jié)點(diǎn)從XMLDataObject中刪除，但是接管e1節(jié)點(diǎn)以下的節(jié)點(diǎn)。例如：

31、刪除前數(shù)據(jù)如下：<parent><e1><item></item></e1></parent>刪除后數(shù)據(jù)變?yōu)椋?lt;parent><item></item></parent>五、 操縱數(shù)據(jù)對(duì)象static XMLDataObject unionXDO(XMLDataObject xdo) throws Exception合并xdo參數(shù)中的數(shù)據(jù)對(duì)象，并以第一個(gè)數(shù)據(jù)對(duì)象的根節(jié)點(diǎn)作為合并后的數(shù)據(jù)對(duì)象的根節(jié)點(diǎn)。例如：xdo0數(shù)據(jù)如下：<root><parent1>

32、<item1></item1></parent1></root>xdo1數(shù)據(jù)如下：<parent2><item2></item2></parent2>xdo2數(shù)據(jù)如下：<parent3><item3></item3></parent3>合并后數(shù)據(jù)變?yōu)椋?lt;root><parent1><item1></item1></parent1><parent2><item2><

33、/item2></parent2><parent3><item3></item3></parent3></root>Element getColElement(Element row,int col)取得row元素的第col列元素。例如：row元素如下：<Row><c1></c1><c2></c2></Row>那么取第0列元素得到的就是：<c1></c1>Element getColElement(Element row,

34、String colName)取得row元素的名為colName的列元素。int getColumnCount()取得列的個(gè)數(shù)（實(shí)際上是取第0行數(shù)據(jù)的列的個(gè)數(shù)）int getColumnCount(int arow)取得第arow行數(shù)據(jù)的列的個(gè)數(shù)。實(shí)際可能出現(xiàn)各行的列的個(gè)數(shù)不一樣的情況，例如：<or><ormap table="table1"><orcolumn columname="c1"></orcolumn><orcolumn columname="c2"></o

35、rcolumn></ormap><ormap table="table2"><orcolumn columname="c1"></ormap></or>Element getCutRoot()取得當(dāng)前起始路徑startPath所指定的子根節(jié)點(diǎn)XMLDataObject getDo(String nodePath) throws Exception取得nodePath指定的子節(jié)點(diǎn)所對(duì)應(yīng)的XMLDataObject對(duì)象。例如：假定以下xml文件對(duì)應(yīng)的XMLDataObject為xdo<S

36、TUDENT><ITEM><STUDENT_ID>crab</STUDENT_ID><STUDENT_NAME>alive</STUDENT_NAME></ITEM><ITEM><STUDENT_ID>whelk</STUDENT_ID><STUDENT_NAME>dead</STUDENT_NAME></ITEM></STUDENT>執(zhí)行xdo.getDo("ITEM")返回的XMLDataObject對(duì)應(yīng)的XM

37、L如下：<ITEM><STUDENT_ID>crab</STUDENT_ID><STUDENT_NAME>alive</STUDENT_NAME></ITEM>XMLDataObject getDo(String nodePath,int n) throws Exception取得nodePath指定的子節(jié)點(diǎn)下第n個(gè)XMLDataObject對(duì)象。例如：假定以下xml文件對(duì)應(yīng)的XMLDataObject為xdo<STUDENT><ITEM><STUDENT_ID>crab</STU

38、DENT_ID><STUDENT_NAME>alive</STUDENT_NAME></ITEM><ITEM><STUDENT_ID>whelk</STUDENT_ID><STUDENT_NAME>dead</STUDENT_NAME></ITEM></STUDENT>執(zhí)行xdo.getDo("ITEM",1)返回的XMLDataObject對(duì)應(yīng)的XML如下：<ITEM><STUDENT_ID>whelk</STUDEN

39、T_ID><STUDENT_NAME>dead</STUDENT_NAME></ITEM>ArrayList getItem(Element rt,String itemName)取得rt節(jié)點(diǎn)下名稱為itemName的所有節(jié)點(diǎn)。itemName應(yīng)為全路徑名稱。Object getItemAny(long arow,int col)取得第arow行第col列的節(jié)點(diǎn)或者節(jié)點(diǎn)的值（如果該節(jié)點(diǎn)為葉節(jié)點(diǎn)）。Object getItemAny(long arow,String colName)取得第arow行，列名稱為colName的節(jié)點(diǎn)或者節(jié)點(diǎn)的值（如果該節(jié)點(diǎn)為

40、葉節(jié)點(diǎn)）。Attribute getItemAttribute(long arow,int col)取得第arow行第col列的節(jié)點(diǎn)的屬性。Attribute getItemAttribute(long arow,String colName)取得第arow行，列名稱為colName的節(jié)點(diǎn)的屬性。Object getItemNameAny(long arow,int col)取得第arow行第col列的節(jié)點(diǎn)的名稱。Object getRow(long arow)取得arow參數(shù)指定的行節(jié)點(diǎn)。long getRowCount()取得行的個(gè)數(shù)。String getRowName(long arow

41、)取得arow參數(shù)指定的行的名稱。Element getUniqueItem(String itemName)取得名為itemName的唯一結(jié)點(diǎn)。boolean isBSingleRow()當(dāng)前數(shù)據(jù)對(duì)象是否是單行模式。即當(dāng)前的數(shù)據(jù)對(duì)象是否只表示一行數(shù)據(jù)。void rename(String newName)將當(dāng)前起始路徑startPath所指定的子根節(jié)點(diǎn)的名稱改為newName。void renameItem(long arow, String colName, String newName) throws IllegalArgumentException將第arow行名為colName的節(jié)點(diǎn)

42、的名稱改為newName。void renameRow(long arow, String newName)將arow參數(shù)指定的行節(jié)點(diǎn)的名稱改為newName。void reset()清除數(shù)據(jù)對(duì)象中的所有數(shù)據(jù)。void setBFullPathMode(boolean b)設(shè)置路徑模式為全路徑模式或者相對(duì)路徑模式。b=true時(shí)為全路徑模式，b=false時(shí)為相對(duì)路徑模式。六、 讀取數(shù)據(jù)String getItemValue(Element rt,String itemName)取得rt節(jié)點(diǎn)下名為itemName的節(jié)點(diǎn)的值。String getItemValue(String nodeName)取得根節(jié)點(diǎn)下名為nodeName的節(jié)點(diǎn)的值。String getRowAttributeValue(long arow,int att_idx)取得arow參數(shù)指定的行節(jié)點(diǎn)的第att_idx個(gè)屬性的值。String getRowAttributeValue(long arow,String name)取得arow參數(shù)指定的行節(jié)點(diǎn)的名為name的屬性的值。long retrieve() throws DOException取得startPath所指定的子根節(jié)點(diǎn)的數(shù)據(jù)。七、 更改數(shù)據(jù)void setItemAny(lon