jruby-jms 1.1.0-java

data/Rakefile

@@ -0,0 +1,30 @@
+lib = File.expand_path('../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+
+raise "jruby-jms must be built with JRuby: try again with `jruby -S rake'" unless defined?(JRUBY_VERSION)
+
+require 'rubygems'
+require 'rubygems/package'
+require 'rake/clean'
+require 'rake/testtask'
+require 'jms/version'
+
+desc "Build gem"
+task :gem  do |t|
+  Gem::Package.build(Gem::Specification.load('parallel_minion.gemspec'))
+end
+
+desc "Run Test Suite"
+task :test do
+  Rake::TestTask.new(:functional) do |t|
+    t.test_files = FileList['test/*_test.rb']
+    t.verbose    = true
+  end
+
+  Rake::Task['functional'].invoke
+end
+
+desc "Generate RDOC documentation"
+task :doc do
+  system "rdoc --main README.md --inline-source --quiet README.md `find lib -name '*.rb'`"
+end

data/examples/advanced/session_pool.rb

@@ -0,0 +1,37 @@
+#
+# How to use the session pool in a multi-threaded application such as Rails
+#   This example shows how to have multiple producers publishing information
+#   to topics
+#
+
+# Allow examples to be run in-place without requiring a gem install
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../../lib'
+
+require 'rubygems'
+require 'yaml'
+require 'jms'
+ 
+jms_provider = ARGV[0] || 'activemq'
+
+### This part would typically go in a Rails Initializer ###
+
+# Load Connection parameters from configuration file
+config = YAML.load_file(File.join(File.dirname(__FILE__), '..', 'jms.yml'))[jms_provider]
+raise "JMS Provider option:#{jms_provider} not found in jms.yml file" unless config
+
+JMS_CONNECTION = JMS::Connection.new(config)
+JMS_CONNECTION.start
+JMS_SESSION_POOL = JMS_CONNECTION.create_session_pool(config)
+
+# Ensure connections are released if application is shutdown
+at_exit do
+  JMS_SESSION_POOL.close
+  JMS_CONNECTION.close
+end
+
+### This part would typically go in the Rails Model ###
+
+JMS_SESSION_POOL.producer(:queue_name => 'SampleQueue') do |session, producer|
+  producer.send(session.message("Hello World"))
+end
+

data/examples/client-server/replier.rb

@@ -0,0 +1,29 @@
+#
+# Sample request/reply pattern replier:
+# Basically does the following:
+# 1) Consume messages from ExampleQueue indefinitely
+# 2) Get JMSReplyTo from consumed message
+# 3) Produce and send response to received message
+#
+
+# Allow examples to be run in-place without requiring a gem install
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../../lib'
+
+require 'rubygems'
+require 'jms'
+require 'yaml'
+
+jms_provider = ARGV[0] || 'activemq'
+
+# Load Connection parameters from configuration file
+config = YAML.load_file(File.join(File.dirname(__FILE__), '..', 'jms.yml'))[jms_provider]
+raise "JMS Provider option:#{jms_provider} not found in jms.yml file" unless config
+
+JMS::Connection.session(config) do |session|
+  session.consume(:queue_name => "ExampleQueue", :timeout => -1) do |message|
+    p "Got message: #{message.data}. Replying politely."
+    session.producer(:destination => message.reply_to) do |producer|
+      producer.send(session.message("Hello to you too!"))
+    end
+  end
+end

data/examples/client-server/requestor.rb

@@ -0,0 +1,40 @@
+#
+# Sample request/reply pattern requestor implementation:
+# Basically what this does is:
+# 1) Create temporary Queue to MQ Session
+# 2) Create consumer to session (This is important to be up before producer to make sure response isn't available before consumer is up)
+# 3) Create producer to session
+# 4) Create message for session
+# 5) Set message's JMSReplyTo to point to the temporary queue created in #1
+# 6) Send message to send queue
+# 7) Consume the first message available from the temporary queue within the time set in :timeout
+# 8) Close temporary queue, consumer, producer and session by ending the blocks
+#
+
+# Allow examples to be run in-place without requiring a gem install
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../../lib'
+
+require 'rubygems'
+require 'yaml'
+require 'jms'
+
+jms_provider = ARGV[0] || 'activemq'
+
+# Load Connection parameters from configuration file
+config = YAML.load_file(File.join(File.dirname(__FILE__), '..', 'jms.yml'))[jms_provider]
+raise "JMS Provider option:#{jms_provider} not found in jms.yml file" unless config
+
+JMS::Connection.session(config) do |session|
+  session.temporary_queue do |temporary_queue|
+    session.consumer(:destination => temporary_queue) do |consumer|
+      session.producer(:queue_name => "ExampleQueue") do |producer|
+        message = session.message("Hello World")
+        message.jms_reply_to = temporary_queue
+        producer.send(message)
+      end
+      response_message = consumer.get(:timeout => 5000)                 # Using timeout of 5seconds here
+      response = response_message != nil ? response_message.data : nil  # Get message data as response if response_message is available
+      p response
+    end
+  end
+end

data/examples/file-to-q/files_to_q.rb

@@ -0,0 +1,51 @@
+#
+# Example : files_to_q : Place all files in a directory to a queue
+#     Each file is written as a separate message
+#     Place the data in a file ending with '.data'
+#     and the header information in a file with same name, but with an
+#     extension of '.yml'
+#
+#  jruby files_to_q.rb activemq my_queue
+#
+
+# Allow examples to be run in-place without requiring a gem install
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../../lib'
+
+require 'rubygems'
+require 'jms'
+require 'yaml'
+
+raise("Required Parameters: 'jms_provider' 'queue_name' 'input_directory'") unless ARGV.count >= 2
+jms_provider = ARGV[0]
+queue_name = ARGV[1]
+path = ARGV[2] || queue_name
+
+# Load Connection parameters from configuration file
+config = YAML.load_file(File.join(File.dirname(__FILE__), '..', 'jms.yml'))[jms_provider]
+raise "JMS Provider option:#{jms_provider} not found in jms.yml file" unless config
+
+counter = 0
+# Consume all available messages on the queue
+JMS::Connection.session(config) do |session|
+  session.producer(:queue_name => queue_name) do |producer|
+    Dir.glob(File.join(path,'*.data')) do |filename|
+      unless File.directory?(filename)
+        printf("%5d: #{filename}\n",counter = counter + 1)
+        data = File.open(filename, 'rb') {|file| file.read }
+        header_filename = File.join(File.dirname(filename), File.basename(filename))
+        header_filename = header_filename[0, header_filename.length - '.data'.length] + '.yml'
+        header = File.exist?(header_filename) ? YAML.load_file(header_filename) : nil
+        message = session.message(data, :bytes)
+        if header
+          header[:attributes].each_pair do |k,v|
+            next if k == :jms_destination
+            message.send("#{k}=".to_sym, v) if message.respond_to?("#{k}=".to_sym)
+          end if header[:attributes]
+          message.properties = header[:properties] || {}
+        end
+        producer.send(message)
+      end
+    end
+ end
+end
+puts "Read #{counter} messages from #{path} and wrote to #{queue_name}"

data/examples/file-to-q/q_to_files.rb

@@ -0,0 +1,44 @@
+#
+# Example: q_to_files:
+#  Copy all messages in a queue to separate files in a directory
+#  The messages are left on the queue by
+#
+#  jruby q_to_files.rb activemq my_queue
+#
+
+# Allow examples to be run in-place without requiring a gem install
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../../lib'
+
+require 'rubygems'
+require 'jms'
+require 'yaml'
+require 'fileutils'
+
+raise("Required Parameters: 'jms_provider' 'queue_name' 'output_directory'") unless ARGV.count >= 2
+jms_provider = ARGV[0]
+queue_name = ARGV[1]
+path = ARGV[2] || queue_name
+
+# Load Connection parameters from configuration file
+config = YAML.load_file(File.join(File.dirname(__FILE__), '..', 'jms.yml'))[jms_provider]
+raise "JMS Provider option:#{jms_provider} not found in jms.yml file" unless config
+
+# Create supplied path if it does not exist
+FileUtils.mkdir_p(path)
+
+counter = 0
+# Consume all available messages on the queue
+JMS::Connection.session(config) do |session|
+  session.browse(:queue_name => queue_name, :timeout=>1000) do |message|
+    counter += 1
+    filename = File.join(path, "message_%03d" % counter)
+    File.open(filename+'.data', 'wb') {|file| file.write(message.data) }
+    header = {
+      :attributes => message.attributes,
+      :properties => message.properties
+    }
+    File.open(filename+'.yml', 'wb') {|file| file.write(header.to_yaml) }
+  end
+end
+
+puts "Saved #{counter} messages to #{path}"

data/examples/invm/invm.rb

@@ -0,0 +1,44 @@
+#
+# Sample ActiveMQ InVM Example:
+#   Write to a queue and then consume the message in a separate thread
+#
+# Note: This example only works with ActiveMQ
+#       Update the jar files path in ../jms.yml to point to your ActiveMQ installation
+
+# Allow examples to be run in-place without requiring a gem install
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../../lib'
+
+require 'rubygems'
+require 'yaml'
+require 'jms'
+require 'benchmark'
+
+# Set Log4J properties file so that it does not need to be in the CLASSPATH
+java.lang.System.properties['log4j.configuration'] = "file://#{File.join(File.dirname(__FILE__), 'log4j.properties')}"
+
+jms_provider = 'activemq-invm'
+
+# Load Connection parameters from configuration file
+config = YAML.load_file(File.join(File.dirname(__FILE__), '..', 'jms.yml'))[jms_provider]
+raise "JMS Provider option:#{jms_provider} not found in jms.yml file" unless config
+
+JMS::Connection.start(config) do |connection|
+  # Consume messages in a separate thread
+  connection.on_message(:queue_name => 'ExampleQueue') do |message|
+    JMS::logger.info "Consumed message from ExampleQueue: '#{message.data}'"
+  end
+
+  # Send a single message within a new session
+  connection.session do |session|
+    session.producer(:queue_name => 'ExampleQueue') do |producer|
+      producer.send(session.message("Hello World. #{Time.now}"))
+    end
+  end
+
+  JMS::logger.info "Put message on ExampleQueue"
+
+  # Give the consume thread time to process the message before terminating
+  sleep 1
+
+  JMS::logger.info "Shutting down"
+end

data/examples/invm/log4j.properties

@@ -0,0 +1,58 @@
+#
+# This file controls most of the logging in ActiveMQ which is mainly based around
+# the commons logging API.
+#
+log4j.rootLogger=INFO, logfile, console
+log4j.logger.org.apache.activemq.spring=WARN
+log4j.logger.org.apache.activemq.web.handler=WARN
+log4j.logger.org.springframework=WARN
+log4j.logger.org.apache.xbean=WARN
+log4j.logger.org.apache.camel=INFO
+
+# When debugging or reporting problems to the ActiveMQ team,
+# comment out the above lines and uncomment the next.
+
+#log4j.rootLogger=DEBUG, logfile, console
+
+# Or for more fine grained debug logging uncomment one of these
+#log4j.logger.org.apache.activemq=DEBUG
+#log4j.logger.org.apache.camel=DEBUG
+
+# Console appender
+log4j.appender.console=org.apache.log4j.ConsoleAppender
+log4j.appender.console.layout=org.apache.log4j.PatternLayout
+log4j.appender.console.layout.ConversionPattern=%d{ISO8601} %-5p: %m [%c %t]%n
+log4j.appender.console.threshold=INFO
+
+# File appender
+log4j.appender.logfile=org.apache.log4j.RollingFileAppender
+log4j.appender.logfile.file=activemq.log
+log4j.appender.logfile.maxFileSize=10240KB
+log4j.appender.logfile.maxBackupIndex=5
+log4j.appender.logfile.append=true
+log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
+log4j.appender.logfile.layout.ConversionPattern=%d{ISO8601} %-5p: %m [%c %t]%n
+# use some of the following patterns to see MDC logging data
+#
+# %X{activemq.broker}
+# %X{activemq.connector}
+# %X{activemq.destination}
+#
+# e.g.
+#
+# log4j.appender.logfile.layout.ConversionPattern=%d | %-20.20X{activemq.connector} | %-5p | %m | %c | %t%n
+
+###########
+# Audit log
+###########
+
+log4j.additivity.org.apache.activemq.audit=false
+log4j.logger.org.apache.activemq.audit=INFO, audit
+
+log4j.appender.audit=org.apache.log4j.FileAppender
+log4j.appender.audit.file=activemq-audit.log
+log4j.appender.logfile.maxFileSize=10240KB
+log4j.appender.logfile.maxBackupIndex=5
+log4j.appender.audit.append=true
+log4j.appender.audit.layout=org.apache.log4j.PatternLayout
+log4j.appender.audit.layout.ConversionPattern=%d{ISO8601} %-5p: %m [%c %t]%n

data/examples/jms.yml

@@ -0,0 +1,149 @@
+# This YAML file contains the configuration options for several different
+# JMS Providers
+#
+# The Examples that ship with jruby-jms will use the entry 'activemq' unless
+# overriden at the command line. For example:
+#    jruby producer.rb activemq
+#
+
+---
+# Active MQ Centralized Broker
+activemq:
+  :factory: org.apache.activemq.ActiveMQConnectionFactory
+  :broker_url: tcp://127.0.0.1:61616
+  :username: system
+  :password: manager
+  :require_jars:
+    - ~/Applications/apache-activemq-5.5.0/activemq-all-5.5.0.jar
+    - ~/Applications/apache-activemq-5.5.0/lib/optional/slf4j-log4j12-1.5.11.jar
+    - ~/Applications/apache-activemq-5.5.0/lib/optional/log4j-1.2.14.jar
+
+# ActiveMQ In VM Broker (Supports messaging within a JVM instance)
+activemq-invm:
+  :factory: org.apache.activemq.ActiveMQConnectionFactory
+  :broker_url: vm://mybroker
+  :object_message_serialization_defered: true
+  :require_jars:
+    - ~/Applications/apache-activemq-5.5.0/activemq-all-5.5.0.jar
+    - ~/Applications/apache-activemq-5.5.0/lib/optional/slf4j-log4j12-1.5.11.jar
+    - ~/Applications/apache-activemq-5.5.0/lib/optional/log4j-1.2.14.jar
+
+# ActiveMQ with failover to slave instance
+activemq-ha:
+  :factory: org.apache.activemq.ActiveMQConnectionFactory
+  :broker_url: failover://(tcp://msg1:61616,tcp://msg2:61616)?randomize=false&timeout=30000&initialReconnectDelay=100&useExponentialBackOff=true
+  :require_jars:
+    - ~/Applications/apache-activemq-5.5.0/activemq-all-5.5.0.jar
+    - ~/Applications/apache-activemq-5.5.0/lib/optional/slf4j-log4j12-1.5.11.jar
+    - ~/Applications/apache-activemq-5.5.0/lib/optional/log4j-1.2.14.jar
+
+# JBoss 4 Messaging
+  :jndi_name: ConnectionFactory
+  :jndi_context:
+    java.naming.factory.initial: org.jnp.interfaces.NamingContextFactory
+    java.naming.provider.url: jnp://localhost:1099
+    java.naming.security.principal: user
+    java.naming.security.credentials: pwd
+  :require_jars:
+    - ~/Applications/jboss-messaging-client/1.4.0.SP3/javassist.jar
+    - ~/Applications/jboss-messaging-client/1.4.0.SP3/jboss-aop-jdk50.jar
+    - ~/Applications/jboss-messaging-client/1.4.0.SP3/jboss-messaging-client.jar
+    - ~/Applications/jboss-messaging-client/1.4.0.SP3/jbossall-client.jar
+    - ~/Applications/jboss-messaging-client/1.4.0.SP3/trove.jar
+
+# Apache Qpid
+qpid:
+  :jndi_name: local
+  :jndi_context:
+    java.naming.factory.initial: org.apache.qpid.jndi.PropertiesFileInitialContextFactory
+    connectionfactory.local: amqp://guest:guest@clientid/testpath?brokerlist='tcp://localhost:5672'
+  :require_jars:
+    - ~/Applications/javax.jms.jar
+    - ~/Applications/qpid-0.8/lib/backport-util-concurrent-2.2.jar
+    - ~/Applications/qpid-0.8/lib/commons-collections-3.2.jar
+    - ~/Applications/qpid-0.8/lib/commons-lang-2.2.jar
+    - ~/Applications/qpid-0.8/lib/mina-core-1.0.1.jar
+    - ~/Applications/qpid-0.8/lib/qpid-client-0.8.jar
+    - ~/Applications/qpid-0.8/lib/qpid-common-0.8.jar
+    - ~/Applications/qpid-0.8/lib/slf4j-api-1.6.1.jar
+    - ~/Applications/qpid-0.8/lib/log4j-1.2.12.jar
+    - ~/Applications/qpid-0.8/lib/slf4j-log4j12-1.6.1.jar
+
+# HornetQ Broker
+hornetq:
+  # Connect to a local HornetQ Broker using JNDI
+  :jndi_name: /ConnectionFactory
+  :jndi_context:
+    java.naming.factory.initial: org.jnp.interfaces.NamingContextFactory
+    java.naming.provider.url: jnp://localhost:1099
+    java.naming.factory.url.pkgs: org.jboss.naming:org.jnp.interfaces
+    java.naming.security.principal: guest
+    java.naming.security.credentials: guest
+  :require_jars:
+    - ~/Applications/hornetq-2.4.0.Final/lib/hornetq-commons.jar
+    - ~/Applications/hornetq-2.4.0.Final/lib/hornetq-core-client.jar
+    - ~/Applications/hornetq-2.4.0.Final/lib/hornetq-jms-client.jar
+    - ~/Applications/hornetq-2.4.0.Final/lib/jboss-jms-api.jar
+    - ~/Applications/hornetq-2.4.0.Final/lib/jnp-client.jar
+    - ~/Applications/hornetq-2.4.0.Final/lib/netty.jar
+
+# Tibco EMS
+ems:
+  :jndi_name: TestFactory
+  :jndi_context:
+    java.naming.factory.initial: com.tibco.tibjms.naming.TibjmsInitialContextFactory
+    java.naming.provider.url: tcp://localhost:7222
+  :require_jars:
+    - C:\tibco\ems\8.0\lib\jms-2.0.jar
+    - C:\tibco\ems\8.0\lib\tibjms.jar
+    - C:\tibco\ems\8.0\lib\tibcrypt.jar
+
+# IBM WebSphere MQ
+wmq:
+  :factory: com.ibm.mq.jms.MQQueueConnectionFactory
+  :queue_manager: LOCAL
+  :host_name: localhost
+  :channel: MY.CLIENT.CHL
+  :port: 1414
+  # Transport Type: com.ibm.mq.jms.JMSC::MQJMS_TP_CLIENT_MQ_TCPIP
+  :transport_type: 1
+  :username: mqm
+  :require_jars:
+    - /opt/mqm/lib/com.ibm.mqjms.jar
+
+# Oracle AQ 9
+oracleaq:
+  :factory: 'JMS::OracleAQConnectionFactory'
+  :url: 'jdbc:oracle:thin:@hostname:1521:instanceid'
+  :username: 'aquser'
+  :password: 'mypassword'
+  :require_jars:
+    - ~/Applications/oraclestreams/ojdbc6.jar
+    - ~/Applications/oraclestreams/jmscommon.jar
+    - ~/Applications/oraclestreams/aqapi.jar
+    - ~/Applications/oraclestreams/xdb.jar
+    - ~/Applications/oraclestreams/jta.jar
+
+oracleaq_simple:
+  :factory: 'JMS::OracleAQConnectionFactory'
+  :url: 'jdbc:oracle:thin:aquser/mypassword@hostname:1521:instanceid'
+  :require_jars:
+    - ~/Applications/oraclestreams/ojdbc6.jar
+    - ~/Applications/oraclestreams/jmscommon.jar
+    - ~/Applications/oraclestreams/aqapi.jar
+    - ~/Applications/oraclestreams/xdb.jar
+    - ~/Applications/oraclestreams/jta.jar
+
+oracleaq_jndi:
+  :jndi_name: ConnectionFactory
+  :jndi_context:
+    java.naming.factory.initial: oracle.jms.AQjmsInitialContextFactory
+    java.naming.security.principal: aquser
+    java.naming.security.credentials: mypassword
+    db_url: jdbc:oracle:thin:@hostname:1521:instanceid
+  :require_jars:
+    - ~/Applications/oraclestreams/ojdbc6.jar
+    - ~/Applications/oraclestreams/jmscommon.jar
+    - ~/Applications/oraclestreams/aqapi.jar
+    - ~/Applications/oraclestreams/xdb.jar
+    - ~/Applications/oraclestreams/jta.jar