activemessaging 0.8.2 → 0.9.0

data/VERSION

@@ -1 +1 @@
-0.8.2
+0.9.0

data/activemessaging.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{activemessaging}
-  s.version = "0.8.2"
+  s.version = "0.9.0"
 
   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{2011-08-15}
+  s.date = %q{2011-12-05}
   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. Now supporting Rails 3 as of version 0.8.0.}
   s.email = %q{activemessaging-discuss@googlegroups.com}
   s.extra_rdoc_files = [
@@ -67,6 +67,18 @@ Gem::Specification.new do |s|
     "lib/activemessaging/railtie.rb",
     "lib/activemessaging/test_helper.rb",
     "lib/activemessaging/trace_filter.rb",
+    "lib/generators/active_messaging/install/USAGE",
+    "lib/generators/active_messaging/install/install_generator.rb",
+    "lib/generators/active_messaging/install/templates/application_processor.rb",
+    "lib/generators/active_messaging/install/templates/broker.yml",
+    "lib/generators/active_messaging/install/templates/poller",
+    "lib/generators/active_messaging/install/templates/poller.rb",
+    "lib/generators/active_messaging/processor/USAGE",
+    "lib/generators/active_messaging/processor/processor_generator.rb",
+    "lib/generators/active_messaging/processor/templates/messaging.rb",
+    "lib/generators/active_messaging/processor/templates/processor.rb",
+    "lib/generators/active_messaging/processor/templates/processor_spec.rb",
+    "lib/generators/active_messaging/processor/templates/processor_test.rb",
     "lib/tasks/start_consumers.rake",
     "poller.rb",
     "test/all_tests.rb",

data/lib/activemessaging.rb

@@ -126,3 +126,7 @@ module ActiveMessaging
   end
 
 end
+
+if !defined?(Rails::Railtie)
+  ActiveMessaging.load_activemessaging
+end

data/lib/activemessaging/adapters/jms.rb

@@ -1,10 +1,13 @@
-
 if defined?(JRUBY_VERSION)
 #require 'java'
 include Java
 
-import javax.naming.InitialContext
-import javax.jms.MessageListener
+begin
+  java_import javax.naming.InitialContext
+  java_import javax.jms.MessageListener
+rescue NameError
+  raise LoadError, "ActiveMessaging::Adapter::Jms needs Jave EE classes on the CLASSPATH"
+end
 
 module ActiveMessaging
   module Adapters

data/lib/activemessaging/adapters/stomp.rb

@@ -20,7 +20,7 @@ module ActiveMessaging
           cfg[:passcode] ||= ""
           cfg[:host] ||= "localhost"
           cfg[:port] ||= "61613"
-          cfg[:reliable]  = cfg[:reliable].nil? ? TRUE : cfg[:reliable].nil?
+          cfg[:reliable]  = cfg[:reliable].nil? ? TRUE : cfg[:reliable]
           cfg[:reconnectDelay] ||= 5
           cfg[:clientId] ||= nil
 

data/lib/activemessaging/railtie.rb

@@ -11,7 +11,7 @@ module ActiveMessaging
       
       if defined? Rails
         ActiveMessaging.logger.info "ActiveMessaging: Rails available: Adding dispatcher prepare callback."
-        ActionDispatch::Callbacks.to_prepare :activemessaging do
+        ActionDispatch::Callbacks.to_prepare do
           ActiveMessaging.reload_activemessaging
         end
       end

data/lib/generators/active_messaging/install/USAGE

@@ -0,0 +1,21 @@
+Description:
+    Configures your application to use active messaging. The following files are installed:
+    1. config/broker.yml - Configures the broker that you will be using. 
+    2. script/poller - This script will start/stop/run the process that will be polling your broker. The name of this file/process is configurable. See Usage below. 
+    3. lib/poller.rb - The poller script will use this file to start up ActiveMesssaging
+  
+    The generator will also create a app/processors directory and modify your application.rb so that app/processors is in the autoload path
+
+Usage:
+    If you do not pass in an argument then the poller filename/process will be called poller. You can override this default by passing in the name that you want the file and process to be. 
+  
+Examples:
+    rails g activemessaging:install
+  
+      Installs activemessaging with the poller process named poller
+
+    rails g activemessaging:install POLLER_NAME
+  
+      Installs activemessaging but allows you to customize the name of the poller
+      
+      

data/lib/generators/active_messaging/install/install_generator.rb

@@ -0,0 +1,34 @@
+module ActiveMessaging
+  class InstallGenerator < Rails::Generators::Base
+    source_root File.expand_path("../templates", __FILE__)
+    
+    argument :poller_name, :type => :string, :default => 'poller', :banner => 'poller_name'
+
+    def copy_application
+      copy_file "application_processor.rb", "app/processors/application_processor.rb"
+    end
+    
+    def copy_poller
+      template "poller", "script/#{poller_name}"
+      chmod("script/#{poller_name}", 0755)
+    end
+    
+    def copy_poller_rb
+      copy_file "poller.rb", "lib/#{poller_name}.rb"
+    end
+    
+    def copy_broker_rb
+      copy_file "broker.yml", "config/broker.yml"
+    end
+    
+    def add_gems
+      gem("daemons")
+    end
+    
+   
+    def change_application
+      application '  config.autoload_paths += %W(#{config.root}/app/processors)'
+    end
+    
+  end
+end

data/lib/generators/active_messaging/install/templates/application_processor.rb

@@ -0,0 +1,18 @@
+class ApplicationProcessor < ActiveMessaging::Processor
+  
+  # Default on_error implementation - logs standard errors but keeps processing. Other exceptions are raised.
+  # Have on_error throw ActiveMessaging::AbortMessageException when you want a message to be aborted/rolled back,
+  # meaning that it can and should be retried (idempotency matters here).
+  # Retry logic varies by broker - see individual adapter code and docs for how it will be treated
+  def on_error(err)
+    if (err.kind_of?(StandardError))
+      logger.error "ApplicationProcessor::on_error: #{err.class.name} rescued:\n" + \
+      err.message + "\n" + \
+      "\t" + err.backtrace.join("\n\t")
+    else
+      logger.error "ApplicationProcessor::on_error: #{err.class.name} raised: " + err.message
+      raise err
+    end
+  end
+
+end

data/lib/generators/active_messaging/install/templates/broker.yml

@@ -0,0 +1,139 @@
+#
+# broker.yml
+#
+# Simple yaml file for the env specific configuration of the broker connections.
+# See the wiki for more information: http://code.google.com/p/activemessaging/wiki/Configuration
+#
+development:
+    ############################
+    # Stomp Adapter Properties #
+    ############################
+    adapter: stomp
+
+    # properties below are all defaults for this adapter
+    # login: ""
+    # passcode: ""
+    # host: localhost
+    # port: 61613
+    # reliable: true
+    # reconnectDelay: 5
+
+    # NEW! enable stomp retry logic
+    #  will resend errored out messages to be retried when on_error throws ActiveMessaging::AbortMessageException
+    #
+    # Max number of times to retry an aborted message, for 0, will not retry (default)
+    # retryMax: 0
+    #
+    # If error still occurs after retryMax, send message to specified dead letter queue
+    # deadLetterQueue: '/queue/activemessaging/deadletter'
+
+    
+    ###########################
+    # AMQP Adapter Properties #    
+    ###########################
+    # adapter: amqp
+ 
+    # properties below are defaults for this adapter
+    # host: localhost
+    # port: 5672
+    # user: guest
+    # pass: guest
+    # vhost: /
+    # ssl: false
+    # ssl_verify: 1  
+    # debug: 0
+    # queue_name: <autogenerated>
+    # queue_durable: false if queue_name is autogenerated, defaults to true otherwise
+    # queue_auto_delete: true if queue_name is autogenerated, defaults to false otherwise
+    # queue_exclusive: true if queue_name is autogenerated, defaults to true otherwise
+
+    # SSL:
+
+    # in order to use SSL you will need to use the following fork of the carrot project:
+    #
+    #   http://github.com/rabbitt/carrot
+    #
+    # If your certificate is self signed, you will want to set ssl_verify to 0 which corresponds to 
+    # OpenSSL::SSL::VERIFY_NONE. Otherwise, it defaults to 1 (OpenSSL::SSL::VERIFY_PEER).
+   
+    # QUEUE_*:
+
+    # queue_name is the name of the "inbox" queue that will be bound to all subscription keys (called queues
+    # or destinations here). In other words, you only have one queue where all messages end up using this 
+    # adapter, and it is bound to the relevant exchanges using routing keys and exchange information 
+    # you provide in your messages.rb and subscribes_to calls. For example,
+    #
+    # in messages.rb:
+    #   s.queue :hello_world, 'hello.world', :exchange_type => :direct, :exchange_name => 'amq.direct'
+    #
+    # in a processor:
+    #   subscribes_to :hello_world, :routing_key => 'hello.#'
+    # 
+    # in a model:
+    #   publish :hello_world, 'Hello world!', :routing_key => 'hello.world'
+
+   
+    # Note: in the event that you don't specify a routing_key on publish, the queue_name of the specified
+    # destination (as listed in messages.rb) will be used as the routing_key when publishing.
+
+    ################################
+    # Beanstalk Adapter Properties #
+    ################################
+    # adapter: beanstalk
+    # host: localhost
+
+    ## properties below are all defaults for this adapter
+    # port: 11300
+
+
+    #################################
+    # Amazon SQS Adapter Properties #
+    #################################
+    # adapter: asqs
+    # access_key_id: XXXXXXXXXXXXXXXXXXXX
+    # secret_access_key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+
+    ## properties below are all defaults for this adapter
+    # host: queue.amazonaws.com
+    # port: 80
+    # reliable: true
+    # reconnectDelay: 5
+    # aws_version: 2006-04-01 
+    # content_type: text/plain
+    # poll_interval: 1
+    # cache_queue_list: true
+
+
+    ########################################
+    # ReliableMessaging Adapter Properties #
+    ########################################
+    # adapter: reliable_msg
+
+    ## properties below are all defaults for this adapter
+    # poll_interval: 1
+    # reliable: true
+
+
+    ###################################
+    # Websphere MQ Adapter Properties #
+    ###################################
+    # adapter: wmq
+    # q_mgr_name: ""
+    # poll_interval: .1
+
+
+    
+test:
+    adapter: test
+    reliable: false
+
+production:
+    adapter: stomp
+    reliable: true
+    # properties below are all defaults for this adapter
+    # login: ""
+    # passcode: ""
+    # host: localhost
+    # port: 61613
+    # reliable: true
+    # reconnectDelay: 5

data/lib/generators/active_messaging/install/templates/poller

@@ -0,0 +1,24 @@
+#!/usr/bin/env ruby
+
+ENV['APP_ROOT'] ||= File.expand_path(File.join(File.dirname(__FILE__), '..'))
+APP_ROOT = ENV['APP_ROOT']
+script_file = File.join(APP_ROOT, 'lib', '<%=poller_name%>.rb')
+tmp_dir = File.join(APP_ROOT, 'tmp')
+
+require 'rubygems'
+require 'daemons'
+
+
+options = {
+  :app_name   => "<%=poller_name%>",
+  :dir_mode   => :normal,
+  :dir        => tmp_dir,
+  :multiple   => true,
+  :ontop      => false,
+  :mode       => :load,
+  :backtrace  => true,
+  :monitor    => true,
+  :log_output => true
+}
+
+Daemons.run(script_file,options)

data/lib/generators/active_messaging/install/templates/poller.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# Make sure stdout and stderr write out without delay for using with daemon like scripts
+STDOUT.sync = true; STDOUT.flush
+STDERR.sync = true; STDERR.flush
+
+#Try to Load Merb
+merb_init_file = File.expand_path(File.dirname(__FILE__)+'/../config/merb_init')
+if File.exists? merb_init_file
+  require File.expand_path(File.dirname(__FILE__)+'/../config/boot')
+  #need this because of the CWD
+  Merb.root = MERB_ROOT
+  require merb_init_file
+else
+  # Load Rails
+  RAILS_ROOT=File.expand_path(File.join(File.dirname(__FILE__), '..'))
+  require File.join(RAILS_ROOT, 'config', 'boot')
+  require File.join(RAILS_ROOT, 'config', 'environment')
+end
+
+require 'active_support'
+require 'activemessaging'
+
+# Load ActiveMessaging processors
+#ActiveMessaging::load_processors
+
+# Start it up!
+ActiveMessaging::start

data/lib/generators/active_messaging/processor/USAGE

@@ -0,0 +1,2 @@
+Generates a stub ActiveMessaging Processor and associated test. 
+

data/lib/generators/active_messaging/processor/processor_generator.rb

@@ -0,0 +1,39 @@
+module ActiveMessaging
+  class ProcessorGenerator < Rails::Generators::NamedBase
+    # namespace "activemessaging"
+    source_root File.expand_path("../templates", __FILE__)
+
+    # check_class_collision :suffix=>"Processor"
+    
+    def copy_processor
+      template "processor.rb", "app/processors/#{file_name}_processor.rb"
+    end
+    
+    def copy_messaging
+      template "messaging.rb", "config/messaging.rb"
+    end
+    
+    hook_for :test_framework, :as => :active_messaging_processor
+    
+  end
+end
+
+module TestUnit
+  class ActiveMessagingProcessor < Rails::Generators::NamedBase
+    source_root File.expand_path("../templates", __FILE__)
+    
+    def copy_processor
+      template "processor_test.rb", "test/functional/#{file_name}_processor_test.rb"
+    end
+  end
+end
+
+module Rspec
+  class ActiveMessagingProcessor < Rails::Generators::NamedBase
+    source_root File.expand_path("../templates", __FILE__)
+    
+    def copy_processor
+      template "processor_spec.rb", "spec/functional/#{file_name}_processor_spec.rb"
+    end
+  end
+end

data/lib/generators/active_messaging/processor/templates/messaging.rb

@@ -0,0 +1,12 @@
+#
+# Add your destination definitions here
+# can also be used to configure filters, and processor groups
+#
+ActiveMessaging::Gateway.define do |s|
+  #s.destination :orders, '/queue/Orders'
+  #s.filter :some_filter, :only=>:orders
+  #s.processor_group :group1, :order_processor
+  
+  s.destination :<%= singular_name %>, '/queue/<%= class_name %>'
+  
+end

data/lib/generators/active_messaging/processor/templates/processor.rb

@@ -0,0 +1,8 @@
+class <%= class_name %>Processor < ApplicationProcessor
+
+  subscribes_to :<%= singular_name %>
+
+  def on_message(message)
+    logger.debug "<%= class_name %>Processor received: " + message
+  end
+end

data/lib/generators/active_messaging/processor/templates/processor_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'activemessaging/test_helper'
+require File.dirname(__FILE__) + '/../../app/processors/application_processor'
+
+describe <%= class_name %>Processor do
+  
+  include ActiveMessaging::TestHelper
+  
+  before(:each) do
+    load File.dirname(__FILE__) + "/../../app/processors/<%= file_name %>_processor.rb"
+    @processor = <%= class_name %>Processor.new
+  end
+  
+  after(:each) do
+    @processor = nil
+  end
+  
+  it "should receive message" do
+    @processor.on_message('Your test message here!')
+  end
+
+  
+  
+end

data/lib/generators/active_messaging/processor/templates/processor_test.rb

@@ -0,0 +1,20 @@
+require File.dirname(__FILE__) + '/../test_helper'
+require 'activemessaging/test_helper'
+require File.dirname(__FILE__) + '/../../app/processors/application_processor'
+
+class <%= class_name %>ProcessorTest < Test::Unit::TestCase
+  include ActiveMessaging::TestHelper
+  
+  def setup
+    load File.dirname(__FILE__) + "/../../app/processors/<%= file_name %>_processor.rb"
+    @processor = <%= class_name %>Processor.new
+  end
+  
+  def teardown
+    @processor = nil
+  end  
+
+  def test_<%= file_name %>_processor
+    @processor.on_message('Your test message here!')
+  end
+end

metadata

@@ -5,9 +5,9 @@ version: !ruby/object:Gem::Version
   prerelease: 
   segments: 
   - 0
-  - 8
-  - 2
-  version: 0.8.2
+  - 9
+  - 0
+  version: 0.9.0
 platform: ruby
 authors: 
 - Jon Tirsen
@@ -20,7 +20,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-08-15 00:00:00 -04:00
+date: 2011-12-05 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -99,6 +99,18 @@ files:
 - lib/activemessaging/railtie.rb
 - lib/activemessaging/test_helper.rb
 - lib/activemessaging/trace_filter.rb
+- lib/generators/active_messaging/install/USAGE
+- lib/generators/active_messaging/install/install_generator.rb
+- lib/generators/active_messaging/install/templates/application_processor.rb
+- lib/generators/active_messaging/install/templates/broker.yml
+- lib/generators/active_messaging/install/templates/poller
+- lib/generators/active_messaging/install/templates/poller.rb
+- lib/generators/active_messaging/processor/USAGE
+- lib/generators/active_messaging/processor/processor_generator.rb
+- lib/generators/active_messaging/processor/templates/messaging.rb
+- lib/generators/active_messaging/processor/templates/processor.rb
+- lib/generators/active_messaging/processor/templates/processor_spec.rb
+- lib/generators/active_messaging/processor/templates/processor_test.rb
 - lib/tasks/start_consumers.rake
 - poller.rb
 - test/all_tests.rb