jsparrow 1.1.1 → 1.1.2

data/sample/sample_topic.rb

@@ -0,0 +1,33 @@
+require 'rubygems'
+require 'jsparrow'
+
+JSparrow::Connection.configure do |connection|
+  connection.use_jms_client_jar '/opt/openjms/lib/openjms-0.7.7-beta-1.jar'
+
+  connection.use_jndi_properties :initial_context_factory => 'org.exolab.jms.jndi.InitialContextFactory',
+                                 :provider_url            => 'tcp://localhost:3035'
+                               # :security_principal      => 'user',
+                               # :security_credentials    => 'password'
+
+  connection.enable_connection_factories :topic_connection_factory => 'ConnectionFactory'
+  
+  connection.enable_topics :test_topic => 'TestTopic'
+end
+
+jms_client = JSparrow::Connection.new_client
+jms_client.start
+
+jms_client.topic_sender(:test_topic).send_text_message('jsparrow rocks!') do |msg|
+  msg.set_string_property('recipient', 'jsparrow-example')
+end
+
+jms_client.topic_receiver(:test_topic).receive_message(
+    :timeout  => 5000,
+    :selector => "recipient = 'jsparrow-example'"
+  ) do |msg|
+  
+  puts "is text message? #{msg.is_text_message?}"    # is text message? true
+  puts "message: #{msg.text}"                        # message: jsparrow rocks!
+end
+
+jms_client.stop

data/spec/client_spec.rb

@@ -1,86 +1,69 @@
 require File.dirname(File.expand_path(__FILE__)) + '/spec_helper.rb'
 
-#
-# Cenario que testa o start e stop do cliente JMS.
-#
-describe JSparrow::Connection::Client, ', quando criado,' do
+describe JSparrow::Connection::Client do
 
-  before(:all) do
-    @jms_client = create_jms_client
+  subject do
+    create_jms_client
   end
   
-  it 'deveria permitir ser iniciado e parado' do
-    @jms_client.start
+  context 'When created' do
+  
+    it 'should be started and stoped' do
+      subject.start
     
-    @jms_client.is_started?.should be true
-    @jms_client.is_stoped?.should be false
+      subject.is_started?.should be true
+      subject.is_stoped?.should be false
     
-    @jms_client.stop
+      subject.stop
     
-    @jms_client.is_started?.should be false
-    @jms_client.is_stoped?.should be true
-  end
-end
-
-#
-# Cenario de configuracao do cliente JMS, quando sao informadas as propriedades de ambiente
-# para conexao com o servidor de aplicacoes e a inicializacao do contexto JNDI inicial,
-# onde estao criadas as connection factories, queues e topics.
-#
-# Importante: nesse momento o cliente JMS ainda nao sera iniciado, ja que nao deve haver
-#             configuracao depois inicia-lo.
-#
-describe JSparrow::Connection::Client, ', quando esta sendo configurado, mas ainda nao iniciado,' do
-
-  before(:all) do
-    @jms_client = create_jms_client
-  end
-  
-  it 'deveria ter uma connection factory especifica para queues' do
-    @jms_client.queue_connection_factory_enabled?.should be true
-  end
+      subject.is_started?.should be false
+      subject.is_stoped?.should be true
+    end
   
-  it 'deveria ter uma connection factory especifica para topics' do
-    @jms_client.topic_connection_factory_enabled?.should be true
-  end
+    it 'should not be started if already is' do
+      subject.start
+    
+      lambda {
+          subject.start
+        }.should raise_error JSparrow::Connection::InvalidStateError
+    
+      subject.stop
+    end
   
-  it 'deveria ter uma Queue especifica' do
-    @jms_client.queue_enabled?(:test_queue).should eql true
+    it 'should not be stoped if already is' do
+      subject.start
+      subject.stop
+    
+      lambda {
+          subject.stop
+        }.should raise_error JSparrow::Connection::InvalidStateError
+    end
   end
   
-  it 'deveria ter um Topic especifico' do
-    @jms_client.topic_enabled?(:test_topic).should eql true
-  end  
-end
+  context 'When started' do
 
-#
-# Cenario pos-configuracao do cliente JMS, quando as queues e os topicos ja devem estar
-# disponiveis, e entao e possivel obter sender/receiver para elas.
-#
-describe JSparrow::Connection::Client, ', depois de ter sido configurado,' do
+    before(:all) do
+      subject.start
+    end
 
-  before(:all) do
-    @jms_client = create_jms_client
-    @jms_client.start
-  end
-  
-  after(:all) do
-    @jms_client.stop
-  end
-  
-  it 'deveria possibilitar obter um Sender para uma Queue especifica' do
-    @jms_client.queue_sender(:test_queue).should_not be nil
-  end
-  
-  it 'deveria possibilitar obter um Receiver para uma Queue especifica' do
-    @jms_client.queue_receiver(:test_queue).should_not be nil
-  end
-  
-  it 'deveria possibilitar obter um Sender para um Topic especifico' do
-    @jms_client.topic_sender(:test_topic).should_not be nil
-  end
-  
-  it 'deveria possibilitar obter um Receiver para um Topic especifico' do
-    @jms_client.topic_receiver(:test_topic).should_not be nil
+    after(:all) do
+      subject.stop
+    end
+
+    it 'should allow get a Sender for a Queue' do
+      subject.queue_sender(:test_queue).should_not be nil
+    end
+
+    it 'should allow get a Receiver for a Queue' do
+      subject.queue_receiver(:test_queue).should_not be nil
+    end
+
+    it 'should allow get a Sender for a Topic' do
+      subject.topic_sender(:test_topic).should_not be nil
+    end
+
+    it 'should allow get a Receiver for a Topic' do
+      subject.topic_receiver(:test_topic).should_not be nil
+    end
   end
-end
+end

data/spec/connection_spec.rb

@@ -1,31 +1,47 @@
 require File.dirname(File.expand_path(__FILE__)) + '/spec_helper.rb'
 
-#
-# Cenario que testa a configuracao a conexao com o provedor de JMS.
-#
-describe JSparrow::Connection, ', quando configurado,' do
+describe JSparrow::Connection do
 
-  before(:all) do
-    @config = configure_connection
+  subject do
+    configure_connection
   end
   
-  it 'deveria ter jms_client_jar' do
-    @config.jms_client_jar.should_not be nil
-  end
+  context 'When configured' do
+  
+    it 'should known a jms_client_jar' do
+      subject.jms_client_jar.should_not be nil
+    end
 
-  it 'deveria ter jndi_properties' do
-    @config.jndi_properties.should_not be nil
-  end
+    it 'should known a jndi_properties' do
+      subject.jndi_properties.should_not be nil
+    end
 
-  it 'deveria ter enabled_connection_factories' do
-    @config.enabled_connection_factories.should_not be nil
-  end
+    it 'should have the queue_connection_factory enabled' do
+      subject.enabled_connection_factories[:queue_connection_factory].should_not be nil
+    end
 
-  it 'deveria ter enabled_queues' do
-    @config.enabled_queues.should_not be nil
-  end
+    it 'should have the topic_connection_factory enabled' do
+      subject.enabled_connection_factories[:topic_connection_factory].should_not be nil
+    end
+
+    it 'should have the test_queue enabled' do
+      subject.enabled_queues[:test_queue].should_not be nil
+    end
 
-  it 'deveria ter enabled_topics' do
-    @config.enabled_topics.should_not be nil
+    it 'should have the test_topic enabled' do
+      subject.enabled_topics[:test_topic].should_not be nil
+    end
+  
+    it 'should allow create a new Client' do
+      jms_client = create_jms_client
+    
+      jms_client.class.should be JSparrow::Connection::Client
+    end
+  
+    it 'should allow create a new Listener' do
+      jms_listener = create_jms_listener
+    
+      jms_listener.class.superclass.should be JSparrow::Connection::Listener
+    end
   end
-end
+end

data/spec/listener_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(File.expand_path(__FILE__)) + '/spec_helper.rb'
+
+describe JSparrow::Connection::Listener do
+
+  subject do
+    create_jms_listener
+  end
+
+  context 'When inherited for listening a queue' do
+
+    it 'should listen to "test_queue" destination' do
+      subject.listen_to_destination.should eql :queue => :test_queue
+    end
+  end
+
+  context 'When inherited and created,' do
+  
+    it 'should be started and stoped' do
+      subject.start_listening
+    
+      subject.is_listening?.should be true
+    
+      subject.stop_listening
+    
+      subject.is_listening?.should be false
+    end
+  
+    it 'should receive a message' do
+      send_message_to_listener 'TestQueueListener'
+    
+      subject.start_listening
+    
+      sleep 1 # espera um pouquinho pra mensagem ser entregue
+    
+      subject.received_messages.size.should eql 1
+
+      subject.stop_listening
+    end
+  end
+end

data/spec/messaging_spec.rb

@@ -1,142 +1,121 @@
 require File.dirname(File.expand_path(__FILE__)) + '/spec_helper.rb'
 
-#
-# Cenario pos-obtencao de um Sender e um Receiver, quando deve ser possivel enviar e
-# receber mensagens de tres tipos (Texto, Objeto e Mapa) de uma queue especifica,
-# individualmente ou em lote.
-#
-describe JSparrow::Messaging, ', quando tem um Sender e um Receiver para uma Queue especifica,' do
+describe JSparrow::Messaging do
+
+  context 'When have a Sender and a Receiver for a Queue' do
   
-  before(:all) do
-    @jms_client = create_jms_client
-    @jms_client.start
+    before(:all) do
+      @jms_client = create_jms_client
+      @jms_client.start
     
-    @sender   = @jms_client.queue_sender(:test_queue)
-    @receiver = @jms_client.queue_receiver(:test_queue)
-  end
+      @sender   = @jms_client.queue_sender(:test_queue)
+      @receiver = @jms_client.queue_receiver(:test_queue)
+    end
   
-  after(:all) do
-    @jms_client.stop
-  end
+    after(:all) do
+      @jms_client.stop
+    end
   
-  it 'deveria possibilitar enviar uma mensagem de texto e recebe-la' do
-    my_text = 'Mensagem de texto enviada da spec'
+    it 'should send a text_message and next receive it' do
+      my_text = 'Mensagem de texto enviada da spec'
     
-    @sender.send_text_message(my_text) do |msg|
-      msg.set_string_property('recipient', 'jsparrow-spec')
-    end
+      @sender.send_text_message(my_text) do |msg|
+        msg.set_string_property('recipient', 'jsparrow-spec')
+      end
     
-    received_text = nil
+      received_text = nil
     
-    @receiver.receive_message(:selector => "recipient = 'jsparrow-spec'") do |msg|
-      received_text = msg.text
-    end
+      @receiver.receive_message(:selector => "recipient = 'jsparrow-spec'") do |msg|
+        received_text = msg.text
+      end
     
-    received_text.should eql my_text
-  end
+      received_text.should eql my_text
+    end
   
-  it 'deveria possibilitar enviar um objeto e recebe-lo' do
-    my_object = java.util.ArrayList.new
-    my_object << 'Obj1 enviado da spec'
+    it 'should send a object_message and next receive it' do
+      my_object = java.util.ArrayList.new
+      my_object << 'Obj1 enviado da spec'
     
-    @sender.send_object_message(my_object) do |msg|
-      msg.set_string_property('recipient', 'jsparrow-spec')
-    end
+      @sender.send_object_message(my_object) do |msg|
+        msg.set_string_property('recipient', 'jsparrow-spec')
+      end
     
-    received_object = nil
+      received_object = nil
     
-    @receiver.receive_message(:selector => "recipient = 'jsparrow-spec'") do |msg|
-      received_object = msg.object
-    end
+      @receiver.receive_message(:selector => "recipient = 'jsparrow-spec'") do |msg|
+        received_object = msg.object
+      end
     
-    received_object.should eql my_object
-  end
+      received_object.should eql my_object
+    end
   
-  it 'deveria possibilitar enviar uma mensagem mapa e recebe-la' do
-    my_id_long = 1234567
+    it 'should send a map_message and next receive it' do
+      my_id_long = 1234567
     
-    @sender.send_map_message do |msg|
-      msg.set_string_property('recipient', 'jsparrow-spec')
-      msg.set_long('id', my_id_long)
-    end
+      @sender.send_map_message do |msg|
+        msg.set_string_property('recipient', 'jsparrow-spec')
+        msg.set_long('id', my_id_long)
+      end
     
-    received_id_long = nil
+      received_id_long = nil
     
-    @receiver.receive_message(:selector => "recipient = 'jsparrow-spec'") do |msg|
-      received_id_long = msg.get_long('id')
-    end
+      @receiver.receive_message(:selector => "recipient = 'jsparrow-spec'") do |msg|
+        received_id_long = msg.get_long('id')
+      end
     
-    received_id_long.should eql my_id_long
-  end
+      received_id_long.should eql my_id_long
+    end
   
-  it 'deveria possibilitar enviar varias mensagens de qualquer tipo e recebe-las' do
-    my_text = 'Mensagem de texto enviada da spec'
+    it 'should send messages a lot and next receive it' do
+      my_text = 'Mensagem de texto enviada da spec'
     
-    my_object = java.util.ArrayList.new
-    my_object << 'Obj1 enviado da spec'
+      my_object = java.util.ArrayList.new
+      my_object << 'Obj1 enviado da spec'
     
-    my_id_long = 1234567
+      my_id_long = 1234567
     
-    @sender.send_messages do |session, producer|
-      #--- TextMessage
-      text_message = session.create_text_message(my_text)
-      text_message.set_string_property('recipient', 'jsparrow-spec')
-      producer.send(text_message)
+      @sender.send_messages do |session, producer|
+        #--- TextMessage
+        text_message = session.create_text_message(my_text)
+        text_message.set_string_property('recipient', 'jsparrow-spec')
+        producer.send(text_message)
       
-      #--- objectMessage
-      object_message = session.create_object_message(my_object)
-      object_message.set_string_property('recipient', 'jsparrow-spec')
-      producer.send(object_message)
+        #--- objectMessage
+        object_message = session.create_object_message(my_object)
+        object_message.set_string_property('recipient', 'jsparrow-spec')
+        producer.send(object_message)
       
-      #--- MapMessage
-      map_message = session.create_map_message
-      map_message.set_string_property('recipient', 'jsparrow-spec')
-      map_message.set_long('id', my_id_long)
-      producer.send(map_message)
+        #--- MapMessage
+        map_message = session.create_map_message
+        map_message.set_string_property('recipient', 'jsparrow-spec')
+        map_message.set_long('id', my_id_long)
+        producer.send(map_message)
       
-      # Commita as tres mensagens enviadas na sessao
-      session.commit
-    end
+        # Commita as tres mensagens enviadas na sessao
+        session.commit
+      end
     
-    received_text    = nil
-    received_object  = nil
-    received_id_long = nil
+      received_text    = nil
+      received_object  = nil
+      received_id_long = nil
     
-    @receiver.receive_message(:timeout => 1000, :selector => "recipient = 'jsparrow-spec'") do |msg|
-      if msg.is_text_message?
-        received_text = msg.text
-      end
+      @receiver.receive_message(:timeout => 1000, :selector => "recipient = 'jsparrow-spec'") do |msg|
+        if msg.is_text_message?
+          received_text = msg.text
+        end
       
-      if msg.is_object_message?
-        received_object = msg.object
-      end
+        if msg.is_object_message?
+          received_object = msg.object
+        end
       
-      if msg.is_map_message?
-        received_id_long = msg.get_long('id')
+        if msg.is_map_message?
+          received_id_long = msg.get_long('id')
+        end
       end
-    end
     
-    received_text.should    eql my_text
-    received_object.should  eql my_object
-    received_id_long.should eql my_id_long
-  end
-end
-
-#
-# Cenario pos-configuracao do cliente JMS, quando deve ser possivel escutar mensagens
-# atraves de objetos listeners.
-#
-describe JSparrow::Messaging::Listener,
-         ', quando um Listener se registra para escutar uma Queue especifica,' do
-  
-  before(:all) do
-    @jms_client = create_jms_client
-    @jms_client.start
-  end
-  
-  after(:all) do
-    @jms_client.stop
+      received_text.should    eql my_text
+      received_object.should  eql my_object
+      received_id_long.should eql my_id_long
+    end
   end
-  
-  it 'deveria possibilitar escutar mensagens atraves de um listener'
 end

data/spec/spec_helper.rb

@@ -8,15 +8,6 @@ require File.dirname(File.expand_path(__FILE__)) + '/../lib/jsparrow.rb'
 #
 module JSparrowHelperMethods
 
-  #
-  # Apenas cria, mas nao faz o setup do cliente JMS.
-  #
-  def create_jms_client
-    configure_connection
-    
-    JSparrow::Connection.new_client
-  end
-  
   def configure_connection
     JSparrow::Connection.configure do |connection|
       connection.use_jms_client_jar '/opt/openjms/lib/openjms-0.7.7-beta-1.jar'
@@ -34,8 +25,57 @@ module JSparrowHelperMethods
       connection.enable_topics :test_topic => 'TestTopic'
     end
   end
+
+  def create_jms_client
+    configure_connection
+    
+    JSparrow::Connection.new_client
+  end
+  
+  def create_jms_listener
+    configure_connection
+    
+    JSparrow::Connection.new_listener :as => JSparrowHelperClasses::TestQueueListener
+  end
+  
+  def send_message_to_listener(listener_name)
+    @jms_client = create_jms_client
+    @jms_client.start
+    
+    my_text = 'Mensagem de texto enviada da spec para o listener TestQueueListener'
+    
+    @jms_client.queue_sender(:test_queue).send_text_message(my_text) do |msg|
+      msg.set_string_property('recipient',   'jsparrow-spec')
+      msg.set_string_property('to_listener', listener_name)
+    end
+
+    @jms_client.stop
+  end
 end
 
+module JSparrowHelperClasses
+  
+  #
+  # Listener da queue TestQueue
+  #
+  class TestQueueListener < JSparrow::Connection::Listener
+    listen_to :queue => :test_queue
+  
+    receive_only_in_criteria :selector => "recipient = 'jsparrow-spec' and to_listener = 'TestQueueListener'"
+  
+    attr_reader :received_messages
+  
+    def initialize(connection)
+      super(connection)
+    
+      @received_messages = []
+    end
+  
+    def on_receive_message(received_message)
+      @received_messages << received_messages
+    end
+  end
+end
 #
 # Enriquece a classe Spec::Example::ExampleGroup com o helper.
 #