mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-11 12:25:53 +00:00
f337b95b60
mozilla::EditorBase stores nsISelectionController and nsIDocument with nsWeakPtr. However, nsWeakPtr requires QI to retrieve actual pointer and it makes some damage to the performance. If mozilla::WeakPter were available for them, it'd be great. However, it's not available with nsISelectionController nor nsIDocument because it's possible to implement SupportsWeakPtr only with their subclasses but the subclasses shouldn't be referred by editor. Therefore, this patch creates mozilla::CachedWeakPtr<class T> which stores both raw pointer (as cache) and nsWeakPtr and when its cache is requested, it checks if the object referred by nsWeakPtr is still alive. Additionally, this patch hides the members from subclasses of EditorBase for reducing the maintenance cost. MozReview-Commit-ID: FvtM7453Vv8 --HG-- extra : rebase_source : a524a8ea327c3993645fafa81db8aef65090f1e0
80 lines
2.6 KiB
Plaintext
80 lines
2.6 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#include "nsISupports.idl"
|
|
|
|
%{C++
|
|
#include "mozilla/MemoryReporting.h"
|
|
%}
|
|
|
|
/**
|
|
* An instance of |nsIWeakReference| is a proxy object that cooperates with
|
|
* its referent to give clients a non-owning, non-dangling reference. Clients
|
|
* own the proxy, and should generally manage it with an |nsCOMPtr| (see the
|
|
* type |nsWeakPtr| for a |typedef| name that stands out) as they would any
|
|
* other XPCOM object. The |QueryReferent| member function provides a
|
|
* (hopefully short-lived) owning reference on demand, through which clients
|
|
* can get useful access to the referent, while it still exists.
|
|
*
|
|
* @version 1.0
|
|
* @see nsISupportsWeakReference
|
|
* @see nsWeakReference
|
|
* @see nsWeakPtr
|
|
*/
|
|
[scriptable, uuid(9188bc85-f92e-11d2-81ef-0060083a0bcf)]
|
|
interface nsIWeakReference : nsISupports
|
|
{
|
|
/**
|
|
* |QueryReferent| queries the referent, if it exists, and like |QueryInterface|, produces
|
|
* an owning reference to the desired interface. It is designed to look and act exactly
|
|
* like (a proxied) |QueryInterface|. Don't hold on to the produced interface permanently;
|
|
* that would defeat the purpose of using a non-owning |nsIWeakReference| in the first place.
|
|
*/
|
|
void QueryReferent( in nsIIDRef uuid, [iid_is(uuid), retval] out nsQIResult result );
|
|
|
|
%{C++
|
|
virtual size_t SizeOfOnlyThis(mozilla::MallocSizeOf aMallocSizeOf) const = 0;
|
|
|
|
/**
|
|
* Returns true if the referring object is alive. Otherwise, false.
|
|
*/
|
|
virtual bool IsAlive() const = 0;
|
|
%}
|
|
};
|
|
|
|
|
|
/**
|
|
* |nsISupportsWeakReference| is a factory interface which produces appropriate
|
|
* instances of |nsIWeakReference|. Weak references in this scheme can only be
|
|
* produced for objects that implement this interface.
|
|
*
|
|
* @version 1.0
|
|
* @see nsIWeakReference
|
|
* @see nsSupportsWeakReference
|
|
*/
|
|
[scriptable, uuid(9188bc86-f92e-11d2-81ef-0060083a0bcf)]
|
|
interface nsISupportsWeakReference : nsISupports
|
|
{
|
|
/**
|
|
* |GetWeakReference| produces an appropriate instance of |nsIWeakReference|.
|
|
* As with all good XPCOM `getters', you own the resulting interface and should
|
|
* manage it with an |nsCOMPtr|.
|
|
*
|
|
* @see nsIWeakReference
|
|
* @see nsWeakPtr
|
|
* @see nsCOMPtr
|
|
*/
|
|
nsIWeakReference GetWeakReference();
|
|
};
|
|
|
|
|
|
%{C++
|
|
#ifdef MOZILLA_INTERNAL_API
|
|
#include "nsIWeakReferenceUtils.h"
|
|
#endif
|
|
%}
|
|
|