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)
  # ...
end

handle request

post '/monkey' do
  MonkeyService.handle(request.body.read)
end

fiber_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
end

async

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."
end

todo

supports packet and envelope

authors

takafan