RocketAMF 0.0.5

data/spec/amf/deserializer_spec.rb

@@ -0,0 +1,311 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+
+describe "when deserializing" do
+  before :each do
+    RocketAMF::ClassMapper.reset
+  end
+
+  describe "AMF0" do
+    it "should deserialize numbers" do
+      input = object_fixture('amf0-number.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == 3.5
+    end
+
+    it "should deserialize booleans" do
+      input = object_fixture('amf0-boolean.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should === true
+    end
+
+    it "should deserialize strings" do
+      input = object_fixture('amf0-string.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == "this is a テスト"
+    end
+
+    it "should deserialize anonymous objects" do
+      input = object_fixture('amf0-object.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == {:foo => 'baz', :bar => 3.14}
+    end
+
+    it "should deserialize nulls" do
+      input = object_fixture('amf0-null.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == nil
+    end
+
+    it "should deserialize undefineds" do
+      input = object_fixture('amf0-undefined.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == nil
+    end
+
+    it "should deserialize references properly" do
+      input = object_fixture('amf0-ref-test.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.length.should == 2
+      output[0].should === output[1]
+    end
+
+    it "should deserialize hashes" do
+      input = object_fixture('amf0-hash.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == {:a => 'b', :c => 'd'}
+    end
+
+    it "should deserialize arrays from flash player" do
+      # Even Array is serialized as a "hash", so check that deserializer converts to array
+      input = object_fixture('amf0-ecma-ordinal-array.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == ['a', 'b', 'c', 'd']
+    end
+
+    it "should serialize strict arrays" do
+      input = object_fixture('amf0-strict-array.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == ['a', 'b', 'c', 'd']
+    end
+
+    it "should deserialize dates" do
+      input = object_fixture('amf0-date.bin')
+      output = RocketAMF.deserialize(input, 0)
+      output.should == Time.utc(2003, 2, 13, 5)
+    end
+
+    it "should deserialize XML"
+
+    it "should deserialize an unmapped object as a dynamic anonymous object" do
+      input = object_fixture("amf0-typed-object.bin")
+      output = RocketAMF.deserialize(input, 0)
+
+      output.type.should == 'org.rocketAMF.ASClass'
+      output.should == {:foo => 'bar', :baz => nil}
+    end
+
+    it "should deserialize a mapped object as a mapped ruby class instance" do
+      class RubyClass
+        attr_accessor :foo, :baz
+      end
+      RocketAMF::ClassMapper.define {|m| m.map :as => 'org.rocketAMF.ASClass', :ruby => 'RubyClass'}
+
+      input = object_fixture("amf0-typed-object.bin")
+      output = RocketAMF.deserialize(input, 0)
+
+      output.should be_a(RubyClass)
+      output.foo.should == 'bar'
+      output.baz.should == nil
+    end
+  end
+
+  describe "AMF3" do
+    describe "simple messages" do
+      it "should deserialize a null" do
+        input = object_fixture("amf3-null.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == nil
+      end
+
+      it "should deserialize a false" do
+        input = object_fixture("amf3-false.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == false
+      end
+
+      it "should deserialize a true" do
+        input = object_fixture("amf3-true.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == true
+      end
+
+      it "should deserialize integers" do
+        input = object_fixture("amf3-max.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == RocketAMF::MAX_INTEGER
+
+        input = object_fixture("amf3-0.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == 0
+
+        input = object_fixture("amf3-min.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == RocketAMF::MIN_INTEGER
+      end
+
+      it "should deserialize large integers" do
+        input = object_fixture("amf3-largeMax.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == RocketAMF::MAX_INTEGER + 1
+
+        input = object_fixture("amf3-largeMin.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == RocketAMF::MIN_INTEGER - 1
+      end
+
+      it "should deserialize BigNums" do
+        input = object_fixture("amf3-bigNum.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == 2**1000
+      end
+
+      it "should deserialize a simple string" do
+        input = object_fixture("amf3-string.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == "String . String"
+      end
+
+      it "should deserialize a symbol as a string" do
+        input = object_fixture("amf3-symbol.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == "foo"
+      end
+
+      it "should deserialize dates" do
+        input = object_fixture("amf3-date.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == Time.at(0)
+      end
+
+      #BAH! Who sends XML over AMF?
+      it "should deserialize a REXML document"
+    end
+
+    describe "objects" do
+      it "should deserialize an unmapped object as a dynamic anonymous object" do
+        input = object_fixture("amf3-dynObject.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        expected = {
+          :property_one => 'foo',
+          :property_two => 1,
+          :nil_property => nil,
+          :another_public_property => 'a_public_value'
+        }
+        output.should == expected
+      end
+
+      it "should deserialize a mapped object as a mapped ruby class instance" do
+        class RubyClass
+          attr_accessor :foo, :baz
+        end
+        RocketAMF::ClassMapper.define {|m| m.map :as => 'org.rocketAMF.ASClass', :ruby => 'RubyClass'}
+
+        input = object_fixture("amf3-typedObject.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        output.should be_a(RubyClass)
+        output.foo.should == 'bar'
+        output.baz.should == nil
+      end
+
+      it "should deserialize a hash as a dynamic anonymous object" do
+        input = object_fixture("amf3-hash.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == {:foo => "bar", :answer => 42}
+      end
+
+      it "should deserialize an empty array" do
+        input = object_fixture("amf3-emptyArray.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == []
+      end
+
+      it "should deserialize an array of primatives" do
+        input = object_fixture("amf3-primArray.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == [1,2,3,4,5]
+      end
+
+      it "should deserialize an array of mixed objects" do
+        input = object_fixture("amf3-mixedArray.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        h1 = {:foo_one => "bar_one"}
+        h2 = {:foo_two => ""}
+        so1 = {:foo_three => 42}
+        output.should == [h1, h2, so1, {:foo_three => nil}, {}, [h1, h2, so1], [], 42, "", [], "", {}, "bar_one", so1]
+      end
+
+      it "should deserialize a byte array"
+    end
+
+    describe "and implementing the AMF Spec" do
+      it "should keep references of duplicate strings" do
+        input = object_fixture("amf3-stringRef.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        class StringCarrier; attr_accessor :str; end
+        foo = "foo"
+        bar = "str"
+        sc = StringCarrier.new
+        sc = {:str => foo}
+        output.should == [foo, bar, foo, bar, foo, sc]
+      end
+
+      it "should not reference the empty string" do
+        input = object_fixture("amf3-emptyStringRef.bin")
+        output = RocketAMF.deserialize(input, 3)
+        output.should == ["",""]
+      end
+
+      it "should keep references of duplicate dates" do
+        input = object_fixture("amf3-datesRef.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        output[0].should equal(output[1])
+        # Expected object:
+        # [DateTime.parse "1/1/1970", DateTime.parse "1/1/1970"]
+      end
+
+      it "should keep reference of duplicate objects" do
+        input = object_fixture("amf3-objRef.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        obj1 = {:foo => "bar"}
+        obj2 = {:foo => obj1[:foo]}
+        output.should == [[obj1, obj2], "bar", [obj1, obj2]]
+      end
+
+      it "should keep references of duplicate arrays" do
+        input = object_fixture("amf3-arrayRef.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        a = [1,2,3]
+        b = %w{ a b c }
+        output.should == [a, b, a, b]
+      end
+
+      it "should not keep references of duplicate empty arrays unless the object_id matches" do
+        input = object_fixture("amf3-emptyArrayRef.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        a = []
+        b = []
+        output.should == [a,b,a,b]
+      end
+
+      it "should keep references of duplicate XML and XMLDocuments"
+      it "should keep references of duplicate byte arrays"
+
+      it "should deserialize a deep object graph with circular references" do
+        input = object_fixture("amf3-graphMember.bin")
+        output = RocketAMF.deserialize(input, 3)
+
+        output[:children][0][:parent].should === output
+        output[:parent].should === nil
+        output[:children].length.should == 2
+        # Expected object:
+        # parent = Hash.new
+        # child1 = Hash.new
+        # child1[:parent] = parent
+        # child1[:children] = []
+        # child2 = Hash.new
+        # child2[:parent] = parent
+        # child2[:children] = []
+        # parent[:parent] = nil
+        # parent[:children] = [child1, child2]
+      end
+    end
+  end
+end

data/spec/amf/request_spec.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+
+describe RocketAMF::Request do
+  it "should handle remoting message from remote object" do
+    req = create_request("remotingMessage.bin")
+
+    req.headers.length.should == 0
+    req.messages.length.should == 1
+    message = req.messages[0].data
+    message.should be_a(RocketAMF::Values::RemotingMessage)
+    message.messageId.should == "FE4AF2BC-DD3C-5470-05D8-9971D51FF89D"
+    message.body.should == [true]
+  end
+
+  it "should handle command message from remote object" do
+    req = create_request("commandMessage.bin")
+
+    req.headers.length.should == 0
+    req.messages.length.should == 1
+    message = req.messages[0].data
+    message.should be_a(RocketAMF::Values::CommandMessage)
+    message.messageId.should == "7B0ACE15-8D57-6AE5-B9D4-99C2D32C8246"
+    message.body.should == {}
+  end
+end

data/spec/amf/response_spec.rb

@@ -0,0 +1,68 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+
+describe RocketAMF::Response do
+  it "should serialize response when converted to string" do
+    res = RocketAMF::Response.new
+    res.should_receive(:serialize).and_return('serialized')
+    res.to_s.should == 'serialized'
+  end
+
+  it "should serialize a simple call" do
+    res = RocketAMF::Response.new
+    res.amf_version = 3
+    res.messages << RocketAMF::Message.new('/1/onResult', '', 'hello')
+
+    expected = request_fixture('simple-response.bin')
+    res.serialize.should == expected
+  end
+
+  it "should serialize a AcknowledgeMessage response" do
+    ak = RocketAMF::Values::AcknowledgeMessage.new
+    ak.clientId = "7B0ACE15-8D57-6AE5-B9D4-99C2D32C8246"
+    ak.messageId = "7B0ACE15-8D57-6AE5-B9D4-99C2D32C8246"
+    ak.timestamp = 0
+    res = RocketAMF::Response.new
+    res.amf_version = 3
+    res.messages << RocketAMF::Message.new('/1/onResult', '', ak)
+
+    expected = request_fixture('acknowledge-response.bin')
+    res.serialize.should == expected
+  end
+
+  it "should respond to ping command" do
+    res = RocketAMF::Response.new
+    req = create_request('commandMessage.bin')
+    res.each_method_call req do |method, args|
+      nil
+    end
+
+    res.messages.length.should == 1
+    res.messages[0].data.should be_a(RocketAMF::Values::AcknowledgeMessage)
+  end
+
+  it "should handle RemotingMessages properly" do
+    res = RocketAMF::Response.new
+    req = create_request('remotingMessage.bin')
+    res.each_method_call req do |method, args|
+      method.should == 'WritesController.save'
+      args.should == [true]
+      true
+    end
+
+    res.messages.length.should == 1
+    res.messages[0].data.should be_a(RocketAMF::Values::AcknowledgeMessage)
+    res.messages[0].data.body.should == true
+  end
+
+  it "should catch exceptions properly" do
+    res = RocketAMF::Response.new
+    req = create_request('remotingMessage.bin')
+    res.each_method_call req do |method, args|
+      raise 'Error in call'
+    end
+
+    res.messages.length.should == 1
+    res.messages[0].data.should be_a(RocketAMF::Values::ErrorMessage)
+    res.messages[0].target_uri.should =~ /onStatus$/
+  end
+end

data/spec/amf/serializer_spec.rb

@@ -0,0 +1,328 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+
+require 'rexml/document'
+
+describe "when serializing" do
+  before :each do
+    RocketAMF::ClassMapper.reset
+  end
+
+  describe "AMF0" do
+    it "should serialize nils" do
+      output = RocketAMF.serialize(nil, 0)
+      output.should == object_fixture('amf0-null.bin')
+    end
+
+    it "should serialize booleans" do
+      output = RocketAMF.serialize(true, 0)
+      output.should === object_fixture('amf0-boolean.bin')
+    end
+
+    it "should serialize numbers" do
+      output = RocketAMF.serialize(3.5, 0)
+      output.should == object_fixture('amf0-number.bin')
+    end
+
+    it "should serialize strings" do
+      output = RocketAMF.serialize("this is a テスト", 0)
+      output.should == object_fixture('amf0-string.bin')
+    end
+
+    it "should serialize arrays" do
+      output = RocketAMF.serialize(['a', 'b', 'c', 'd'], 0)
+      output.should == object_fixture('amf0-strict-array.bin')
+    end
+
+    it "should serialize references" do
+      class OtherClass
+        attr_accessor :foo, :bar
+      end
+      obj = OtherClass.new
+      obj.foo = "baz"
+      obj.bar = 3.14
+
+      output = RocketAMF.serialize({'0' => obj, '1' => obj}, 0)
+      output.should == object_fixture('amf0-ref-test.bin')
+    end
+
+    it "should serialize dates" do
+      output = RocketAMF.serialize(Time.utc(2003, 2, 13, 5), 0)
+      output.should == object_fixture('amf0-date.bin')
+    end
+  
+    it "should serialize hashes" do
+      output = RocketAMF.serialize({:a => 'b', :c => 'd'}, 0)
+      output.should == object_fixture('amf0-hash.bin')
+    end
+
+    it "should serialize unmapped objects" do
+      class RubyClass
+        attr_accessor :foo, :baz
+      end
+      obj = RubyClass.new
+      obj.foo = "bar"
+
+      output = RocketAMF.serialize(obj, 0)
+      output.should == object_fixture('amf0-untyped-object.bin')
+    end
+
+    it "should serialize mapped objects" do
+      class RubyClass
+        attr_accessor :foo, :baz
+      end
+      obj = RubyClass.new
+      obj.foo = "bar"
+      RocketAMF::ClassMapper.define {|m| m.map :as => 'org.rocketAMF.ASClass', :ruby => 'RubyClass'}
+
+      output = RocketAMF.serialize(obj, 0)
+      output.should == object_fixture('amf0-typed-object.bin')
+    end
+  end
+
+  describe "AMF3" do
+    describe "simple messages" do
+      it "should serialize a null" do
+        expected = object_fixture("amf3-null.bin")
+        output = RocketAMF.serialize(nil, 3)
+        output.should == expected
+      end
+
+      it "should serialize a false" do
+        expected = object_fixture("amf3-false.bin")
+        output = RocketAMF.serialize(false, 3)
+        output.should == expected
+      end
+
+      it "should serialize a true" do
+        expected = object_fixture("amf3-true.bin")
+        output = RocketAMF.serialize(true, 3)
+        output.should == expected
+      end
+
+      it "should serialize integers" do
+        expected = object_fixture("amf3-max.bin")
+        input = RocketAMF::MAX_INTEGER
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+
+        expected = object_fixture("amf3-0.bin")
+        output = RocketAMF.serialize(0, 3)
+        output.should == expected
+
+        expected = object_fixture("amf3-min.bin")
+        input = RocketAMF::MIN_INTEGER
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize large integers" do
+        expected = object_fixture("amf3-largeMax.bin")
+        input = RocketAMF::MAX_INTEGER + 1
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+
+        expected = object_fixture("amf3-largeMin.bin")
+        input = RocketAMF::MIN_INTEGER - 1
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize BigNums" do
+        expected = object_fixture("amf3-bigNum.bin")
+        input = 2**1000
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize a simple string" do
+        expected = object_fixture("amf3-string.bin")
+        input = "String . String"
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize a symbol as a string" do
+        expected = object_fixture("amf3-symbol.bin")
+        output = RocketAMF.serialize(:foo, 3)
+        output.should == expected
+      end
+
+      it "should serialize Times" do
+        expected = object_fixture("amf3-date.bin")
+        input = Time.utc 1970, 1, 1, 0
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      #BAH! Who sends XML over AMF?
+      it "should serialize a REXML document"
+    end
+
+    describe "objects" do
+      it "should serialize an unmapped object as a dynamic anonymous object" do
+        class NonMappedObject
+          attr_accessor :property_one
+          attr_accessor :property_two
+          attr_accessor :nil_property
+          attr_writer :read_only_prop
+
+          def another_public_property
+            'a_public_value'
+          end
+
+          def method_with_arg arg='foo'
+            arg
+          end
+        end
+        obj = NonMappedObject.new
+        obj.property_one = 'foo'
+        obj.property_two = 1
+        obj.nil_property = nil
+
+        expected = object_fixture("amf3-dynObject.bin")
+        input = obj
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize a hash as a dynamic anonymous object" do
+        hash = {}
+        hash[:answer] = 42
+        hash[:foo] = "bar"
+
+        expected = object_fixture("amf3-hash.bin")
+        input = hash
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize an empty array" do
+        expected = object_fixture("amf3-emptyArray.bin")
+        input = []
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize an array of primatives" do
+        expected = object_fixture("amf3-primArray.bin")
+        input = [1, 2, 3, 4, 5]
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize an array of mixed objects" do
+        h1 = {:foo_one => "bar_one"}
+        h2 = {:foo_two => ""}
+        class SimpleObj
+          attr_accessor :foo_three
+        end
+        so1 = SimpleObj.new
+        so1.foo_three = 42
+
+        expected = object_fixture("amf3-mixedArray.bin")
+        input = [h1, h2, so1, SimpleObj.new, {}, [h1, h2, so1], [], 42, "", [], "", {}, "bar_one", so1]
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should serialize a byte array"
+    end
+
+    describe "and implementing the AMF Spec" do
+      it "should keep references of duplicate strings" do
+        class StringCarrier
+          attr_accessor :str
+        end
+        foo = "foo"
+        bar = "str"
+        sc = StringCarrier.new
+        sc.str = foo
+
+        expected = object_fixture("amf3-stringRef.bin")
+        input = [foo, bar, foo, bar, foo, sc]
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should not reference the empty string" do
+        expected = object_fixture("amf3-emptyStringRef.bin")
+        input = ""
+        output = RocketAMF.serialize([input,input], 3)
+        output.should == expected
+      end
+
+      it "should keep references of duplicate dates" do
+        expected = object_fixture("amf3-datesRef.bin")
+        input = Time.utc 1970, 1, 1, 0
+        output = RocketAMF.serialize([input,input], 3)
+        output.should == expected
+      end
+
+      it "should keep reference of duplicate objects" do
+        class SimpleReferenceableObj
+          attr_accessor :foo
+        end
+        obj1 = SimpleReferenceableObj.new
+        obj1.foo = :bar
+        obj2 = SimpleReferenceableObj.new
+        obj2.foo = obj1.foo
+
+        expected = object_fixture("amf3-objRef.bin")
+        input = [[obj1, obj2], "bar", [obj1, obj2]]
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should keep references of duplicate arrays" do
+        a = [1,2,3]
+        b = %w{ a b c }
+
+        expected = object_fixture("amf3-arrayRef.bin")
+        input = [a, b, a, b]
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should not keep references of duplicate empty arrays unless the object_id matches" do
+        a = []
+        b = []
+        a.should == b
+        a.object_id.should_not == b.object_id
+
+        expected = object_fixture("amf3-emptyArrayRef.bin")
+        input = [a,b,a,b]
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+
+      it "should keep references of duplicate XML and XMLDocuments"
+      it "should keep references of duplicate byte arrays"
+
+      it "should serialize a deep object graph with circular references" do
+        class GraphMember
+          attr_accessor :parent
+          attr_accessor :children
+
+          def initialize
+            self.children = []
+          end
+
+          def add_child child
+            children << child
+            child.parent = self
+            child
+          end
+        end
+
+        parent = GraphMember.new
+        level_1_child_1 = parent.add_child GraphMember.new
+        level_1_child_2 = parent.add_child GraphMember.new
+
+        expected = object_fixture("amf3-graphMember.bin")
+        input = parent
+        output = RocketAMF.serialize(input, 3)
+        output.should == expected
+      end
+    end
+  end
+end