XPConnect Sample

原版本

Ariel Blackenroth <arielb@rice.edu>
Michael Ang <mang@subcarrier.org>
Last modified 09/19/2006 14:21:29

在"錯了也沒關係"也沒關係的這個想法底下，我們寫出了這份指南。它還不成熟，所以還會再進行修改。

XPConnect 可以光靠 Javascript 就能完整控制整個 XPCOM 物件。在 Javascript 和 native code 之間的溝通是靠 XPIDL 介面定義的程序語言來控制的。可以參考 Roadmap for documentation on XPCOM, XPConnect, XPTCall and XPIDL 獲得更多資訊。

概觀

這份範例將展示如何透過 XPConnect 取用一個 XPCOM 物件，Javascript 會在頁面載入的>時候就用 components 物件創建一個實體(instance)，然後透過nsISample 介面呼叫一個 QueryInterface 。

netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
var sample = Components.classes["@mozilla.org/sample;1"].createInstance();
sample = sample.QueryInterface(Components.interfaces.nsISample);

在表單上面的按鈕連接著 javascript 事件處理器，它會再去呼叫 C++ 程式碼中定義的功>能。

nsISample.idl 這個介面宣告了 XPCOM 物件。它定義了兩個函式跟所需要的的參數還有一個屬性。它同時>也設定好了這個介面的 id 。這個 idl 檔案是用 xpidl 編譯器編進 C++ 標頭檔。這些東>西包括 nsISample.h 還有一個 .xpt 的檔案在執行期間還會用再用到。

attribute string value;
void writeValue(in string aPrefix);
void poke(in string aValue);

nsSample.cpp

包含了 nsISample.idl 中宣告了的所有方法。 SampleImpl 從 nsISample.h 中繼承而來，的標頭是動態從 xpidl 中創建而來的。屬性值已經展開進一個 get 和 set 還有 return 的值會改變 NS_IMETHOD，一個成功的狀態給這個方法。巨集 NS_DECL_ISUPPORTS定義在這個方法裡。巨集 NS_DECL_ISUPPORTS定義在 mozilla/xpcom/public/nsISupportsUtils.h 裡，定義了那些從 nsISupports.h 來的方法。 * NS_IMPL_ISUPPORTS1(SampleImpl, nsISample) 在這個建構子裡面， NS_INIT_REFCNT 巨集被設做 0。

要注意因為在 C++ 裡面用 InterCaps Style 來撰寫，所以 IDL 還有 Javascript 跟著使用這樣的命名方式，除了

QueryInterface nsSampleFactory.cpp

這就是那個建立 nsSample 類別的 class。 ... 為了增加程式碼的可攜性，COM framework 用了 factories 來建立應用功能的實體，而不是直接應用這些實體自已本身。這個 factory 是從 nsFactory 繼承來的，它也同樣是一個 XPCOM 物件。想知道更多有關 factory 的資訊，可以參考這裡：

generic factory document Modularization techniques document