EOS+60+基礎(chǔ)參考手冊_xpath.doc

Primeton EOS 6.0 基礎(chǔ)參考手冊目錄目 錄第1章 模板使用說明1-11.1 特別說明1-11.2 標(biāo)題1-21.3 圖1-21.4 表1-21.5 并列關(guān)系和順序關(guān)系1-31.5.1 并列關(guān)系1-31.5.2 順序關(guān)系1-31.6 說明和注意1-41.6.1 單行文字1-41.6.2 多行文字1-41.6.3 表格中的說明1-41.7 代碼1-5第2章 測試標(biāo)題級別2-12.1 標(biāo)題22-12.1.1 標(biāo)題32-12.2 標(biāo)題212-12.2.1 標(biāo)題312-12.2.2 標(biāo)題322-1第3章 客戶端接入錯(cuò)誤！未定義書簽。3.1 概述3-13.2 相關(guān)概念3-13.2.1 服務(wù)存儲(chǔ)庫錯(cuò)誤！未定義書簽。3.2.2 服務(wù)上下文錯(cuò)誤！未定義書簽。3.2.3 服務(wù)消息處理攔截錯(cuò)誤！未定義書簽。3.2.4 用戶對象權(quán)限驗(yàn)證錯(cuò)誤！未定義書簽。3.3 接口及方法說明3-43.3.1 包含的類3-43.3.2 類的方法3-5iPrimeton EOS 6.0 基礎(chǔ)參考手冊第1章 模板使用說明第1章 模板使用說明允許使用的樣式都在本章中列出，請不要自定義其他樣式，以免影響模板的正常使用。使用樣式的方法為：從樣式下拉列表框中選擇，如圖1-1所示。圖1-1 樣式使用說明正文文字統(tǒng)一使用“正文”樣式，提供快捷鍵“F5”。1.1 特別說明從其他文檔中拷貝粘貼時(shí)，請務(wù)必選擇“僅保留文本”，如圖1-2所示。否則會(huì)帶入很多不屬于本模板的非法樣式，并破壞模板中的樣式，本人概不負(fù)責(zé)！圖1-2 粘貼請選擇僅保留文本1.2 標(biāo)題支持“標(biāo)題1”“標(biāo)題7”，共7級標(biāo)題，不允許自定義其他標(biāo)題樣式。更換章（即標(biāo)題1）時(shí)，請插入“分節(jié)符”。1.3 圖貼圖（包括界面截圖、Visio圖等）時(shí)，請選中圖片，使用“Figure”樣式，按“回車”鍵后，自動(dòng)出現(xiàn)“Figure Description”樣式的圖說明。圖編號會(huì)隨著“標(biāo)題1”的變化，重新開始編號。1.4 表表格上面可以先使用“Table Description”樣式的表說明。表編號會(huì)隨著“標(biāo)題1”的變化，重新開始編號。插入一個(gè)表格后，按以下步驟設(shè)置表格樣式：(1) 選中該表格左上角的標(biāo)記，然后選擇“Table”樣式，設(shè)定整個(gè)表格的樣式。(2) 選中表格的第一行，選擇“Table Heading”樣式，設(shè)定表頭的樣式。(3) 選中表格其他行，選擇“Table Text”樣式，設(shè)定表格文字的樣式。舉例如表1-1所示。表1-1 表格說明參數(shù)名稱參數(shù)說明取值范圍日期& 說明：更簡便的方式是直接拷貝上表，修改內(nèi)容即可。1.5 并列關(guān)系和順序關(guān)系1.5.1 并列關(guān)系并列關(guān)系表述沒有任何順序，但同屬于一個(gè)范疇的內(nèi)容。使用“Item List”樣式，如下：l 并列內(nèi)容1l 并列內(nèi)容2l 表格中的文字如需表示并列關(guān)系，請使用“Item List in Table”樣式。如下表所示。表1-2 表格說明參數(shù)名稱參數(shù)說明取值范圍日期l 描述文字1l 描述文字21.5.2 順序關(guān)系順序關(guān)系表述有前后關(guān)聯(lián)的內(nèi)容，一般用于描述操作步驟等，如下：(1) 步驟1(2) 步驟2(3) & 說明：默認(rèn)接續(xù)上一個(gè)步驟，有時(shí)需要重新從(1)開始編號，只需選中需要置為(1)的編號，右鍵單擊，從彈出菜單中選擇“重新開始編號”即可。表格中的文字如需表示順序關(guān)系，請使用“Item Step in Table”樣式。如下表所示。表1-3 表格說明參數(shù)名稱參數(shù)說明取值范圍日期(1) 描述文字1(2) 描述文字21.6 說明和注意1.6.1 單行文字對于單行文字的說明或注意，請拷貝如下樣式，修改內(nèi)容即可。頭部使用“Notes Heading”樣式，文字使用“Notes Text”樣式。建議下面留一個(gè)空行。& 說明：更簡便的方式是直接拷貝上表，修改內(nèi)容即可。 注意：用戶安裝開發(fā)版時(shí)，系統(tǒng)會(huì)缺省安裝JBOSS 3.2.5。開發(fā)版不支持其它應(yīng)用服務(wù)器。1.6.2 多行文字對于多行文字的說明或注意，請拷貝如下樣式，修改內(nèi)容即可。頭部使用“Notes Heading”樣式，文字使用“Notes Text List”樣式。建議下面留一個(gè)空行。& 說明：l 如果您想成為gocom社區(qū)用戶，請到注冊。l 用戶選擇安裝社區(qū)版時(shí)，系統(tǒng)會(huì)缺省安裝JBOSS 3.2.5。 注意：l 注意事項(xiàng)1。l 注意事項(xiàng)2。1.6.3 表格中的說明表格中的說明請拷貝如下樣式。頭部使用“Notes Heading in Table”樣式，單行文字使用“Notes Text in Table”樣式，多行文字使用“Notes Text List in Table”樣式。表1-4 表格說明參數(shù)名稱參數(shù)說明取值范圍日期關(guān)于日期的描述& 說明：l 說明1l 說明2日期的取值范圍& 說明：說明文字1.7 代碼代碼使用“Terminal Display”樣式。3-8Primeton EOS 6.0 基礎(chǔ)參考手冊第2章 測試標(biāo)題級別第2章 測試標(biāo)題級別2.1 標(biāo)題22.1.1 標(biāo)題 標(biāo)題.1 標(biāo)題.1.1 標(biāo)題.1.1.1 標(biāo)題72.2 標(biāo)題212.2.1 標(biāo)題312.2.2 標(biāo)題3 標(biāo)題4 標(biāo)題4.1 標(biāo)題5.2 標(biāo)題52Primeton EOS 6.0 基礎(chǔ)參考手冊Error! Reference source not found.Error! Reference source not found.第3章 XPath3.1 概述XPath提供了訪問對象的內(nèi)容的一組語法，通過該語法，可以遍歷訪問對象；這些對象可以以JavaBean,SDO,Map等各種形式存在，也可以是他們的混合形式。利用xpath語法，屏蔽和統(tǒng)一了這些對象的訪問方式。3.2 相關(guān)概念3.2.1 XPath語法EOS支持的XPath語法如下：path := /? (step /)* stepstep := ? property| property index_from_1 |# ;如果是DOM節(jié)點(diǎn)，取節(jié)點(diǎn)的值| property . index_from_0| reference ? attribute = value | .property := NCName ; may be simple or complex typeattribute := NCName ; must be simple typereference : NCName ; index_from_0 := Digitsindex_from_1 := NotZero (Digits)?value := LiteralLiteral := * | * NotZero := 1-9Digits := 0-9+EOS XPath與SDO XPath的語法有以下差異l Step不支持.回溯 l 不支持schemel Value只支持字符串，不支持?jǐn)?shù)字和布爾值l 支持/#，獲取DOM節(jié)點(diǎn)的值舉一個(gè)對DOM節(jié)點(diǎn)值的訪問的例子，假設(shè)在一個(gè)混合對象JavaBean中,有一個(gè)Element類型的名稱為elem的DOM對象。該DOM對象如下zhangsan那么就可以通過xpath語法elem/#獲取DOM節(jié)點(diǎn)的值”zhangsan”了。根據(jù)上面列出的xpath語法，我們可以看到，除了標(biāo)準(zhǔn)Xpath語法外，EOS的Xpath語法額外添加了一種下標(biāo)取值的語法，即.以0開始的下標(biāo)?！癲epartment.0/name”相當(dāng)于“department1/name”。3.2.2 XPath所支持訪問的對象Xpath支持的訪問的對象有以下幾種：l Javabean：普通的java Bean對象l DataObject：SDO的DataObject對象l Collection包括數(shù)組，Listl Map：Map數(shù)據(jù)對象l Document：Document文檔對象l PageContext：Http請求的PageContext對象l ServletContext：Http請求的ServletContext對象l HttpServletRequest：Http請求的ServletRequest對象l HttpSession：Http請求的HttpSession對象3.2.3 類型映射（type mapping）在根據(jù)xpath創(chuàng)建對象，對對象屬性進(jìn)行賦值的時(shí)候，如果不能夠從對象的數(shù)據(jù)元信息（比如從DataObject的Type中獲取的屬性，從JavaBean,Map中獲取屬性的類型）中得到當(dāng)前要?jiǎng)?chuàng)建的節(jié)點(diǎn)信息，那么就需要根據(jù)類型映射獲取該節(jié)點(diǎn)的類型。在根據(jù)xpath，對對象進(jìn)行賦值操作時(shí)，如果要?jiǎng)討B(tài)創(chuàng)建對象或?qū)傩?，那么類型映射的?guī)則如下：Key(前綴是xpath:)Value備注xpath：xpath表達(dá)式j(luò)ava：實(shí)現(xiàn)類的名稱如果實(shí)現(xiàn)類的名稱是以 為后綴的，表示要?jiǎng)?chuàng)建一個(gè)數(shù)組xpath：xpath表達(dá)式sdo：DataObject類型名稱如果類型名稱是以 為后綴的，表示要?jiǎng)?chuàng)建一個(gè)DataObject數(shù)組例如：對于xpath和java實(shí)現(xiàn)類型的映射com.primeton.java包下有類AddressTypeclass AddressTypeprivate String type;public void setType(String)this.type=type;XPathLocator locator=XPathLocator.getInstance();Map typeMapping=new HashMap();typeMapping.put(“xpath:/property”,”java:com.primeton.java.AddressType”);locator.setTypeMappings(typeMapping);locator.setValue(new HashMap(),”/property/type”,”test”);XPathLocator locator2=XPathLocator.getInstance();Map typeMapping2=new HashMap();typeMapping2.put(“xpath:/property”,”java:com.primeton.java.AddressType”);locator2.setTypeMapping(typeMapping2);locator2.setValue(new HashMap(),”property1/type”,”test”);對于xpath和DataObject實(shí)現(xiàn)類型的映射定義了類型為com.primeton.sdo.AddressType的sdo數(shù)據(jù)對象,它包含有名稱type的屬性XPathLocator locator=XPathLocator.getInstance();Map typeMapping=new HashMap();typeMapping.put(“xpath:/property”,”sdo:com.primeton.java.AddressType”);locator.setTypeMappings(typeMapping);locator.setValue(new HashMap(),”/property/type”,”test”);XPathLocator locator2=XPathLocator.getInstance();Map typeMapping2=new HashMap();typeMapping2.put(“xpath:/property”,”sdo:com.primeton.java.AddressType”);locator2.setTypeMapping(typeMapping2);locator2.setValue(new HashMap(),”property1/type”,”test”);3.3 規(guī)則和約束3.3.1 類型映射設(shè)置類型映射時(shí)，對于集合類型（List），不支持設(shè)置集合的元素類型。比如類似下面的類型映射是不支持的Map typeMapping=new HashMap();typeMapping.put(“xpath:/property”,”java:java.util.ArrayList”)3.3.2 動(dòng)態(tài)的創(chuàng)建節(jié)點(diǎn) 節(jié)點(diǎn)的父對象為Map結(jié)構(gòu)當(dāng)該節(jié)點(diǎn)的父對象為Map,且該節(jié)點(diǎn)沒有指定類型映射，則會(huì)為該節(jié)點(diǎn)生成HashMap或者Object數(shù)組，具體生成哪種類型，根據(jù)xpath表達(dá)式語法而定;當(dāng)xpath的節(jié)點(diǎn)xpath為propertyindex（其中index從1開始）時(shí)，生成Object數(shù)組；否則生成HashMap對象。XPathLocator locator=XPathLocator.getInstance();locator.setValue(new HashMap(),”property1”,”test”);等同于Map root=new HashMap();Object data=new Object1;data0=”test”;root.put(“property”,data);XPathLocator locator2=XPathLocator.getInstance();locator2.setValue(new HashMap(),”property/subProperty”,”test”);等同于Map root=new HashMap();Map subMap=new HashMap();subMap.put(“subProperty”,”test”);root.put(“property”,subMap); 節(jié)點(diǎn)的父對象為非Map的結(jié)構(gòu)當(dāng)需要?jiǎng)討B(tài)創(chuàng)建的節(jié)點(diǎn)的父對象為其他類型，則會(huì)根據(jù)父對象的元信息，取得該節(jié)點(diǎn)所對應(yīng)的類型。如果該類型是一個(gè)可實(shí)例化的對象，就創(chuàng)建對象。否則就根據(jù)類型映射查找該節(jié)點(diǎn)對應(yīng)的類型，創(chuàng)建對象，如果沒有查找到，就拋異常定義了這樣一個(gè)類CompoundClassclass CompoundClassprivate List datas;public List getDatas()return this.datas;public void setDatas(List datas)this.datas=datas;CompoundClass clazz=new CompoundClass();XPathLocator locator=XPathLocator.getInstance();locator.setValue(new HashMap(),”property1”,”test”);等同于Map root=new HashMap();Object data=new Object1;data0=”test”;root.put(“property”,data);XPathLocator locator2=XPathLocator.getInstance();locator2.setValue(new HashMap(),”property/subProperty”,”test”);等同于Map root=new HashMap();Map subMap=new HashMap();subMap.put(“subProperty”,”test”);root.put(“property”,subMap);3.3.3 對DOM進(jìn)行訪問 對Node的xpath數(shù)據(jù)讀取約束對Node進(jìn)行xpath訪問的時(shí)候，Document或者Element的根的名稱被忽略。比如JavaBean中有一個(gè)名稱為dom的Document對象，名稱為elem的Element對象。class JavaBeanprivate Document dom;private Element elem;publc Document getDom()return dom;public Element getElem()return elem;其中dom和elem屬性都是下面的結(jié)構(gòu) 那么訪問Document 的order節(jié)點(diǎn)的xpath為 /dom/order訪問Element的order節(jié)點(diǎn)的xpath為 /elem/order 對Node的xpath操作對Node進(jìn)行操作時(shí), XPathLocator 中的addValue , setValue，getValues都有特定的語義。相關(guān)的語義結(jié)合下面的例子說明：addValue 數(shù)據(jù)： xxxx yyyyy 場景一： addValue(/Account/Addressid=1, jjjj); 結(jié)果： xxxxjjjj yyyyy 場景二： addValue(/Account/Order, customerNode); 結(jié)果： xxxx yyyyy 場景三：setValue(/Account/Order， newOrderNode) xxxx yyyyy 場景四：List nodes=getValues(“Account/Address”)獲取到了Account/Address的結(jié)點(diǎn)列表3.4 接口及方法說明3.4.1 包含的類表3-1 xpath包含的類類名描述com.eos.data.xpath.XPathLocator使用XPath語法對各種混合對象進(jìn)行取值和設(shè)置的類3.4.2 類的方法 com.eos.data.xpath.XPathLocator.1 類的說明使用XPath語法對各種混合對象進(jìn)行取值和設(shè)置的類。.2 類的方法表3-2 com.eos.data.xpath.XPathLocator類的方法方法說明void setTypeMappings(Map mappin