activemessaging 0.6.1 → 0.7.1

data/README

@@ -0,0 +1,22 @@
+ActiveMessaging is an attempt to bring the simplicity and elegance of rails development to the world of messaging. Messaging, (or event-driven architecture) is widely used for enterprise integration, with frameworks such as Java's JMS, and products such as ActiveMQ, Tibco, IBM MQSeries, etc.
+
+ActiveMessaging is a generic framework to ease using messaging, but is not tied to any particular messaging system - in fact, it now has support for Stomp, Amazon Simple Queue Service (SQS), Beanstalk, JMS (using StompConnect or [JMSWithJRuby direct on JRuby]), WebSphere MQ, and the all-Ruby ReliableMessaging.
+
+Here's a sample of a processor class that handles incoming messages:
+
+    class HelloWorldProcessor < ActiveMessaging::Processor
+
+    subscribes_to :hello_world
+
+    def on_message(message)
+    puts "received: " + message
+    end
+
+    end
+
+
+h1. Support
+
+Best bet is the google groups mailing list:
+
+http://groups.google.com/group/activemessaging-discuss

data/Rakefile

@@ -19,32 +19,54 @@ task :rdoc do
   RDoc::RDoc.new.document(%w(--line-numbers --inline-source --title ActiveMessaging README lib))
 end
 
-gem_spec = Gem::Specification.new do |s|
-  s.name = %q{activemessaging}
-  s.version = "0.6.1"
-
-  s.specification_version = 2 if s.respond_to? :specification_version=
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["jon.tirsen", "kookster", "olle.jonsson", "sylvain.perez", "anti.god.botherer", 'uwe.kubosch']
-  s.date = %q{2008-08-15}
-  s.description = %q{ActiveMessaging is an attempt to bring the simplicity and elegance of rails development to the world of messaging. Messaging, (or event-driven architecture) is widely used for enterprise integration, with frameworks such as Java's JMS, and products such as ActiveMQ, Tibco, IBM MQSeries, etc.}
-  s.email = %q{activemessaging-discuss@googlegroups.com}
-  s.files = FileList['generators/**/*', 'lib/**/*', 'tasks/**/*', 'Rakefile', 'messaging.rb.example'].to_a
-  s.homepage = %q{http://code.google.com/p/activemessaging/}
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.2.0}
-  s.summary = %q{ActiveMessaging is an attempt to bring the simplicity and elegance of rails development to the world of messaging. Messaging, (or event-driven architecture) is widely used for enterprise integration, with frameworks such as Java's JMS, and products such as ActiveMQ, Tibco, IBM MQSeries, etc.}
-  #s.test_files = ["test"]
-  #s.autorequire = 'activemessaging'
-  s.has_rdoc = true
-
-  s.add_dependency(%q<activesupport>, [">= 1.0.0"])
-  s.add_dependency(%q<rubigen>, [">= 1.5.2"])
-  #s.add_dependency(%q<common-pool-cliffmoon>, [">= 0.0.3"])
-end
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    
+    # basic
+    gemspec.name = "activemessaging"
+    gemspec.summary = "Official activemessaging gem, now hosted on github.com/kookster. (kookster prefix temporary)"
+    gemspec.description = "ActiveMessaging is an attempt to bring the simplicity and elegance of rails development to the world of messaging. Messaging, (or event-driven architecture) is widely used for enterprise integration, with frameworks such as Java's JMS, and products such as ActiveMQ, Tibco, IBM MQSeries, etc."
+    gemspec.email = "activemessaging-discuss@googlegroups.com"
+    gemspec.homepage = "http://github.com/kookster/activemessaging"
+    gemspec.authors = ["Jon Tirsen", "Andrew Kuklewicz", "Olle Jonsson", "Sylvain Perez", "Cliff Moon", 'Uwe Kubosch']
 
-desc 'Generate ActiveMessaging gem.'
-Rake::GemPackageTask.new(gem_spec) do |pkg|
+    # added
+    gemspec.add_dependency('activesupport', '>= 1.0.0')
+    
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
 end
 
+
+# gem_spec = Gem::Specification.new do |s|
+#   s.name = %q{activemessaging}
+#   s.version = "0.6.1"
+# 
+#   s.specification_version = 2 if s.respond_to? :specification_version=
+# 
+#   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+#   s.authors = ["jon.tirsen", "kookster", "olle.jonsson", "sylvain.perez", "anti.god.botherer", 'uwe.kubosch']
+#   s.date = %q{2008-08-15}
+#   s.description = %q{ActiveMessaging is an attempt to bring the simplicity and elegance of rails development to the world of messaging. Messaging, (or event-driven architecture) is widely used for enterprise integration, with frameworks such as Java's JMS, and products such as ActiveMQ, Tibco, IBM MQSeries, etc.}
+#   s.email = %q{activemessaging-discuss@googlegroups.com}
+#   s.files = FileList['generators/**/*', 'lib/**/*', 'tasks/**/*', 'Rakefile', 'messaging.rb.example'].to_a
+#   s.homepage = %q{http://code.google.com/p/activemessaging/}
+#   s.require_paths = ["lib"]
+#   s.rubygems_version = %q{1.2.0}
+#   s.summary = %q{ActiveMessaging is an attempt to bring the simplicity and elegance of rails development to the world of messaging. Messaging, (or event-driven architecture) is widely used for enterprise integration, with frameworks such as Java's JMS, and products such as ActiveMQ, Tibco, IBM MQSeries, etc.}
+#   #s.test_files = ["test"]
+#   #s.autorequire = 'activemessaging'
+#   s.has_rdoc = true
+# 
+#   s.add_dependency(%q<activesupport>, [">= 1.0.0"])
+#   s.add_dependency(%q<rubigen>, [">= 1.5.2"])
+#   #s.add_dependency(%q<common-pool-cliffmoon>, [">= 0.0.3"])
+# end
+
+# desc 'Generate ActiveMessaging gem.'
+# Rake::GemPackageTask.new(gem_spec) do |pkg|
+# end
+

data/VERSION

@@ -0,0 +1 @@
+0.7.1

data/activemessaging.gemspec

@@ -0,0 +1,113 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{activemessaging}
+  s.version = "0.7.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jon Tirsen", "Andrew Kuklewicz", "Olle Jonsson", "Sylvain Perez", "Cliff Moon", "Uwe Kubosch"]
+  s.date = %q{2010-04-08}
+  s.description = %q{ActiveMessaging is an attempt to bring the simplicity and elegance of rails development to the world of messaging. Messaging, (or event-driven architecture) is widely used for enterprise integration, with frameworks such as Java's JMS, and products such as ActiveMQ, Tibco, IBM MQSeries, etc.}
+  s.email = %q{activemessaging-discuss@googlegroups.com}
+  s.extra_rdoc_files = [
+    "README"
+  ]
+  s.files = [
+    "README",
+     "Rakefile",
+     "VERSION",
+     "activemessaging.gemspec",
+     "generators/a13g_test_harness/a13g_test_harness_generator.rb",
+     "generators/a13g_test_harness/templates/active_messaging_test.rhtml",
+     "generators/a13g_test_harness/templates/active_messaging_test_controller.rb",
+     "generators/a13g_test_harness/templates/index.rhtml",
+     "generators/filter/USAGE",
+     "generators/filter/filter_generator.rb",
+     "generators/filter/templates/filter.rb",
+     "generators/filter/templates/filter_test.rb",
+     "generators/processor/USAGE",
+     "generators/processor/processor_generator.rb",
+     "generators/processor/templates/application.rb",
+     "generators/processor/templates/broker.yml",
+     "generators/processor/templates/jruby_poller",
+     "generators/processor/templates/messaging.rb",
+     "generators/processor/templates/poller",
+     "generators/processor/templates/poller.rb",
+     "generators/processor/templates/processor.rb",
+     "generators/processor/templates/processor_test.rb",
+     "generators/tracer/USAGE",
+     "generators/tracer/templates/controller.rb",
+     "generators/tracer/templates/helper.rb",
+     "generators/tracer/templates/index.rhtml",
+     "generators/tracer/templates/layout.rhtml",
+     "generators/tracer/templates/trace_processor.rb",
+     "generators/tracer/tracer_generator.rb",
+     "init.rb",
+     "lib/activemessaging.rb",
+     "lib/activemessaging/adapter.rb",
+     "lib/activemessaging/adapters/asqs.rb",
+     "lib/activemessaging/adapters/base.rb",
+     "lib/activemessaging/adapters/beanstalk.rb",
+     "lib/activemessaging/adapters/jms.rb",
+     "lib/activemessaging/adapters/reliable_msg.rb",
+     "lib/activemessaging/adapters/stomp.rb",
+     "lib/activemessaging/adapters/test.rb",
+     "lib/activemessaging/adapters/wmq.rb",
+     "lib/activemessaging/base_message.rb",
+     "lib/activemessaging/filter.rb",
+     "lib/activemessaging/gateway.rb",
+     "lib/activemessaging/message_sender.rb",
+     "lib/activemessaging/named_base.rb",
+     "lib/activemessaging/processor.rb",
+     "lib/activemessaging/support.rb",
+     "lib/activemessaging/test_helper.rb",
+     "lib/activemessaging/trace_filter.rb",
+     "poller.rb",
+     "tasks/start_consumers.rake",
+     "test/all_tests.rb",
+     "test/app/config/broker.yml",
+     "test/asqs_test.rb",
+     "test/config_test.rb",
+     "test/filter_test.rb",
+     "test/gateway_test.rb",
+     "test/jms_test.rb",
+     "test/reliable_msg_test.rb",
+     "test/stomp_test.rb",
+     "test/test_helper.rb",
+     "test/tracer_test.rb"
+  ]
+  s.homepage = %q{http://github.com/kookster/activemessaging}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Official activemessaging gem, now hosted on github.com/kookster. (kookster prefix temporary)}
+  s.test_files = [
+    "test/all_tests.rb",
+     "test/asqs_test.rb",
+     "test/config_test.rb",
+     "test/filter_test.rb",
+     "test/gateway_test.rb",
+     "test/jms_test.rb",
+     "test/reliable_msg_test.rb",
+     "test/stomp_test.rb",
+     "test/test_helper.rb",
+     "test/tracer_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 1.0.0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 1.0.0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 1.0.0"])
+  end
+end
+

data/generators/filter/templates/filter_test.rb

@@ -20,7 +20,7 @@ class <%= class_name %>FilterTest < Test::Unit::TestCase
   end  
 
   def test_<%= file_name %>_filter
-    @message = ActiveMessaging::TestMessage.new(@destination.value, {'message-id'=>'test-message-id-header'}, 'message body')
+    @message = ActiveMessaging::TestMessage.new('message body', {'message-id'=>'test-message-id-header'}, @destination.value )
     @routing = {:direction=>:incoming, :destination=>@destination}
     @filter.process(@message, @routing)
   end

data/generators/processor/templates/broker.yml

@@ -27,13 +27,14 @@ development:
     # If error still occurs after retryMax, send message to specified dead letter queue
     # deadLetterQueue: '/queue/activemessaging/deadletter'
 
+    ################################
+    # Beanstalk Adapter Properties #
+    ################################
+    # adapter: beanstalk
+    # host: localhost
 
-    ###################################
-    # Websphere MQ Adapter Properties #
-    ###################################
-    # adapter: wmq
-    # q_mgr_name: ""
-    # poll_interval: .1
+    ## properties below are all defaults for this adapter
+    # port: 11300
 
 
     #################################
@@ -61,8 +62,18 @@ development:
 
     ## properties below are all defaults for this adapter
     # poll_interval: 1
-    # reliable: true    
+    # reliable: true
+
+
+    ###################################
+    # Websphere MQ Adapter Properties #
+    ###################################
+    # adapter: wmq
+    # q_mgr_name: ""
+    # poll_interval: .1
+
 
+    
 test:
     adapter: test
     reliable: false

data/init.rb

@@ -0,0 +1,3 @@
+require 'active_support'
+require 'ostruct'
+require 'activemessaging'

data/lib/activemessaging.rb

@@ -1,5 +1,4 @@
 module ActiveMessaging
-  VERSION  = "0.6.1"
   APP_ROOT = ENV['APP_ROOT'] || ENV['RAILS_ROOT'] || ((defined? RAILS_ROOT) && RAILS_ROOT) || File.dirname($0)
   APP_ENV  = ENV['APP_ENV']  || ENV['RAILS_ENV']  || 'development'
   ROOT     = File.expand_path(File.join(File.dirname(__FILE__), '..'))
@@ -49,9 +48,7 @@ module ActiveMessaging
   end
 
   def self.load_config
-    p APP_ROOT
     path = File.expand_path("#{APP_ROOT}/config/messaging.rb")
-    p path
     begin
       load path
     rescue MissingSourceFile

data/lib/activemessaging/adapters/asqs.rb

@@ -1,22 +1,22 @@
 require 'rubygems'
 require 'net/http'
+require 'net/https'
 require 'openssl'
 require 'base64'
 require 'cgi'
 require 'time'
-require 'activemessaging/adapter'
+require 'uri'
+
+require 'activemessaging/adapters/base'
 
 module ActiveMessaging
   module Adapters
-    module AmazonSQS
-
-      class Connection
-        include ActiveMessaging::Adapter
+    module AmazonSqs
 
+      class Connection < ActiveMessaging::Adapters::BaseConnection
         register :asqs
 
         QUEUE_NAME_LENGTH = 1..80
-        # MESSAGE_SIZE = 1..(256 * 1024)
         MESSAGE_SIZE = 1..(8 * 1024)
         VISIBILITY_TIMEOUT = 0..(24 * 60 * 60)
         NUMBER_OF_MESSAGES = 1..255
@@ -24,37 +24,38 @@ module ActiveMessaging
         SET_QUEUE_ATTRIBUTES = ['VisibilityTimeout']
 
         #configurable params
-        attr_accessor :reliable, :reconnectDelay, :access_key_id, :secret_access_key, :aws_version, :content_type, :host, :port, :poll_interval, :cache_queue_list
-        
+        attr_accessor :reconnectDelay, :access_key_id, :secret_access_key, :aws_version, :content_type, :host, :port, :poll_interval, :cache_queue_list
+      
         #generic init method needed by a13g
         def initialize cfg
-            raise "Must specify a access_key_id" if (cfg[:access_key_id].nil? || cfg[:access_key_id].empty?)
-            raise "Must specify a secret_access_key" if (cfg[:secret_access_key].nil? || cfg[:secret_access_key].empty?)
-
-            @access_key_id=cfg[:access_key_id]
-            @secret_access_key=cfg[:secret_access_key]
-            @request_expires = cfg[:requestExpires]         || 10
-            @request_retry_count = cfg[:requestRetryCount]  || 5
-            @aws_version = cfg[:aws_version]                || '2008-01-01'
-            @content_type = cfg[:content_type]              || 'text/plain'
-            @host = cfg[:host]                              || 'queue.amazonaws.com'
-            @port = cfg[:port]                              || 80
-            @protocol = cfg[:protocol]                      || 'http'
-            @poll_interval = cfg[:poll_interval]            || 1
-            @reconnect_delay = cfg[:reconnectDelay]         || 5
-            @aws_url="#{@protocol}://#{@host}"
-
-            @cache_queue_list = cfg[:cache_queue_list].nil? ? true : cfg[:cache_queue_list]
-            @reliable =         cfg[:reliable].nil?         ? true : cfg[:reliable]
-            
-            #initialize the subscriptions and queues
-            @subscriptions = {}
-            @current_subscription = 0
-            queues
+          raise "Must specify a access_key_id" if (cfg[:access_key_id].nil? || cfg[:access_key_id].empty?)
+          raise "Must specify a secret_access_key" if (cfg[:secret_access_key].nil? || cfg[:secret_access_key].empty?)
+
+          @access_key_id=cfg[:access_key_id]
+          @secret_access_key=cfg[:secret_access_key]
+          @request_expires = cfg[:requestExpires]         || 10
+          @request_retry_count = cfg[:requestRetryCount]  || 5
+          @aws_version = cfg[:aws_version]                || '2008-01-01'
+          @content_type = cfg[:content_type]              || 'text/plain'
+          @host = cfg[:host]                              || 'queue.amazonaws.com'
+          @port = cfg[:port]                              || 80
+          @protocol = cfg[:protocol]                      || 'http'
+          @poll_interval = cfg[:poll_interval]            || 1
+          @reconnect_delay = cfg[:reconnectDelay]         || 5
+          @aws_url="#{@protocol}://#{@host}"
+
+          @cache_queue_list = cfg[:cache_queue_list].nil? ? true : cfg[:cache_queue_list]
+          @reliable =         cfg[:reliable].nil?         ? true : cfg[:reliable]
+        
+          #initialize the subscriptions and queues
+          @subscriptions = {}
+          @current_subscription = 0
+          queues
         end
 
         def disconnect
           #it's an http request - there is no disconnect - ha!
+          return true
         end
 
         # queue_name string, headers hash
@@ -108,18 +109,18 @@ module ActiveMessaging
           begin
             delete_message message
           rescue Object=>exception
-            logger.error "Exception in ActiveMessaging::Adapters::AmazonSQS::Connection.received() logged and ignored: "
+            logger.error "Exception in ActiveMessaging::Adapters::AmazonSWS::Connection.received() logged and ignored: "
             logger.error exception
           end
         end
 
+        # do nothing; by not deleting the message will eventually become visible again
         def unreceive message, headers={}
-          # do nothing; by not deleting the message will eventually become visible again
           return true
         end
-        
+      
         protected
-        
+      
         def create_queue(name)
           validate_new_queue name
       		response = make_request('CreateQueue', nil, {'QueueName'=>name})
@@ -137,7 +138,7 @@ module ActiveMessaging
       		response = make_request('ListQueues', nil, params)
           response.nil? ? [] : response.nodes("//QueueUrl").collect{ |n| add_queue(n.text) }
         end
-        
+      
         def get_queue_attributes(queue, attribute='All')
           validate_get_queue_attribute(attribute)
           params = {'AttributeName'=>attribute}
@@ -185,7 +186,7 @@ module ActiveMessaging
           response = make_request('ReceiveMessage', "#{queue.queue_url}", params)
           response.nodes("//Message").collect{ |n| Message.from_element n, response, queue } unless response.nil?
         end
-        
+      
         def delete_message message
           response = make_request('DeleteMessage', "#{message.queue.queue_url}", {'ReceiptHandle'=>message.receipt_handle})
         end
@@ -193,7 +194,7 @@ module ActiveMessaging
       	def make_request(action, url=nil, params = {})
           # puts "make_request a=#{action} u=#{url} p=#{params}"
       	  url ||= @aws_url
-      	  
+    	  
       		# Add Actions
       		params['Action'] = action
       		params['Version'] = @aws_version
@@ -238,14 +239,22 @@ module ActiveMessaging
           return Net::HTTP.start(h, p){ |http| http.request(r) }
         end
 
+        def http_request h, p, r
+          http = Net::HTTP.new(h, p)
+          http.use_ssl = true if "https" == @protocol
+          # Don't carp about SSL cert verification
+          http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+          return http.request(r)
+        end
+
         def check_errors(response)
           raise "http response was nil" if (response.nil?)
           raise response.errors if (response && response.errors?)
           response
         end
-        
+      
         private
-        
+      
         # internal data structure methods
         def add_queue(url)
           q = Queue.from_url url
@@ -300,19 +309,18 @@ module ActiveMessaging
         def validate_number_of_messages nom
           raise "Number of messages, #{nom}, must be between #{NUMBER_OF_MESSAGES.min} and #{NUMBER_OF_MESSAGES.max}." unless NUMBER_OF_MESSAGES.include?(nom)
         end
-
       end
 
       class SQSResponse
         attr_accessor :headers, :doc, :http_response
-        
+      
         def initialize response
           # puts "response.body = #{response.body}"
           @http_response = response
           @headers = response.to_hash()
           @doc = REXML::Document.new(response.body)
         end
-      
+    
         def message_type
           return doc ? doc.root.name : ''
         end
@@ -335,16 +343,16 @@ module ActiveMessaging
 
           return msg
         end
-      
+    
         def get_text(xpath,default='')
           e = REXML::XPath.first( doc, xpath)
           e.nil? ? default : e.text
         end
-      
+    
         def each_node(xp)
           REXML::XPath.each(doc.root, xp) {|n| yield n}
         end
-      
+    
         def nodes(xp)
           doc.elements.to_a(xp)
         end
@@ -352,11 +360,11 @@ module ActiveMessaging
 
       class Subscription
         attr_accessor :name, :headers, :count
-        
+      
         def initialize(destination, headers={}, count=1)
           @destination, @headers, @count = destination, headers, count
         end
-        
+      
         def add
           @count += 1
         end
@@ -364,15 +372,16 @@ module ActiveMessaging
         def remove
           @count -= 1
         end
-
       end
 
       class Queue
         attr_accessor :name, :pathinfo, :domain, :visibility_timeout
 
         def self.from_url url
-          return Queue.new($2,$1) if (url =~ /^http:\/\/(.+)\/([-a-zA-Z0-9_]+)$/)
-          raise "Bad Queue URL: #{url}"
+          u = URI.parse(url)
+          name = u.path.gsub(/\//, "")
+          domain  = u.host
+          return Queue.new(name,domain) 
         end
 
         def queue_url
@@ -389,21 +398,20 @@ module ActiveMessaging
       end
 
       # based on stomp message, has pointer to the SQSResponseObject
-      class Message
-        attr_accessor :headers, :id, :body, :command, :response, :queue, :md5_of_body, :receipt_handle
-        
+      class Message < ActiveMessaging::BaseMessage
+        attr_accessor :response, :queue, :md5_of_body, :receipt_handle
+      
         def self.from_element e, response, queue
-          Message.new(response.headers, e.elements['MessageId'].text, e.elements['Body'].text, e.elements['MD5OfBody'].text, e.elements['ReceiptHandle'].text, response, queue)
+          Message.new(e.elements['Body'].text, response.headers, e.elements['MessageId'].text, e.elements['MD5OfBody'].text, e.elements['ReceiptHandle'].text, response, queue)
         end
-      
-        def initialize headers, id, body, md5_of_body, receipt_handle, response, queue, command='MESSAGE'
-          @headers, @id, @body, @md5_of_body, @receipt_handle, @response, @queue, @command =  headers, id, body, md5_of_body, receipt_handle, response, queue, command
-          headers['destination'] = queue.name
+    
+        def initialize body, headers, id, md5_of_body, receipt_handle, response, queue
+          super(body, id, headers, queue.name)
+          @md5_of_body, @receipt_handle, @response, @queue =  md5_of_body, receipt_handle, response, queue
         end
 
-      
         def to_s
-          "<AmazonSQS::Message id='#{id}' body='#{body}' headers='#{headers.inspect}' command='#{command}' response='#{response}'>"
+          "<AmazonSQS::Message id='#{id}' body='#{body}' headers='#{headers.inspect}' response='#{response}'>"
         end
       end