RubyGems - activemessaging - Versions diffs - 0.6.0 - Mend

activemessaging 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (46) hide show

data/Rakefile +50 -0
data/generators/a13g_test_harness/a13g_test_harness_generator.rb +19 -0
data/generators/a13g_test_harness/templates/active_messaging_test.rhtml +13 -0
data/generators/a13g_test_harness/templates/active_messaging_test_controller.rb +29 -0
data/generators/a13g_test_harness/templates/index.rhtml +17 -0
data/generators/filter/USAGE +0 -0
data/generators/filter/filter_generator.rb +19 -0
data/generators/filter/templates/filter.rb +12 -0
data/generators/filter/templates/filter_test.rb +28 -0
data/generators/processor/USAGE +8 -0
data/generators/processor/processor_generator.rb +31 -0
data/generators/processor/templates/application.rb +18 -0
data/generators/processor/templates/broker.yml +79 -0
data/generators/processor/templates/jruby_poller +117 -0
data/generators/processor/templates/messaging.rb +12 -0
data/generators/processor/templates/poller +23 -0
data/generators/processor/templates/poller.rb +23 -0
data/generators/processor/templates/processor.rb +8 -0
data/generators/processor/templates/processor_test.rb +20 -0
data/generators/tracer/USAGE +8 -0
data/generators/tracer/templates/controller.rb +14 -0
data/generators/tracer/templates/helper.rb +2 -0
data/generators/tracer/templates/index.rhtml +4 -0
data/generators/tracer/templates/layout.rhtml +16 -0
data/generators/tracer/templates/trace_processor.rb +100 -0
data/generators/tracer/tracer_generator.rb +25 -0
data/lib/activemessaging.rb +133 -0
data/lib/activemessaging/adapter.rb +21 -0
data/lib/activemessaging/adapters/asqs.rb +412 -0
data/lib/activemessaging/adapters/base.rb +82 -0
data/lib/activemessaging/adapters/jms.rb +237 -0
data/lib/activemessaging/adapters/reliable_msg.rb +190 -0
data/lib/activemessaging/adapters/stomp.rb +99 -0
data/lib/activemessaging/adapters/test.rb +155 -0
data/lib/activemessaging/adapters/wmq.rb +202 -0
data/lib/activemessaging/filter.rb +29 -0
data/lib/activemessaging/gateway.rb +422 -0
data/lib/activemessaging/message_sender.rb +30 -0
data/lib/activemessaging/named_base.rb +54 -0
data/lib/activemessaging/processor.rb +45 -0
data/lib/activemessaging/support.rb +17 -0
data/lib/activemessaging/test_helper.rb +194 -0
data/lib/activemessaging/trace_filter.rb +34 -0
data/messaging.rb.example +5 -0
data/tasks/start_consumers.rake +8 -0
metadata +123 -0

data/Rakefile ADDED Viewed

@@ -0,0 +1,50 @@
+require 'rake'
+require 'rake/testtask'
+require 'rdoc/rdoc'
+require 'rake/gempackagetask'
+desc 'Default: run unit tests.'
+task :default => :test
+desc 'Test the ActiveMessaging plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+desc 'Generate documentation for the ActiveMessaging plugin.'
+task :rdoc do
+  rm_rf 'doc'
+  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.0"
+  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/generators/a13g_test_harness/a13g_test_harness_generator.rb ADDED Viewed

@@ -0,0 +1,19 @@
+class A13gTestHarnessGenerator < RubiGen::Base
+  def manifest
+    record do |m|
+      controller_path = 'app/controllers'
+      m.directory controller_path
+      m.file 'active_messaging_test_controller.rb', File.join(controller_path, 'active_messaging_test_controller.rb')
+      view_path = 'app/views/active_messaging_test'
+      m.directory view_path
+      m.file 'index.rhtml', File.join(view_path, 'index.rhtml')
+      view_path = 'app/views/layouts'
+      m.directory view_path
+      m.file 'active_messaging_test.rhtml', File.join(view_path, 'active_messaging_test.rhtml')
+    end
+  end
+end

data/generators/a13g_test_harness/templates/active_messaging_test.rhtml ADDED Viewed

@@ -0,0 +1,13 @@
+<html>
+<head>
+  <title>ActiveMessaging Test Harness: <%= controller.action_name %></title>
+  <%= stylesheet_link_tag 'scaffold' %>
+</head>
+<body>
+<p style="color: green"><%= flash[:notice] %></p>
+<%= yield  %>
+</body>
+</html>

data/generators/a13g_test_harness/templates/active_messaging_test_controller.rb ADDED Viewed

@@ -0,0 +1,29 @@
+class ActiveMessagingTestController < ApplicationController
+  include ActiveMessaging::MessageSender
+  def index
+    @destinations = ActiveMessaging::Gateway.named_destinations.values
+    if request.post?
+      @message = params[:message]
+      if params[:destination].nil? || params[:destination].empty?
+        flash[:notice] = "Please specify a destination."
+        return
+      else
+        @destination = params[:destination].intern
+      end
+      if @message.nil? || @message.empty?
+        flash[:notice] = "Please specify a message."
+        return
+      end
+      puts "#{@destination} : #{@message}"
+      publish @destination, @message
+      flash[:notice] = "'#{@message}' sent to #{@destination}"
+    end
+  end
+end

data/generators/a13g_test_harness/templates/index.rhtml ADDED Viewed

@@ -0,0 +1,17 @@
+<h1>ActiveMessaging Test Harness</h1>
+<% form_tag :action => 'index' do |f| %>
+<p>
+	<label for="destination">Destination:</label><br/>
+	(broker: name => 'destination')<br/>
+	<select name="destination">
+		<option value=""></option>
+		<%= options_from_collection_for_select @destinations, 'name', 'to_s', @destination %>
+	</select>
+</p>
+<p>
+	<label for="message">Message:</label><br/>
+	<%= text_area_tag :message, @message, :size=>'50x10' %>
+</p>
+<%= submit_tag "submit" %>
+<% end -%>

data/generators/filter/USAGE ADDED Viewed

File without changes

data/generators/filter/filter_generator.rb ADDED Viewed

@@ -0,0 +1,19 @@
+class FilterGenerator < RubiGen::Base
+  def manifest
+    record do |m|
+      path = 'app/processors'
+      test_path = 'test/functional'
+      # Check for class naming collisions
+      m.class_collisions class_path, "#{class_name}Controller", "#{class_name}ControllerTest", "#{class_name}Helper"
+      # filter and test directories
+      m.directory File.join(path, class_path)
+      m.directory File.join(test_path, class_path)
+      # filter and test templates
+      m.template 'filter.rb', File.join(path, class_path, "#{file_name}_filter.rb")
+      m.template 'filter_test.rb', File.join(test_path, class_path, "#{file_name}_filter_test.rb")
+    end
+  end
+end

data/generators/filter/templates/filter.rb ADDED Viewed

@@ -0,0 +1,12 @@
+class <%= class_name %>Filter < ActiveMessaging::Filter
+  attr_accessor :options
+  def initialize(options={})
+    @options = options
+  end
+  def process(message, routing)
+    logger.debug "<%= class_name %>Filter filtering message: #{message.inspect} with routing: #{routing.inspect}"
+  end
+end

data/generators/filter/templates/filter_test.rb ADDED Viewed

@@ -0,0 +1,28 @@
+require File.dirname(__FILE__) + '/../test_helper'
+require File.dirname(__FILE__) + '/../../vendor/plugins/activemessaging/lib/activemessaging/test_helper'
+class <%= class_name %>FilterTest < Test::Unit::TestCase
+  include ActiveMessaging::TestHelper
+  def setup
+    # if you want to write code to tests against the filter directly
+    load File.dirname(__FILE__) + "/../../app/processors/<%= file_name %>_filter.rb"
+    @options = {:direction=>:incoming, :only=>:<%= file_name %>_test}
+    @filter = <%= class_name %>Filter.new(@options)
+    @destination = ActiveMessaging::Gateway.destination :<%= file_name %>_test, '/queue/<%= file_name %>.test.queue'
+  end
+  def teardown
+    ActiveMessaging::Gateway.reset
+    @filter = nil
+    @destination = nil
+    @options = nil
+  end
+  def test_<%= file_name %>_filter
+    @message = ActiveMessaging::TestMessage.new(@destination.value, {'message-id'=>'test-message-id-header'}, 'message body')
+    @routing = {:direction=>:incoming, :destination=>@destination}
+    @filter.process(@message, @routing)
+  end
+end

data/generators/processor/USAGE ADDED Viewed

@@ -0,0 +1,8 @@
+Description:
+    Generates a stub ActiveMessaging Processor and associated test.
+Examples:
+    ./script/generate processor HelloWorld
+    will create:
+        /app/processors/hello_world_processor.rb
+        /test/functional/hello_world_processor_test.rb

data/generators/processor/processor_generator.rb ADDED Viewed

@@ -0,0 +1,31 @@
+require File.dirname(__FILE__) + '/../../lib/activemessaging/named_base'
+class ProcessorGenerator < NamedBase
+  def manifest
+    record do |m|
+      path = 'app/processors'
+      test_path = 'test/functional'
+      # Check for class naming collisions.
+      m.class_collisions class_path, "#{class_name}Controller", "#{class_name}ControllerTest", "#{class_name}Helper"
+      # processor and test directories
+      m.directory File.join(path, class_path)
+      m.directory File.join(test_path, class_path)
+      # processor and test templates
+      m.template 'processor.rb', File.join(path, class_path, "#{file_name}_processor.rb")
+      m.template 'processor_test.rb', File.join(test_path, class_path, "#{file_name}_processor_test.rb")
+      m.template 'messaging.rb', File.join('config', "messaging.rb")
+      m.file 'broker.yml', File.join('config', "broker.yml")
+      m.file 'application.rb', File.join(path, "application.rb")
+      m.file 'poller.rb', File.join('lib', "poller.rb")
+      if defined?(JRUBY_VERSION)
+        m.file 'jruby_poller', File.join('script', "jruby_poller"), { :chmod => 0755 }
+      else
+        m.file 'poller', File.join('script', "poller"), { :chmod => 0755 }
+      end
+    end
+  end
+end

data/generators/processor/templates/application.rb ADDED Viewed

@@ -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/generators/processor/templates/broker.yml ADDED Viewed

@@ -0,0 +1,79 @@
+#
+# 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'
+    ###################################
+    # Websphere MQ Adapter Properties #
+    ###################################
+    # adapter: wmq
+    # q_mgr_name: ""
+    # poll_interval: .1
+    #################################
+    # 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
+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/generators/processor/templates/jruby_poller ADDED Viewed

@@ -0,0 +1,117 @@
+#!/bin/sh
+JRUBY_CMD=`which jruby`
+RAILS_ROOT="$(dirname $0)/.."
+POLLER_RB="$RAILS_ROOT/vendor/plugins/activemessaging/poller.rb"
+OUT="$RAILS_ROOT/tmp/poller.output"
+PID_FILE="$RAILS_ROOT/tmp/poller0.pid"
+if [ -z "$JRUBY_CMD" ] ; then
+	echo "Could not find jruby on your path."
+	exit 1
+fi
+if [ ! -f $POLLER_RB ] ; then
+	echo "Could not find the poller file at: $POLLER_RB"
+	exit 1
+fi
+function start() {
+	if [[ -s $PID_FILE && -n "$(ps -A | grep "^[ \t]*$(< $PID_FILE)")" ]] ; then
+		PID=$(< $PID_FILE)
+		echo "Poller already running with pid $PID."
+		exit 1
+	fi
+	$JRUBY_CMD $POLLER_RB "$@" >> $OUT 2>&1 &
+	PID=$!
+	echo $PID > $PID_FILE
+	echo "Poller started with pid=$PID"
+}
+function stop() {
+	if [[ -z "$(ps -A | grep "^[ \t]*$(< $PID_FILE)")" ]] ; then
+		echo "Poller is not currently running."
+		exit 1
+	fi
+	if [ -z "$FORCE" ] ; then
+		echo "Sending TERM signal to poller."
+		kill -TERM $(< $PID_FILE)
+	else
+		echo "Sending KILL signal to poller."
+		kill -KILL $(< $PID_FILE)
+	fi
+	rm $PID_FILE
+}
+function restart() {
+	stop
+	start
+}
+function run() {
+	exec $JRUBY_CMD $POLLER_RB "$@"
+}
+function zap() {
+	echo "Resetting to stopped state."
+	[ -f $PID_FILE ] && rm $PID_FILE
+}
+function usage() {
+	cat <<EOF
+Usage: poller <command> <options> -- <application options>
+* where <command> is one of:
+  start         start an instance of the application
+  stop          stop all instances of the application
+  restart       stop all instances and restart them afterwards
+  run           start the application and stay on top
+  zap           set the application to a stopped state
+* and where <options> may contain several of the following:
+    -t, --ontop                      Stay on top (does not daemonize)
+    -f, --force                      Force operation
+EOF
+}
+CMD=$1
+shift
+for i in "1" "2" ; do
+	case "$1" in
+		"-f"|"--force")
+			FORCE="true"
+			shift
+		;;
+		"-t"|"--ontop")
+			ONTOP="true"
+			shift
+		;;
+	esac
+done
+[ "$1" == "--" ] && shift
+case "$CMD" in
+	"start")
+		start
+	;;
+	"stop")
+		stop
+	;;
+	"run")
+		run
+	;;
+	"restart")
+		restart
+	;;
+	"zap")
+		zap
+	;;
+	"usage"|*)
+		usage
+		exit 1
+	;;
+esac