jruby-jms 0.10.1 → 0.10.2

data/README.md

@@ -1,15 +1,13 @@
-jruby-jms
-=========
+## jruby-jms
 
 * http://github.com/reidmorrison/jruby-jms
 
 ### Current Activities & Backward Compatibility
 
-Please read the source files for now for documentation. Looking into rdoc doc
-generation issue.
+Please read the documentation in the source files for now. Currently looking 
+into the rdoc doc generation issue for JRuby extended Java interfaces and classes.
 
 There may still be some changes to the API to make things better and/or simpler.
-
 Once the code goes to V1.0.0 I will make every effort to not break the 
 existing interface in any way.
 
@@ -41,7 +39,7 @@ API is available to you at any time.
 
 ### Install
 
-    gem install jruby-jms
+    jgem install jruby-jms
 
 ### Simplification
 
@@ -54,8 +52,7 @@ or Producer that is independent of whether it is producing or consuming to/from
 or a Topic or a Queue. The complexity of which JMS class is used is taken care
 of by jruby-jms.
 
-Concepts & Terminology
-----------------------
+## Concepts & Terminology
 
 ### Java Message Service (JMS) API
 
@@ -97,12 +94,10 @@ topic they are interested in
 
 ### Producer
 
-Producers write message to a queue or topic
+Producers write messages to queues or topics
 
 ActiveMQ Example:
     require 'rubygems'
-    
-    # Include JMS after ActiveMQ
     require 'jms'
     
     # Connect to ActiveMQ
@@ -113,7 +108,7 @@ ActiveMQ Example:
     }
 
     JMS::Connection.session(config) do |session|
-      session.producer(:q_name => 'ExampleQueue') do |producer|
+      session.producer(:queue_name => 'ExampleQueue') do |producer|
         producer.send(session.message("Hello World"))
       end
     end
@@ -124,8 +119,6 @@ Consumers read message from a queue or topic
 
 ActiveMQ Example:
     require 'rubygems'
-    
-    # Include JMS after ActiveMQ
     require 'jms'
     
     # Connect to ActiveMQ
@@ -136,22 +129,17 @@ ActiveMQ Example:
     }
     
     JMS::Connection.session(config) do |session|
-      session.consume(:q_name => 'ExampleQueue', :timeout=>1000) do |message|
+      session.consume(:queue_name => 'ExampleQueue', :timeout=>1000) do |message|
         p message
       end
     end
 
-Overview
---------
+## Overview
 
 jruby-jms is a complete JRuby API into the Java Messaging Specification (JMS) 
 followed by many JMS Providers.
 
-In order to communicate with a JMS provider jruby-jms needs the jar files in the
-CLASSPATH that are supplied by the JMS Provider.
-
-Threading
----------
+## Threading
 
 A JMS::Connection instance can be shared between threads, whereas a session, 
 consumer, producer, and any artifacts created by the session should only be 
@@ -162,31 +150,28 @@ that thread blocked on Consumer.receive. Or, even better use Connection.on_messa
 which will create a session, within which any message received from the specified
 queue or topic match will be passed to the block.
 
-### Example
-
-Logging
--------
+## Logging
 
 jruby-jms detects the logging available in the current environment.
 When running under Rails it will use the Rails logger, otherwise the standard
 Ruby logger. The logger can also be replaced by calling Connection.logger=
 
-Dependencies
-------------
+## Dependencies
+
+### JMS V1.1 Provider
+
+In order to communicate with a JMS V 1.1 provider jruby-jms needs the jar files supplied
+by the JMS provider. As in the examples above the jar files can be specified in
+the configuration element :require_jars. Otherwise, the jars must be explicitly
+required in the Ruby code:
+  `require "~/Applications/apache-activemq-5.4.2/activemq-all-5.4.2.jar"`
 
 ### JRuby
 
 jruby-jms has been tested against JRuby 1.5.1 and 1.6, but should work with any
 current JRuby version.
 
-### JMS
-
-Every JMS Provider has details on which jar files to include in your CLASSPATH
-for their JMS client to work. Some examples for connection settings are covered
-in the Connection.new documentation
-
-Development
------------
+## Development
 
 Want to contribute to jruby-jms?
 
@@ -196,53 +181,32 @@ First clone the repo and run the tests:
     cd jruby-jms
     jruby -S rake test
 
-Feel free to ping the mailing list with any issues and we'll try to resolve it.
-
+Feel free to submit any issues and we'll try to resolve it.
 
-Contributing
-------------
+## Contributing
 
 Once you've made your great commits:
 
-1. [Fork][1] jruby-jms
+1. [Fork](http://help.github.com/forking/) jruby-jms
 2. Create a topic branch - `git checkout -b my_branch`
 3. Push to your branch - `git push origin my_branch`
-4. Create an [Issue][2] with a link to your branch
+4. Create an [Issue](http://github.com/reidmorrison/jruby-jms/issues) with a link to your branch
 5. That's it!
 
-You might want to checkout our [Contributing][cb] wiki page for information
-on coding standards, new features, etc.
-
-
-Mailing List
-------------
-
-TBA
-
-Meta
-----
+## Meta
 
 * Code: `git clone git://github.com/reidmorrison/jruby-jms.git`
 * Home: <http://github.com/reidmorrison/jruby-jms>
-* Docs: <http://jruby-jms.github.com/jruby-jms/>
 * Bugs: <http://github.com/reidmorrison/jruby-jms/issues>
-* List: TBA
-* Gems: <http://gemcutter.org/gems/jruby-jms>
+* Gems: <http://rubygems.org/gems/jruby-jms>
 
-This project uses [Semantic Versioning][sv].
+This project uses [Semantic Versioning](http://semver.org/).
 
-
-Author
-------
+## Author
 
 Reid Morrison :: rubywmq@gmail.com :: @reidmorrison
 
-[1]: http://help.github.com/forking/
-[2]: http://github.com/reidmorrison/jruby-jms/issues
-[sv]: http://semver.org/
-
-License
--------
+## License
 
 Copyright 2008 - 2011  J. Reid Morrison
 

data/Rakefile

@@ -9,7 +9,7 @@ desc "Build gem"
 task :gem  do |t|
   gemspec = Gem::Specification.new do |s|
     s.name = 'jruby-jms'
-    s.version = '0.10.1'
+    s.version = '0.10.2'
     s.author = 'Reid Morrison'
     s.email = 'rubywmq@gmail.com'
     s.homepage = 'https://github.com/reidmorrison/jruby-jms'

data/lib/jms/connection.rb

@@ -107,7 +107,8 @@ module JMS
         rescue Exception => exc
           JMS::logger.error "Failed to Load Jar File:#{jar}. #{exc.to_s}"
         end
-      end
+      end if jar_list
+      
       require 'jms/message_listener'
       require 'jms/javax_jms_message'
       require 'jms/javax_jms_text_message'
@@ -223,7 +224,7 @@ module JMS
 
       # Load Jar files on demand so that they do not need to be in the CLASSPATH
       # of JRuby lib directory
-      fetch_dependencies(params[:require_jars]) if params[:require_jars]
+      fetch_dependencies(params[:require_jars])
 
       connection_factory = nil
       factory = params[:factory]

data/test/message_test.rb

@@ -43,7 +43,7 @@ class JMSTest < Test::Unit::TestCase
     should 'produce, browse and consume messages to/from a queue' do
       JMS::Connection.session(@config) do |session|
         assert_not_nil session
-        data = nil
+        data = :timed_out
         browse_data = nil
         session.producer(:queue_name => @queue_name) do |producer|
           # Send Message

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
     - 0
     - 10
-    - 1
-  version: 0.10.1
+    - 2
+  version: 0.10.2
 platform: ruby
 authors: 
   - Reid Morrison
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-21 00:00:00 -05:00
+date: 2011-02-23 00:00:00 -05:00
 default_executable: 
 dependencies: []