| BackstagePass.h |
|
2569 |
| components.conf |
|
632 |
| ExportHelpers.cpp |
stopAtWindowProxy = |
18822 |
| JSServices.cpp |
allowNativeWrapper |
5508 |
| JSServices.h |
|
484 |
| jsshell.msg |
|
539 |
| moz.build |
|
1843 |
| nsIXPConnect.h |
The core XPConnect public interfaces. |
10953 |
| nsXPConnect.cpp |
High level class and public functions implementation. |
36929 |
| README |
see http://www.mozilla.org/scriptable |
40 |
| Sandbox.cpp |
The Components.Sandbox object.
|
74999 |
| SandboxPrivate.h |
|
4222 |
| xpc.msg |
|
21613 |
| XPCCallContext.cpp |
Call context. |
5610 |
| XPCComponents.cpp |
The "Components" xpcom objects for JavaScript. |
83344 |
| XPCConvert.cpp |
Data conversion between native and JavaScript types. |
49040 |
| XPCDebug.cpp |
|
1653 |
| XPCException.cpp |
An implementaion of nsIException. |
2063 |
| XPCForwards.h |
Private forward declarations. |
1273 |
| XPCInlines.h |
private inline methods (#include'd by xpcprivate.h). |
10553 |
| XPCJSContext.cpp |
Per JSContext object |
53046 |
| XPCJSID.cpp |
An xpcom implementation of the JavaScript nsIID and nsCID objects. |
22043 |
| XPCJSMemoryReporter.h |
|
1025 |
| XPCJSRuntime.cpp |
Per JSRuntime object |
116704 |
| XPCJSWeakReference.cpp |
|
2736 |
| XPCJSWeakReference.h |
|
805 |
| XPCLocale.cpp |
JS locale callbacks implemented by XPCOM modules. These are theoretically
safe for use on multiple threads. Unfortunately, the intl code underlying
these XPCOM modules doesn't yet support this, so in practice
XPCLocaleCallbacks are limited to the main thread.
|
4732 |
| XPCLog.cpp |
Debug Logging support. |
1854 |
| XPCLog.h |
Debug Logging support. |
2074 |
| XPCMaps.cpp |
Private maps (hashtables). |
6649 |
| XPCMaps.h |
Private maps (hashtables). |
10136 |
| XPCModule.cpp |
|
551 |
| XPCModule.h |
Module implementation for the xpconnect library. |
947 |
| xpcObjectHelper.h |
|
1829 |
| xpcprivate.h |
XPConnect allows JS code to manipulate C++ object and C++ code to manipulate
JS objects. JS manipulation of C++ objects tends to be significantly more
complex. This comment explains how it is orchestrated by XPConnect.
For each C++ object to be manipulated in JS, there is a corresponding JS
object. This is called the "flattened JS object". By default, there is an
additional C++ object involved of type XPCWrappedNative. The XPCWrappedNative
holds pointers to the C++ object and the flat JS object.
All XPCWrappedNative objects belong to an XPCWrappedNativeScope. These scopes
are essentially in 1:1 correspondence with JS compartments. The
XPCWrappedNativeScope has a pointer to the JS compartment. The global of a
flattened JS object is one of the globals in this compartment (the exception
to this rule is when a PreCreate hook asks for a different global; see
nsIXPCScriptable below).
Some C++ objects (notably DOM objects) have information associated with them
that lists the interfaces implemented by these objects. A C++ object exposes
this information by implementing nsIClassInfo. If a C++ object implements
nsIClassInfo, then JS code can call its methods without needing to use
QueryInterface first. Typically, all instances of a C++ class share the same
nsIClassInfo instance. (That is, obj->QueryInterface(nsIClassInfo) returns
the same result for every obj of a given class.)
XPConnect tracks nsIClassInfo information in an XPCWrappedNativeProto object.
A given XPCWrappedNativeScope will have one XPCWrappedNativeProto for each
nsIClassInfo instance being used. The XPCWrappedNativeProto has an associated
JS object, which is used as the prototype of all flattened JS objects created
for C++ objects with the given nsIClassInfo.
Each XPCWrappedNativeProto has a pointer to its XPCWrappedNativeScope. If an
XPCWrappedNative wraps a C++ object with class info, then it points to its
XPCWrappedNativeProto. Otherwise it points to its XPCWrappedNativeScope. (The
pointers are smooshed together in a tagged union.) Either way it can reach
its scope.
An XPCWrappedNativeProto keeps track of the set of interfaces implemented by
the C++ object in an XPCNativeSet. (The list of interfaces is obtained by
calling a method on the nsIClassInfo.) An XPCNativeSet is a collection of
XPCNativeInterfaces. Each interface stores the list of members, which can be
methods, constants, getters, or setters.
An XPCWrappedNative also points to an XPCNativeSet. Initially this starts out
the same as the XPCWrappedNativeProto's set. If there is no proto, it starts
out as a singleton set containing nsISupports. If JS code QI's new interfaces
outside of the existing set, the set will grow. All QueryInterface results
are cached in XPCWrappedNativeTearOff objects, which are linked off of the
XPCWrappedNative.
Besides having class info, a C++ object may be "scriptable" (i.e., implement
nsIXPCScriptable). This allows it to implement a more DOM-like interface,
besides just exposing XPCOM methods and constants. An nsIXPCScriptable
instance has hooks that correspond to all the normal JSClass hooks. Each
nsIXPCScriptable instance can have pointers from XPCWrappedNativeProto and
XPCWrappedNative (since C++ objects can have scriptable info without having
class info).
|
98236 |
| xpcpublic.h |
|
28321 |
| xpcrtfuzzing |
|
|
| XPCRuntimeService.cpp |
This will #undef the above |
7041 |
| XPCSelfHostedShmem.cpp |
read_only |
3588 |
| XPCSelfHostedShmem.h |
|
3252 |
| XPCShellImpl.cpp |
for isatty() |
44492 |
| XPCString.cpp |
Infrastructure for sharing DOMString data with JSStrings.
Importing an nsAString into JS:
If possible (GetSharedBufferHandle works) use the external string support in
JS to create a JSString that points to the readable's buffer. We keep a
reference to the buffer handle until the JSString is finalized.
Exporting a JSString as an nsAReadable:
Wrap the JSString with a root-holding XPCJSReadableStringWrapper, which roots
the string and exposes its buffer via the nsAString interface, as
well as providing refcounting support.
|
4400 |
| XPCThrower.cpp |
Code for throwing errors into JavaScript. |
4492 |
| XPCVariant.cpp |
nsIVariant implementation for xpconnect. |
22998 |
| XPCWrappedJS.cpp |
Class that wraps JS objects to appear as XPCOM objects. |
22799 |
| XPCWrappedJSClass.cpp |
Sharable code and data for wrapper around JSObjects. |
37698 |
| XPCWrappedJSIterator.cpp |
|
2732 |
| XPCWrappedNative.cpp |
Wrapper object for reflecting native xpcom objects into JavaScript. |
62542 |
| XPCWrappedNativeInfo.cpp |
Manage the shared info about interfaces for use by wrappedNatives. |
20672 |
| XPCWrappedNativeJSOps.cpp |
JavaScript JSClasses and JSOps for our Wrapped Native JS Objects. |
40336 |
| XPCWrappedNativeProto.cpp |
Shared proto object for XPCWrappedNative. |
4522 |
| XPCWrappedNativeScope.cpp |
Class used to manage the wrapped native objects within a JS scope. |
17128 |
| XPCWrapper.cpp |
|
2584 |
| XPCWrapper.h |
|
980 |