nsIMicrosummaryService.idl

Go to the documentation of this file.

#include "nsISupports.idl"

interface nsIDOMDocument;
interface nsIDOMNode;
interface nsIURI;
interface nsISimpleEnumerator;
interface nsIMicrosummary;

[scriptable, uuid(560b0980-be95-47e9-81cc-4428c073127c)]
interface nsIMicrosummaryObserver : nsISupports
{
    void onContentLoaded(in nsIMicrosummary microsummary);

    void onError(in nsIMicrosummary microsummary);

    void onElementAppended(in nsIMicrosummary microsummary);
};


[scriptable, uuid(05b48344-d0a7-427e-934e-9a6e0d5ecced)]
interface nsIMicrosummaryGenerator : nsISupports
{
    // Has the generator itself, which may be a remote resource, been loaded.
    readonly attribute boolean loaded;

    // An arbitrary descriptive name for this microsummary generator.
    readonly attribute AUTF8String name;

    // The canonical location and unique identifier of the generator.
    // It tells us where the generator comes from and where to go for updates.
    //
    // For generators referenced by web pages via <link> tags, this URI is
    // the URL specified by the tag.
    //
    // For generators installed via nsSidebar::addMicrosummaryGenerator,
    // this URI is a URN of the form urn:source:<url>, where <url> is the
    // remote location from which we installed the generator.
    //
    // For generators installed via some other mechanism (f.e. an extension
    // that dynamically creates generators), this URI is a URN in a form
    // of the extension's own choosing, with the only restriction being that
    // the URI be globally unique.  To ensure this, we recommend that such
    // extensions incorporate UUIDs created by nsUUIDGenerator into the URNs
    // of the generators they create.
    readonly attribute nsIURI uri;

    boolean equals(in nsIMicrosummaryGenerator aOther);

    // For generators installed by the user or bundled with the browser, the
    // local URI points to the location of the local file containing the
    // generator's XML.
    readonly attribute nsIURI localURI;

    // Whether or not this generator needs page content to generate
    // a microsummary. Microsummaries generated by XSLT templates need page
    // content, while those which represent the actual microsummary content
    // do not.
    readonly attribute boolean needsPageContent;

    AString generateMicrosummary(in nsIDOMNode aPageContent);

    long calculateUpdateInterval(in nsIDOMNode aPageContent);
};


[scriptable, uuid(6867dc21-077f-4462-937d-cd8b7c680e0c)]
interface nsIMicrosummary : nsISupports
{
    // the URI of the page being summarized
    readonly attribute nsIURI pageURI;

    // The generator that generates this microsummary. May need to be loaded.
    attribute nsIMicrosummaryGenerator generator;

    // The content of the microsummary.
    // Since generators and pages can be remote resources, and we need them
    // to generate the content, this may not always be available.
    readonly attribute AString content;

    // The minimum interval after which this microsummary would like to be refreshed
    // (or null if it doesn't care).
    readonly attribute long updateInterval;

    // Used when a site author has indicated that a microsummary (or an
    // associated generator) will no longer be available.
    readonly attribute boolean needsRemoval;

    void addObserver(in nsIMicrosummaryObserver observer);

    void removeObserver(in nsIMicrosummaryObserver observer);

    boolean equals(in nsIMicrosummary aOther);

    void update();
};

[scriptable, uuid(7111e88d-fecd-4b17-b7a9-1fa74e23153f)]
interface nsIMicrosummarySet : nsISupports
{
    void addObserver(in nsIMicrosummaryObserver observer);

    void removeObserver(in nsIMicrosummaryObserver observer);

    nsISimpleEnumerator Enumerate();
};


[scriptable, uuid(D58143A2-74FA-4B13-94ED-113AF8936D80)]
interface nsIMicrosummaryService : nsISupports
{
    nsIMicrosummaryGenerator getGenerator(in nsIURI generatorURI);

    void addGenerator(in nsIURI generatorURI);

    nsIMicrosummaryGenerator installGenerator(in nsIDOMDocument xmlDefinition);

    nsISimpleEnumerator getBookmarks();

    nsIMicrosummarySet getMicrosummaries(in nsIURI pageURI,
                                         in long long bookmarkID);

    nsIMicrosummary getMicrosummary(in long long bookmarkID);

    nsIMicrosummary createMicrosummary(in nsIURI pageURI, in nsIURI generatorURI);

    void setMicrosummary(in long long bookmarkID,
                         in nsIMicrosummary microsummary);

    void removeMicrosummary(in long long bookmarkID);

    boolean hasMicrosummary(in long long bookmarkID);

    boolean isMicrosummary(in long long bookmarkID,
                           in nsIMicrosummary microsummary);

    nsIMicrosummary refreshMicrosummary(in long long bookmarkID);
};

[scriptable, uuid(f9e577a8-19d9-4ca0-a140-b9e43f014470)]
interface nsILiveTitleNotificationSubject : nsISupports
{
    // The ID of the bookmark displaying this title.
    // Note: in the old bookmarks code, this is an RDF resource.  In Places
    // it is currently a URI, but after the fix for bug 360133 lands it will
    // become an integer.
    readonly attribute long long bookmarkID;

    // The microsummary being displayed as the live title for the bookmark.
    // The actual value of the microsummary (i.e. the string that gets displayed
    // to the user) is stored in the content property of this object.
    readonly attribute nsIMicrosummary microsummary;
};