Commit 2424265e authored by tasak@google.com's avatar tasak@google.com

bindings: preparation for fixing incorrect dependency of SerializedScriptValue.

Split Writer, Reader, Serializer and Deserializer off from SerializedScriptValue.cpp.

The goal is https://codereview.chromium.org/718383003/

BUG=358074

Review URL: https://codereview.chromium.org/721133002

git-svn-id: svn://svn.chromium.org/blink/trunk@185349 bbb929c8-8fbe-4397-9dbb-9b2b20218538
parent 1cf642dc
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef SerializationTag_h
#define SerializationTag_h
namespace blink {
namespace SerializedScriptValueInternal {
// Serialization format is a sequence of tags followed by zero or more data arguments.
// Tags always take exactly one byte. A serialized stream first begins with
// a complete VersionTag. If the stream does not begin with a VersionTag, we assume that
// the stream is in format 0.
// This format is private to the implementation of SerializedScriptValue. Do not rely on it
// externally. It is safe to persist a SerializedScriptValue as a binary blob, but this
// code should always be used to interpret it.
// WebCoreStrings are read as (length:uint32_t, string:UTF8[length]).
// RawStrings are read as (length:uint32_t, string:UTF8[length]).
// RawUCharStrings are read as (length:uint32_t, string:UChar[length/sizeof(UChar)]).
// RawFiles are read as (path:WebCoreString, url:WebCoreStrng, type:WebCoreString).
// There is a reference table that maps object references (uint32_t) to v8::Values.
// Tokens marked with (ref) are inserted into the reference table and given the next object reference ID after decoding.
// All tags except InvalidTag, PaddingTag, ReferenceCountTag, VersionTag, GenerateFreshObjectTag
// and GenerateFreshArrayTag push their results to the deserialization stack.
// There is also an 'open' stack that is used to resolve circular references. Objects or arrays may
// contain self-references. Before we begin to deserialize the contents of these values, they
// are first given object reference IDs (by GenerateFreshObjectTag/GenerateFreshArrayTag);
// these reference IDs are then used with ObjectReferenceTag to tie the recursive knot.
enum SerializationTag {
InvalidTag = '!', // Causes deserialization to fail.
PaddingTag = '\0', // Is ignored (but consumed).
UndefinedTag = '_', // -> <undefined>
NullTag = '0', // -> <null>
TrueTag = 'T', // -> <true>
FalseTag = 'F', // -> <false>
StringTag = 'S', // string:RawString -> string
StringUCharTag = 'c', // string:RawUCharString -> string
Int32Tag = 'I', // value:ZigZag-encoded int32 -> Integer
Uint32Tag = 'U', // value:uint32_t -> Integer
DateTag = 'D', // value:double -> Date (ref)
MessagePortTag = 'M', // index:int -> MessagePort. Fills the result with transferred MessagePort.
NumberTag = 'N', // value:double -> Number
BlobTag = 'b', // uuid:WebCoreString, type:WebCoreString, size:uint64_t -> Blob (ref)
BlobIndexTag = 'i', // index:int32_t -> Blob (ref)
FileTag = 'f', // file:RawFile -> File (ref)
FileIndexTag = 'e', // index:int32_t -> File (ref)
DOMFileSystemTag = 'd', // type:int32_t, name:WebCoreString, uuid:WebCoreString -> FileSystem (ref)
FileListTag = 'l', // length:uint32_t, files:RawFile[length] -> FileList (ref)
FileListIndexTag = 'L', // length:uint32_t, files:int32_t[length] -> FileList (ref)
ImageDataTag = '#', // width:uint32_t, height:uint32_t, pixelDataLength:uint32_t, data:byte[pixelDataLength] -> ImageData (ref)
ObjectTag = '{', // numProperties:uint32_t -> pops the last object from the open stack;
// fills it with the last numProperties name,value pairs pushed onto the deserialization stack
SparseArrayTag = '@', // numProperties:uint32_t, length:uint32_t -> pops the last object from the open stack;
// fills it with the last numProperties name,value pairs pushed onto the deserialization stack
DenseArrayTag = '$', // numProperties:uint32_t, length:uint32_t -> pops the last object from the open stack;
// fills it with the last length elements and numProperties name,value pairs pushed onto deserialization stack
RegExpTag = 'R', // pattern:RawString, flags:uint32_t -> RegExp (ref)
ArrayBufferTag = 'B', // byteLength:uint32_t, data:byte[byteLength] -> ArrayBuffer (ref)
ArrayBufferTransferTag = 't', // index:uint32_t -> ArrayBuffer. For ArrayBuffer transfer
ArrayBufferViewTag = 'V', // subtag:byte, byteOffset:uint32_t, byteLength:uint32_t -> ArrayBufferView (ref). Consumes an ArrayBuffer from the top of the deserialization stack.
CryptoKeyTag = 'K', // subtag:byte, props, usages:uint32_t, keyDataLength:uint32_t, keyData:byte[keyDataLength]
// If subtag=AesKeyTag:
// props = keyLengthBytes:uint32_t, algorithmId:uint32_t
// If subtag=HmacKeyTag:
// props = keyLengthBytes:uint32_t, hashId:uint32_t
// If subtag=RsaHashedKeyTag:
// props = algorithmId:uint32_t, type:uint32_t, modulusLengthBits:uint32_t, publicExponentLength:uint32_t, publicExponent:byte[publicExponentLength], hashId:uint32_t
// If subtag=EcKeyTag:
// props = algorithmId:uint32_t, type:uint32_t, namedCurve:uint32_t
ObjectReferenceTag = '^', // ref:uint32_t -> reference table[ref]
GenerateFreshObjectTag = 'o', // -> empty object allocated an object ID and pushed onto the open stack (ref)
GenerateFreshSparseArrayTag = 'a', // length:uint32_t -> empty array[length] allocated an object ID and pushed onto the open stack (ref)
GenerateFreshDenseArrayTag = 'A', // length:uint32_t -> empty array[length] allocated an object ID and pushed onto the open stack (ref)
ReferenceCountTag = '?', // refTableSize:uint32_t -> If the reference table is not refTableSize big, fails.
StringObjectTag = 's', // string:RawString -> new String(string) (ref)
NumberObjectTag = 'n', // value:double -> new Number(value) (ref)
TrueObjectTag = 'y', // new Boolean(true) (ref)
FalseObjectTag = 'x', // new Boolean(false) (ref)
VersionTag = 0xFF // version:uint32_t -> Uses this as the file version.
};
enum ArrayBufferViewSubTag {
ByteArrayTag = 'b',
UnsignedByteArrayTag = 'B',
UnsignedByteClampedArrayTag = 'C',
ShortArrayTag = 'w',
UnsignedShortArrayTag = 'W',
IntArrayTag = 'd',
UnsignedIntArrayTag = 'D',
FloatArrayTag = 'f',
DoubleArrayTag = 'F',
DataViewTag = '?'
};
enum CryptoKeySubTag {
AesKeyTag = 1,
HmacKeyTag = 2,
// ID 3 was used by RsaKeyTag, while still behind experimental flag.
RsaHashedKeyTag = 4,
EcKeyTag = 5,
// Maximum allowed value is 255
};
enum AssymetricCryptoKeyType {
PublicKeyType = 1,
PrivateKeyType = 2,
// Maximum allowed value is 2^32-1
};
enum CryptoKeyAlgorithmTag {
AesCbcTag = 1,
HmacTag = 2,
RsaSsaPkcs1v1_5Tag = 3,
// ID 4 was used by RsaEs, while still behind experimental flag.
Sha1Tag = 5,
Sha256Tag = 6,
Sha384Tag = 7,
Sha512Tag = 8,
AesGcmTag = 9,
RsaOaepTag = 10,
AesCtrTag = 11,
AesKwTag = 12,
RsaPssTag = 13,
EcdsaTag = 14,
// Maximum allowed value is 2^32-1
};
enum NamedCurveTag {
P256Tag = 1,
P384Tag = 2,
P521Tag = 3,
};
enum CryptoKeyUsage {
// Extractability is not a "usage" in the WebCryptoKeyUsages sense, however
// it fits conveniently into this bitfield.
ExtractableUsage = 1 << 0,
EncryptUsage = 1 << 1,
DecryptUsage = 1 << 2,
SignUsage = 1 << 3,
VerifyUsage = 1 << 4,
DeriveKeyUsage = 1 << 5,
WrapKeyUsage = 1 << 6,
UnwrapKeyUsage = 1 << 7,
DeriveBitsUsage = 1 << 8,
// Maximum allowed value is 1 << 31
};
} // namespace SerializedScriptValueInternal
} // namespace blink
#endif
......@@ -69,6 +69,10 @@ public:
~SerializedScriptValue();
// VarInt encoding constants.
static const int varIntShift = 7;
static const int varIntMask = (1 << varIntShift) - 1;
// If a serialization error occurs (e.g., cyclic input value) this
// function returns an empty representation, schedules a V8 exception to
// be thrown using v8::ThrowException(), and sets |didThrow|. In this case
......
......@@ -94,8 +94,11 @@
'ScriptString.h',
'ScriptValue.cpp',
'ScriptValue.h',
'ScriptValueSerializer.cpp',
'ScriptValueSerializer.h',
'ScriptWrappable.cpp',
'ScriptWrappable.h',
'SerializationTag.h',
'SerializedScriptValue.cpp',
'SerializedScriptValue.h',
'SharedPersistent.h',
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment