利用Flash5的XML能力，用SOAP進行通訊，可以創(chuàng)建Flash界面Web應用程序。SOAP(Simple Object Access Protocal)是通過網(wǎng)絡平臺在不同的系統(tǒng)間交換數(shù)據(jù)的方法。SOAP使用XML文檔，通過類似于HTTP的協(xié)議處理網(wǎng)頁的請求和和回應動作。
由微軟的.NET和Apache SOAP看來，SOAP是用來在不同的系統(tǒng)間交換數(shù)據(jù)協(xié)議中是最方便的一種。
這篇文章中，你可以看到怎樣建立一個基于Flash的計算器，并利用SOAP進行遠程過程調用(RPC)在服務器上建立簡單的計算程序。
要完成這個例子，你需要安裝了Flash5，微軟的SOAP Toolkit2.0 SP2,Visual Basic,Windows NT/2000 server和IIS。
本程序需要建立服務器應用程序和監(jiān)聽器，用來處理所有收到的SOAP請求。這個程序使用了微軟的ASP監(jiān)聽器和SOAPCalc ActiveX DLL，這些都可以在微軟的SOAP Tookit中找到。
另外，還需要一個封裝了SOAP的Flash組件，這個免費的組件可以在http://software.mrev.com/soap.asp下載到。
都準備好了之后，讓我們開始吧。
第一步：建立ASP監(jiān)聽器
在服務器端，需要對進入的SOAP請求進行操作�？梢允褂肁SP文件來處理這些請求。首先，在IIS中建立一個新的目錄或是虛擬目錄，并命名為SOAPCalc。在這個目錄中，建立一個新的ASP文件，并命名為“default.asp”
輸入以下代碼：
| ＜%@language=vbscript%＞ ＜% Set CalcSrv = Server.CreateObject("SOAPCalc.CalcSrv") CalcSrv.Process Request, Response %＞ |
這個ASP頁面接收從Flash中發(fā)送來的SOAP XML請求，并把Request和Response對象傳遞給CalcServ組件
 圖1 |
CalcSrv從數(shù)據(jù)流中讀入并解析SOAP請求，完成所需要的計算。并且把ASP的Response對象通過SOAP送到客戶端。
 圖2 |
客戶端的Flash應用程序讀取了返回數(shù)據(jù)，刷新計算器的顯示。
第二步：建立服務器端計算器組件
下一步，建立服務器端的用來完成計算操作的組件。打開Visual Basic 6,建立一個新的ActiveX DLL工程。
這個組件和SOAP Toolkit中的“Using a Low Level API for SOAP Messages”這個例子程序是相同的，但是我們把工程的名字改成了SOAPCalc。如果你沒有安裝Visual Basic，也可以直接下載編譯過的CalcServ安裝程序(見參考)。安裝程序將復制并注冊所有需要的文件。本文后面的zip包中有這個例子的VB代碼，以及編譯好的DLL文件。
這個演示程序通過SOAP reader對象讀取進入的請求。然后，它將檢查請求中的SOAP封裝是否包含叫做＜Add＞＜Subtract＞, ＜Multiply＞ 或 ＜Divide＞的節(jié)點，以及兩個子節(jié)點＜A＞和＜B＞。如果找到了，它將處理請求，并且通過serializer返回SOAP消息和ASP的Response對象。
因為Flash的XML解析器不能處理XML標記的名稱空間，所以，需要使用單一的結構。
一般的SOAP主體是這樣的：
| ＜SOAPSDK1:AddResponse xmlns:SOAPSDK1="uri:Calc"＞ �。糞OAPSDK1:Answer＞12＜/SOAPSDK1:Answer＞ ＜/SOAPSDK1:Response＞ |
但是，由于前述的理由，我們不能直接使用這樣的結構。而應該用下面這樣Flash支持的語法形式。這種形式包容了同樣的數(shù)據(jù)，只是沒有SOAPSDK的名字空間和標記前綴而已。
| ＜AddResponse＞ �。糀nswer＞12＜/Answer＞ ＜/AddResponse＞ |
做這些改變，首先應該從這個模塊的代碼前端的聲明部分去掉下面這行：
| Const CALC_NS = "uri:Calc" |
然后，要告訴SOAP Serializer不使用特定的名字空間。把這段代碼：
| ... Serializer.startBody Serializer.startElement MethodName & "Response", CALC_NS Serializer.startElement "Answer", CALC_NS ... |
修改成這樣:
| ... Serializer.startBody Serializer.startElement MethodName & "Response" Serializer.startElement "Answer" ... |
好了，現(xiàn)在可以編譯DLL了。然后IIS服務器上注冊它。(在控制臺或是run對話框中使用regsvr32.exe命令，形式是：regsvr32 DLL所在路徑\DLL文件名)
第三步：建立Flash界面
前面的兩個步驟完成后，就我們繼續(xù)建立客戶端的Flash界面。
首先，在Flash中建立一個簡單的計算器界面。這個界面和普通的數(shù)字計算器很相似--用戶在鍵盤上輸入數(shù)值和計算方法，計算器顯示出計算結果。為了能夠進行計算，在Flash中需要有一些全局變量來存放數(shù)值和計算方法。當用戶點擊計算器的按鈕時，更新這些變量的值。我們用三個root-level變量存放了這些數(shù)據(jù)：
_root.calcValue 存放計算器顯示的數(shù)值
_root.operator 存放選擇了的計算方法
_root.lastValue 存放上一次運算的結果
然后需要建立各種與用戶交互的按鈕，比如0~9的數(shù)字，各種運算符，小數(shù)點，等號等等。除此之外，還需要建立一個文本框，以便顯示計算結果。在Flash中，通過動態(tài)文本(Dynamic Text)把變量綁定到文本框上，這個文本框中將顯示出變量的值，并隨變量的變化而刷新。(方法是：從text options面版中選擇Dynamic Text，設置bind variable為 _root.calcValue。)
下一步，為每個按鈕建立相應的Action：當數(shù)字按鈕被按下的時候，更新變量 _root.calcValue 的值，當運算符按鈕被按下時，設置變量_root.operator的值。這個值要和服務器端的SOAPCalc 組件所需要的值保持一致。(本例中是"Add", "Subtract", Multiply", 或 "Divide")同樣在這個Action中，添加代碼用來把當前的計算結果保存到變量_root.lastValue中。運算符按鈕的Action中應該有這樣的代碼：
| on (release) { // operator應該是 "Add", "Subtract", Multiply", 或 "Divide" _root.operator = "Add"; _root.lastValue = _root.calcValue; ... } |
下面，添加"="按鈕的Action，當用戶按下這個按鈕的時候，將調用函數(shù)發(fā)送SOAP消息，進行計算:
| on (release) { _root.calculate(_root.operator, _root.lastValue, _root.calcValue); } |
在Flash影片的root level中的新層中，建立一個所有函數(shù)都將用到的Action。在這個Action中，建立一個函數(shù)calculate()處理SOAP請求和回應。函數(shù)calculate()的作用是向服務器發(fā)送運算所需要的兩個數(shù)和運算符。
其形式是：
| function calculate(operator, a, b) { ... } |
具體的代碼將在下面的部分繼續(xù)填充。
第四步：實現(xiàn)SOAP消息
其實這樣功能的計算器使用Flash集成的腳本語言ActionScript就可以輕松完成，但是我們這里演示的是SOAP計算器，所以需要利用服務器完成所有的計算請求。Flash5能夠發(fā)送和接受XML文檔，而SOAP消息也是普通的XML文檔，所以我們可以使用Flash集成的XML對象來建立和解析SOAP消息。
為了使建立Flash/SOAP應用程序的過程更為簡單，你可以下載Media Revolution所開發(fā)的Flash SOAP組件。它是免費的。這個組件通過封裝XML操作而簡化了在Flash中發(fā)送和接受SOAP消息的操作�？梢詮膆ttp://software.mrev.com/soap.asp下載這個組件。使用方法是把它復制到Flash影片所在目錄，在root level加入一個名為SOAP的影片夾子，并加入如下代碼：
| loadMovie ("SOAP.swf", "_root.SOAP"); |
在函數(shù)calculate()中使用這個SOAP對象。首先，創(chuàng)建一個新的SOAP對象。注意名稱"SOAP"要和上一步加入的SOAP組件名稱相同。
為這個對象的onLoad屬性分配一個函數(shù)名。這個函數(shù)在SOAP對象接受或處理SOAP回應時運行。(函數(shù)displayCalcResult將在后面定義)。
代碼如下：
| function calculate (operator, a, b) { ... var SOAPCalc = new SOAP.SOAP(); SOAPCalc.onLoad = displayCalcResult; ... } |
然后，使用內建的SOAP方法createMethod() 和 addParameter() 定義遠端過程調用的類型。SOAP對象假定服務器應用程序期望的節(jié)點和調用的方法同名。并且返回一個名稱為[方法名]Response的節(jié)點。 (比如 AddResponse)。
代碼如下：
| function calculate (operator, a, b) { ... SOAPCalc.createMethod(operator); SOAPCalc.addParameter("A", a); SOAPCalc.addParameter("B", b); ... } |
最后，使用SOAP對象的方法send()，把請求發(fā)送到前面建立的SOAP監(jiān)聽器的地址上。
| function calculate (operator, a, b) { ... SOAPCalc.send ("http://localhost/SOAPCalc/default.asp"); ... } |
注：因為安全問題，F(xiàn)lash播放器限制SOAP請求和影片在一個子域中。Macromedia將發(fā)布一個修正版的播放器，以便解決這一問題。
當SOAP對象收到和解析服務器發(fā)回的回應，onLoad事件將被觸發(fā)。通過前面分配給onLoad屬性的函數(shù)，可以很容易的存取服務器的回應信息。比如：
| function displayCalcResult () { _root.calcValue = this.Response.Answer; } |
SOAP Response對象中的[函數(shù)名]Response.Answer節(jié)點中存放的就是計算結果。
回應的SOAP消息如下所示：
| ＜SOAP-ENV:Envelope xmlns: SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\"＞ �。糞OAP-ENV:Body＞ �。糀ddResponse＞ �。糀nswer＞10＜/Answer＞ ＜/AddResponse＞ �。�/SOAP-ENV:Body＞ ＜/SOAP-ENV:Envelope＞ |
上面的displayCalcResult()遠程操作返回的值存放在root-level的變量 _root.calcValue中，這樣動態(tài)文本框將自動顯示其值。
這些都做好以后，你就擁有了一個Flash SOAP計算器了。完整的演示可參見：http://software.mrev.com/demo/soap
關于錯誤處理，請解析＜Fault＞節(jié)點的子節(jié)點＜faultcode＞和其他節(jié)點，它們包含了錯誤信息:
| ＜?xml version="1.0"?＞ ＜SOAP-ENV:Envelope＞ �。糞OAP-ENV:Body＞ ＜SOAP-ENV:Fault＞ ＜faultcode＞Server＜/faultcode＞ �。糵aultstring＞ Parameter missing: B �。�/faultstring＞ �。�/SOAP-ENV:Fault＞ ＜/SOAP-ENV:Body＞ ＜/SOAP-ENV:Envelope＞ |
通過Flash使用SOAP傳遞信息，把用戶界面和數(shù)據(jù)分離，是一個不錯的主意。這樣客戶端可以得到比以往的Web界面更豐富的多媒體界面。通過在Flash函數(shù)內封裝SOAP請求和SOAP組件，大大降低了開發(fā)難度，甚至可以讓對XML和SOAP不很熟悉的Flash開發(fā)人員輕松的應用。