stomper 1.0.0 → 2.0.0

data/spec/receiptor_spec.rb

@@ -1,35 +0,0 @@
-require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
-
-module Stomper
-  describe Receiptor do
-    class MockConcreteReceipter
-      include Stomper::Receiptor
-    end
-
-    before(:each) do
-      @client = MockConcreteReceipter.new
-    end
-    
-    describe "expected interface" do
-    end
-
-    describe "receipt handling" do
-      before(:each) do
-        @client.should_receive(:connected?).any_number_of_times.and_return(true)
-        @client.should_receive(:send_without_receipt_handler).with('/queue/to','message body',a_kind_of(Hash)).at_least(:once).and_return(nil)
-      end
-
-      it "should dispatch a receipt when sent with a block" do
-        @client.should_receive(:receive_without_receipt_dispatch).once.and_return(Stomper::Frames::Receipt.new({ :'receipt-id' => 'msg-0001' }, ''))
-        receipt_processed = false
-        @client.send('/queue/to', 'message body', :receipt => 'msg-0001') do |r|
-          receipt_processed = true
-        end
-        @client.receipt_handlers.size.should == 1
-        @client.receive_with_receipt_dispatch
-        receipt_processed.should be_true
-        @client.receipt_handlers.size.should == 0
-      end
-    end
-  end
-end

data/spec/shared_connection_examples.rb

@@ -1,79 +0,0 @@
-shared_examples_for "All Client Connections" do
-  describe "connection initializers" do
-    describe "from uri" do
-      it "should accept the stomp:/// uri (no host specified)" do
-        lambda { @connection.class.new("stomp:///") }.should_not raise_error
-      end
-
-      it "should accept a uri specifying just the host" do
-        lambda { @connection.class.new("stomp://localhost/") }.should_not raise_error
-      end
-
-      it "should accept a uri specifying host and port" do
-        lambda { @connection.class.new("stomp://localhost:61613/") }.should_not raise_error
-      end
-
-      it "should accept a uri specifying host, port and credentials" do
-        lambda { @connection.class.new("stomp://test_user:s3cr3tz@localhost:61613/") }.should_not raise_error
-      end
-
-      it "should accept a uri specifying a secure connection" do
-        lambda { @connection.class.new("stomp+ssl://localhost") }.should_not raise_error
-      end
-
-      it "should not accept a bogus URI" do
-        lambda { @connection.class.new("stomp://localhost:garbage") }.should raise_error
-      end
-
-    end
-  end
-
-  describe "connection control" do
-    it "should provide the appropriate all connection control and status methods" do
-      @connection.should respond_to(:connect)
-      @connection.should respond_to(:disconnect)
-      @connection.should respond_to(:close)
-      @connection.should respond_to(:connected?)
-    end
-
-    it "should not report it is connected after close is called" do
-      @connection.connect
-      @connection.connected?.should be_true
-      @connection.close
-      @connection.connected?.should be_false
-    end
-    
-    it "should not report it is connected after disconnect is called" do
-      @connection.connect
-      @connection.connected?.should be_true
-      @connection.disconnect
-      @connection.connected?.should be_false
-    end
-  end
-
-  describe "connection IO" do
-    it "should provide methods for receiving frames and writing frames" do
-      @connection.should respond_to(:transmit)
-      @connection.should respond_to(:receive)
-    end
-    it "should transmit frames" do
-      @connection.connect
-      @frame = nil
-      @connection.transmit(Stomper::Frames::Subscribe.new("/topic/test_topic"))
-      @connection.transmit(Stomper::Frames::Send.new("/topic/test_topic", "hello"))
-      @frame = @connection.receive while @frame.nil?
-      @frame.should be_an_instance_of(Stomper::Frames::Message)
-      @frame.body.should == "hello"
-    end
-  end
-
-  describe "exception handling" do
-    it "should close and propagate when an exception is raised on transmit" do
-      pending
-    end
-
-    it "should close and propagate when an exception is raised on receive" do
-      pending
-    end
-  end
-end

data/spec/subscriber_spec.rb

@@ -1,77 +0,0 @@
-require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
-
-module Stomper
-  describe Subscriber do
-    class MockConcreteSubscriber
-      include Stomper::Subscriber
-    end
-
-    before(:each) do
-      @client = MockConcreteSubscriber.new
-    end
-    
-    describe "expected interface" do
-      it "should provide a subscribe method" do
-        @client.should respond_to(:subscribe)
-        @client.should_receive(:transmit).with(an_instance_of(Stomper::Frames::Subscribe)).twice.and_return(nil)
-        @client.subscribe("/queue/to", {:additional => 'header'})
-        @client.subscribe("/queue/to")
-      end
-      it "should provide an unsubscribe method" do
-        @client.should respond_to(:unsubscribe)
-        @client.should_receive(:transmit).with(an_instance_of(Stomper::Frames::Subscribe)).twice.and_return(nil)
-        @client.subscribe("/queue/to", {:id => 'subscription-id'})
-        @client.subscribe("/queue/to")
-        @client.should_receive(:transmit).with(an_instance_of(Stomper::Frames::Unsubscribe)).twice.and_return(nil)
-        @client.unsubscribe("/queue/to", 'subscription-id')
-        @client.unsubscribe("/queue/to")
-      end
-    end
-
-    describe "subscribing to queue" do
-      before(:each) do
-        @message_sent = Stomper::Frames::Message.new({:destination => "/queue/test"}, "test message")
-        @client.should_receive(:connected?).any_number_of_times.and_return(true)
-        @client.should_receive(:transmit).with(a_kind_of(Stomper::Frames::ClientFrame)).at_least(:once).and_return(nil)
-      end
-
-      it "should subscribe to a destination with a block" do
-        @client.should_receive(:receive_without_message_dispatch).once.and_return(@message_sent)
-        @message_received = nil
-        @client.subscribe("/queue/test") do |msg|
-          @message_received = msg
-        end
-        @client.receive_with_message_dispatch
-        @message_received.should == @message_sent
-      end
-
-      it "should not unsubscribe from all destinations when a subscription id is provided" do
-        @client.subscribe("/queue/test", { :id => 'subscription-1' }) do |msg|
-          @message_received = msg
-        end
-        @client.subscribe("/queue/test") do |msg|
-          @message_received = msg
-        end
-        @client.subscribe("/queue/test", :id => 'subscription-2') do |msg|
-          @message_received = msg
-        end
-        @client.unsubscribe("/queue/test", 'subscription-1')
-        @client.subscriptions.size.should == 2
-      end
-
-      it "should not unsubscribe from non-naive subscriptions when only a destination is supplied" do
-        @client.subscribe("/queue/test", { :id => 'subscription-1' }) do |msg|
-          @message_received = msg
-        end
-        @client.subscribe("/queue/test") do |msg|
-          @message_received = msg
-        end
-        @client.subscribe("/queue/test") do |msg|
-          @message_received = msg
-        end
-        @client.unsubscribe("/queue/test")
-        @client.subscriptions.size.should == 1
-      end
-    end
-  end
-end

data/spec/subscription_spec.rb

@@ -1,157 +0,0 @@
-require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
-
-module Stomper
-  describe Subscription do
-    before(:each) do
-      @subscription = Subscription.new("/queue/test/1", 'subscription-1')
-    end
-
-    describe "basic expectations" do
-      it "should be constructable from a parameter list, providing sensible defaults for omitted arguments" do
-        @subscription.destination.should == "/queue/test/1"
-        @subscription.ack.should == :auto
-        @subscription.selector.should be_nil
-
-        @subscription = Subscription.new("/queue/test/2", 'subscription-1', 'client', 'a > 3')
-        @subscription.destination.should == "/queue/test/2"
-        @subscription.ack.should == :client
-        @subscription.selector.should == 'a > 3'
-      end
-
-      it "should be constructable from a hash, providing sensible defaults for omitted arguments" do
-        @subscription = Subscription.new({ :destination => '/queue/test/2' })
-        @subscription.destination.should == "/queue/test/2"
-        @subscription.ack.should == :auto
-
-        @subscription = Subscription.new({:destination => "/queue/test/3", :ack => :client, :id => 'subscription-3', :selector => 'b < 10' })
-        @subscription.destination.should == "/queue/test/3"
-        @subscription.ack.should == :client
-        @subscription.id.should_not be_nil
-        @subscription.selector.should == "b < 10"
-      end
-
-      it "should use the specified ID for subscribing and unsubscribing" do
-        @subscription.id.should_not be_nil
-        @subscription.id.should_not be_empty
-        @subscription.id.should == @subscription.to_subscribe.id
-        @subscription.id.should == @subscription.to_unsubscribe.id
-      end
-
-      it "should provide a meaningful ID when the ack mode is not auto" do
-        @client_ack_subscription = Subscription.new("/queue/test/1",nil,'client')
-        @client_ack_subscription.id.should_not be_nil
-      end
-
-      it "should provide a meaningful ID when the selector is specified" do
-        @selector_subscription = Subscription.new("/queue/test/1",nil,'auto',"a > 3.5")
-        @selector_subscription.id.should_not be_nil
-      end
-
-      it "should provide a SUBSCRIBE frame" do
-        @subscription.should respond_to(:to_subscribe)
-        @frame = @subscription.to_subscribe
-        @frame.destination.should == "/queue/test/1"
-        @frame.id.should_not be_nil
-        @frame.ack.should == "auto"
-      end
-    end
-
-    describe "message acceptance" do
-      it "should accept a message without a subscription header only when the subscription is 'naive'" do
-        @matching_subscription_1 = Subscription.new("/queue/test/1")
-        @matching_subscription_2 = Subscription.new("/queue/test/1", nil, :auto)
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1'},"test message")
-        @subscription.accepts?(@message).should be_false
-        @matching_subscription_1.accepts?(@message).should be_true
-        @matching_subscription_2.accepts?(@message).should be_true
-      end
-
-      it "should be able to accept messages by destination" do
-        @non_matching_subscription = Subscription.new("/queue/test/another")
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1', :subscription => @subscription.id},"test message")
-        @subscription.accepts?(@message).should be_true
-        @non_matching_subscription.accepts?(@message).should be_false
-      end
-
-      it "should accept messages only if the same destination and subscription" do
-        @alternate_subscription = Subscription.new("/queue/test/1", 'subscription-2')
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1', :subscription => @subscription.id},"test message")
-        @subscription.accepts?(@message).should be_true
-        @alternate_subscription.accepts?(@message).should be_false
-      end
-
-      it "should accept messages by the subscription id if the message has a subscription" do
-        @non_matching_subscription = Subscription.new("/queue/test/1")
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1', :subscription => @subscription.id},"test message")
-        @subscription.accepts?(@message).should be_true
-        @non_matching_subscription.accepts?(@message).should be_false
-      end
-
-      it "should not accept messages with the same destination when its ack mode is not 'auto' and no subscription header was specified" do
-        @non_matching_subscription = Subscription.new("/queue/test/1", nil, 'client')
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1'},"test message")
-        @non_matching_subscription.accepts?(@message).should be_false
-      end
-
-      it "should not accept messages with the same destination when it has a selector and no subscription header was specified" do
-        @non_matching_subscription = Subscription.new("/queue/test/1", nil, 'auto', 'rating > 3.0')
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1'},"test message")
-        @non_matching_subscription.accepts?(@message).should be_false
-      end
-
-      # Either insist that the #id method return something meaningful in non-trivial situations
-      # as part of the expected behavior of the interface, or change this test!
-      # We now insist on it, so this test is valid.
-      it "should accept messages when it has a selector and the subscription header was specified" do
-        @non_matching_subscription = Subscription.new("/queue/test/1", nil, 'auto', 'rating > 3.0')
-        # To test this without insisting that the #id field be equivalent to the subscribe frame's header
-        # go this way:
-
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1', :subscription => @non_matching_subscription.id},"test message")
-        @non_matching_subscription.accepts?(@message).should be_true
-      end
-    end
-
-    describe "message delivery" do
-      it "should call its callback when an applicable message arrives for its destination" do
-        called_back = false
-        @subscription_with_block = Subscription.new("/queue/test/1", 'subscription-test') do |msg|
-          called_back = (msg == @message)
-        end
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1', :subscription => @subscription_with_block.id},"test message")
-        @subscription_with_block.perform(@message)
-        called_back.should be_true
-      end
-
-      it "should not call its callback when given a message for a different destination" do
-        called_back = false
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1'},"test message")
-        @subscription_with_block = Subscription.new("/queue/test/another", 'subscription-test') do |msg|
-          called_back = (msg == @message)
-        end
-        @subscription_with_block.perform(@message)
-        called_back.should be_false
-      end
-
-      it "should call its callback when a message arrives for its subscription id" do
-        called_back = false
-        @subscription_with_block = Subscription.new("/queue/test/another", 'subscription-test') do |msg|
-          called_back = (msg == @message)
-        end
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1', :subscription => @subscription_with_block.id},"test message")
-        @subscription_with_block.perform(@message)
-        called_back.should be_true
-      end
-
-      it "should not call its callback when a message arrives for its subscription id, even on the same " do
-        called_back = false
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1', :subscription => 'subscription-not-test'},"test message")
-        @subscription_with_block = Subscription.new("/queue/test/another", 'subscription-test') do |msg|
-          called_back = (msg == @message)
-        end
-        @subscription_with_block.perform(@message)
-        called_back.should be_false
-      end
-    end
-  end
-end

data/spec/subscriptions_spec.rb

@@ -1,145 +0,0 @@
-require File.expand_path(File.join(File.dirname(__FILE__), 'spec_helper'))
-
-module Stomper
-  describe Subscriptions do
-    before(:each) do
-      @subscriptions = Subscriptions.new
-    end
-
-    describe "adding subscriptions" do
-      it "should add a subscription given a subscription object" do
-        @subscriptions << Subscription.new('/queue/test/3', 'subscription-3', nil, 'b < 10')
-        @subscriptions.size.should == 1
-        @subscriptions.first.destination.should == "/queue/test/3"
-        @subscriptions.first.ack.should == :auto
-        @subscriptions.first.selector.should == 'b < 10'
-        @subscriptions.first.id.should_not be_nil
-      end
-    end
-
-    describe "enumerable" do
-      it "should provide an each method" do
-        @subscriptions.should respond_to(:each)
-      end
-      it "should be enumerable" do
-        @subscriptions.is_a?(Enumerable).should be_true
-      end
-    end
-
-    describe "thread safe" do
-      # How do you test this?
-      it "should synchronize adding subscriptions" do
-        @subscriptions << Subscription.new("/queue/test/1")
-        @subscriptions << Subscription.new("/queue/test/2")
-        @subscriptions << Subscription.new("/queue/test/3")
-        Thread.new { sleep(0.1); @subscriptions << Subscription.new("/queue/test/4") }
-        # In general, this next step should execute before the thread has a chance to
-        # but the sleep in the map should mean that our thread gets woken up before
-        # map finishes.  However, destinations should NEVER contain "/queue/test/4"
-        # because map should be synchronized.
-        destinations = @subscriptions.map { |sub| sleep(0.1); sub.destination }
-        destinations.size.should == 3
-        destinations.should == ['/queue/test/1', '/queue/test/2', '/queue/test/3']
-        @subscriptions.size.should == 4
-        @subscriptions.last.destination.should == "/queue/test/4"
-      end
-
-      it "should synchronize removing subscriptions" do
-        @subscriptions << Subscription.new("/queue/test/1")
-        @subscriptions << Subscription.new("/queue/test/2")
-        @subscriptions << Subscription.new("/queue/test/3")
-        sync_thread = Thread.new { sleep(0.1); @subscriptions.remove("/queue/test/1") }
-        destinations = @subscriptions.map { |sub| sleep(0.1); sub.destination }
-        destinations.size.should == 3
-        destinations.should == ['/queue/test/1', '/queue/test/2', '/queue/test/3']
-        sync_thread.join
-        @subscriptions.size.should == 2
-        @subscriptions.first.destination.should == "/queue/test/2"
-      end
-
-    end
-
-    describe "message delivery" do
-      it "should deliver messages to matching subscriptions" do
-        received_1 = false
-        received_2 = false
-        received_3 = false
-        @subscriptions << Subscription.new("/queue/test/1") { |msg| received_1 = true }
-        @subscriptions << Subscription.new("/queue/test/1", 'subscription-2') { |msg| received_2 = true }
-        @subscriptions << Subscription.new("/queue/test/2") { |msg| received_3 = true }
-        @message = Stomper::Frames::Message.new({:destination => '/queue/test/1'},"test message")
-        @subscriptions.perform(@message)
-        received_1.should be_true
-        received_2.should be_false
-        received_3.should be_false
-      end
-    end
-
-    describe "unsubscribing" do
-      it "should remove all naive subscriptions when unsubscribing with a string destination" do
-        @removed_subscriptions = [Subscription.new("/queue/test/1"), Subscription.new("/queue/test/1")]
-        @removed_subscriptions.each { |sub| @subscriptions << sub }
-        @subscriptions << Subscription.new("/queue/test/2")
-        @subscriptions << Subscription.new("/queue/test/1", 'subscription-4')
-        @to_remove = @subscriptions.remove("/queue/test/1")
-        @subscriptions.size.should == 2
-        @subscriptions.should_not include(@removed_subscriptions.first)
-        @subscriptions.should_not include(@removed_subscriptions.last)
-        @to_remove.size.should == 2
-        @to_remove.should include(@removed_subscriptions.first)
-        @to_remove.should include(@removed_subscriptions.last)
-      end
-      it "should remove all subscriptions that accept messages for a supplied subscription ID" do
-        @removed_subscription = Subscription.new("/queue/test/1", 'subscription-4')
-        @subscriptions << Subscription.new("/queue/test/1")
-        @subscriptions << Subscription.new("/queue/test/1")
-        @subscriptions << Subscription.new("/queue/test/2")
-        @subscriptions << @removed_subscription
-        @to_remove = @subscriptions.remove(nil, @removed_subscription.id)
-        @subscriptions.size.should == 3
-        @subscriptions.should_not include(@removed_subscription)
-        @to_remove.size.should == 1
-        @to_remove.should include(@removed_subscription)
-      end
-      it "should remove subscriptions as expected when parameter is a hash specifying the ID" do
-        @removed_subscription = Subscription.new("/queue/test/1", 'subscription-4')
-        @subscriptions << Subscription.new("/queue/test/1")
-        @subscriptions << Subscription.new("/queue/test/1")
-        @subscriptions << Subscription.new("/queue/test/2")
-        @subscriptions << @removed_subscription
-        @to_remove = @subscriptions.remove({ :id => @removed_subscription.id })
-        @subscriptions.size.should == 3
-        @subscriptions.should_not include(@removed_subscription)
-        @to_remove.size.should == 1
-        @to_remove.should include(@removed_subscription)
-      end
-      it "should remove subscriptions as expected when parameter is a hash specifying the destination" do
-        @removed_subscriptions = [Subscription.new("/queue/test/1"), Subscription.new("/queue/test/1")]
-        @removed_subscriptions.each { |sub| @subscriptions << sub }
-        @subscriptions << Subscription.new("/queue/test/2")
-        @subscriptions << Subscription.new("/queue/test/1", 'subscription-4')
-        @to_remove = @subscriptions.remove( { :destination => "/queue/test/1" })
-        @subscriptions.size.should == 2
-        @subscriptions.should_not include(@removed_subscriptions.first)
-        @subscriptions.should_not include(@removed_subscriptions.last)
-        @to_remove.size.should == 2
-        @to_remove.should include(@removed_subscriptions.first)
-        @to_remove.should include(@removed_subscriptions.last)
-      end
-      it "should remove subscriptions as expected when parameter is a Subscription" do
-        @removed_subscription = Subscription.new("/queue/test/1", 'subscription-4')
-        @subscriptions << Subscription.new("/queue/test/1")
-        @subscriptions << Subscription.new("/queue/test/1")
-        @subscriptions << Subscription.new("/queue/test/2")
-        @subscriptions << @removed_subscription
-        @to_remove = @subscriptions.remove(@removed_subscription)
-        @to_remove.size.should == 1
-        @to_remove.should include(@removed_subscription)
-        @to_remove = @subscriptions.remove(Subscription.new("/queue/test/1", nil, :client))
-        @to_remove.should be_empty
-        @subscriptions.size.should == 3
-        @subscriptions.should_not include(@removed_subscription)
-      end
-    end
-  end
-end