mirror of
https://github.com/msgpack/msgpack-c.git
synced 2025-03-24 01:26:33 +01:00
104 lines
3.6 KiB
Plaintext
104 lines
3.6 KiB
Plaintext
NAME
|
|
Data::MessagePack - MessagePack serialising/deserialising
|
|
|
|
SYNOPSIS
|
|
my $packed = Data::MessagePack->pack($dat);
|
|
my $unpacked = Data::MessagePack->unpack($dat);
|
|
|
|
DESCRIPTION
|
|
This module converts Perl data structures to MessagePack and vice versa.
|
|
|
|
ABOUT MESSAGEPACK FORMAT
|
|
MessagePack is a binary-based efficient object serialization format. It
|
|
enables to exchange structured objects between many languages like JSON.
|
|
But unlike JSON, it is very fast and small.
|
|
|
|
ADVANTAGES
|
|
PORTABILITY
|
|
Messagepack is language independent binary serialize format.
|
|
|
|
SMALL SIZE
|
|
say length(JSON::XS::encode_json({a=>1, b=>2})); # => 13
|
|
say length(Storable::nfreeze({a=>1, b=>2})); # => 21
|
|
say length(Data::MessagePack->pack({a=>1, b=>2})); # => 7
|
|
|
|
The MessagePack format saves memory than JSON and Storable format.
|
|
|
|
STREAMING DESERIALIZER
|
|
MessagePack supports streaming deserializer. It is useful for
|
|
networking such as RPC.
|
|
|
|
If you want to get more information about the MessagePack format, please
|
|
visit to <http://msgpack.org/>.
|
|
|
|
METHODS
|
|
my $packed = Data::MessagePack->pack($data[, $max_depth]);
|
|
Pack the $data to messagepack format string.
|
|
|
|
This method throws an exception when the perl structure is nested
|
|
more than $max_depth levels(default: 512) in order to detect
|
|
circular references.
|
|
|
|
Data::MessagePack->pack() throws an exception when encountering
|
|
blessed object, because MessagePack is language-independent format.
|
|
|
|
my $unpacked = Data::MessagePack->unpack($msgpackstr);
|
|
unpack the $msgpackstr to a MessagePack format string.
|
|
|
|
Configuration Variables
|
|
$Data::MessagePack::PreferInteger
|
|
Pack the string as int when the value looks like int(EXPERIMENTAL).
|
|
|
|
SPEED
|
|
This is the result of benchmark/serialize.pl and
|
|
benchmark/deserialize.pl on my SC440(Linux 2.6.32-23-server #37-Ubuntu
|
|
SMP).
|
|
|
|
-- serialize
|
|
JSON::XS: 2.3
|
|
Data::MessagePack: 0.24
|
|
Storable: 2.21
|
|
Benchmark: running json, mp, storable for at least 1 CPU seconds...
|
|
json: 1 wallclock secs ( 1.00 usr + 0.01 sys = 1.01 CPU) @ 141939.60/s (n=143359)
|
|
mp: 1 wallclock secs ( 1.06 usr + 0.00 sys = 1.06 CPU) @ 355500.94/s (n=376831)
|
|
storable: 1 wallclock secs ( 1.12 usr + 0.00 sys = 1.12 CPU) @ 38399.11/s (n=43007)
|
|
Rate storable json mp
|
|
storable 38399/s -- -73% -89%
|
|
json 141940/s 270% -- -60%
|
|
mp 355501/s 826% 150% --
|
|
|
|
-- deserialize
|
|
JSON::XS: 2.3
|
|
Data::MessagePack: 0.24
|
|
Storable: 2.21
|
|
Benchmark: running json, mp, storable for at least 1 CPU seconds...
|
|
json: 0 wallclock secs ( 1.05 usr + 0.00 sys = 1.05 CPU) @ 179442.86/s (n=188415)
|
|
mp: 0 wallclock secs ( 1.01 usr + 0.00 sys = 1.01 CPU) @ 212909.90/s (n=215039)
|
|
storable: 2 wallclock secs ( 1.14 usr + 0.00 sys = 1.14 CPU) @ 114974.56/s (n=131071)
|
|
Rate storable json mp
|
|
storable 114975/s -- -36% -46%
|
|
json 179443/s 56% -- -16%
|
|
mp 212910/s 85% 19% --
|
|
|
|
AUTHORS
|
|
Tokuhiro Matsuno
|
|
|
|
Makamaka Hannyaharamitu
|
|
|
|
THANKS TO
|
|
Jun Kuriyama
|
|
|
|
Dan Kogai
|
|
|
|
FURUHASHI Sadayuki
|
|
|
|
hanekomu
|
|
|
|
LICENSE
|
|
This library is free software; you can redistribute it and/or modify it
|
|
under the same terms as Perl itself.
|
|
|
|
SEE ALSO
|
|
<http://msgpack.org/> is official web site for MessagePack format.
|
|
|