| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CONTENT_PUBLIC_CHILD_V8_VALUE_CONVERTER_H_ | 5 #ifndef CONTENT_PUBLIC_CHILD_V8_VALUE_CONVERTER_H_ |
| 6 #define CONTENT_PUBLIC_CHILD_V8_VALUE_CONVERTER_H_ | 6 #define CONTENT_PUBLIC_CHILD_V8_VALUE_CONVERTER_H_ |
| 7 | 7 |
| 8 #include "base/callback.h" | 8 #include "base/callback.h" |
| 9 #include "content/common/content_export.h" | 9 #include "content/common/content_export.h" |
| 10 #include "v8/include/v8.h" | 10 #include "v8/include/v8.h" |
| (...skipping 11 matching lines...) Expand all Loading... |
| 22 // The JSON types (null, boolean, string, number, array, and object) as well as | 22 // The JSON types (null, boolean, string, number, array, and object) as well as |
| 23 // binary values are supported. For binary values, we convert to WebKit | 23 // binary values are supported. For binary values, we convert to WebKit |
| 24 // ArrayBuffers, and support converting from an ArrayBuffer or any of the | 24 // ArrayBuffers, and support converting from an ArrayBuffer or any of the |
| 25 // ArrayBufferView subclasses (Uint8Array, etc.). | 25 // ArrayBufferView subclasses (Uint8Array, etc.). |
| 26 class CONTENT_EXPORT V8ValueConverter { | 26 class CONTENT_EXPORT V8ValueConverter { |
| 27 public: | 27 public: |
| 28 // Extends the default behaviour of V8ValueConverter. | 28 // Extends the default behaviour of V8ValueConverter. |
| 29 class CONTENT_EXPORT Strategy { | 29 class CONTENT_EXPORT Strategy { |
| 30 public: | 30 public: |
| 31 typedef base::Callback<base::Value*( | 31 typedef base::Callback<base::Value*( |
| 32 v8::Handle<v8::Value>, v8::Isolate* isolate)> FromV8ValueCallback; | 32 v8::Local<v8::Value>, v8::Isolate* isolate)> FromV8ValueCallback; |
| 33 | 33 |
| 34 virtual ~Strategy() {} | 34 virtual ~Strategy() {} |
| 35 | 35 |
| 36 // If false is returned, V8ValueConverter proceeds with the default | 36 // If false is returned, V8ValueConverter proceeds with the default |
| 37 // behavior. | 37 // behavior. |
| 38 // Use |callback| to convert any child values, as this will retain | 38 // Use |callback| to convert any child values, as this will retain |
| 39 // the ValueConverter's internal checks for depth and cycles. | 39 // the ValueConverter's internal checks for depth and cycles. |
| 40 virtual bool FromV8Object(v8::Handle<v8::Object> value, | 40 virtual bool FromV8Object(v8::Local<v8::Object> value, |
| 41 base::Value** out, | 41 base::Value** out, |
| 42 v8::Isolate* isolate, | 42 v8::Isolate* isolate, |
| 43 const FromV8ValueCallback& callback) const; | 43 const FromV8ValueCallback& callback) const; |
| 44 | 44 |
| 45 // If false is returned, V8ValueConverter proceeds with the default | 45 // If false is returned, V8ValueConverter proceeds with the default |
| 46 // behavior. | 46 // behavior. |
| 47 // Use |callback| to convert any child values, as this will retain | 47 // Use |callback| to convert any child values, as this will retain |
| 48 // the ValueConverter's internal checks for depth and cycles. | 48 // the ValueConverter's internal checks for depth and cycles. |
| 49 virtual bool FromV8Array(v8::Handle<v8::Array> value, | 49 virtual bool FromV8Array(v8::Local<v8::Array> value, |
| 50 base::Value** out, | 50 base::Value** out, |
| 51 v8::Isolate* isolate, | 51 v8::Isolate* isolate, |
| 52 const FromV8ValueCallback& callback) const; | 52 const FromV8ValueCallback& callback) const; |
| 53 | 53 |
| 54 // If false is returned, V8ValueConverter proceeds with the default | 54 // If false is returned, V8ValueConverter proceeds with the default |
| 55 // behavior. v8::Object is passed as ArrayBuffer and ArrayBufferView | 55 // behavior. v8::Object is passed as ArrayBuffer and ArrayBufferView |
| 56 // classes are siblings. | 56 // classes are siblings. |
| 57 virtual bool FromV8ArrayBuffer(v8::Handle<v8::Object> value, | 57 virtual bool FromV8ArrayBuffer(v8::Local<v8::Object> value, |
| 58 base::Value** out, | 58 base::Value** out, |
| 59 v8::Isolate* isolate) const; | 59 v8::Isolate* isolate) const; |
| 60 | 60 |
| 61 // If false is returned, V8ValueConverter proceeds with the default | 61 // If false is returned, V8ValueConverter proceeds with the default |
| 62 // behavior. This allows to intercept "non-finite" values and do something | 62 // behavior. This allows to intercept "non-finite" values and do something |
| 63 // with them. | 63 // with them. |
| 64 virtual bool FromV8Number(v8::Handle<v8::Number> value, | 64 virtual bool FromV8Number(v8::Local<v8::Number> value, |
| 65 base::Value** out) const; | 65 base::Value** out) const; |
| 66 | 66 |
| 67 // If false is returned, V8ValueConverter proceeds with the default | 67 // If false is returned, V8ValueConverter proceeds with the default |
| 68 // behavior. | 68 // behavior. |
| 69 virtual bool FromV8Undefined(base::Value** out) const; | 69 virtual bool FromV8Undefined(base::Value** out) const; |
| 70 }; | 70 }; |
| 71 | 71 |
| 72 static V8ValueConverter* create(); | 72 static V8ValueConverter* create(); |
| 73 | 73 |
| 74 virtual ~V8ValueConverter() {} | 74 virtual ~V8ValueConverter() {} |
| (...skipping 23 matching lines...) Expand all Loading... |
| 98 virtual void SetStripNullFromObjects(bool val) = 0; | 98 virtual void SetStripNullFromObjects(bool val) = 0; |
| 99 | 99 |
| 100 // Extend default behavior of V8ValueConverter. | 100 // Extend default behavior of V8ValueConverter. |
| 101 virtual void SetStrategy(Strategy* strategy) = 0; | 101 virtual void SetStrategy(Strategy* strategy) = 0; |
| 102 | 102 |
| 103 // Converts a base::Value to a v8::Value. | 103 // Converts a base::Value to a v8::Value. |
| 104 // | 104 // |
| 105 // Unsupported types are replaced with null. If an array or object throws | 105 // Unsupported types are replaced with null. If an array or object throws |
| 106 // while setting a value, that property or item is skipped, leaving a hole in | 106 // while setting a value, that property or item is skipped, leaving a hole in |
| 107 // the case of arrays. | 107 // the case of arrays. |
| 108 virtual v8::Handle<v8::Value> ToV8Value( | 108 virtual v8::Local<v8::Value> ToV8Value( |
| 109 const base::Value* value, | 109 const base::Value* value, |
| 110 v8::Handle<v8::Context> context) const = 0; | 110 v8::Local<v8::Context> context) const = 0; |
| 111 | 111 |
| 112 // Converts a v8::Value to base::Value. | 112 // Converts a v8::Value to base::Value. |
| 113 // | 113 // |
| 114 // Unsupported types (unless explicitly configured) are not converted, so | 114 // Unsupported types (unless explicitly configured) are not converted, so |
| 115 // this method may return NULL -- the exception is when converting arrays, | 115 // this method may return NULL -- the exception is when converting arrays, |
| 116 // where unsupported types are converted to Value(TYPE_NULL). | 116 // where unsupported types are converted to Value(TYPE_NULL). |
| 117 // | 117 // |
| 118 // Likewise, if an object throws while converting a property it will not be | 118 // Likewise, if an object throws while converting a property it will not be |
| 119 // converted, whereas if an array throws while converting an item it will be | 119 // converted, whereas if an array throws while converting an item it will be |
| 120 // converted to Value(TYPE_NULL). | 120 // converted to Value(TYPE_NULL). |
| 121 virtual base::Value* FromV8Value(v8::Handle<v8::Value> value, | 121 virtual base::Value* FromV8Value(v8::Local<v8::Value> value, |
| 122 v8::Handle<v8::Context> context) const = 0; | 122 v8::Local<v8::Context> context) const = 0; |
| 123 }; | 123 }; |
| 124 | 124 |
| 125 } // namespace content | 125 } // namespace content |
| 126 | 126 |
| 127 #endif // CONTENT_PUBLIC_CHILD_V8_VALUE_CONVERTER_H_ | 127 #endif // CONTENT_PUBLIC_CHILD_V8_VALUE_CONVERTER_H_ |
| OLD | NEW |