remote script文檔(轉載自微軟)(七)

2019-11-18 22:28:50

字體：大中小

來源：轉載

供稿：網友

文檔: 檢查錯誤
當您在服務器腳本中用 remote scripting 調用方法時，可能會遇到多種錯誤，包括語法錯誤和運行時間錯誤，以及調用 remote scripting 方法時的錯誤。remote scripting 調用機制向您提供了獲知調用過程中所出現錯誤信息的途徑。

錯誤處理程序根據您是進行同步或者異步調用稍微有些不一樣。如果您在進行同步調用時導致錯誤，那么 remote scripting 機制將在瀏覽器中顯示一條錯誤消息。錯誤文字來自于調用對象的 message 屬性。有關詳細信息，請參閱如下的“Remote Scripting 調用故障診斷”。

不過，如果您產生導致一個錯誤的異步調用，那么您可以通過指定一個錯誤回調函數捕獲該錯誤，該回調函數的調用在很大程度上和普通回調函數有相似之處。

捕獲異步調用中產生的錯誤

您可以指定自己異步 remote scripting 調用中的錯誤回調函數名。由于您必須傳遞該回調函數的函數指針，因此對于異步方法調用來說，您必須使用 javaScript。如果您已經創建了對服務器頁的對象引用，那么可以用第一個語法示例。否則可以用第二個語法示例。
callObject = aspObject.methodName(p1, p2[,...],
   callbackFunction, errorCallbackFunction, context)

callobject = RSExecute(url, methodName, p1, p2[,...],
   callbackFunction, errorCallbackFunction, context)

有關產生對服務器方法異步調用的詳細信息，請參閱異步調用 Remote Scripting 方法。

不管您進行同步還是異步調用，都可以得到關于錯誤條件的信息，方法是測試調用對象的屬性。如果用戶指定了錯誤回調函數，那么調用對象就被作為參數傳遞，就象普通回調函數參數傳遞一樣。特別是下面的屬性提供了錯誤信息：

status 如果遠程調用失敗則包含 -1。

data 包含服務器返回的 xml 格式的粗信息。這是調試的最好信息源，因為它包含了錯誤消息的完整文本以及服務器生成的其他消息。

message 包含 remote scripting 代理過程生成的錯誤消息信息（如果有的話）。message 中的錯誤消息不必要和 data 屬性中的一樣。例如，如果 ASP 頁包含一條語法錯誤，那么關于該錯誤的詳細消息將出現在 data 屬性中，但消息屬性將只包含這樣一條消息──它指示用戶不能調用 ASP 頁上的方法。
下面的腳本示例了客戶腳本中的一個錯誤回調函數。第一個腳本產生一個 remote scripting 調用，并指明錯誤回調函數。第二個腳本是錯誤回調函數本身。錯誤回調函數并不顯式地對調用對象 status 屬性值進行測試，因為該函數僅在調用失敗時才被調用。

<SCRIPT LANGUAGE="Javascript" for="btnSquare" event="onclick">
    rsMath = RSGetASPObject("rsadd.asp");
    number1 = txt1.value;
    context = "squaring";
    co = rsMath.square(number1,showResults,showErrors,context);

function showErrors(co){
    // 轉儲粗數據
    msg = "The raw data returned by the remote method call is "
    msg = msg + co.data
    alert(msg);
    // 顯示友好信息
    msg = "The following error occurred during the "
    msg = msg + co.context
    msg = msg + " remote scripting call:/n"
    msg = msg + co.message
    alert(msg);
}
</SCRIPT>

Remote Scripting 調用故障診斷
找到某個 remote scripting 調用中的確切錯誤源并不總是一件容易的事情，因為 remote scripting 不僅涉及到客戶而且涉及到服務器上的多個文件。不過，某些類型的錯誤屬于一般性錯誤，而且容易發現。另外，用戶可以用 remote scripting 機制的錯誤捕獲程序獲得調用過程中所出現錯誤的詳細信息。

在某些情況下，用戶不能用 remote scripting 進行任何處理，因為尚未對之進行正確的初始化。下表列出了典型的初始化錯誤及其可能的出錯緣由。

癥狀可能錯因
Remote scripting 不起作用；客戶頁源僅包含 <APPLET> 標記。 RSEnableRemoteScripting
調用不在文檔主體內。請參閱使得客戶頁內的 Remote Scripting 有效。
Remote scripting 不起作用；所有調用失敗。 ASP 頁未被調用。使用 http:// 協議（而不是 file://）。
客戶端錯誤消息，比如當試圖調用 remote scripting 方法時，出現“未定義 'MSRS' ”消息。試圖進行遠程調用之前，未能成功調用 RSEnableRemoteScripting 方法。
客戶端錯誤消息“對象不支持該屬性或者方法，”特別顯示出和 .HTM 文件不匹配的行號。找不到代理對象 (RsPRoxy.class)，或者 RSEnableRemoteScripting 方法中傳遞的是無效 URL。
客戶端錯誤消息“創建文件的 ASP 對象失敗”。 RSGetASPObject 調用中傳遞的是無效 URL。請參閱作為對象引用 ASP 頁。

如果錯誤位于包含遠程調用方法的 ASP 頁中，或者如果錯誤出現在對某個遠程方法的調用過程中，那么用戶可以在某個錯誤回調函數中捕獲該錯誤，而且用戶可以從調用對象的 data 和 message 屬性中獲得關于錯誤的信息。

下表列出了用戶可以用錯誤回調函數捕獲的典型問題以及 message 和 data 屬性中的值。在多數情況下，message 屬性返回一般性信息，而 data 屬性則包含關于錯誤的詳細信息。

注意數據屬性包含一定數目的 XML 標記以及和調用有關的其他信息。下表列出了出現在屬性值中的一個字符串。

問題消息值數據值
RSExecute 方法中 ASP 頁的無效 URL。請參閱同步調用 Remote Scripting 方法和異步調用 Remote Scripting 方法不同的，包括用戶試圖調用的頁名。 (null)
ASP 文件到 Rs.asp 的路徑錯誤。請參閱使得服務器頁中的 Remote Scripting 有效。 “調用的頁不支持 remote scripting?！?“未找到包括文件?！?
ASP 文件中的語法或者運行時間錯誤。 “調用的頁不支持 remote scripting?！?和錯誤有關的細節，包括行號。
試圖調用不存在的方法。 “不是公用函數?！?“不是公用函數?！?
ASP 構造函數引用了未出現在 ASP 文件中的函數。請參閱使得服務器頁中的 Remote Scripting 有效 “調用的頁不支持 remote scripting。” “functionName未定義。”

上一篇：remote script文檔(轉載自微軟)(八)

下一篇：remote script文檔(轉載自微軟)(六)