jsparrow 1.1.3 → 1.1.4

data/lib/javaee.rb

@@ -0,0 +1,164 @@
+# Libs directory definition
+JEE_LIB_DIR = File.expand_path(File.dirname(__FILE__)) + '/javaee'
+
+require 'java'
+require "#{JEE_LIB_DIR}/jsparrow-essential.jar"
+require "#{JEE_LIB_DIR}/javaee-1.5.jar"
+require "#{JEE_LIB_DIR}/jms.jar"
+
+module JSparrow
+  module JMS
+
+    module Session
+      #
+      # Sobrescreve metodos de instancia.
+      #
+      module OverrideMethods
+        def create_text_message(text_message)
+          enriches_message super(text_message)
+        end
+
+        def create_object_message(object_message)
+          enriches_message super(object_message)
+        end
+
+        def create_map_message
+          enriches_message super
+        end
+      
+        def create_consumer(destination, criteria_for_receiving)
+          enriches_consumer super(destination, criteria_for_receiving)
+        end
+      
+        # --- Private methods -- #
+        private
+      
+          def enriches_message(message)
+            class << message
+              include Message::TypingMethods
+              include Message::CriteriaMethods
+            end
+          
+            message
+          end
+        
+          def enriches_consumer(consumer)
+            class << consumer
+              include Consumer::OverrideMethods
+            end
+          
+            consumer
+          end
+      end
+    end
+    
+    module Consumer
+      #
+      # Sobrescreve metodos de instancia.
+      #
+      module OverrideMethods
+        def receive(timeout)
+          received_message = super(timeout)
+        
+          if received_message.nil?
+            received_message
+          else
+            enriches_message received_message
+          end
+        end
+      
+        # --- Private methods -- #
+        private
+      
+          def enriches_message(message)
+            class << message
+              include Message::TypingMethods
+            end
+          
+            message
+          end
+      end
+    end
+    
+    module Message
+      #
+      # Identifica o tipo de uma mensagem.
+      #
+      module TypingMethods
+        def is_text_message?
+          respond_to? :get_text
+        end
+    
+        def is_object_message?
+          (respond_to? :get_object and !(respond_to? :get_long))
+        end
+    
+        def is_map_message?
+          respond_to? :get_long
+        end
+      end
+    
+      #
+      # Adiciona criterios a mensagem.
+      #
+      module CriteriaMethods
+        def add_criteria_to_reception(name, value)
+          set_string_property(name, value)
+        end
+      end
+    end
+  end
+
+  module JNDI
+    #
+    # Builder para construcao de contexto JNDI para conexao com o provedor
+    # de JMS.
+    #
+    class ContextBuilder
+      attr_accessor :jms_client_jar, :jndi_properties
+
+      def initialize(jms_client_jar, jndi_properties)
+        @jms_client_jar  = jms_client_jar
+        @jndi_properties = jndi_properties
+      end
+
+      #
+      # Constroi um contexto JNDI inicial a partir das configuracoes atuais.
+      #
+      def build
+          # Carrega a biblioteca cliente do servidor de aplicacoes
+          require @jms_client_jar
+
+          InitialContext.new(to_jndi_environment_hashtable)
+      end
+
+      # --- Private methods --- #
+      private
+
+        #
+        # Cria um Hashtable Java contendo as configuracoes atuais.
+        #
+        def to_jndi_environment_hashtable
+          jndi_env = Hashtable.new
+
+          jndi_env.put(
+            InitialContext::INITIAL_CONTEXT_FACTORY,
+            @jndi_properties[:initial_context_factory])
+
+          jndi_env.put(
+            InitialContext::PROVIDER_URL,
+            @jndi_properties[:provider_url])
+
+          jndi_env.put(
+            InitialContext::SECURITY_PRINCIPAL,
+            @jndi_properties[:security_principal]) if @jndi_properties[:security_principal]
+
+          jndi_env.put(
+            InitialContext::SECURITY_CREDENTIALS,
+            @jndi_properties[:security_credentials]) if @jndi_properties[:security_credentials]
+
+          jndi_env
+        end
+    end
+  end
+end

data/lib/jsparrow.rb

@@ -1,11 +1,7 @@
 $LOAD_PATH.unshift(File.dirname(File.expand_path(__FILE__)))
 
-# Bibliotecas necessarias usar JMS
-require 'jms.rb'
+require 'javaee'
 
-# Bibliotecas do JSparrow
-require 'connection.rb'
-require 'client.rb'
-require 'listener.rb'
-require 'messaging.rb'
-require 'error.rb'
+require 'connection'
+require 'interaction'
+require 'error'

data/sample/sample_queue.rb

@@ -14,11 +14,11 @@ JSparrow::Connection.configure do
   enable_queues :test_queue => 'TestQueue'
 end
 
-jms_client = JSparrow::Connection.new_client
+jms_client = new_jsparrow_client
 jms_client.start
 
 jms_client.queue_sender(:test_queue).send_text_message('jsparrow rocks!') do |msg|
-  msg.set_string_property('recipient', 'jsparrow-example')
+  msg.add_criteria_to_reception('recipient', 'jsparrow-example')
 end
 
 jms_client.queue_receiver(:test_queue).receive_message(

data/sample/sample_topic.rb

@@ -14,11 +14,11 @@ JSparrow::Connection.configure do
   enable_topics :test_topic => 'TestTopic'
 end
 
-jms_client = JSparrow::Connection.new_client
+jms_client = new_jsparrow_client
 jms_client.start
 
 jms_client.topic_sender(:test_topic).send_text_message('jsparrow rocks!') do |msg|
-  msg.set_string_property('recipient', 'jsparrow-example')
+  msg.add_criteria_to_reception('recipient', 'jsparrow-example')
 end
 
 jms_client.topic_receiver(:test_topic).receive_message(

data/spec/client_spec.rb

@@ -1,12 +1,12 @@
 require File.dirname(File.expand_path(__FILE__)) + '/spec_helper.rb'
 
-describe JSparrow::Connection::Client do
+describe JSparrow::Interactors::Client do
 
   subject do
-    create_jms_client
+    new_jms_client
   end
   
-  context 'When created' do
+  context 'when created' do
   
     it 'should be started and stoped' do
       subject.start
@@ -40,7 +40,7 @@ describe JSparrow::Connection::Client do
     end
   end
   
-  context 'When started' do
+  context 'when started' do
 
     before(:all) do
       subject.start

data/spec/connection_spec.rb

@@ -6,7 +6,7 @@ describe JSparrow::Connection do
     configure_connection
   end
   
-  context 'When configured' do
+  context 'when configured' do
   
     it 'should known a jms_client_jar' do
       subject.jms_client_jar.should_not be nil
@@ -33,15 +33,22 @@ describe JSparrow::Connection do
     end
   
     it 'should allow create a new Client' do
-      jms_client = create_jms_client
+      jms_client = new_jms_client
     
-      jms_client.class.should be JSparrow::Connection::Client
+      jms_client.class.should be JSparrow::Interactors::Client
     end
   
-    it 'should allow create a new Listener' do
-      jms_listener = create_jms_listener
+    it 'should allow create a new named Listener' do
+      jms_listener = new_named_jms_listener
     
-      jms_listener.class.superclass.should be JSparrow::Connection::Listener
+      jms_listener.class.superclass.should be JSparrow::Interactors::Listener
+    end
+    
+    it 'should allow create a new anonymous Listener' do
+      jms_listener = new_anonymous_jms_listener
+      
+      jms_listener.class.should be JSparrow::Interactors::Listener
+      jms_listener.respond_to?(:on_receive_message).should be true
     end
   end
 end

data/spec/listener_spec.rb

@@ -1,19 +1,16 @@
 require File.dirname(File.expand_path(__FILE__)) + '/spec_helper.rb'
 
-describe JSparrow::Connection::Listener do
+describe JSparrow::Interactors::Listener do
 
-  subject do
-    create_jms_listener
-  end
+  context 'when inherited and created' do
 
-  context 'When inherited for listening a queue' do
+    subject do
+      new_named_jms_listener
+    end
 
     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
@@ -26,6 +23,8 @@ describe JSparrow::Connection::Listener do
     end
   
     it 'should receive a message' do
+      subject.received_messages.size.should eql 0
+
       send_message_to_listener 'TestQueueListener'
     
       subject.start_listening
@@ -37,4 +36,40 @@ describe JSparrow::Connection::Listener do
       subject.stop_listening
     end
   end
+  
+  context 'when anonymously created' do
+   
+    subject do
+      new_anonymous_jms_listener
+    end
+    
+    it 'should listen to "test_queue" destination' do
+      subject.listen_to_destination.should eql :queue => :test_queue
+    end
+    
+    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
+      subject.received_messages.size.should eql 0
+
+      send_message_to_listener 'anonymous'
+    
+      subject.start_listening
+    
+      sleep 1 # espera um pouquinho pra mensagem ser entregue
+      
+      # verify if message was received
+      subject.received_messages.size.should eql 1
+
+      subject.stop_listening
+    end
+  end
 end

data/spec/messaging_spec.rb

@@ -2,10 +2,10 @@ require File.dirname(File.expand_path(__FILE__)) + '/spec_helper.rb'
 
 describe JSparrow::Messaging do
 
-  context 'When have a Sender and a Receiver for a Queue' do
+  context 'when have a Sender and a Receiver for a Queue' do
   
     before(:all) do
-      @jms_client = create_jms_client
+      @jms_client = new_jms_client
       @jms_client.start
     
       @sender   = @jms_client.queue_sender(:test_queue)
@@ -20,7 +20,7 @@ describe JSparrow::Messaging do
       my_text = 'Mensagem de texto enviada da spec'
     
       @sender.send_text_message(my_text) do |msg|
-        msg.set_string_property('recipient', 'jsparrow-spec')
+        msg.add_criteria_to_reception('recipient', 'jsparrow-spec')
       end
     
       received_text = nil
@@ -37,7 +37,7 @@ describe JSparrow::Messaging do
       my_object << 'Obj1 enviado da spec'
     
       @sender.send_object_message(my_object) do |msg|
-        msg.set_string_property('recipient', 'jsparrow-spec')
+        msg.add_criteria_to_reception('recipient', 'jsparrow-spec')
       end
     
       received_object = nil
@@ -53,7 +53,7 @@ describe JSparrow::Messaging do
       my_id_long = 1234567
     
       @sender.send_map_message do |msg|
-        msg.set_string_property('recipient', 'jsparrow-spec')
+        msg.add_criteria_to_reception('recipient', 'jsparrow-spec')
         msg.set_long('id', my_id_long)
       end
     
@@ -70,7 +70,7 @@ describe JSparrow::Messaging do
     my_text = 'Mensagem de texto enviada da spec'
   
     @sender.send_text_message(my_text) do |msg|
-      msg.set_string_property('recipient', 'jsparrow-spec')
+      msg.add_criteria_to_reception('recipient', 'jsparrow-spec')
     end
   
     received_text = nil
@@ -93,17 +93,17 @@ describe JSparrow::Messaging do
       @sender.send_messages do |session, producer|
         #--- TextMessage
         text_message = session.create_text_message(my_text)
-        text_message.set_string_property('recipient', 'jsparrow-spec')
+        text_message.add_criteria_to_reception('recipient', 'jsparrow-spec')
         producer.send(text_message)
       
         #--- objectMessage
         object_message = session.create_object_message(my_object)
-        object_message.set_string_property('recipient', 'jsparrow-spec')
+        object_message.add_criteria_to_reception('recipient', 'jsparrow-spec')
         producer.send(object_message)
       
         #--- MapMessage
         map_message = session.create_map_message
-        map_message.set_string_property('recipient', 'jsparrow-spec')
+        map_message.add_criteria_to_reception('recipient', 'jsparrow-spec')
         map_message.set_long('id', my_id_long)
         producer.send(map_message)
       

data/spec/spec_helper.rb

@@ -4,18 +4,18 @@ require 'spec'
 require File.dirname(File.expand_path(__FILE__)) + '/../lib/jsparrow.rb'
 
 #
-# Modulo com metodos uteis para as specs.
+# Helper methods for specs.
 #
 module JSparrowHelperMethods
 
   def configure_connection
     JSparrow::Connection.configure do
       use_jms_client_jar '/opt/openjms/lib/openjms-0.7.7-beta-1.jar'
-
+ 
       use_jndi_properties :initial_context_factory => 'org.exolab.jms.jndi.InitialContextFactory',
-                          :provider_url            => 'tcp://localhost:3035'
-                        # :security_principal      => 'user',
-                        # :security_credentials    => 'password'
+                          :provider_url => 'tcp://localhost:3035'
+                        # :security_principal => 'user',
+                        # :security_credentials => 'password'
       
       enable_connection_factories :queue_connection_factory => 'ConnectionFactory', 
                                   :topic_connection_factory => 'ConnectionFactory'
@@ -26,27 +26,43 @@ module JSparrowHelperMethods
     end
   end
 
-  def create_jms_client
+  def new_jms_client
     configure_connection
     
-    JSparrow::Connection.new_client
+    new_jsparrow_client
   end
   
-  def create_jms_listener
+  def new_named_jms_listener
     configure_connection
     
-    JSparrow::Connection.new_listener :as => JSparrowHelperClasses::TestQueueListener
+    new_jsparrow_listener :as => JSparrowHelperClasses::TestQueueListener
+  end
+  
+  def new_anonymous_jms_listener
+    listener = new_jsparrow_listener(
+        :listen_to => { :queue => :test_queue },
+        :receive_only_in_criteria => { :selector => "recipient = 'jsparrow-spec' and to_listener = 'anonymous'" }
+      ) do |received_message|
+        
+      received_messages << received_message
+    end
+    
+    def listener.received_messages
+      @received_messages ||= []
+    end
+    
+    listener
   end
   
   def send_message_to_listener(listener_name)
-    @jms_client = create_jms_client
+    @jms_client = new_jms_client
     @jms_client.start
     
-    my_text = 'Mensagem de texto enviada da spec para o listener TestQueueListener'
+    my_text = "Mensagem de texto enviada da spec para o listener #{listener_name}"
     
     @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)
+      msg.add_criteria_to_reception('recipient',   'jsparrow-spec')
+      msg.add_criteria_to_reception('to_listener', listener_name)
     end
 
     @jms_client.stop
@@ -54,11 +70,10 @@ module JSparrowHelperMethods
 end
 
 module JSparrowHelperClasses
-  
   #
-  # Listener da queue TestQueue
+  # Listener for test against "TestQueue" queue
   #
-  class TestQueueListener < JSparrow::Connection::Listener
+  class TestQueueListener < JSparrow::Interactors::Listener
     listen_to :queue => :test_queue
   
     receive_only_in_criteria :selector => "recipient = 'jsparrow-spec' and to_listener = 'TestQueueListener'"
@@ -72,12 +87,13 @@ module JSparrowHelperClasses
     end
   
     def on_receive_message(received_message)
-      @received_messages << received_messages
+      @received_messages << received_message
     end
   end
 end
+
 #
-# Enriquece a classe Spec::Example::ExampleGroup com o helper.
+# Some steroids for Spec::Example::ExampleGroup.
 #
 class Spec::Example::ExampleGroup
   include JSparrowHelperMethods