hessian2
like json, additionally, 麻绳2 parse your object as a struct.
hessian2 implements hessian 2.0 protocol. look web services protocol and serialization protocol.
Sequel::Mysql2::Dataset and ActiveRecord::Relation are also okey.
changelog
2.0.6: support ruby 2.4 Integer
comparing
yajl-ruby: json, fast.
msgpack: binary, faster.
protobuf: encoding your object with schema.
marshal: powerful, fast, but ruby only.
hessian2: powerful as marshal but parse object to struct, clean api, smaller.
install
gem install hessian2
serializing
require 'hessian2'
attributes = { born_at: Time.new(2009, 5, 8), name: '大鸡', price: 99.99 }
monkey = Monkey.new(attributes)
#=> #<Monkey id: nil, born_at: "2009-05-08 00:00:00", name: "\u5927\u9E21", price: #<BigDecimal:2b7c568,'0.9998999999 999999E2',27(45)>>
bin = Hessian2.write(monkey)deserializing
monkey = Hessian2.parse(bin)
#=> #<struct id=nil, born_at=2009-05-08 00:00:00 +0800, name="\u5927\u9E21", price=99.99>struct wrapper
for hash and object, only send values that specified.
MonkeyStruct = Struct.new(:born_at, :name)
wrapped_monkey = Hessian2::StructWrapper.new(MonkeyStruct, monkey)
bin = Hessian2.write(wrapped_monkey)parsing values-binary to a monkey struct
monkey = Hessian2.parse(bin, MonkeyStruct)
#=> #<struct born_at=2009-05-08 00:00:00 +0800, name="\u5927\u9E21">monkeys
wrapped_monkeys = Hessian2::StructWrapper.new([MonkeyStruct], monkeys)
bin = Hessian2.write(wrapped_monkeys)
monkeys = Hessian2.parse(bin, [MonkeyStruct])struct wrapper supports: hash, object, [hash, [object
class wrapper
for statically typed languages.
wrapped_monkey = Hessian2::ClassWrapper.new('com.sun.java.Monkey', monkey)monkeys
wrapped_monkeys = Hessian2::ClassWrapper.new('[com.sun.java.Monkey', monkeys)class wrapper supports: hash, object, [hash, [object
type wrapper
wrap a string to long
str = '-0x8_000_000_000_000_000'
heslong = Hessian2::TypeWrapper.new(:long, str)wrap a file to binary
binstr = IO.binread(File.expand_path("../Lighthouse.jpg", __FILE__))
hesbin = Hessian2::TypeWrapper.new(:bin, binstr)there are types: 'L', 'I', 'B', '[L', '[I', '[B', :long, :int, :bin, [:long], [:int], [:bin]
:symbolize_keys parser option
bin = Hessian2.write(attributes)
hash = Hessian2.parse(bin, nil, symbolize_keys: true)
#=> {:born_at=>2009-05-08 00:00:00 +0800, :name=>"\u5927\u9E21", :price=>99.99}client
url = 'http://127.0.0.1:9292/monkey'
client = Hessian2::Client.new(url)call remote method, send a monkey
client.send_monkey(monkey)service
extend hessian handler
class MonkeyService
extend Hessian2::Handler
def self.send_monkey(monkey)
# ...
endhandle request
post '/monkey' do
MonkeyService.handle(request.body.read)
endfiber_aware
fibered service, fiber aware client. use em-synchrony/em-http post.
client = Hessian2::Client.new(url, fiber_aware: true)
concurrency = 2
EM.synchrony do
EM::Synchrony::FiberIterator.new(0...10, concurrency).each do |i|
puts client.asleep
end
EM.stop
endasync
evented service, asynchronous callbacks. use em-synchrony/em-http apost.
client = Hessian2::Client.new(url, async: true)
EM.run do
http = client.asleep
http.callback do |r|
puts Hessian2.parse_rpc(r.response)
EM.stop
end
http.errback do |r|
puts r.error
EM.stop
end
puts "posted."
endtodo
supports packet and envelope