【正文】 件的類型，可以是基礎(chǔ)類型，也可以是用戶自定義的復雜類型。 定義 傳輸文件格式 Transfomat 傳輸文件格式元素，表示在網(wǎng)絡(luò)中傳輸?shù)氖?XML 格式、 TXT 格式還是 URL格式。 備注：功能層 XML schema 的詳細設(shè)計可參考附錄 B。 表示層 XML schema 的設(shè)計 表示層是用來規(guī)定功能層描述的接口調(diào)用如何在網(wǎng)絡(luò)協(xié)議上表示的問題。它詳細的描述了功能層暴露的接口的消息格式，如發(fā)送消息的消息格式、返回消息的消息格式和報錯時候的消息格式。它主要有以下兩個作用： 1) 生成消息封裝類，供前臺調(diào)用。前臺將搜 集的數(shù)據(jù)封裝入對應(yīng)的消息封裝類中，然后將消息對象作為參數(shù)，再通過 RMI 調(diào)用管理容器中的請求方法。 2) 輔助完成序列化和反序列化過程，即當后臺接收到前臺發(fā)送的對象時，后臺需要將對象轉(zhuǎn)換成具有合適消息格式的 String 流，再與 SP 服務(wù)器進行通訊。 所以，表示層文件的設(shè)計最重要的是包含消息的具體信息，現(xiàn)提取主要元素如下： 定義 消息 Message 消息元素，用來規(guī)定操作之間傳遞數(shù)據(jù)的邏輯定義，一個表示層文件可包含多個消息元素。 屬性： Name：表明操作名稱，分為請求方法、響應(yīng)方法和報錯方法。 Transcontent：調(diào)用方法所傳輸?shù)膬?nèi)容。 定義 傳輸內(nèi)容 Transcontent 傳輸內(nèi)容元素，用來規(guī)定調(diào)用 SP 提供的方法時，需要的數(shù)據(jù)格式 。 備注： 表示層 XML schema 詳細設(shè)計可參考附錄 C。 傳輸層 XML schema 的設(shè)計 傳輸層規(guī)定采用什么傳輸協(xié)議及傳輸中所需要的信息。當 SP 提供的是一般服務(wù)時，它采用的傳輸協(xié)議有可能是 HTTP、 UDP、 TCP；當 SP 運用的是 web 服務(wù)時，它采用的是 SOAP 協(xié)議。傳輸層 XML 用來存儲數(shù)據(jù)傳輸所需的信息，它將用來協(xié)助傳輸代理完成傳輸任務(wù)。 定義 HTTP HTTP 元素 ，用于包含 HTTP 傳輸所需要的信息。 屬性： Version：表示 HTTP 的版本信息。 Location：表示 SP 提供的 web 服務(wù) ip 地址或域名信息。 URL： SP 提供的 web 服務(wù)連接地址。 Port：表示 SP 提供的 web 服務(wù)端口信息。 TransMethod：表示使用 HTTP 進行傳輸?shù)膫鬏敺椒ǎ?Get、 Head、 Post、put、 delete、 trace、 option 和 connect 這八種可選。它們依次表示請求資源的表示、返回報頭而不返回表示、向服務(wù)器提交數(shù)據(jù)、上傳資源的表示、刪除資源、返回收到的請求、 返回服務(wù)器支持的 HTTP 方法的列表和用于可配置為加密隧道以提高安全性的代理。 定義 UDP UDP 元素，用于包含 UDP 傳輸所需要的信息。 屬性： Location：表示 SP 提供的 web 服務(wù) ip 地址或域名信息。 Port：表示 SP 提供的 web 服務(wù)端口信息。 定義 TCP TCP 元素，用于包含 TCP 傳輸所需要的信息。 屬性： Location：表示 SP 提供的 web 服務(wù) ip 地址或域名信息。 Port：表示 SP 提供的 web 服務(wù)端口信息。 Byte：一次能傳輸?shù)淖畲笞止?jié)數(shù)。 定義 SOAP 用于包含 SOAP 傳輸所需要 的信息。當傳輸?shù)氖欠?web 服務(wù)時，將 SOAP的子元素全置空，設(shè)置為不可用狀態(tài)。 屬性： SOAPVersion： SOAP 的版本信息。 InterfaceURL：服務(wù)器端的接口的地址。 OperationURL：服務(wù)器端的制定的操作的地址。 備注：傳輸層 XML schema 詳細設(shè)計可參考附錄 D。 三層 XML文件解析的設(shè)計與實現(xiàn) 在可視化編輯器將 SP 的服務(wù)信息以 XML 文件格式生成后，解析模塊負責將生成的 XML 文件的數(shù)據(jù)封裝入不同的數(shù)據(jù)封裝類的對象中，以備之后結(jié)合Velocity 模板，共同生成需 要的 Agent 服務(wù)代理。 根據(jù)需求，我們可以將解析模塊分成元素封裝類組件和解析組件，來完成XML 文件中的數(shù)據(jù)到 Java 類的映射?？梢暬庉嬈髟谏?XML 文件之后，首先會調(diào)用解析組件去解析三層 XML 文件，其次將解析出的內(nèi)容映射到數(shù)據(jù)封裝類的對象中，然后再調(diào)用代碼生成器組件去結(jié)合數(shù)據(jù)封裝類的對象和設(shè)計好的模板共同生成 Agent 服務(wù)代理。 1) 元素封裝類的設(shè)計 數(shù)據(jù)封裝類的設(shè)計思想是將已生成的 XML文件的主要元素都封裝成對應(yīng)的類，然后將元素中的屬性和子元素都設(shè)置為類屬性，并且在類中為每個屬性設(shè)置SET 和 GET 方法， 以備以后的調(diào)用。 下面以為功能層的元素 Operation設(shè)計數(shù)據(jù)封裝類為例： Operation name=GetInsu url= Parameter message=GetInsuRequest name=GetInsuRequest type=Input/Parameter Parameter message=GetInsuResponse name=GetInsuResponse type=Output /Parameter Fault message = ―Fault‖, name = ―Fault‖, type = ―Output‖/ /Operation 定義 OperationBean 類 屬性： Name ： string 類型，其屬性值代表操作名稱。 URL： string 類型，其屬性值代表處理該操作的服務(wù)器內(nèi)程序的地址。 Parameters： ArrayList Parameter類型，數(shù)組里包含參數(shù)的信息。 Fault： Message 類型，其值表示當消息處理出錯時候，后臺獲得的消息格式。 方法： 對上述每個屬性的 Set 和 Get 方法。 2) XML 解析的主要過程 解析類主要是通過 Dom4j 技術(shù)結(jié)合 XPath 技術(shù)，來讀取生成的 XML 文件中節(jié)點信息，然后將獲取的數(shù)據(jù)封裝入元素封裝類的對象中。其中 XPath 則是一門在 XML 文檔中查找信息的語言， XPath 可用來在 XML 文檔中對元素和屬性進行遍歷。 對于上述的 Operation 元素，現(xiàn)定義 OperationParser 類： 定義 Operation 解析類 OperationParser Operation 解析類負責獲取 Operation 中屬性和子元素的相關(guān)信息。 方法： Public OperationBean parseOperation(Element elt) 解析類唯一暴露的接口，用來解析 elt 對象，獲得其中的屬性和子元素信息，并將其封裝入 OperationBean 類對象中返回。 Private string getName(Element elt) 返回獲得的 Operation 的 name 屬性值。 Private string getURL(Element elt) 返 回獲得的 Operation 的 URL 屬性值。 Private ArrayListParameter getParameters(Element elt) 返回獲得的 Operation 中的 Parameter 列表。 Private Message getFault(Element elt) 返回獲得的 Operation 中的 Fault 消息格式。 下面以解析 Operation 元素為例，描述一下元素的解析流程： 1) 首先聲明一個 Operation 元素封裝類 OperationBean 的對象。 2) 根據(jù)方法 parseOperation 獲得參數(shù) operaelt, 通過調(diào)用 getName 方法獲得name 屬性，將其賦值給封裝類對象。其中 getName 方法的具體實現(xiàn)時調(diào)用 Dom4j 中的 getAttribute(―name‖)。 3) 方法 parseOperation 調(diào)用 getURL 方法，從而獲得 URL 值，然后將其賦值給元素封裝類對象。其中 getURL 的實現(xiàn)過程與 getName 相似。 4) 方法 parseOperation 調(diào)用 getParameters 方法，從而獲得 Parameter 值，然后將其賦值給元素封裝對象，其中 getParameters 的實 現(xiàn)時調(diào)用 parameter的解析類提供的接口 ParameterParser。 5) 方法 parseOperation 調(diào)用 getFault 方法，獲得 Fault 的消息格式。其中g(shù)etFault 的具體實現(xiàn)是調(diào)用 MessageParser 解析類提供的接口parseMessage。 6) 返回被賦值后的元素封裝類的對象。 數(shù)據(jù)轉(zhuǎn)換模塊的設(shè)計與實現(xiàn) 數(shù)據(jù)轉(zhuǎn)換模塊負責實現(xiàn)將從前臺接收的對象格式和與服務(wù)器之間約定的通訊格式字符串之間的格式轉(zhuǎn)換。在項目實際運行中，后臺會接收到前臺會發(fā)送出一個服務(wù)請求類的對象，而后臺和服務(wù)器之間的 約定的通信格式并非是對象格式，所以，后臺需要將從前臺獲取的請求類的對象轉(zhuǎn)換成為符合約定的格式（ XML 格式、文本格式、 URL 格式和 SOAP 格式），同時要轉(zhuǎn)化成對應(yīng)的字符串，再進行消息通訊。 目標數(shù)據(jù)格式介紹 SP 服務(wù)提供商所提供的服務(wù)要求的信息交互的格式有分不同種類，下面分別列舉了 XML 格式、 SOAP 格式、文本格式、和 URL 格式的例子。 1) XML 格式 當服務(wù)提供商的服務(wù)器應(yīng)用的是 XML 格式進行通訊時，數(shù)據(jù)轉(zhuǎn)換模塊將從 前臺獲取對象轉(zhuǎn)換為服務(wù)器要求的 XML 格式，并且將其拼接成字符串以在網(wǎng)絡(luò)中傳播，具體的 實例如下： 發(fā)送 Request 消息簡要格式： request=?xml version= encoding=utf8 ?GetBookPriceRequest nameJava / name/GetBookPriceRequest 獲得 Response 消息簡要格式 : ?xml version= encoding=utf8 ? GetBookPriceResponse Price/Price /GetBookPriceResponse 很容易看出，上述的請求消息是要查詢 Java 這本書的價格，而服務(wù)器處理后返回的是書的價格為 元。 2) SOAP 格式 當服務(wù)提供商應(yīng)用的是 Web 服務(wù)時，它通常是基于 SOAP 協(xié)議。因此，當從前臺獲得請求對象后，數(shù)據(jù)裝換模塊將對象中信息封裝入 SOAP 的信封中，并且將其拼接成字符串形式進行發(fā)送。具體的實例如下： 發(fā)送 Request 消息格式： ?xml version=?soap:Envelope xmlns:soap= envelopesoap:encodingStyle= xmlns:m= m:GetStockPrice m:StockName IBM /m:StockName /m:GetStockPrice/soap:Body/soap:Envelope 獲得 Response 消息格式： ?xml version=?soap:Envelope xmlns :soap= /2022/12/soap –envelope soap:encodingStyle= soap:Body xmlns:m=/m:GetStockPriceResponse/soap:Body/soap:Envelope 在上面的例子中，一個 GetStockPrice 請求被發(fā)送到了服務(wù)器。此請求有一 個 StockName 參數(shù)，而在響應(yīng)中則會返回一個 Price 參數(shù)。此功能的命名空間被定義在此地址中： 3) 文本格式 當服務(wù)提供商提供的消息的格式為 TXT 文本格式時，前臺在從頁面獲取信息時，就已將輸入的信息根 據(jù)事先后臺和服務(wù)提供商約定好的格式（參考附錄 E）映射到具體的數(shù)字，并把數(shù)字封裝入請求對象后發(fā)送給容器。不過這種格式的傳輸只限于簡單的數(shù)據(jù)傳輸，只有當請求和響應(yīng)元素封裝類中的屬性是基礎(chǔ)類型或者 string 類型時候，才能用文本格式表示。具體的實例如下： 發(fā)送 Request 消息格式： 100D8240000010000000000000000202200 獲得 Response 消息格式： 070004HS00888898982022610100D8240000010000000000000000202200 乍看起來這一串數(shù)字看不懂是什么意思，不過只要參考事先與服務(wù)提供商約定好的格式（參考服務(wù)）就可以明白，在 Request 消息中，前兩位即 07 表示企業(yè)碼，隨后的兩位 00 表示服務(wù)碼，在隨后的兩位 04 表示內(nèi)部包標示，在隨后的兩位 HS 表示店面號，以此類推。 4) URL 格式 當服務(wù)提供商提供的服務(wù)為 URL 格式 時，后臺在獲取請求對象后，把對象裝換成 ―ur