qpid_messaging 0.16.0

data/ext/cqpid/extconf.rb

@@ -0,0 +1,73 @@
+#
+# 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.
+#
+
+# To create the Makefile then you need to specify the location
+# of the Qpid shared libraries using the commandline:
+#
+#  $ ruby extconf.rb --with-qpid-lib=[path to libraries]
+#
+
+require 'mkmf'
+
+# Setup the build environment.
+$CFLAGS = "-fPIC -fno-inline -x c++"
+
+REQUIRED_LIBRARIES = [
+                      'qpidclient',
+                      'qpidcommon',
+                      'qpidmessaging',
+                      'qpidtypes'
+                     ]
+
+REQUIRED_HEADERS = [
+                    'qpid/messaging/Address.h',
+                    'qpid/messaging/Connection.h',
+                    'qpid/messaging/Duration.h',
+                    'qpid/messaging/exceptions.h',
+                    'qpid/messaging/FailoverUpdates.h',
+                    'qpid/messaging/Handle.h',
+                    'qpid/messaging/ImportExport.h',
+                    'qpid/messaging/Message.h',
+                    'qpid/messaging/Receiver.h',
+                    'qpid/messaging/Sender.h',
+                    'qpid/messaging/Session.h'
+                   ]
+
+dir_config('qpid')
+
+def abort_build filetype, filename
+  abort "Missing required #{filetype}: #{filename}"
+end
+
+def require_library lib
+  abort_build "library", lib unless have_library lib
+end
+
+def require_header header
+  abort_build "header", header unless have_header header
+end
+
+have_library('stdc++')
+
+REQUIRED_LIBRARIES.each {|library| require_library library}
+
+REQUIRED_HEADERS.each {|header| require_header header}
+
+create_makefile('cqpid')
+

data/features/closing_a_connection.feature

@@ -0,0 +1,13 @@
+Feature: Closing an open connection
+  When working with a broker
+  As a producer or consumer
+  I want to close a connection
+
+  Scenario: The connection is already closed
+    Given a closed connection
+    Then calling close does not raise an exception
+
+  Scenario: The connection is open
+    Given an open connection
+    And the connection is closed
+    Then the connection is in the closed state

data/features/closing_a_session.feature

@@ -0,0 +1,13 @@
+Feature: Closing an open session
+  While working with a session
+  As a producer or consumer
+  I want to close the session
+
+  Scenario: The connection has already been closed
+    Given an open session with a closed connection
+    Then closing the session does not raise an error
+
+  Scenario: Closing an active session
+    Given an open session
+    Then closing the session does not raise an error
+    And the connection is in the open state

data/features/connecting_to_a_broker.feature

@@ -0,0 +1,13 @@
+Feature: Connecting to a broker
+  In order to interaction on an AMQP network
+  As a producer or consumer
+  I want to connect to a broker
+
+  Scenario: Connections are closed by default
+    Given a new connection
+    Then the connection is in the closed state
+
+  Scenario: Opening a connection
+    Given a new connection
+    And the connection is opened
+    Then the connection is in the open state

data/features/creating_a_receiver.feature

@@ -0,0 +1,29 @@
+Feature: Creating a receiver
+  When working with a messaging environment
+  As a consumer
+  I want to create a Receiver for consuming messages
+
+  Scenario: The session is closed
+    Given a closed session
+    Then creating a receiver with "my-queue" raises an exception
+
+  Scenario: The connection is closed
+    Given an open session with a closed connection
+    Then creating a receiver with "my-queue" raises an exception
+
+  Scenario: The address is malformed
+    Given an open session
+    Then creating a receiver with "my-queue;{foo:bar}" raises an exception
+
+  Scenario: The address string is valid but the queue does not exist
+    Given an open session
+    Then creating a receiver for a nonexistent queue raises an exception
+
+  Scenario: The address string is fine
+    Given an open session
+    Then creating a receiver with "my-queue;{create:always}" succeeds
+
+  Scenario: Using an Address object
+    Given an open session
+    And an Address with the name "create-receiver-test" and subject "foo" and option "create" set to "always"
+    Then creating a receiver with an Address succeeds

data/features/creating_a_sender.feature

@@ -0,0 +1,25 @@
+Feature: Creating a sender
+  When working with a session
+  As a producer
+  I want to create a Sender for sending messages
+
+  Scenario: The session is closed
+    Given a closed session
+    Then creating a sender with "my-queue;{create:always}" raises an exception
+
+  Scenario: The connection is closed
+    Given an open session with a closed connection
+    Then creating a sender with "my-queue;{create:always}" raises an exception
+
+  Scenario: The address is malformed
+    Given an open session
+    Then creating a sender with "my-queue;{foo:bar}" raises an exception
+
+  Scenario: The address string is valid
+    Given an open session
+    Then creating a sender with "my-queue;{create:always}" succeeds
+
+  Scenario: Using an Address object
+    Given an open session
+    And an Address with the name "my-queue" and subject "my-subject" and option "create" set to "always"
+    Then creating a sender with an Address succeeds

data/features/creating_a_session.feature

@@ -0,0 +1,12 @@
+Feature: Creating a session
+  When working with a broker
+  As a producer or consumer
+  I want to create a session
+
+  Scenario: The connection is closed
+    Given a closed connection
+    Then creating a session raises an exception
+
+  Scenario: The connection is open
+    Given an open connection
+    Then creating a session works

data/features/getting_the_connections_authenticated_username.feature

@@ -0,0 +1,8 @@
+Feature: Getting the authenticated username from an open connection.
+  When connected to a broker
+  As a producer or consumer
+  I can retrieve the username used to authenticate
+
+  Scenario: When connected anonymously
+    Given an open connection
+    Then the authenticated username should be "anonymous"

data/features/receiving_a_message.feature

@@ -0,0 +1,28 @@
+Feature: Receving a message
+  When working with a broker
+  As a message consumer
+  I need to be able to receive messages
+
+  Scenario: Receiving after the session is closed
+    Given a sender and receiver for "my-queue;{create:always}"
+    And the message "this is a test" is sent
+    And the session is closed
+    Then getting the next message raises an error
+
+  Scenario: Receiving after the connection is closed
+    Given a sender and receiver for "my-queue;{create:always}"
+    And the message "this is a test" is sent
+    And the connection is closed
+    Then getting the next message raises an error
+
+  Scenario: No message is received on an empty queue
+    Given an existing receiver for "my-queue;{create:always}"
+    And the receiver has no pending messages
+    Then getting the next message raises an error
+
+  Scenario: A message is pending
+    Given a sender and receiver for "my-queue;{create:always}"
+    And the receiver has a capacity of 1
+    And the message "this is a test" is sent
+    Then the receiver should have 1 message available
+    And the receiver should receive a message with "this is a test"

data/features/sending_a_message.feature

@@ -0,0 +1,21 @@
+Feature: Sending a message
+  When working with a broker
+  As a producer
+  I want to send messages using an existing Sender
+
+  Scenario: The session is closed
+    Given an open session
+    And creating a sender with "my-queue;{create:always}" succeeds
+    And the session is closed
+    Then sending the message "This is a test" should raise an error
+
+  Scenario: The connection is closed
+    Given an open session
+    And creating a sender with "my-queue;{create:always}" succeeds
+    And the connection is closed
+    Then sending the message "This is a test" should raise an error
+
+  Scenario: The message sends successfully
+    Given an open session
+    And creating a sender with "my-queue;{create:always}" succeeds
+    Then sending the message "This is a test" succeeds

data/features/session_returns_its_connection.feature

@@ -0,0 +1,12 @@
+Feature: A session returns its connection
+  With an action session
+  As a producer or consumer
+  I can retrieve the underlying connection for the session
+
+  Scenario: The connection is closed
+    Given an open session with a closed connection
+    Then the connection for the session is in the closed state
+
+  Scenario: The connection is open
+    Given an open session
+    Then the connection for the session is in the open state

data/features/sessions_have_names.feature

@@ -0,0 +1,8 @@
+Feature: Session have a name
+  When using a session
+  As a producer or consumer
+  I can name a session and then later retrieve it by name
+
+  Scenario: Naming a session
+    Given an existing session named "test-session"
+    Then the session can be retrieved by the name "test-session"

data/features/step_definitions/address_steps.rb

@@ -0,0 +1,24 @@
+#
+# 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.
+#
+
+Given /^an Address with the name "([^"]*)" and subject "([^"]*)" and option "([^"]*)" set to "([^"]*)"$/ do |name, subject, key, value|
+  options = Hash.new
+  options["#{key}"] = "#{value}"
+  @address = Qpid::Messaging::Address.new "#{name}", "#{subject}", options
+end

data/features/step_definitions/connection_steps.rb

@@ -0,0 +1,93 @@
+#
+# 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.
+#
+
+# close all connections
+After do
+  @connection.close if @connection
+end
+
+Given /^a new connection$/ do
+  @connection = Qpid::Messaging::Connection.new unless @connection
+end
+
+Given /^an open connection$/ do
+  steps %Q{
+    Given a new connection
+  }
+  @connection.open
+end
+
+Given /^a closed connection$/ do
+  steps %Q{
+    Given a new connection
+  }
+  @connection.close if @connection.open?
+end
+
+Then /^the connection is in the (open|closed) state$/ do |state|
+  @connection.open?.should == false if state == "closed"
+  @connection.open?.should == true  if state == "open"
+end
+
+Given /^the connection is opened$/ do
+  @connection.open
+end
+
+Given /^the connection is closed$/ do
+  @connection.close
+end
+
+Then /^creating a session raises an exception$/ do
+  lambda {
+    @session = @connection.create_session
+  }.should raise_error
+end
+
+Then /^creating a session works$/ do
+  steps %Q{
+    Given a session exists with the name "nameless"
+  }
+  @session.should_not be_nil
+end
+
+Given /^an existing session named "([^"]*)"$/ do |name|
+  steps %Q{
+    Given an open connection
+    And a session exists with the name "#{name}"
+  }
+end
+
+Given /^a session exists with the name "([^"]*)"$/ do |name|
+  @session = @connection.create_session :name => "#{name}"
+end
+
+Then /^the session can be retrieved by the name "([^"]*)"$/ do |name|
+  session = @connection.session "#{name}"
+  session.should_not be_nil
+end
+
+Then /^calling close does not raise an exception$/ do
+  lambda {
+    @connection.close
+  }.should_not raise_error
+end
+
+Then /^the authenticated username should be "([^"]*)"$/ do |username|
+  @connection.authenticated_username.should == "#{username}"
+end

data/features/step_definitions/receiver_steps.rb

@@ -0,0 +1,61 @@
+#
+# 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.
+#
+
+Given /^an existing receiver for "([^"]*)"$/ do |address|
+  steps %Q{
+    Given an open session
+    Then creating a receiver with "#{address}" succeeds
+  }
+end
+
+Given /^the receiver has no pending messages$/ do
+  available = @receiver.available
+  available.should == 0
+end
+
+Then /^getting the next message raises an error$/ do
+  lambda {
+    @message = @receiver.get Qpid::Messaging::Duration::IMMEDIATE
+  }.should raise_error
+end
+
+Given /^a sender and receiver for "([^"]*)"$/ do |address|
+  steps %Q{
+    Given an open session
+    Then creating a sender with "#{address}" succeeds
+    Then creating a receiver with "#{address}" succeeds
+  }
+end
+
+Then /^the receiver should receive a message with "([^"]*)"$/ do |content|
+  @message = @receiver.fetch Qpid::Messaging::Duration::IMMEDIATE
+
+  @message.should_not be_nil
+  @message.content.should == "#{content}"
+end
+
+Given /^the receiver has a capacity of (\d+)$/ do |capacity|
+  @receiver.capacity = capacity.to_i
+end
+
+Then /^the receiver should have (\d+) message available$/ do |available|
+  # TODO we shouldn't need to sleep a second in order to have this update
+  sleep 1
+  @receiver.available.should == available.to_i
+end