nsINavHistoryService Interface

 Adds a history observer. If ownsWeak is false, the history service will
 keep an owning reference to the observer.  If ownsWeak is true, then
 aObserver must implement nsISupportsWeakReference, and the history service
 will keep a weak reference to the observer.

void addObserver(in nsINavHistoryObserver observer, in boolean ownsWeak)

 Call to manually add a visit for a specific page. This will probably not
 be commonly used other than for backup/restore type operations. If the URI
 does not have an entry in the history database already, one will be created
 with no visits, no title, hidden, not typed.  Adding a visit will
 automatically increment the visit count for the visited page and will unhide
 it and/or mark it typed according to the transition type.

 @param aURI             Visited page
 @param aTime            Time page was visited (microseconds)
 @param aReferringURI    The URI of the visit that generated this one. Use
                         null for no referrer.
 @param aTranstitionType Type of transition: one of TRANSITION_* above
 @param aIsRedirect      True if the given visit redirects to somewhere else.
                         (ie you will create an visit out of here that is a
                         redirect transition). This causes this page to be
                         hidden in normal history views (unless it has been
                         unhidden by visiting it with a non-redirect).
 @param aSessionID       The session ID that this page belongs to. Use 0 for
                         no session.
 @returns The ID of the created visit. This will be 0 if the URI is not
          valid for adding to history (canAddURI = false).

long long addVisit(in nsIURI aURI, in PRTime aTime, in nsIURI aReferringURI, in long aTransitionType, in boolean aIsRedirect, in long long aSessionID)

 Returns true if this URI would be added to the history. You don't have to
 worry about calling this, addPageToSession/addURI will always check before
 actually adding the page. This function is public because some components
 may want to check if this page would go in the history (i.e. for
 annotations).

boolean canAddURI(in nsIURI aURI)

 Executes an array of queries. All of the query objects are ORed
 together. Within a query, all the terms are ANDed together as in
 executeQuery. See executeQuery()

nsINavHistoryResult executeQueries([array, size_is(aQueryCount)] in nsINavHistoryQuery aQueries, in unsigned long aQueryCount, in nsINavHistoryQueryOptions options)

 Executes a single query.

nsINavHistoryResult executeQuery(in nsINavHistoryQuery aQuery, in nsINavHistoryQueryOptions options)

 Gets the stored character-set for an URI.

 @param aURI
        URI to retrieve character-set for
 @returns character-set, empty string if not found

AString getCharsetForURI(in nsIURI aURI)

 This returns a new query object that you can pass to executeQuer[y/ies].
 It will be initialized to all empty (so using it will give you all history).

nsINavHistoryQuery getNewQuery()

 This returns a new options object that you can pass to executeQuer[y/ies]
 after setting the desired options.

nsINavHistoryQueryOptions getNewQueryOptions()

 Gets the original title of the page.

AString getPageTitle(in nsIURI aURI)

 Import the given Mork history file.
  @param file     The Mork history file to import

void importHistory(in nsIFile file)

 This is just like markPageAsTyped (in nsIBrowserHistory, also implemented
 by the history service), but for bookmarks. It declares that the given URI
 is being opened as a result of following a bookmark. If this URI is loaded
 soon after this message has been received, that transition will be marked
 as following a bookmark.

void markPageAsFollowedBookmark(in nsIURI aURI)

 Converts a query into an equivalent string that can be persisted. Inverse
 of queryStringToQueries()

AUTF8String queriesToQueryString([array, size_is(aQueryCount)] in nsINavHistoryQuery aQueries, in unsigned long aQueryCount, in nsINavHistoryQueryOptions options)

 Converts a query URI-like string to an array of actual query objects for
 use to executeQueries(). The output query array may be empty if there is
 no information. However, there will always be an options structure returned
 (if nothing is defined, it will just have the default values).

void queryStringToQueries(in AUTF8String aQueryString, [array, size_is(aResultCount)] out nsINavHistoryQuery aQueries, out unsigned long aResultCount, out nsINavHistoryQueryOptions options)

 Removes a history observer.

void removeObserver(in nsINavHistoryObserver observer)

 Runs the passed callback in batch mode. Use this when a lot of things
 are about to change. Calls can be nested, observers will only be
 notified when all batches begin/end.

 @param aCallback
        nsINavHistoryBatchCallback interface to call.
 @param aUserData
        Opaque parameter passed to nsINavBookmarksBatchCallback

void runInBatchMode(in nsINavHistoryBatchCallback aCallback, in nsISupports aClosure)

 Sets the character-set for an URI.

 @param aURI
        URI to set the character-set for
 @param aCharset
        character-set to be set

void setCharsetForURI(in nsIURI aURI, in AString aCharset)