qpid_messaging 0.16.0

data/lib/qpid_messaging/version.rb

@@ -0,0 +1,33 @@
+#
+# 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.
+#
+
+module Qpid #:nodoc:
+
+  NAME = "qpid_messaging"
+
+  module Version
+
+    NUMBERS = [MAJOR = 0,
+               MINOR = 16,
+               RELEASE = 0]
+  end
+
+  VERSION = Version::NUMBERS.join('.')
+
+end

data/spec/qpid/address_spec.rb

@@ -0,0 +1,87 @@
+#
+# 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 Address do
+
+      before(:each) do
+        @address = Qpid::Messaging::Address.new "my-name", "my-subject", :create => :always
+      end
+
+      it "stores the name, subject and options when created" do
+        name    = @address.name
+        subject = @address.subject
+        create  = @address.options["create"]
+
+        name.should    == "my-name"
+        subject.should == "my-subject"
+        create.should  == "always"
+      end
+
+      it "can update the name" do
+        @address.name = "new-name"
+
+        name = @address.name
+
+        name.should == "new-name"
+      end
+
+      it "can update the subject" do
+        @address.subject = "new-subject"
+
+        subject = @address.subject
+
+        subject.should == "new-subject"
+      end
+
+      it "can update the type" do
+        @address.address_type = "routed"
+
+        type = @address.address_type
+
+        type.should == "routed"
+      end
+
+      it "can update the options" do
+        @address.options[:create] = :never
+
+        create = @address.options["create"]
+
+        create.should == "always"
+      end
+
+      it "can return a string representation" do
+        address = Qpid::Messaging::Address.new "foo", "bar", :create => :always, :link => :durable
+        result = address.to_s
+
+        result.should =~ /foo\/bar/
+        result.should =~ /create:always/
+        result.should =~ /link:durable/
+      end
+
+    end
+
+  end
+
+end

data/spec/qpid/connection_spec.rb

@@ -0,0 +1,191 @@
+#
+# 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 Connection do
+
+      before(:each) do
+        @session_impl    = double('Cqpid::Session')
+        @connection_impl = double('Cqpid::Connection')
+
+        @connection = Qpid::Messaging::Connection.new :impl => @connection_impl
+      end
+
+      it "accepts options on construction" do
+        expect {
+          connection = Qpid::Messaging::Connection.new :options => {:username => "foo"}
+
+          connection.options.should include("username")
+        }.should_not raise_error
+      end
+
+      it "returns the underlying implementation" do
+        impl = @connection.connection_impl
+
+        impl.should == @connection_impl
+      end
+
+      it "opens the connection" do
+        @connection_impl.should_receive(:open)
+
+        @connection.open
+      end
+
+      it "closes the connection" do
+        @connection_impl.should_receive(:close)
+
+        @connection.close
+      end
+
+      it "retrieves a session by name" do
+        @connection_impl.should_receive(:getSession).
+          with("farkle").
+          and_return(@session_impl)
+
+        session = @connection.session "farkle"
+
+        session.session_impl.should == @session_impl
+      end
+
+      it "raises an error when a session name is invalid" do
+        @connection_impl.should_receive(:getSession).
+          with("farkle").
+          and_raise(RuntimeError)
+
+        expect {
+          @connection.session "farkle"
+        }.to raise_error(SessionNameException)
+      end
+
+      ####################################################################
+      # test conditions for when a connection is not connected to a broker
+      ####################################################################
+      describe "when closed" do
+
+        before(:each) do
+          @connection_impl.should_receive(:isOpen).
+            and_return(false)
+        end
+
+        it "returns false when not connected to a broker" do
+          open = @connection.open?
+
+          open.should == false
+        end
+
+        it "should raise an error when creating a session on a closed connection" do
+          expect {
+            @connection.create_session
+          }.to raise_error(RuntimeError)
+        end
+
+        it "raises an error when creating a transactional session on a closed connection" do
+          expect {
+            @connection.create_session :transactional => true
+          }.to raise_error(RuntimeError)
+        end
+
+        it "raises an error when creating a named session on a closed connection" do
+          expect {
+            @connection.create_session :name => "test", :transactional => true
+          }.to raise_error(RuntimeError)
+        end
+
+        it "returns a null username when not connected" do
+          username = @connection.authenticated_username
+
+          username.should be_nil
+        end
+
+      end
+
+      #########################################################
+      # test conditions for when a connection must be connected
+      #########################################################
+      describe "when connected" do
+
+        before(:each) do
+          @connection_impl.should_receive(:isOpen).
+            and_return(true)
+        end
+
+        it "returns true when connected to a broker" do
+          open = @connection.open?
+
+          open.should == true
+        end
+
+        it "creates a session" do
+          @connection_impl.should_receive(:createSession).
+            and_return(@session_impl)
+
+          session = @connection.create_session
+
+          session.session_impl.should == @session_impl
+        end
+
+        it "creates a named session with a name when provided" do
+          @connection_impl.should_receive(:createSession).with("farkle").
+            and_return(@session_impl)
+
+          session = @connection.create_session :name => "farkle"
+
+          session.session_impl.should == @session_impl
+        end
+
+        it "creates a transactional session when specified" do
+          @connection_impl.should_receive(:createTransactionalSession).
+            and_return(@session_impl)
+
+          session = @connection.create_session :transactional => true
+
+          session.session_impl.should == @session_impl
+        end
+
+        it "creates a named transactional session when specified" do
+          @connection_impl.should_receive(:createTransactionalSession).
+            with("farkle").
+            and_return(@session_impl)
+
+          session = @connection.create_session :transactional => true, :name => "farkle"
+
+          session.session_impl.should == @session_impl
+        end
+
+        it "returns the authenticated username when connected" do
+          @connection_impl.should_receive(:getAuthenticatedUsername).
+            and_return("mcpierce")
+
+          username = @connection.authenticated_username
+
+          username.should == "mcpierce"
+        end
+
+      end
+
+    end
+
+  end
+
+end

data/spec/qpid/duration_spec.rb

@@ -0,0 +1,56 @@
+#
+# 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 Duration do
+
+      before(:each) do
+        @duration = Qpid::Messaging::Duration::SECOND
+      end
+
+      it "returns the underlying implementation" do
+        impl = @duration.duration_impl
+
+        impl.should_not be_nil
+      end
+
+      it "can create a duration with a millisecond value" do
+        duration = Qpid::Messaging::Duration.new 500
+
+        milliseconds = duration.milliseconds
+
+        milliseconds.should == 500
+      end
+
+      it "returns the time in milliseconds" do
+        milliseconds = @duration.milliseconds
+
+        milliseconds.should == 1000
+      end
+
+    end
+
+  end
+
+end

data/spec/qpid/encoding_spec.rb

@@ -0,0 +1,63 @@
+#
+# 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 "encoding" do
+    end
+
+    describe "decoding" do
+
+      before(:each) do
+        @message = Qpid::Messaging::Message.new
+      end
+
+      it "can decode a message's text content" do
+        @message.content = "This is an unencoded message."
+
+        content = Qpid::Messaging.decode @message
+
+        content.should == "This is an unencoded message."
+      end
+
+      it "can decode a message's list content" do
+        @message.content = ["this", "that"]
+
+        content = Qpid::Messaging.decode @message
+
+        content.should == ["this", "that"]
+      end
+
+      it "can decode a message's map content" do
+        @message.content = {"this" => "that"}
+
+        content = Qpid::Messaging.decode @message
+
+        content.should == {"this" => "that"}
+      end
+
+    end
+
+  end
+
+end

data/spec/qpid/message_spec.rb

@@ -0,0 +1,292 @@
+#
+# 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 Message do
+
+      before(:each) do
+        @message = Qpid::Messaging::Message.new :content => "My content"
+      end
+
+      it "returns its implementation" do
+        impl = @message.message_impl
+
+        impl.class.should == Cqpid::Message
+      end
+
+      it "can set the reply to address" do
+        address = Qpid::Messaging::Address.new "my-queue", ""
+
+        @message.reply_to = address
+
+        reply_to = @message.reply_to
+
+        reply_to.name.should == address.name
+      end
+
+      it "should store the content when created" do
+        content = @message.content
+
+        content.should == "My content"
+      end
+
+      it "should properly encode a map when created" do
+        message = Qpid::Messaging::Message.new :content => {"foo" => "bar"}
+
+        content      = message.content
+        content_type = message.content_type
+
+        content_type.should == "amqp/map"
+        content.class == Hash
+        content["foo"].should == "bar"
+      end
+
+      it "should properly encode a list when created" do
+        message = Qpid::Messaging::Message.new :content => ["foo", "bar"]
+
+        content      = message.content
+        content_type = message.content_type
+
+        content_type.should == "amqp/list"
+        content.class == Array
+        content.should include("foo")
+        content.should include("bar")
+      end
+
+      it "should store the subject" do
+        @message.subject = "new-subject"
+
+        subject = @message.subject
+
+        subject.should == "new-subject"
+      end
+
+      it "should update the content type" do
+        @message.content_type = "amqp/audio"
+
+        content_type = @message.content_type
+
+        content_type.should == "amqp/audio"
+      end
+
+      it "should store the message id" do
+        @message.message_id = "foo"
+
+        id = @message.message_id
+
+        id.should == "foo"
+      end
+
+      it "should store the user id" do
+        @message.user_id = "foo"
+
+        id = @message.user_id
+
+        id.should == "foo"
+      end
+
+      it "should store the correlation id" do
+        @message.correlation_id = "message1"
+
+        id = @message.correlation_id
+
+        id.should == "message1"
+      end
+
+      it "should store the priority" do
+        @message.priority = 7
+
+        priority = @message.priority
+
+        priority.should == 7
+      end
+
+      it "should accept a Duration as the time to live" do
+        @message.ttl = Qpid::Messaging::Duration::SECOND
+
+        ttl = @message.ttl
+
+        ttl.milliseconds.should == Qpid::Messaging::Duration::SECOND.milliseconds
+      end
+
+      it "should accept an integer value as the time to live" do
+        @message.ttl = 15000
+
+        ttl = @message.ttl
+
+        ttl.milliseconds.should == 15000
+      end
+
+      it "should update the durable flag" do
+        @message.durable = true
+
+        durable = @message.durable
+
+        durable.should == true
+      end
+
+      it "should update the redelivered flag" do
+        @message.redelivered = true
+
+        redelivered = @message.redelivered
+
+        redelivered.should == true
+      end
+
+      it "should store a property" do
+        property = @message[:test_property]
+
+        property.should == nil
+
+        @message[:test_property] = "test_value1"
+
+        property = @message[:test_property]
+
+        property.should == "test_value1"
+      end
+
+      it "should convert a symbol property value to a string" do
+        @message[:test_property] = :test_value2
+
+        property = @message[:test_property]
+
+        property.should == "test_value2"
+      end
+
+      it "should convert a symbol property name to a string" do
+        @message[:test_property] = "test_value3"
+
+        property = @message["test_property"]
+
+        property.should == "test_value3"
+      end
+
+      it "should store text content" do
+        @message.content = "This is the content."
+
+        content = @message.content
+
+        content.should == "This is the content."
+      end
+
+      it "should store list content" do
+        list = ["foo", "bar"]
+
+        @message.content = list
+
+        content      = @message.content
+        content_type = @message.content_type
+
+        content.should      == list
+        content_type.should == "amqp/list"
+      end
+
+      it "should convert symbol list elements to strings" do
+        @message.content = [:farkle]
+
+        content = @message.content.first
+
+        content.should == "farkle"
+      end
+
+      it "should store map content" do
+        map = {"foo" => "bar"}
+
+        @message.content = map
+
+        content      = @message.content
+        content_type = @message.content_type
+
+        content.should      == map
+        content_type.should == "amqp/map"
+      end
+
+      it "should convert symbol map elements to strings" do
+        @message.content = {:first_name => :qpid}
+
+        content = @message.content["first_name"]
+
+        content.should == "qpid"
+      end
+
+      describe "with content from the underlying implementation" do
+
+        before(:each) do
+          @message_impl = double("Cqpid::Message")
+          @message = Qpid::Messaging::Message.new :impl => @message_impl
+        end
+
+        it "should return simple text content" do
+          @message_impl.should_receive(:getContent).
+            and_return("my content")
+          @message_impl.should_receive(:getContentType).
+            and_return("")
+
+          content = @message.content
+
+          content.should == "my content"
+        end
+
+        it "should decode a list" do
+          list = ["first", "second"]
+
+          @message_impl.should_receive(:getContent).
+            and_return(list)
+          @message_impl.should_receive(:getContentType).
+            twice.
+            and_return("amqp/list")
+          Qpid::Messaging.stub!(:decode).
+            with(@message, "amqp/list").
+            and_return(list)
+
+          content = @message.content
+
+          content.should == list
+        end
+
+        it "should decode a map" do
+          map = {"first" => "second"}
+
+          @message_impl.should_receive(:getContent).
+            and_return(map)
+          @message_impl.should_receive(:getContentType).
+            twice.
+            and_return("amqp/map")
+          Qpid::Messaging.stub!(:decode).
+            with(@message, "amqp/map").
+            and_return(map)
+
+          content = @message.content
+
+          content.should == map
+        end
+
+
+      end
+
+    end
+
+  end
+
+end