XUL XPCOM JavaScript - dim13/lor GitHub Wiki

<nowiki>
const Ci = Components.interfaces;

// константы, аналогично как в C++
const CLASS_ID    = Components.ID("b058921b-cdc2-43b3-8515-e2b9d6133263");
const CLASS_NAME  = "Simple JavaScript Componennt";
const CONTRACT_ID = "@mydomain.com/XPCOMSample/MyComponent;1";
const INTERFACE   = Ci.IMyComponent;

// Собственно наш компонент
function MyComponent() {}

MyComponent.prototype =
{
    // Метод сложения двух чисел, описанный в .idl файле
    Add: function(a, b)
    {
        return a + b;
    },

    // Мы также должны реализовать QueryInterface, чтобы
    // проверить правильность использования объекта. Это означает, что
    // мы не сможем использовать этот объект как указатель на интерфейс, который в нём
    // не реализован. Методы AddRef() и Release() из nsISupports не реализованы.
    QueryInterface: function(aIID)
    {
        // Мы знаем только о базовом интерфейсе nsISupports и нашем IMyComponent,
        // иначе выбрасываем исключение.
        if(!aIID.equals(INTERFACE) && !aIID.equals(Ci.nsISupports))
            throw Components.results.NS_ERROR_NO_INTERFACE;

        return this;
    }
};

// Наша фабрика, создаёт и возвращает синглетон MyComponent.
// Частично реализует интерфейс nsIFactory.
var MyComponentFactory =
{
    singleton: null,

    // Вызывается из скрипта для создания объекта XPCOM компонента
    createInstance: function(aOuter, aIID)
    {
        if(aOuter != null)
            throw Components.results.NS_ERROR_NO_AGGREGATION;

        // объект уже создан?
        if(this.singleton == null)
            this.singleton = new MyComponent();

        return this.singleton.QueryInterface(aIID);
    }
};

// Модуль, реализует интерфейс nsIModule, позволяет работать с нашей фабрикой
var MyComponentModule =
{
    registerSelf: function(aCompMgr, aFileSpec, aLocation, aType)
    {
        aCompMgr = aCompMgr.QueryInterface(Components.interfaces.nsIComponentRegistrar);
        aCompMgr.registerFactoryLocation(CLASS_ID, CLASS_NAME, CONTRACT_ID, aFileSpec, aLocation, aType);
    },

    unregisterSelf: function(aCompMgr, aLocation, aType)
    {
        aCompMgr = aCompMgr.QueryInterface(Components.interfaces.nsIComponentRegistrar);
        aCompMgr.unregisterFactoryLocation(CLASS_ID, aLocation);
    },

    getClassObject: function(aCompMgr, aCID, aIID)
    {
        // Абсолютно неправильное использование объекта модуля.
        // В принципе, такого не должно возникать.
        if(!aIID.equals(Components.interfaces.nsIFactory))
            throw Components.results.NS_ERROR_NOT_IMPLEMENTED;

        // Запрос нашего интерфейса, которому однозначно сопоставлена
        // фабрика.
        if(aCID.equals(CLASS_ID))
            return MyComponentFactory;

        // Мы не смогли обработать запрос объекта, и ничего не знаем о запрошенном
        // интерфейсе.
        throw Components.results.NS_ERROR_NO_INTERFACE;
    },

    canUnload: function(aCompMgr) { return true; }
};

// Главный загрузчик, должен возвращать объект нашего модуля
function NSGetModule(aCompMgr, aFileSpec) { return MyComponentModule; }
</nowiki>