• 介紹
• 環(huán)境
• Xerces DOM解析器類
  　　類層次結(jié)構(gòu)
  　　解析器狀態(tài)
  　　解析器池化
• 數(shù)據(jù)采集類
• 解析器測試應(yīng)用
• 代碼樣本的系統(tǒng)安裝、構(gòu)建和執(zhí)行
  　　Xerces安裝
  　　Windows操作系統(tǒng)
  　　Linux操作系統(tǒng)
  　　構(gòu)建Xerces DOM解析器應(yīng)用
  　　Windows操作系統(tǒng)
  　　Linux操作系統(tǒng)
  　　運行應(yīng)用
• 其它開發(fā)商服務(wù)
• 術(shù)語縮寫
• 了解更多信息
  

介紹

　　Xerces開放源代碼XML解析器是Apache XML項目（http://xml.apache.org/）XML項目組的一個組成部分。過去幾年，它們在面向web和其它類型的應(yīng)用中已得到廣泛的應(yīng)用。電話應(yīng)用也不例外。VoiceXML解譯器OpenVXI就使用Xerces作為其核心技術(shù)。呼叫控制協(xié)議，如會話發(fā)起協(xié)議（SIP）也使用XML來控制和傳輸數(shù)據(jù)。

　　Dialogic的通信服務(wù)框架（CSF）也從使用XML工具中獲益巨大。本應(yīng)用注釋具體講述的就是如何將Xerces DOM解析器集成至CSF中，以及如何在簡單的測試程序中使用Xerces DOM解析器。本文闡述的原則即是要幫助讀者全面地使用Xerces DOM，以便于他們更好地構(gòu)建其各自的CSF應(yīng)用。

　　最初的XML集成一般選用的是XML DOM模式，而不是XML的簡單API（SAX）模式。雖然不如SAX那樣高效，但是這種結(jié)構(gòu)化更明顯的DOM模式卻可以提供更可行的兩步流程。XML文件首先被解析成一個樹型結(jié)構(gòu)。任何的語法錯誤均會在此時被標(biāo)記出來。樹型結(jié)構(gòu)建成之后，數(shù)據(jù)收集程序就開始遍歷該樹型結(jié)構(gòu)，將需要的數(shù)據(jù)取出來，放在應(yīng)用指定的數(shù)據(jù)結(jié)構(gòu)中。

　　此處我們假設(shè)讀者已熟悉基本的CSF概念。如需閱讀本框架的介紹，請訪問http://resource.Dialogic.com/telecom/support/appnotes/8989/index.htm，
詳細(xì)參閱《通信服務(wù)框架（CSF）介紹》。如欲獲得連接至其它CSF主題的鏈接地址，請訪問：http://resource.Dialogic.com/telecom/ support/solutions/index.htm。

環(huán)境

　　操作系統(tǒng)為Windows*時，本文所述方法之測試環(huán)境所使用的軟件有：

操作系統(tǒng)為Linux*時：

• Red Hat* Enterprise Linux 3.0 update 1


• Xerces C++，2.6.0版


• 面向Linux的DialogicNetStructure 主機媒體處理（HMP）軟件Release 1.2。

Xerces DOM解析器類

類層次結(jié)構(gòu)

　　Xerces DOM解析器對象的類層次結(jié)構(gòu)非常類似于其它CSF電話網(wǎng)絡(luò)、數(shù)據(jù)通信或語音設(shè)備。抽象的DOM解析器設(shè)備包括實施任何類似解析器的有用狀態(tài)信息和基本數(shù)據(jù)及方法。具體的XercesDOMParser類出自于抽象類，并提供了針對特定Xerces解析器的具體方法和數(shù)據(jù)。其它類似的DOM解析器如果添加到CSF，也可以基于同樣的抽象類進行構(gòu)建。圖1詳細(xì)描述了該類層次結(jié)構(gòu)。

解析器狀態(tài)

　　Xerces DOM解析器是CSF中的一個有狀態(tài)的實體，非常類似于通信或語音設(shè)備。相對而言，它更為簡單，因為它不是異步的。所以它的狀態(tài)種類更少。例如，它不需"正在進行"狀態(tài)。此外，由于本身是同步的，所以它也不需使用CSF命令對象。命令對象與異步命令搭配使用時可發(fā)揮出色的運行效果，但是除非應(yīng)用邏輯完全受同一隊列的事件/命令的驅(qū)使，否則很容易出現(xiàn)順序問題。這樣就有可能需要為同步命令如Xerces解析創(chuàng)建一個完成事件（completion event）。而且如果要為CSF添加其它采用異步模式的XML解析器，那么可能也會出現(xiàn)上述結(jié)果。所以這個時候，我們采取了相對簡單的同步方法。

圖2表示的是解析器的狀態(tài)機制。其運轉(zhuǎn)過程具體如下。

• 首先創(chuàng)建解析器對象，此時對象為未初始化狀態(tài)。經(jīng)過Xerces XML4C子系統(tǒng)的初始化，對象進入可用狀態(tài)。


• 然后初始化DOM解析器，指定錯誤處理程序，配置驗證模式，此時進入打開狀態(tài)。


• 此時對象就可以解析XML文件了。完成一個同步解析操作，就可以創(chuàng)建出一個表示XML文件的分層DOM樹結(jié)構(gòu)。在解析過程中，將自動執(zhí)行XML語法檢查。如果文件存在語法問題，解析操作就將會被中止，以排除該語法錯誤。Xerces還會將詳細(xì)的錯誤信息記錄在CSF事件日志上。

圖2. Xerces DOM解析器的狀態(tài)機制

進入已解析狀態(tài)后，就可以通過應(yīng)用指定的方法遍歷DOM樹結(jié)構(gòu)，然后收集相關(guān)數(shù)據(jù)并轉(zhuǎn)移至某個存儲地點，以便應(yīng)用以后使用。

　　完成DOM樹結(jié)構(gòu)掃描后，即可發(fā)布掃描結(jié)果，解析器對象返回打開狀態(tài)，以便進行另外的XML解析。

解析器池化

　　Xerces DOM解析器是CSF池化對象。CPoolObj類是一個C++模板，可以將對象存放在可擴展對象池中，這些對象都已經(jīng)過初始化、可以隨時使用。當(dāng)使用GetAvailable()方法向池請求一個對象時，會首先搜索一個對象的向量以查找是否有未使用的條目。如果找到，對象就會被返回。否則就將創(chuàng)建新的對象。當(dāng)不再需要對象時，就可以通過Release()方法將其返回池中，以供日后使用。這樣可以節(jié)省運行時期間刪除和初始化對象的成本。

　　池化運算還須考慮到對象的狀態(tài)變化。每個新對象被創(chuàng)建后，它必定會進入打開狀態(tài)。對象釋放后，又必定會回到打開狀態(tài)。最后，當(dāng)應(yīng)用被關(guān)閉后，池還需要清空，池中的對象也必須全部刪除。

數(shù)據(jù)采集類

　　XML文件完成解析后，會有兩個數(shù)據(jù)收集類來遍歷DOM樹結(jié)構(gòu)，以提取所需要的數(shù)據(jù)。

　　第一組類僅僅概況性地表述STL容器――列表――即用來存儲已解析數(shù)據(jù)的容器。具體的容器類源自于抽象的基礎(chǔ)類。

　　AparsedValueContainer類沒有數(shù)據(jù)和方法。它僅用于配合收集程序類的運行。（見圖3。）抽象收集程序類純虛擬功能CollectValues()的第二個影響因素是容器，當(dāng)在具體收集程序類實施中定義了容器時，必須使用通用的基礎(chǔ)類。所以在真正使用容器之前，必須在每個具體的收集程序類中進行向下類型轉(zhuǎn)換。

該演示使用了兩個不同的對象列表。其中一張列表的內(nèi)容是一些描述SIP URL（SIP地址）的字符串。另一張列表的內(nèi)容則是一些描述一組組相關(guān)CSF配置信息的對象。

　　對STL容器列表的訪問還將受到Boost范圍鎖的保護。測試程序只是順序訪問每個列表――在收集程序類中添加數(shù)據(jù)，然后等列表構(gòu)建完成后，在列表上循環(huán)記錄變量值。但是其它未來的使用方法或許能夠并發(fā)訪問列表。因此鎖的使用十分必要。

　　第二個必要的類是收集程序類。它源自于抽象類，不過這些抽象類僅用于命名純虛擬方法CollectValues，每個具體的類中均必須有這一命名。圖4表示的是測試應(yīng)用中所使用的收集程序類。

　　具體類中的CollectValues方法負(fù)責(zé)定義每個具體XML文件圖解的DOM樹遍歷。它們都知道每個XML文件中找到的DOM組件與屬性的名稱，以及存放變量值所需要的STL容器類。通過遞歸呼叫（recursive call）的使用，它們可以遍歷DOM樹結(jié)構(gòu)并傳輸Xerces方法返回的屬性，然后存儲至容器。

例如，我們可以看這樣一段XML文件：



　　它由三個要素組成――CSFConfig、CONFDEVICES和ConfDevEntry。前兩個要素只用于為解析和數(shù)據(jù)收集過程中的每個ConfDevEntry提供環(huán)境。CONFDEVICES要素用于確定值所駐留的STL容器，容器（CONFDEVICELIST）的每個節(jié)點都包含一個對象，對象的成員變量名稱類似于XML文件中的屬性名稱――如ConfType、ConfDevice、Info1等等。成員變量的值將為屬性的值――DCB、dcbB1D1、及空值。

　　現(xiàn)在我們已經(jīng)了解了從XML到應(yīng)用指定數(shù)據(jù)容器的整個過程，但讀者在將Xerces DOM解析器類用于自己的XML文件上時，還須注意一點。

　　對于任何新的XML文件定義，只需要編寫一個描述容器類的對象即可，然后再編寫一個具體的類，以接收從已解析DOM樹結(jié)構(gòu)傳輸?shù)臄?shù)據(jù)。

　　在定義一個新XML圖解時，我們建議首先使用Mozilla*或Microsoft Internet Explorer*等網(wǎng)絡(luò)瀏覽器檢查一下文件的語法。瀏覽器能夠以更清晰的視圖顯示文件的語法，而且更重要的是，瀏覽器還可以提供語法錯誤訊息，并在XML文件中相應(yīng)的地方指示出來。

解析器測試應(yīng)用

　　基本Xerces解析器和數(shù)據(jù)收集程序類還帶有一個測試應(yīng)用樣本。它能夠執(zhí)行兩類XML文件測試。第一個是對兩個不同XML文件進行單線程、重復(fù)解析。它將驗證和解析XML文件的語法，并將結(jié)果傳輸至應(yīng)用定義的STL容器。然后再使用CSF的日志系統(tǒng)顯示容器的組成內(nèi)容。

　　第二個測試是多線程的解析器負(fù)載測試。應(yīng)用將啟動四個線程。然后這些線程再初始化多個解析器，以便同時通過相同的解析順序進行解析。這樣可以驗證多個解析器是否可以同時在同一個系統(tǒng)上使用，以及負(fù)載測試的實用性。當(dāng)延期運行時，負(fù)載測試也可以用于檢查是否存在內(nèi)存或其它系統(tǒng)資源泄漏。

　　如果測試應(yīng)用在多線程模式中運行，則有必要將CSF日志級別下降到ERROR。在完全DEBUG級別上運行會產(chǎn)生大量日志輸出，事件日志線程和應(yīng)用控制臺窗口也不能與解析器保持同步。提高內(nèi)存容量可以緩沖需要記錄的數(shù)據(jù)。在運行應(yīng)用前，應(yīng)該在CSF Xerces目錄中的log4cplus.properties文件中進行上述調(diào)整。

代碼樣本的系統(tǒng)安裝、構(gòu)建和執(zhí)行

Xerces安裝

　　Xerces XML解析器可以同時在Windows和Linux操作系統(tǒng)中和CSF配合使用。

Windows操作系統(tǒng)

　　在Windows下，以二進制格式安裝Xerces C++發(fā)行版的操作極其簡易。該版本名為"Windows NT 4.0 SP5 compiled with MSVC 6.0 SP3.zip archive"，您可以從本注釋曾使用的文件中獲得：http://www.apache.org/dist/xml/xerces-c/binaries/ WinNT_msvc60/xerces-c_2_6_0-windows_nt-msvc_60.zip。您也可以同時獲得Xerces-C的源代碼。

　　解壓縮該二進制發(fā)行版本至某個目錄即可。

Linux操作系統(tǒng)

　　從源代碼安裝Xerces必須在Linux操作系統(tǒng)下才可完成。您可以訪問Xerces網(wǎng)站（http://xml.apache.org/xerces-c/），進入"當(dāng)前發(fā)布的Xerces-C源代碼"，下載文件xerces-c-current.tar.gz。2004年12月份之后的版本是2.6.0。此版本已經(jīng)過面向Linux的DialogicNetStructure 主機媒體處理軟件1.2版的測試，測試操作系統(tǒng)為Red Hat Enterprise Linux 3.0，Update 1。該網(wǎng)站還提供Xerces Linux二進制發(fā)行版，但是最好不要使用，因為它是根據(jù)Red Hat Linux 8.0開發(fā)的。

解壓縮該發(fā)行版至某個目錄：

tar xvfz xerces-c-current.tar.gz

設(shè)置下列環(huán)境變量：

XERCESCROOT=
export XERCESCROOT

在XERCESCROOT下的構(gòu)建目錄src/xercesc處輸入：

runConfigure -p linux
gmake

　　這樣將在$XERCESCROOT/lib目錄下生成2個動態(tài)庫文件，libxerces-c.so.26.0和libxerces-depdom.so.26.0。

構(gòu)建Xerces DOM解析器應(yīng)用

　　此處不介紹完整的CSF系統(tǒng)設(shè)置。如欲了解詳細(xì)信息，請參見"如欲了解更多信息"部分中的CSF參考（第6頁）。使用Xerces時無需考慮特別的事項，僅完成安裝Xerces軟件安裝即可。如果要同時使用CSF，您必須從Source Forge上CSF項目處下載CSF 0.7.0或更高版本。該項目的網(wǎng)址為：http://sourceforge.net/projects/ commsvcfw/。

　　無論是哪種操作系統(tǒng)，在構(gòu)建應(yīng)用之前，您需要在Xerces目錄下的CDomParserObjApp.h頭文件頂部的幾個#define進行設(shè)置。

• #define FULL_解析器_LOAD_TEST――（Boolean）如果已經(jīng)定義，則在運行應(yīng)用時需要進行多線程負(fù)載測試。如果沒有定義，將進行單線程測試。切記需要根據(jù)所運行的測試調(diào)整CSF日志級別。（"解析器測試應(yīng)用"部分中有詳細(xì)介紹，第4頁。）


• #define SIP_URI_TEST_FILE――（URL或文件規(guī)范）第一次測試的XML文件的位置。測試文件（SipUri1-3.xml）位于Xerces應(yīng)用目錄。如果XML文件由web服務(wù)器提供，則應(yīng)該給出文件的完整URL。


• #define CSF_CONFIG_TEST_FILE――（URL或文件規(guī)范）第二次測試的XML文件的位置。測試文件（CSFConfig.xml）位于Xerces應(yīng)用目錄。如果XML文件由web服務(wù)器提供，則應(yīng)該給出文件的完整URL。

Windows操作系統(tǒng)

　　如欲同時使用CSF，您必須設(shè)置3個環(huán)境變量：XERCES_ROOT、XERCES_INCLUDE和XERCES_LIB。通常的值為

XERCES_ROOT=C:\xerces-c_2_6_0-windows_
nt-msvc_60
XERCES_INCLUDE=%XERCES_ROOT\include
XERCES_LIB=%XERCES_ROOT%\lib

　　Pathenvironment變量必須包含%XERCES_ROOT%\bin。

　　完成以上參數(shù)設(shè)置之后，Visual C++ CSF/Xerces解析器測試應(yīng)用項目就將能夠定位Xerces組件。

　　Visual C++ 6.0用于構(gòu)建CSF和解析器測試應(yīng)用。該項目可被包含于整體CSF工作空間，該項目本身（Dom解析器Obj.dsp）也可以與Visual C++同時運行。

Linux操作系統(tǒng)

　　如欲同時使用CSF，您需要設(shè)置幾個環(huán)境變量。首先，將XERCES_ROOT設(shè)置為完全路徑，直通頂層Xerces目錄。（這與用于構(gòu)建Xerces庫本身的XERCESCROOT的值相同。）例如：

XERCES_ROOT=/usr/local/xerces-c-src_2_6_0
export XERCES_ROOT

　　由于Xerces是一個動態(tài)（共享對象）庫，因此環(huán)境變量LD_LIBRARY_PATH必須包括$XERCES_ROOT/lib。通常設(shè)置如下：

LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:
${XERCES_ROOT}/lib
export LD_LIBRARY_PATH

　　運行Xerces應(yīng)用中的makefile就可構(gòu)建解析器測試應(yīng)用。

運行應(yīng)用

　　DomParserObj應(yīng)用完成構(gòu)建之后，它就可以在任何操作系統(tǒng)的命令行處開始運行。

　　您可以在終端窗口中看到調(diào)試或錯誤日志信息，這些信息的位置為CSF Xerces目錄下的test.log文件。您可以看到XML文件每個重要要素的屬性名稱和值。

　　同時按Ctrl鍵和C鍵可以按順序關(guān)閉DomParserObj。

其它開發(fā)商服務(wù)

　　Applied Telecom Solutions Center創(chuàng)建的所有解決方案均為完整的應(yīng)用，但是如上所述，在Dialogic產(chǎn)品未深入的其它領(lǐng)域，它們也未曾有深入的發(fā)展。盡管如此，Dialogic也可以在這些領(lǐng)域助您一臂之力。請聯(lián)系您的銷售團隊或渠道成員，或者致電1-973-993-3030獲取其它專業(yè)資源。Applied Telecom Solutions Center創(chuàng)建的解決方案可作為完整應(yīng)用的典范。您可以提供關(guān)于電話組件的詳細(xì)信息，以及關(guān)于其它關(guān)鍵解決方案應(yīng)用組件的概要信息。通過http://www.Dialogic.com/上的開發(fā)商資源，以及http://www.Dialogic.com/上的Dialogic通信聯(lián)盟成員優(yōu)勢，Dialogic同樣可以在這些領(lǐng)域助您一臂之力。

術(shù)語縮寫

CSF 通信服務(wù)框架
DOM 域?qū)ο竽Ｊ?br> HMP 主機媒體處理
SAX XML的簡單API
SIP 會話初始化協(xié)議
STL 標(biāo)準(zhǔn)模板庫
URI 統(tǒng)一資源標(biāo)識符
VXML 語音可擴展標(biāo)記語言
XML 可擴展標(biāo)記語言

了解更多信息

通信服務(wù)框架源代碼
http://sourceforge.net/projects/commsvcfw

應(yīng)用注釋：通信服務(wù)框架（CSF）介紹
http://www.Dialogic.com/network/csp/applnots/8989an.htm

應(yīng)用注釋：通信服務(wù)框架的基本原理（第2版）
http://www.Dialogic.com/network/csp/applnots/9333.htm

Xerces C++解析器網(wǎng)站
http://xml.apache.org/xerces-c/

如欲了解更多信息，請訪問Dialogic網(wǎng)站http://www.Dialogic.com。