gecko/dom/bindings/CallbackObject.h
Boris Zbarsky 3349eac0ed Bug 822470 part 1. Factor out the code that callback functions and callback interfaces will be able to share into a CallbackObject class. r=peterv
--HG--
rename : dom/bindings/CallbackFunction.cpp => dom/bindings/CallbackObject.cpp
rename : dom/bindings/CallbackFunction.h => dom/bindings/CallbackObject.h
2013-01-28 08:34:29 -05:00

159 lines
4.6 KiB
C++

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim:set ts=2 sw=2 sts=2 et cindent: */
/* 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/. */
/**
* A common base class for representing WebIDL callback function and
* callback interface types in C++.
*
* This class implements common functionality like lifetime
* management, initialization with the JS object, and setup of the
* call environment. Subclasses are responsible for providing methods
* that do the call into JS as needed.
*/
#ifndef mozilla_dom_CallbackObject_h
#define mozilla_dom_CallbackObject_h
#include "nsISupports.h"
#include "nsISupportsImpl.h"
#include "nsCycleCollectionParticipant.h"
#include "jsapi.h"
#include "jswrapper.h"
#include "mozilla/Assertions.h"
#include "mozilla/Util.h"
#include "nsContentUtils.h"
#include "nsWrapperCache.h"
#include "nsJSEnvironment.h"
#include "xpcpublic.h"
#include "nsLayoutStatics.h"
namespace mozilla {
namespace dom {
class CallbackObject : public nsISupports
{
public:
NS_DECL_CYCLE_COLLECTING_ISUPPORTS
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_CLASS(CallbackObject)
/**
* Create a CallbackObject. aCallback is the callback object we're wrapping.
* aOwner is the object that will be receiving this CallbackObject as a method
* argument, if any. We need this so we can store our callback object in the
* same compartment as our owner. If *aInited is set to false, an exception
* has been thrown.
*/
CallbackObject(JSContext* cx, JSObject* aOwner, JSObject* aCallback,
bool* aInited)
: mCallback(nullptr)
{
// If aOwner is not null, enter the compartment of aOwner's
// underlying object.
if (aOwner) {
aOwner = js::UnwrapObject(aOwner);
JSAutoCompartment ac(cx, aOwner);
if (!JS_WrapObject(cx, &aCallback)) {
*aInited = false;
return;
}
}
// Set mCallback before we hold, on the off chance that a GC could somehow
// happen in there... (which would be pretty odd, granted).
mCallback = aCallback;
// Make sure we'll be able to drop as needed
nsLayoutStatics::AddRef();
NS_HOLD_JS_OBJECTS(this, CallbackObject);
*aInited = true;
}
virtual ~CallbackObject()
{
DropCallback();
}
JSObject* Callback() const
{
xpc_UnmarkGrayObject(mCallback);
return mCallback;
}
protected:
explicit CallbackObject(CallbackObject* aCallbackFunction)
: mCallback(aCallbackFunction->mCallback)
{
// Set mCallback before we hold, on the off chance that a GC could somehow
// happen in there... (which would be pretty odd, granted).
// Make sure we'll be able to drop as needed
nsLayoutStatics::AddRef();
NS_HOLD_JS_OBJECTS(this, CallbackObject);
}
void DropCallback()
{
if (mCallback) {
mCallback = nullptr;
NS_DROP_JS_OBJECTS(this, CallbackObject);
nsLayoutStatics::Release();
}
}
JSObject* mCallback;
class NS_STACK_CLASS CallSetup
{
/**
* A class that performs whatever setup we need to safely make a
* call while this class is on the stack, After the constructor
* returns, the call is safe to make if GetContext() returns
* non-null.
*/
public:
CallSetup(JSObject* const aCallable);
~CallSetup();
JSContext* GetContext() const
{
return mCx;
}
private:
// We better not get copy-constructed
CallSetup(const CallSetup&) MOZ_DELETE;
// Members which can go away whenever
JSContext* mCx;
nsCOMPtr<nsIScriptContext> mCtx;
// And now members whose construction/destruction order we need to control.
// Put our nsAutoMicrotask first, so it gets destroyed after everything else
// is gone
nsAutoMicroTask mMt;
// Can't construct an XPCAutoRequest until we have a JSContext, so
// this needs to be a Maybe.
Maybe<XPCAutoRequest> mAr;
// Can't construct a TerminationFuncHolder without an nsJSContext. But we
// generally want its destructor to come after the destructor of mCxPusher.
Maybe<nsJSContext::TerminationFuncHolder> mTerminationFuncHolder;
nsCxPusher mCxPusher;
// Can't construct a JSAutoCompartment without a JSContext either. Also,
// Put mAc after mCxPusher so that we exit the compartment before we pop the
// JSContext. Though in practice we'll often manually order those two
// things.
Maybe<JSAutoCompartment> mAc;
};
};
} // namespace dom
} // namespace mozilla
#endif // mozilla_dom_CallbackObject_h