fschneider@chromium.org | fb144a0 | 2011-05-04 12:43:48 +0000 | [diff] [blame] | 1 | // Copyright 2011 the V8 project authors. All rights reserved. |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 2 | // Redistribution and use in source and binary forms, with or without |
| 3 | // modification, are permitted provided that the following conditions are |
| 4 | // met: |
| 5 | // |
| 6 | // * Redistributions of source code must retain the above copyright |
| 7 | // notice, this list of conditions and the following disclaimer. |
| 8 | // * Redistributions in binary form must reproduce the above |
| 9 | // copyright notice, this list of conditions and the following |
| 10 | // disclaimer in the documentation and/or other materials provided |
| 11 | // with the distribution. |
| 12 | // * Neither the name of Google Inc. nor the names of its |
| 13 | // contributors may be used to endorse or promote products derived |
| 14 | // from this software without specific prior written permission. |
| 15 | // |
| 16 | // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 17 | // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| 18 | // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| 19 | // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| 20 | // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 21 | // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 22 | // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 23 | // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 24 | // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 25 | // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| 26 | // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 27 | |
| 28 | #ifndef V8_API_H_ |
| 29 | #define V8_API_H_ |
| 30 | |
ager@chromium.org | ddb913d | 2009-01-27 10:01:48 +0000 | [diff] [blame] | 31 | #include "apiutils.h" |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 32 | #include "factory.h" |
| 33 | |
kasperl@chromium.org | a555126 | 2010-12-07 12:49:48 +0000 | [diff] [blame] | 34 | #include "../include/v8-testing.h" |
| 35 | |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 36 | namespace v8 { |
| 37 | |
| 38 | // Constants used in the implementation of the API. The most natural thing |
| 39 | // would usually be to place these with the classes that use them, but |
| 40 | // we want to keep them out of v8.h because it is an externally |
| 41 | // visible file. |
| 42 | class Consts { |
| 43 | public: |
| 44 | enum TemplateType { |
| 45 | FUNCTION_TEMPLATE = 0, |
| 46 | OBJECT_TEMPLATE = 1 |
| 47 | }; |
| 48 | }; |
| 49 | |
| 50 | |
| 51 | // Utilities for working with neander-objects, primitive |
| 52 | // env-independent JSObjects used by the api. |
| 53 | class NeanderObject { |
| 54 | public: |
| 55 | explicit NeanderObject(int size); |
karlklose@chromium.org | 44bc708 | 2011-04-11 12:33:05 +0000 | [diff] [blame] | 56 | explicit inline NeanderObject(v8::internal::Handle<v8::internal::Object> obj); |
| 57 | explicit inline NeanderObject(v8::internal::Object* obj); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 58 | inline v8::internal::Object* get(int index); |
| 59 | inline void set(int index, v8::internal::Object* value); |
| 60 | inline v8::internal::Handle<v8::internal::JSObject> value() { return value_; } |
| 61 | int size(); |
| 62 | private: |
| 63 | v8::internal::Handle<v8::internal::JSObject> value_; |
| 64 | }; |
| 65 | |
| 66 | |
| 67 | // Utilities for working with neander-arrays, a simple extensible |
| 68 | // array abstraction built on neander-objects. |
| 69 | class NeanderArray { |
| 70 | public: |
| 71 | NeanderArray(); |
karlklose@chromium.org | 44bc708 | 2011-04-11 12:33:05 +0000 | [diff] [blame] | 72 | explicit inline NeanderArray(v8::internal::Handle<v8::internal::Object> obj); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 73 | inline v8::internal::Handle<v8::internal::JSObject> value() { |
| 74 | return obj_.value(); |
| 75 | } |
| 76 | |
| 77 | void add(v8::internal::Handle<v8::internal::Object> value); |
| 78 | |
| 79 | int length(); |
| 80 | |
| 81 | v8::internal::Object* get(int index); |
| 82 | // Change the value at an index to undefined value. If the index is |
| 83 | // out of bounds, the request is ignored. Returns the old value. |
| 84 | void set(int index, v8::internal::Object* value); |
| 85 | private: |
| 86 | NeanderObject obj_; |
| 87 | }; |
| 88 | |
| 89 | |
| 90 | NeanderObject::NeanderObject(v8::internal::Handle<v8::internal::Object> obj) |
| 91 | : value_(v8::internal::Handle<v8::internal::JSObject>::cast(obj)) { } |
| 92 | |
| 93 | |
| 94 | NeanderObject::NeanderObject(v8::internal::Object* obj) |
| 95 | : value_(v8::internal::Handle<v8::internal::JSObject>( |
| 96 | v8::internal::JSObject::cast(obj))) { } |
| 97 | |
| 98 | |
| 99 | NeanderArray::NeanderArray(v8::internal::Handle<v8::internal::Object> obj) |
| 100 | : obj_(obj) { } |
| 101 | |
| 102 | |
| 103 | v8::internal::Object* NeanderObject::get(int offset) { |
| 104 | ASSERT(value()->HasFastElements()); |
| 105 | return v8::internal::FixedArray::cast(value()->elements())->get(offset); |
| 106 | } |
| 107 | |
| 108 | |
| 109 | void NeanderObject::set(int offset, v8::internal::Object* value) { |
| 110 | ASSERT(value_->HasFastElements()); |
| 111 | v8::internal::FixedArray::cast(value_->elements())->set(offset, value); |
| 112 | } |
| 113 | |
| 114 | |
| 115 | template <typename T> static inline T ToCData(v8::internal::Object* obj) { |
| 116 | STATIC_ASSERT(sizeof(T) == sizeof(v8::internal::Address)); |
| 117 | return reinterpret_cast<T>( |
ager@chromium.org | ea91cc5 | 2011-05-23 06:06:11 +0000 | [diff] [blame] | 118 | reinterpret_cast<intptr_t>(v8::internal::Foreign::cast(obj)->address())); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 119 | } |
| 120 | |
| 121 | |
| 122 | template <typename T> |
| 123 | static inline v8::internal::Handle<v8::internal::Object> FromCData(T obj) { |
| 124 | STATIC_ASSERT(sizeof(T) == sizeof(v8::internal::Address)); |
ager@chromium.org | ea91cc5 | 2011-05-23 06:06:11 +0000 | [diff] [blame] | 125 | return FACTORY->NewForeign( |
kasperl@chromium.org | 41044eb | 2008-10-06 08:24:46 +0000 | [diff] [blame] | 126 | reinterpret_cast<v8::internal::Address>(reinterpret_cast<intptr_t>(obj))); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 127 | } |
| 128 | |
| 129 | |
ager@chromium.org | c4c9272 | 2009-11-18 14:12:51 +0000 | [diff] [blame] | 130 | class ApiFunction { |
| 131 | public: |
| 132 | explicit ApiFunction(v8::internal::Address addr) : addr_(addr) { } |
| 133 | v8::internal::Address address() { return addr_; } |
| 134 | private: |
| 135 | v8::internal::Address addr_; |
| 136 | }; |
| 137 | |
| 138 | |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 139 | enum ExtensionTraversalState { |
| 140 | UNVISITED, VISITED, INSTALLED |
| 141 | }; |
| 142 | |
| 143 | |
| 144 | class RegisteredExtension { |
| 145 | public: |
| 146 | explicit RegisteredExtension(Extension* extension); |
| 147 | static void Register(RegisteredExtension* that); |
| 148 | Extension* extension() { return extension_; } |
| 149 | RegisteredExtension* next() { return next_; } |
| 150 | RegisteredExtension* next_auto() { return next_auto_; } |
| 151 | ExtensionTraversalState state() { return state_; } |
| 152 | void set_state(ExtensionTraversalState value) { state_ = value; } |
| 153 | static RegisteredExtension* first_extension() { return first_extension_; } |
| 154 | private: |
| 155 | Extension* extension_; |
| 156 | RegisteredExtension* next_; |
| 157 | RegisteredExtension* next_auto_; |
| 158 | ExtensionTraversalState state_; |
| 159 | static RegisteredExtension* first_extension_; |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 160 | }; |
| 161 | |
| 162 | |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 163 | class Utils { |
| 164 | public: |
| 165 | static bool ReportApiFailure(const char* location, const char* message); |
| 166 | |
| 167 | static Local<FunctionTemplate> ToFunctionTemplate(NeanderObject obj); |
| 168 | static Local<ObjectTemplate> ToObjectTemplate(NeanderObject obj); |
| 169 | |
| 170 | static inline Local<Context> ToLocal( |
| 171 | v8::internal::Handle<v8::internal::Context> obj); |
| 172 | static inline Local<Value> ToLocal( |
| 173 | v8::internal::Handle<v8::internal::Object> obj); |
| 174 | static inline Local<Function> ToLocal( |
| 175 | v8::internal::Handle<v8::internal::JSFunction> obj); |
| 176 | static inline Local<String> ToLocal( |
| 177 | v8::internal::Handle<v8::internal::String> obj); |
ager@chromium.org | b61a0d1 | 2010-10-13 08:35:23 +0000 | [diff] [blame] | 178 | static inline Local<RegExp> ToLocal( |
| 179 | v8::internal::Handle<v8::internal::JSRegExp> obj); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 180 | static inline Local<Object> ToLocal( |
| 181 | v8::internal::Handle<v8::internal::JSObject> obj); |
| 182 | static inline Local<Array> ToLocal( |
| 183 | v8::internal::Handle<v8::internal::JSArray> obj); |
| 184 | static inline Local<External> ToLocal( |
ager@chromium.org | ea91cc5 | 2011-05-23 06:06:11 +0000 | [diff] [blame] | 185 | v8::internal::Handle<v8::internal::Foreign> obj); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 186 | static inline Local<Message> MessageToLocal( |
| 187 | v8::internal::Handle<v8::internal::Object> obj); |
sgjesse@chromium.org | 720dc0b | 2010-05-10 09:25:39 +0000 | [diff] [blame] | 188 | static inline Local<StackTrace> StackTraceToLocal( |
| 189 | v8::internal::Handle<v8::internal::JSArray> obj); |
| 190 | static inline Local<StackFrame> StackFrameToLocal( |
| 191 | v8::internal::Handle<v8::internal::JSObject> obj); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 192 | static inline Local<Number> NumberToLocal( |
| 193 | v8::internal::Handle<v8::internal::Object> obj); |
| 194 | static inline Local<Integer> IntegerToLocal( |
| 195 | v8::internal::Handle<v8::internal::Object> obj); |
| 196 | static inline Local<Uint32> Uint32ToLocal( |
| 197 | v8::internal::Handle<v8::internal::Object> obj); |
| 198 | static inline Local<FunctionTemplate> ToLocal( |
| 199 | v8::internal::Handle<v8::internal::FunctionTemplateInfo> obj); |
| 200 | static inline Local<ObjectTemplate> ToLocal( |
| 201 | v8::internal::Handle<v8::internal::ObjectTemplateInfo> obj); |
| 202 | static inline Local<Signature> ToLocal( |
| 203 | v8::internal::Handle<v8::internal::SignatureInfo> obj); |
| 204 | static inline Local<TypeSwitch> ToLocal( |
| 205 | v8::internal::Handle<v8::internal::TypeSwitchInfo> obj); |
| 206 | |
| 207 | static inline v8::internal::Handle<v8::internal::TemplateInfo> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 208 | OpenHandle(const Template* that); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 209 | static inline v8::internal::Handle<v8::internal::FunctionTemplateInfo> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 210 | OpenHandle(const FunctionTemplate* that); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 211 | static inline v8::internal::Handle<v8::internal::ObjectTemplateInfo> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 212 | OpenHandle(const ObjectTemplate* that); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 213 | static inline v8::internal::Handle<v8::internal::Object> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 214 | OpenHandle(const Data* data); |
ager@chromium.org | b61a0d1 | 2010-10-13 08:35:23 +0000 | [diff] [blame] | 215 | static inline v8::internal::Handle<v8::internal::JSRegExp> |
| 216 | OpenHandle(const RegExp* data); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 217 | static inline v8::internal::Handle<v8::internal::JSObject> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 218 | OpenHandle(const v8::Object* data); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 219 | static inline v8::internal::Handle<v8::internal::JSArray> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 220 | OpenHandle(const v8::Array* data); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 221 | static inline v8::internal::Handle<v8::internal::String> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 222 | OpenHandle(const String* data); |
kmillikin@chromium.org | 5d8f0e6 | 2010-03-24 08:21:20 +0000 | [diff] [blame] | 223 | static inline v8::internal::Handle<v8::internal::Object> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 224 | OpenHandle(const Script* data); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 225 | static inline v8::internal::Handle<v8::internal::JSFunction> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 226 | OpenHandle(const Function* data); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 227 | static inline v8::internal::Handle<v8::internal::JSObject> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 228 | OpenHandle(const Message* message); |
sgjesse@chromium.org | 720dc0b | 2010-05-10 09:25:39 +0000 | [diff] [blame] | 229 | static inline v8::internal::Handle<v8::internal::JSArray> |
| 230 | OpenHandle(const StackTrace* stack_trace); |
| 231 | static inline v8::internal::Handle<v8::internal::JSObject> |
| 232 | OpenHandle(const StackFrame* stack_frame); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 233 | static inline v8::internal::Handle<v8::internal::Context> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 234 | OpenHandle(const v8::Context* context); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 235 | static inline v8::internal::Handle<v8::internal::SignatureInfo> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 236 | OpenHandle(const v8::Signature* sig); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 237 | static inline v8::internal::Handle<v8::internal::TypeSwitchInfo> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 238 | OpenHandle(const v8::TypeSwitch* that); |
ager@chromium.org | ea91cc5 | 2011-05-23 06:06:11 +0000 | [diff] [blame] | 239 | static inline v8::internal::Handle<v8::internal::Foreign> |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 240 | OpenHandle(const v8::External* that); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 241 | }; |
| 242 | |
| 243 | |
| 244 | template <class T> |
| 245 | static inline T* ToApi(v8::internal::Handle<v8::internal::Object> obj) { |
| 246 | return reinterpret_cast<T*>(obj.location()); |
| 247 | } |
| 248 | |
| 249 | |
| 250 | template <class T> |
| 251 | v8::internal::Handle<T> v8::internal::Handle<T>::EscapeFrom( |
ager@chromium.org | ddb913d | 2009-01-27 10:01:48 +0000 | [diff] [blame] | 252 | v8::HandleScope* scope) { |
sgjesse@chromium.org | df7a284 | 2010-03-25 14:34:15 +0000 | [diff] [blame] | 253 | v8::internal::Handle<T> handle; |
| 254 | if (!is_null()) { |
| 255 | handle = *this; |
| 256 | } |
| 257 | return Utils::OpenHandle(*scope->Close(Utils::ToLocal(handle))); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 258 | } |
| 259 | |
| 260 | |
| 261 | // Implementations of ToLocal |
| 262 | |
kasperl@chromium.org | defbd10 | 2009-07-13 14:04:26 +0000 | [diff] [blame] | 263 | #define MAKE_TO_LOCAL(Name, From, To) \ |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 264 | Local<v8::To> Utils::Name(v8::internal::Handle<v8::internal::From> obj) { \ |
sgjesse@chromium.org | df7a284 | 2010-03-25 14:34:15 +0000 | [diff] [blame] | 265 | ASSERT(obj.is_null() || !obj->IsTheHole()); \ |
kasperl@chromium.org | defbd10 | 2009-07-13 14:04:26 +0000 | [diff] [blame] | 266 | return Local<To>(reinterpret_cast<To*>(obj.location())); \ |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 267 | } |
| 268 | |
| 269 | MAKE_TO_LOCAL(ToLocal, Context, Context) |
| 270 | MAKE_TO_LOCAL(ToLocal, Object, Value) |
| 271 | MAKE_TO_LOCAL(ToLocal, JSFunction, Function) |
| 272 | MAKE_TO_LOCAL(ToLocal, String, String) |
ager@chromium.org | b61a0d1 | 2010-10-13 08:35:23 +0000 | [diff] [blame] | 273 | MAKE_TO_LOCAL(ToLocal, JSRegExp, RegExp) |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 274 | MAKE_TO_LOCAL(ToLocal, JSObject, Object) |
| 275 | MAKE_TO_LOCAL(ToLocal, JSArray, Array) |
ager@chromium.org | ea91cc5 | 2011-05-23 06:06:11 +0000 | [diff] [blame] | 276 | MAKE_TO_LOCAL(ToLocal, Foreign, External) |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 277 | MAKE_TO_LOCAL(ToLocal, FunctionTemplateInfo, FunctionTemplate) |
| 278 | MAKE_TO_LOCAL(ToLocal, ObjectTemplateInfo, ObjectTemplate) |
| 279 | MAKE_TO_LOCAL(ToLocal, SignatureInfo, Signature) |
| 280 | MAKE_TO_LOCAL(ToLocal, TypeSwitchInfo, TypeSwitch) |
| 281 | MAKE_TO_LOCAL(MessageToLocal, Object, Message) |
sgjesse@chromium.org | 720dc0b | 2010-05-10 09:25:39 +0000 | [diff] [blame] | 282 | MAKE_TO_LOCAL(StackTraceToLocal, JSArray, StackTrace) |
| 283 | MAKE_TO_LOCAL(StackFrameToLocal, JSObject, StackFrame) |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 284 | MAKE_TO_LOCAL(NumberToLocal, Object, Number) |
| 285 | MAKE_TO_LOCAL(IntegerToLocal, Object, Integer) |
| 286 | MAKE_TO_LOCAL(Uint32ToLocal, Object, Uint32) |
| 287 | |
| 288 | #undef MAKE_TO_LOCAL |
| 289 | |
| 290 | |
| 291 | // Implementations of OpenHandle |
| 292 | |
| 293 | #define MAKE_OPEN_HANDLE(From, To) \ |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 294 | v8::internal::Handle<v8::internal::To> Utils::OpenHandle(\ |
| 295 | const v8::From* that) { \ |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 296 | return v8::internal::Handle<v8::internal::To>( \ |
ager@chromium.org | 3291210 | 2009-01-16 10:38:43 +0000 | [diff] [blame] | 297 | reinterpret_cast<v8::internal::To**>(const_cast<v8::From*>(that))); \ |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 298 | } |
| 299 | |
| 300 | MAKE_OPEN_HANDLE(Template, TemplateInfo) |
| 301 | MAKE_OPEN_HANDLE(FunctionTemplate, FunctionTemplateInfo) |
| 302 | MAKE_OPEN_HANDLE(ObjectTemplate, ObjectTemplateInfo) |
| 303 | MAKE_OPEN_HANDLE(Signature, SignatureInfo) |
| 304 | MAKE_OPEN_HANDLE(TypeSwitch, TypeSwitchInfo) |
| 305 | MAKE_OPEN_HANDLE(Data, Object) |
ager@chromium.org | b61a0d1 | 2010-10-13 08:35:23 +0000 | [diff] [blame] | 306 | MAKE_OPEN_HANDLE(RegExp, JSRegExp) |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 307 | MAKE_OPEN_HANDLE(Object, JSObject) |
| 308 | MAKE_OPEN_HANDLE(Array, JSArray) |
| 309 | MAKE_OPEN_HANDLE(String, String) |
kmillikin@chromium.org | 5d8f0e6 | 2010-03-24 08:21:20 +0000 | [diff] [blame] | 310 | MAKE_OPEN_HANDLE(Script, Object) |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 311 | MAKE_OPEN_HANDLE(Function, JSFunction) |
| 312 | MAKE_OPEN_HANDLE(Message, JSObject) |
| 313 | MAKE_OPEN_HANDLE(Context, Context) |
ager@chromium.org | ea91cc5 | 2011-05-23 06:06:11 +0000 | [diff] [blame] | 314 | MAKE_OPEN_HANDLE(External, Foreign) |
sgjesse@chromium.org | 720dc0b | 2010-05-10 09:25:39 +0000 | [diff] [blame] | 315 | MAKE_OPEN_HANDLE(StackTrace, JSArray) |
| 316 | MAKE_OPEN_HANDLE(StackFrame, JSObject) |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 317 | |
| 318 | #undef MAKE_OPEN_HANDLE |
| 319 | |
| 320 | |
| 321 | namespace internal { |
| 322 | |
sgjesse@chromium.org | ea88ce9 | 2011-03-23 11:19:56 +0000 | [diff] [blame] | 323 | // Tracks string usage to help make better decisions when |
| 324 | // externalizing strings. |
| 325 | // |
| 326 | // Implementation note: internally this class only tracks fresh |
| 327 | // strings and keeps a single use counter for them. |
| 328 | class StringTracker { |
| 329 | public: |
| 330 | // Records that the given string's characters were copied to some |
| 331 | // external buffer. If this happens often we should honor |
| 332 | // externalization requests for the string. |
| 333 | void RecordWrite(Handle<String> string) { |
| 334 | Address address = reinterpret_cast<Address>(*string); |
| 335 | Address top = isolate_->heap()->NewSpaceTop(); |
| 336 | if (IsFreshString(address, top)) { |
| 337 | IncrementUseCount(top); |
| 338 | } |
| 339 | } |
| 340 | |
| 341 | // Estimates freshness and use frequency of the given string based |
| 342 | // on how close it is to the new space top and the recorded usage |
| 343 | // history. |
| 344 | inline bool IsFreshUnusedString(Handle<String> string) { |
| 345 | Address address = reinterpret_cast<Address>(*string); |
| 346 | Address top = isolate_->heap()->NewSpaceTop(); |
| 347 | return IsFreshString(address, top) && IsUseCountLow(top); |
| 348 | } |
| 349 | |
| 350 | private: |
| 351 | StringTracker() : use_count_(0), last_top_(NULL), isolate_(NULL) { } |
| 352 | |
| 353 | static inline bool IsFreshString(Address string, Address top) { |
| 354 | return top - kFreshnessLimit <= string && string <= top; |
| 355 | } |
| 356 | |
| 357 | inline bool IsUseCountLow(Address top) { |
| 358 | if (last_top_ != top) return true; |
| 359 | return use_count_ < kUseLimit; |
| 360 | } |
| 361 | |
| 362 | inline void IncrementUseCount(Address top) { |
| 363 | if (last_top_ != top) { |
| 364 | use_count_ = 0; |
| 365 | last_top_ = top; |
| 366 | } |
| 367 | ++use_count_; |
| 368 | } |
| 369 | |
| 370 | // Single use counter shared by all fresh strings. |
| 371 | int use_count_; |
| 372 | |
| 373 | // Last new space top when the use count above was valid. |
| 374 | Address last_top_; |
| 375 | |
| 376 | Isolate* isolate_; |
| 377 | |
| 378 | // How close to the new space top a fresh string has to be. |
| 379 | static const int kFreshnessLimit = 1024; |
| 380 | |
| 381 | // The number of uses required to consider a string useful. |
| 382 | static const int kUseLimit = 32; |
| 383 | |
| 384 | friend class Isolate; |
| 385 | |
| 386 | DISALLOW_COPY_AND_ASSIGN(StringTracker); |
| 387 | }; |
| 388 | |
| 389 | |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 390 | // This class is here in order to be able to declare it a friend of |
| 391 | // HandleScope. Moving these methods to be members of HandleScope would be |
sgjesse@chromium.org | ea88ce9 | 2011-03-23 11:19:56 +0000 | [diff] [blame] | 392 | // neat in some ways, but it would expose internal implementation details in |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 393 | // our public header file, which is undesirable. |
| 394 | // |
sgjesse@chromium.org | ea88ce9 | 2011-03-23 11:19:56 +0000 | [diff] [blame] | 395 | // An isolate has a single instance of this class to hold the current thread's |
| 396 | // data. In multithreaded V8 programs this data is copied in and out of storage |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 397 | // so that the currently executing thread always has its own copy of this |
| 398 | // data. |
danno@chromium.org | 40cb878 | 2011-05-25 07:58:50 +0000 | [diff] [blame] | 399 | class HandleScopeImplementer { |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 400 | public: |
lrn@chromium.org | 1c09276 | 2011-05-09 09:42:16 +0000 | [diff] [blame] | 401 | explicit HandleScopeImplementer(Isolate* isolate) |
| 402 | : isolate_(isolate), |
| 403 | blocks_(0), |
kasper.lund | 4451067 | 2008-07-25 07:37:58 +0000 | [diff] [blame] | 404 | entered_contexts_(0), |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 405 | saved_contexts_(0), |
| 406 | spare_(NULL), |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 407 | call_depth_(0) { } |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 408 | |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 409 | // Threading support for handle data. |
| 410 | static int ArchiveSpacePerThread(); |
sgjesse@chromium.org | ea88ce9 | 2011-03-23 11:19:56 +0000 | [diff] [blame] | 411 | char* RestoreThread(char* from); |
| 412 | char* ArchiveThread(char* to); |
| 413 | void FreeThreadResources(); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 414 | |
| 415 | // Garbage collection support. |
sgjesse@chromium.org | ea88ce9 | 2011-03-23 11:19:56 +0000 | [diff] [blame] | 416 | void Iterate(v8::internal::ObjectVisitor* v); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 417 | static char* Iterate(v8::internal::ObjectVisitor* v, char* data); |
| 418 | |
| 419 | |
ager@chromium.org | 18ad94b | 2009-09-02 08:22:29 +0000 | [diff] [blame] | 420 | inline internal::Object** GetSpareOrNewBlock(); |
lrn@chromium.org | 303ada7 | 2010-10-27 09:33:13 +0000 | [diff] [blame] | 421 | inline void DeleteExtensions(internal::Object** prev_limit); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 422 | |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 423 | inline void IncrementCallDepth() {call_depth_++;} |
| 424 | inline void DecrementCallDepth() {call_depth_--;} |
| 425 | inline bool CallDepthIsZero() { return call_depth_ == 0; } |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 426 | |
kasper.lund | 4451067 | 2008-07-25 07:37:58 +0000 | [diff] [blame] | 427 | inline void EnterContext(Handle<Object> context); |
| 428 | inline bool LeaveLastContext(); |
| 429 | |
| 430 | // Returns the last entered context or an empty handle if no |
| 431 | // contexts have been entered. |
| 432 | inline Handle<Object> LastEnteredContext(); |
| 433 | |
ager@chromium.org | a1645e2 | 2009-09-09 19:27:10 +0000 | [diff] [blame] | 434 | inline void SaveContext(Context* context); |
| 435 | inline Context* RestoreContext(); |
kasper.lund | 4451067 | 2008-07-25 07:37:58 +0000 | [diff] [blame] | 436 | inline bool HasSavedContexts(); |
| 437 | |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 438 | inline List<internal::Object**>* blocks() { return &blocks_; } |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 439 | |
| 440 | private: |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 441 | void ResetAfterArchive() { |
| 442 | blocks_.Initialize(0); |
| 443 | entered_contexts_.Initialize(0); |
| 444 | saved_contexts_.Initialize(0); |
| 445 | spare_ = NULL; |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 446 | call_depth_ = 0; |
| 447 | } |
| 448 | |
| 449 | void Free() { |
| 450 | ASSERT(blocks_.length() == 0); |
| 451 | ASSERT(entered_contexts_.length() == 0); |
| 452 | ASSERT(saved_contexts_.length() == 0); |
| 453 | blocks_.Free(); |
| 454 | entered_contexts_.Free(); |
| 455 | saved_contexts_.Free(); |
| 456 | if (spare_ != NULL) { |
| 457 | DeleteArray(spare_); |
| 458 | spare_ = NULL; |
| 459 | } |
| 460 | ASSERT(call_depth_ == 0); |
| 461 | } |
| 462 | |
lrn@chromium.org | 1c09276 | 2011-05-09 09:42:16 +0000 | [diff] [blame] | 463 | Isolate* isolate_; |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 464 | List<internal::Object**> blocks_; |
kasper.lund | 4451067 | 2008-07-25 07:37:58 +0000 | [diff] [blame] | 465 | // Used as a stack to keep track of entered contexts. |
| 466 | List<Handle<Object> > entered_contexts_; |
| 467 | // Used as a stack to keep track of saved contexts. |
ager@chromium.org | a1645e2 | 2009-09-09 19:27:10 +0000 | [diff] [blame] | 468 | List<Context*> saved_contexts_; |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 469 | Object** spare_; |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 470 | int call_depth_; |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 471 | // This is only used for threading support. |
ager@chromium.org | ddb913d | 2009-01-27 10:01:48 +0000 | [diff] [blame] | 472 | v8::ImplementationUtilities::HandleScopeData handle_scope_data_; |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 473 | |
ager@chromium.org | a1645e2 | 2009-09-09 19:27:10 +0000 | [diff] [blame] | 474 | void IterateThis(ObjectVisitor* v); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 475 | char* RestoreThreadHelper(char* from); |
| 476 | char* ArchiveThreadHelper(char* to); |
| 477 | |
mads.s.ager@gmail.com | 9a4089a | 2008-09-01 08:55:01 +0000 | [diff] [blame] | 478 | DISALLOW_COPY_AND_ASSIGN(HandleScopeImplementer); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 479 | }; |
| 480 | |
| 481 | |
| 482 | static const int kHandleBlockSize = v8::internal::KB - 2; // fit in one page |
| 483 | |
| 484 | |
ager@chromium.org | a1645e2 | 2009-09-09 19:27:10 +0000 | [diff] [blame] | 485 | void HandleScopeImplementer::SaveContext(Context* context) { |
kasper.lund | 4451067 | 2008-07-25 07:37:58 +0000 | [diff] [blame] | 486 | saved_contexts_.Add(context); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 487 | } |
| 488 | |
| 489 | |
ager@chromium.org | a1645e2 | 2009-09-09 19:27:10 +0000 | [diff] [blame] | 490 | Context* HandleScopeImplementer::RestoreContext() { |
kasper.lund | 4451067 | 2008-07-25 07:37:58 +0000 | [diff] [blame] | 491 | return saved_contexts_.RemoveLast(); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 492 | } |
| 493 | |
| 494 | |
kasper.lund | 4451067 | 2008-07-25 07:37:58 +0000 | [diff] [blame] | 495 | bool HandleScopeImplementer::HasSavedContexts() { |
| 496 | return !saved_contexts_.is_empty(); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 497 | } |
| 498 | |
| 499 | |
kasper.lund | 4451067 | 2008-07-25 07:37:58 +0000 | [diff] [blame] | 500 | void HandleScopeImplementer::EnterContext(Handle<Object> context) { |
| 501 | entered_contexts_.Add(context); |
| 502 | } |
| 503 | |
| 504 | |
| 505 | bool HandleScopeImplementer::LeaveLastContext() { |
| 506 | if (entered_contexts_.is_empty()) return false; |
| 507 | entered_contexts_.RemoveLast(); |
| 508 | return true; |
| 509 | } |
| 510 | |
| 511 | |
| 512 | Handle<Object> HandleScopeImplementer::LastEnteredContext() { |
| 513 | if (entered_contexts_.is_empty()) return Handle<Object>::null(); |
| 514 | return entered_contexts_.last(); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 515 | } |
| 516 | |
| 517 | |
| 518 | // If there's a spare block, use it for growing the current scope. |
ager@chromium.org | 18ad94b | 2009-09-02 08:22:29 +0000 | [diff] [blame] | 519 | internal::Object** HandleScopeImplementer::GetSpareOrNewBlock() { |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 520 | internal::Object** block = (spare_ != NULL) ? |
| 521 | spare_ : |
ager@chromium.org | 18ad94b | 2009-09-02 08:22:29 +0000 | [diff] [blame] | 522 | NewArray<internal::Object*>(kHandleBlockSize); |
sgjesse@chromium.org | c514574 | 2009-10-07 09:00:33 +0000 | [diff] [blame] | 523 | spare_ = NULL; |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 524 | return block; |
| 525 | } |
| 526 | |
| 527 | |
lrn@chromium.org | 303ada7 | 2010-10-27 09:33:13 +0000 | [diff] [blame] | 528 | void HandleScopeImplementer::DeleteExtensions(internal::Object** prev_limit) { |
| 529 | while (!blocks_.is_empty()) { |
| 530 | internal::Object** block_start = blocks_.last(); |
| 531 | internal::Object** block_limit = block_start + kHandleBlockSize; |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 532 | #ifdef DEBUG |
lrn@chromium.org | 303ada7 | 2010-10-27 09:33:13 +0000 | [diff] [blame] | 533 | // NoHandleAllocation may make the prev_limit to point inside the block. |
| 534 | if (block_start <= prev_limit && prev_limit <= block_limit) break; |
| 535 | #else |
| 536 | if (prev_limit == block_limit) break; |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 537 | #endif |
lrn@chromium.org | 303ada7 | 2010-10-27 09:33:13 +0000 | [diff] [blame] | 538 | |
| 539 | blocks_.RemoveLast(); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 540 | #ifdef DEBUG |
lrn@chromium.org | 303ada7 | 2010-10-27 09:33:13 +0000 | [diff] [blame] | 541 | v8::ImplementationUtilities::ZapHandleRange(block_start, block_limit); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 542 | #endif |
lrn@chromium.org | 303ada7 | 2010-10-27 09:33:13 +0000 | [diff] [blame] | 543 | if (spare_ != NULL) { |
| 544 | DeleteArray(spare_); |
| 545 | } |
| 546 | spare_ = block_start; |
| 547 | } |
| 548 | ASSERT((blocks_.is_empty() && prev_limit == NULL) || |
| 549 | (!blocks_.is_empty() && prev_limit != NULL)); |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 550 | } |
| 551 | |
kasperl@chromium.org | a555126 | 2010-12-07 12:49:48 +0000 | [diff] [blame] | 552 | |
| 553 | class Testing { |
| 554 | public: |
| 555 | static v8::Testing::StressType stress_type() { return stress_type_; } |
| 556 | static void set_stress_type(v8::Testing::StressType stress_type) { |
| 557 | stress_type_ = stress_type; |
| 558 | } |
| 559 | |
| 560 | private: |
| 561 | static v8::Testing::StressType stress_type_; |
| 562 | }; |
| 563 | |
christian.plesner.hansen | 43d26ec | 2008-07-03 15:10:15 +0000 | [diff] [blame] | 564 | } } // namespace v8::internal |
| 565 | |
| 566 | #endif // V8_API_H_ |