qpid_messaging 0.16.0

data/spec/qpid/receiver_spec.rb

@@ -0,0 +1,170 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+require 'spec_helper'
+
+module Qpid
+
+  module Messaging
+
+    describe Receiver do
+
+      before(:each) do
+        @message_impl  = double("Cqpid::Message")
+        @session       = double("Qpid::Messaging::Session")
+        @receiver_impl = double("Cqpid::Receiver")
+
+        @receiver = Qpid::Messaging::Receiver.new @session, @receiver_impl
+      end
+
+      it "returns the underlying implementation" do
+        impl = @receiver.receiver_impl
+
+        impl.should == @receiver_impl
+      end
+
+      it "gets a message with the default duration" do
+        @receiver_impl.should_receive(:get).
+          with(Qpid::Messaging::Duration::FOREVER.duration_impl).
+          and_return(@message_impl)
+
+        message = @receiver.get
+
+        message.message_impl.should == @message_impl
+      end
+
+      it "gets a message with a specified duration" do
+        @receiver_impl.should_receive(:get).
+          with(Qpid::Messaging::Duration::SECOND.duration_impl).
+          and_return(@message_impl)
+
+        message = @receiver.get Qpid::Messaging::Duration::SECOND
+
+        message.message_impl.should == @message_impl
+      end
+
+      it "returns nil when get receives no message" do
+        @receiver_impl.should_receive(:get).
+          with(Qpid::Messaging::Duration::MINUTE.duration_impl).
+          and_return(nil)
+
+        message = @receiver.get Qpid::Messaging::Duration::MINUTE
+
+        message.should be_nil
+      end
+
+      it "fetches a message with the default duration" do
+        @receiver_impl.should_receive(:fetch).
+          with(Qpid::Messaging::Duration::FOREVER.duration_impl).
+          and_return(@message_impl)
+
+        message = @receiver.fetch
+
+        message.message_impl.should == @message_impl
+      end
+
+      it "fetches a message with a specified duration" do
+        @receiver_impl.should_receive(:fetch).
+          with(Qpid::Messaging::Duration::SECOND.duration_impl).
+          and_return(@message_impl)
+
+        message = @receiver.fetch Qpid::Messaging::Duration::SECOND
+
+        message.message_impl.should == @message_impl
+      end
+
+      it "returns nil when fetch recieves no message" do
+        @receiver_impl.should_receive(:fetch).
+          with(Qpid::Messaging::Duration::MINUTE.duration_impl).
+          and_return(nil)
+
+        message = @receiver.fetch Qpid::Messaging::Duration::MINUTE
+
+        message.should be_nil
+      end
+
+      it "assigns capacity" do
+        @receiver_impl.should_receive(:setCapacity).
+          with(10)
+
+        @receiver.capacity = 10
+      end
+
+      it "returns the capacity" do
+        @receiver_impl.should_receive(:getCapacity).
+          and_return(10)
+
+        capacity = @receiver.capacity
+
+        capacity.should == 10
+      end
+
+      it "reports the number of available messages" do
+        @receiver_impl.should_receive(:getAvailable).
+          and_return(20)
+
+        available = @receiver.available
+
+        available.should == 20
+      end
+
+      it "reports the number of unsettled messages" do
+        @receiver_impl.should_receive(:getUnsettled).
+          and_return(25)
+
+        unsettled = @receiver.unsettled
+
+        unsettled.should == 25
+      end
+
+      it "closes" do
+        @receiver_impl.should_receive(:close)
+
+        @receiver.close
+      end
+
+      it "reports its closed status" do
+        @receiver_impl.should_receive(:isClosed).
+          and_return(true)
+
+        closed = @receiver.closed?
+
+        closed.should == true
+      end
+
+      it "returns its name" do
+        @receiver_impl.should_receive(:getName).
+          and_return("farkle")
+
+        name = @receiver.name
+
+        name.should == "farkle"
+      end
+
+      it "returns its related session" do
+        session = @receiver.session
+
+        session.should == @session
+      end
+
+    end
+
+  end
+
+end

data/spec/qpid/sender_spec.rb

@@ -0,0 +1,135 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+require 'spec_helper'
+
+module Qpid
+
+  module Messaging
+
+    describe Sender do
+
+      before(:each) do
+        @message      = double("Qpid::Messaging::Message")
+        @message_impl = double("Cqpid::Message")
+        @sender_impl  = double("Cqpid::Sender")
+        @session      = double("Qpid::Messaging::Session")
+
+        @sender = Qpid::Messaging::Sender.new @session, @sender_impl
+      end
+
+      it "returns its implementation" do
+        impl = @sender.sender_impl
+
+        impl.should == @sender_impl
+      end
+
+      it "sends a message" do
+        @message.should_receive(:message_impl).
+          and_return(@message_impl)
+        @sender_impl.should_receive(:send).
+          with(@message_impl, false)
+
+        @sender.send @message
+      end
+
+      it "sends a message with optional synch" do
+        @message.should_receive(:message_impl).
+          and_return(@message_impl)
+        @sender_impl.should_receive(:send).
+          with(@message_impl, true)
+
+        @sender.send @message, :sync => true
+      end
+
+      it "sends a message with an optional block" do
+        block_called = false
+
+        @message.should_receive(:message_impl).
+          and_return(@message_impl)
+        @sender_impl.should_receive(:send).
+          with(@message_impl, false)
+
+        @sender.send @message do |message|
+          block_called = true if message == @message
+        end
+
+        block_called.should be_true
+      end
+
+      it "closes" do
+        @sender_impl.should_receive(:close)
+
+        @sender.close
+      end
+
+      it "returns its name" do
+        @sender_impl.should_receive(:getName).
+          and_return("farkle")
+
+        name = @sender.name
+
+        name.should == "farkle"
+      end
+
+      it "sets its capacity" do
+        @sender_impl.should_receive(:setCapacity).
+          with(100)
+
+        @sender.capacity = 100
+      end
+
+      it "returns its capacity" do
+        @sender_impl.should_receive(:getCapacity).
+          and_return(25)
+
+        capacity = @sender.capacity
+
+        capacity.should == 25
+      end
+
+      it "returns the number of unsettled messages" do
+        @sender_impl.should_receive(:getUnsettled).
+          and_return(15)
+
+        unsettled = @sender.unsettled
+
+        unsettled.should == 15
+      end
+
+      it "returns the number of available message slots" do
+        @sender_impl.should_receive(:getAvailable).
+          and_return(50)
+
+        available = @sender.available
+
+        available.should == 50
+      end
+
+      it "returns a reference to its session" do
+        session = @sender.session
+
+        session.should == @session
+      end
+
+    end
+
+  end
+
+end

data/spec/qpid/session_spec.rb

@@ -0,0 +1,353 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+require 'spec_helper'
+
+module Qpid
+
+  module Messaging
+
+    describe Session do
+
+      before(:each) do
+        @connection    = double("Qpid::Messaging::Connection")
+        @session_impl  = double("Cqpid::Session")
+        @session       = Qpid::Messaging::Session.new @connection, @session_impl
+        @sender_impl   = double("Cqpid::Sender")
+        @receiver_impl = double("Cqpid::Receiver")
+      end
+
+      it "returns its implementation" do
+        impl = @session.session_impl
+
+        impl.should == @session_impl
+      end
+
+      it "returns its connection" do
+        connection = @session.connection
+
+        connection.should == @connection
+      end
+
+      it "creates a Sender from an Address" do
+        address = Qpid::Messaging::Address.new "my-queu", "", :create => :always
+
+        @session_impl.should_receive(:createSender).
+          with(address.address_impl).
+          and_return(@sender_impl)
+        @sender_impl.should_receive(:getName).
+          and_return("my-queue")
+
+        sender = @session.create_sender address
+
+        sender.sender_impl.should == @sender_impl
+      end
+
+      it "creates a Sender from an address string" do
+        address = "my-queue;{create:true}"
+
+        @session_impl.should_receive(:createSender).
+          with(address).
+          and_return(@sender_impl)
+        @sender_impl.should_receive(:getName).
+          and_return("my-queue")
+
+        sender = @session.create_sender address
+
+        sender.sender_impl.should == @sender_impl
+      end
+
+      #######################################
+      # scenarios involing an existing Sender
+      #######################################
+      describe "when retrieving a Sender by name" do
+
+        before(:each) do
+          address = "my-queue;{create:always}"
+          @name   = "my-queue"
+
+          @session_impl.should_receive(:createSender).
+            with(address).
+            and_return(@sender_impl)
+          @sender_impl.should_receive(:getName).
+            and_return(@name)
+
+          @sender = @session.create_sender address
+        end
+
+        it "works when the name is valid" do
+          sender = @session.sender @name
+
+          sender.should == @sender
+        end
+
+        it "raises an error when the name is invalid" do
+          expect {
+            @session.sender @name.reverse
+          }.to raise_error(Qpid::Messaging::KeyError)
+        end
+
+     end
+
+      it "creates a Receiver from an Address" do
+        address = Qpid::Messaging::Address.new "my-queue", ""
+
+        @session_impl.should_receive(:createReceiver).
+          with(address.address_impl).
+          and_return(@receiver_impl)
+        @receiver_impl.should_receive(:getName).
+          and_return("my-queue")
+
+        receiver = @session.create_receiver address
+
+        receiver.receiver_impl.should == @receiver_impl
+      end
+
+      it "creates a Receiver from an address string" do
+        address = "my-queue"
+
+        @session_impl.should_receive(:createReceiver).
+          with(address).
+          and_return(@receiver_impl)
+        @receiver_impl.should_receive(:getName).
+          and_return("my-queue")
+
+        receiver = @session.create_receiver address
+
+        receiver.receiver_impl.should == @receiver_impl
+      end
+
+      #########################################
+      # scenarios involving an existing Receiver
+      ##########################################
+      describe "when retrieving a Receiver by name" do
+
+        before(:each) do
+          address = "my-queue"
+          @name   = "my-queue"
+
+          @session_impl.should_receive(:createReceiver).
+            with(address).
+            and_return(@receiver_impl)
+          @receiver_impl.should_receive(:getName).
+            and_return(@name)
+
+          @receiver = @session.create_receiver address
+        end
+
+        it "works with a valid name" do
+          receiver = @session.receiver @name
+
+          receiver.should == @receiver
+        end
+
+        it "raises an error when the name is invalid" do
+          expect {
+            @session.receiver @name.reverse
+          }.to raise_error(Qpid::Messaging::KeyError)
+        end
+
+      end
+
+      it "closes the session" do
+        @session_impl.should_receive(:close)
+
+        @session.close
+      end
+
+      it "commits a pending transaction" do
+        @session_impl.should_receive(:commit)
+
+        @session.commit
+      end
+
+      it "rolls back an uncommitted transaction" do
+        @session_impl.should_receive(:rollback)
+
+        @session.rollback
+      end
+
+      it "acknowledges all received messages" do
+        @session_impl.should_receive(:acknowledge).
+          with(false)
+
+        @session.acknowledge
+      end
+
+      it "acknowledges all messages synchronously" do
+        @session_impl.should_receive(:acknowledge).
+          with(true)
+
+        @session.acknowledge :sync => true
+      end
+
+      it "acknowledges all messages asynchronously" do
+        @session_impl.should_receive(:acknowledge).
+          with(false)
+
+        @session.acknowledge :sync => false
+      end
+
+      ######################################
+      # Scenarios involving a single message
+      ######################################
+      describe "with a single message" do
+
+        before(:each) do
+          @message = Qpid::Messaging::Message.new :content => "Testing"
+        end
+
+        it "can acknowledge asynchronously by default" do
+          @session_impl.should_receive(:acknowledge).
+            with(@message.message_impl, false)
+
+          @session.acknowledge :message => @message
+        end
+
+        it "can acknowledge synchronously" do
+          @session_impl.should_receive(:acknowledge).
+            with(@message.message_impl, true)
+
+          @session.acknowledge :message => @message, :sync => true
+        end
+
+        it "can acknowledge asynchronously" do
+          @session_impl.should_receive(:acknowledge).
+            with(@message.message_impl, false)
+
+          @session.acknowledge :message => @message, :sync => false
+        end
+
+        it "can reject it" do
+          @session_impl.should_receive(:reject).
+            with(@message.message_impl)
+
+          @session.reject @message
+        end
+
+        it "can release it" do
+          @session_impl.should_receive(:release).
+            with(@message.message_impl)
+
+          @session.release @message
+        end
+
+      end
+
+      it "does not block by default when synchronizating with the broker" do
+        @session_impl.should_receive(:sync).
+          with(false)
+
+        @session.sync
+      end
+
+      it "can block while synchronizing with the broker" do
+        @session_impl.should_receive(:sync).
+          with(true)
+
+        @session.sync :block => true
+      end
+
+      it "can not block while synchronizing with the broker" do
+        @session_impl.should_receive(:sync).
+          with(false)
+
+        @session.sync :block => false
+      end
+
+      it "returns the number of messages that are receivable" do
+        @session_impl.should_receive(:getReceivable).
+          and_return(15)
+
+        receivable = @session.receivable
+
+        receivable.should == 15
+      end
+
+      it "returns the number of unsettled messages" do
+        @session_impl.should_receive(:getUnsettledAcks).
+          and_return(25)
+
+        unsettled = @session.unsettled_acks
+
+        unsettled.should == 25
+      end
+
+      it "waits forever by default for the next Receiver with messages" do
+        @session_impl.should_receive(:nextReceiver).
+          with(Qpid::Messaging::Duration::FOREVER.duration_impl).
+          and_return(@receiver_impl)
+
+        receiver = @session.next_receiver
+
+        receiver.receiver_impl.should == @receiver_impl
+      end
+
+      it "uses the specified time when waiting for the next Receiver with messages" do
+        @session_impl.should_receive(:nextReceiver).
+          with(Qpid::Messaging::Duration::SECOND.duration_impl).
+          and_return(@receiver_impl)
+
+        receiver = @session.next_receiver Qpid::Messaging::Duration::SECOND
+
+        receiver.receiver_impl.should == @receiver_impl
+      end
+
+      it "returns nil when no Receiver has messages within the timeout period" do
+        @session_impl.should_receive(:nextReceiver).
+          with(Qpid::Messaging::Duration::MINUTE.duration_impl).
+          and_return(nil)
+
+        receiver = @session.next_receiver Qpid::Messaging::Duration::MINUTE
+
+        receiver.should be_nil
+      end
+
+      it "returns true when there are errors on the session" do
+        @session_impl.should_receive(:hasError).
+          and_return(true)
+
+        errors = @session.errors?
+
+        errors.should be_true
+      end
+
+      it "returns false when there are no errors on the session" do
+        @session_impl.should_receive(:hasError).
+          and_return(false)
+
+        errors = @session.errors?
+
+        errors.should be_false
+      end
+
+      it "causes exceptions to be raised when there are errors" do
+        @session_impl.should_receive(:checkError).
+          and_raise(RuntimeError)
+
+        expect {
+          @session.errors
+        }.to raise_error(RuntimeError)
+      end
+
+    end
+
+  end
+
+end