jruby-jms 0.11.1 → 0.11.2

data/HISTORY.md

@@ -1,3 +1,8 @@
+## 0.11.2 (2011-06-01)
+
+* Issue #8 Add ability to set Producer delivery mode using a Symbol
+* Include ActiveMQ InVM working example along with Log4J properties file
+
 ## 0.11.1 (2011-05-25)
 
 * Fixes the condition where a bad session keeps being re-used in a session pool.

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.11.1'
+    s.version = '0.11.2'
     s.author = 'Reid Morrison'
     s.email = 'rubywmq@gmail.com'
     s.homepage = 'https://github.com/reidmorrison/jruby-jms'

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

@@ -14,26 +14,28 @@ activemq:
   :username: system
   :password: manager
   :require_jars:
-    - ~/Applications/apache-activemq-5.4.2-fuse-03-09/activemq-all-5.4.2-fuse-03-09.jar
-# ActiveMQ 5.5 Requires additional jar files
-#    - ~/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
+    - ~/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-vm:
+activemq-invm:
   :factory: org.apache.activemq.ActiveMQConnectionFactory
-  :broker_url: vm://127.0.0.1
+  :broker_url: vm://mybroker
   :object_message_serialization_defered: true
   :require_jars:
-    - ~/Applications/apache-activemq-5.4.2-fuse-03-09/activemq-all-5.4.2-fuse-03-09.jar
+    - ~/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.4.2-fuse-03-09/activemq-all-5.4.2-fuse-03-09.jar
+    - ~/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

data/examples/producer-consumer/producer.rb

@@ -18,7 +18,7 @@ raise "JMS Provider option:#{jms_provider} not found in jms.yml file" unless con
 
 JMS::Connection.session(config) do |session|
   session.producer(:queue_name => 'ExampleQueue') do |producer|
-    producer.delivery_mode = JMS::DeliveryMode::NON_PERSISTENT
+    producer.delivery_mode_sym = :non_persistent
     producer.send(session.message("Hello World: #{Time.now}"))
     JMS::logger.info "Successfully sent one message to queue ExampleQueue"
   end

data/lib/jms/connection.rb

@@ -121,6 +121,7 @@ module JMS
       require 'jms/object_message'
       require 'jms/session'
       require 'jms/message_consumer'
+      require 'jms/message_producer'
       require 'jms/queue_browser'
       require 'jms/oracle_a_q_connection_factory'
     end

data/lib/jms/message_producer.rb

@@ -0,0 +1,59 @@
+################################################################################
+#  Copyright 2008, 2009, 2010, 2011  J. Reid Morrison
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+################################################################################
+
+# Extend JMS Message Producer Interface with Ruby methods
+#
+# For further help on javax.jms.Message
+#   http://download.oracle.com/javaee/6/api/javax/jms/MessageProducer.html
+#
+# Interface javax.jms.Producer
+module JMS::MessageProducer
+
+  # Return the Delivery Mode as a Ruby symbol
+  #   :persistent
+  #   :non_persistent
+  #   nil if unknown
+  def delivery_mode_sym
+    case delivery_mode
+    when JMS::DeliveryMode::PERSISTENT
+      :persistent
+    when JMS::DeliveryMode::NON_PERSISTENT
+      :non_persistent
+    else
+      nil
+    end
+  end
+
+  # Set the JMS Delivery Mode from a Ruby Symbol
+  # Valid values for mode
+  #   :persistent
+  #   :non_persistent
+  #
+  # Example:
+  #   producer.delivery_mode_sym = :persistent
+  def delivery_mode_sym=(mode)
+    val = case mode
+    when :persistent
+      JMS::DeliveryMode::PERSISTENT
+    when :non_persistent
+      JMS::DeliveryMode::NON_PERSISTENT
+    else
+      raise "Unknown delivery mode symbol: #{mode}"
+    end
+    self.delivery_mode = val
+  end
+
+end

data/test/connection_test.rb

@@ -7,6 +7,9 @@ require 'shoulda'
 require 'jms'
 require 'yaml'
 
+# Set Log4J properties file so that it does not need to be in the CLASSPATH
+java.lang.System.properties['log4j.configuration'] = "test/log4j.properties"
+
 class JMSTest < Test::Unit::TestCase
   context 'JMS Connection' do
     # Load configuration from jms.yml

data/test/jms.yml

@@ -13,7 +13,9 @@ activemq:
   :factory: org.apache.activemq.ActiveMQConnectionFactory
   :broker_url: tcp://localhost:61616
   :require_jars:
-    - ~/Applications/apache-activemq-5.4.2-fuse-03-09/activemq-all-5.4.2-fuse-03-09.jar
+    - ~/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
   :queue_name: TestQueue
   :topic_name: TestTopic
 

data/test/log4j.properties

@@ -0,0 +1,32 @@
+#
+# This file controls most of the logging in ActiveMQ which is mainly based around
+# the commons logging API.
+#
+log4j.rootLogger=INFO, 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
+
+log4j.additivity.org.apache.activemq.audit=false
+log4j.logger.org.apache.activemq.audit=INFO, audit
+
+log4j.appender.audit=org.apache.log4j.ConsoleAppender
+log4j.appender.audit.layout=org.apache.log4j.PatternLayout
+log4j.appender.audit.layout.ConversionPattern=%d{ISO8601} %-5p: %m [%c %t]%n

metadata

@@ -2,7 +2,7 @@
 name: jruby-jms
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.11.1
+  version: 0.11.2
 platform: ruby
 authors: 
   - Reid Morrison
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-25 00:00:00 -04:00
+date: 2011-06-01 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -27,45 +27,12 @@ files:
   - LICENSE.txt
   - Rakefile
   - README.md
-  - doc/created.rid
-  - doc/fr_class_index.html
-  - doc/fr_file_index.html
-  - doc/fr_method_index.html
-  - doc/index.html
-  - doc/rdoc-style.css
-  - doc/classes/JMS.html
-  - doc/classes/JMS/BytesMessage.html
-  - doc/classes/JMS/Connection.html
-  - doc/classes/JMS/MapMessage.html
-  - doc/classes/JMS/Message.html
-  - doc/classes/JMS/MessageConsumer.html
-  - doc/classes/JMS/MessageListenerImpl.html
-  - doc/classes/JMS/ObjectMessage.html
-  - doc/classes/JMS/OracleAQConnectionFactory.html
-  - doc/classes/JMS/QueueBrowser.html
-  - doc/classes/JMS/Session.html
-  - doc/classes/JMS/SessionPool.html
-  - doc/classes/JMS/TextMessage.html
-  - doc/files/README_md.html
-  - doc/files/lib/jms_rb.html
-  - doc/files/lib/jms/bytes_message_rb.html
-  - doc/files/lib/jms/connection_rb.html
-  - doc/files/lib/jms/imports_rb.html
-  - doc/files/lib/jms/logging_rb.html
-  - doc/files/lib/jms/map_message_rb.html
-  - doc/files/lib/jms/message_consumer_rb.html
-  - doc/files/lib/jms/message_listener_impl_rb.html
-  - doc/files/lib/jms/message_rb.html
-  - doc/files/lib/jms/object_message_rb.html
-  - doc/files/lib/jms/oracle_a_q_connection_factory_rb.html
-  - doc/files/lib/jms/queue_browser_rb.html
-  - doc/files/lib/jms/session_pool_rb.html
-  - doc/files/lib/jms/session_rb.html
-  - doc/files/lib/jms/text_message_rb.html
   - examples/jms.yml
   - examples/advanced/session_pool.rb
   - examples/client-server/replier.rb
   - examples/client-server/requestor.rb
+  - examples/invm/invm.rb
+  - examples/invm/log4j.properties
   - examples/performance/consumer.rb
   - examples/performance/producer.rb
   - examples/producer-consumer/browser.rb
@@ -83,6 +50,7 @@ files:
   - lib/jms/message.rb
   - lib/jms/message_consumer.rb
   - lib/jms/message_listener_impl.rb
+  - lib/jms/message_producer.rb
   - lib/jms/object_message.rb
   - lib/jms/oracle_a_q_connection_factory.rb
   - lib/jms/queue_browser.rb
@@ -91,6 +59,7 @@ files:
   - lib/jms/text_message.rb
   - test/connection_test.rb
   - test/jms.yml
+  - test/log4j.properties
   - test/message_test.rb
   - test/session_pool_test.rb
   - test/session_test.rb

data/doc/classes/JMS.html

@@ -1,265 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html 
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Module: JMS</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-
-    elemStyle = elem.style;
-    
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-
-    return true;
-  }
-  
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  
-  // ]]>
-  </script>
-
-</head>
-<body>
-
-
-
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Module</strong></td>
-          <td class="class-name-in-header">JMS</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../files/lib/jms/connection_rb.html">
-                lib/jms/connection.rb
-                </a>
-        <br />
-                <a href="../files/lib/jms/imports_rb.html">
-                lib/jms/imports.rb
-                </a>
-        <br />
-                <a href="../files/lib/jms/logging_rb.html">
-                lib/jms/logging.rb
-                </a>
-        <br />
-                <a href="../files/lib/jms/message_listener_impl_rb.html">
-                lib/jms/message_listener_impl.rb
-                </a>
-        <br />
-                <a href="../files/lib/jms/oracle_a_q_connection_factory_rb.html">
-                lib/jms/oracle_a_q_connection_factory.rb
-                </a>
-        <br />
-                <a href="../files/lib/jms/session_pool_rb.html">
-                lib/jms/session_pool.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-
-        </table>
-    </div>
-  <!-- banner header -->
-
-  <div id="bodyContent">
-
-
-
-  <div id="contextContent">
-
-    <div id="description">
-      <p>
-Copyright 2008, 2009, 2010, 2011 J. Reid Morrison
-</p>
-<p>
-Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);
-you may not use this file except in compliance with the License. You may
-obtain a copy of the License at
-</p>
-<pre>
-    http://www.apache.org/licenses/LICENSE-2.0
-</pre>
-<p>
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an &quot;AS IS&quot; BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-</p>
-
-    </div>
-
-
-   </div>
-
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-
-      <div class="name-list">
-      <a href="#M000002">logger</a>&nbsp;&nbsp;
-      <a href="#M000003">logger=</a>&nbsp;&nbsp;
-      <a href="#M000004">ruby_logger</a>&nbsp;&nbsp;
-      </div>
-    </div>
-
-  </div>
-
-
-    <!-- if includes -->
-
-    <div id="section">
-
-    <div id="class-list">
-      <h3 class="section-bar">Classes and Modules</h3>
-
-      Module <a href="JMS/BytesMessage.html" class="link">JMS::BytesMessage</a><br />
-Module <a href="JMS/MapMessage.html" class="link">JMS::MapMessage</a><br />
-Module <a href="JMS/Message.html" class="link">JMS::Message</a><br />
-Module <a href="JMS/MessageConsumer.html" class="link">JMS::MessageConsumer</a><br />
-Module <a href="JMS/ObjectMessage.html" class="link">JMS::ObjectMessage</a><br />
-Module <a href="JMS/QueueBrowser.html" class="link">JMS::QueueBrowser</a><br />
-Module <a href="JMS/Session.html" class="link">JMS::Session</a><br />
-Module <a href="JMS/TextMessage.html" class="link">JMS::TextMessage</a><br />
-Class <a href="JMS/Connection.html" class="link">JMS::Connection</a><br />
-Class <a href="JMS/MessageListenerImpl.html" class="link">JMS::MessageListenerImpl</a><br />
-Class <a href="JMS/OracleAQConnectionFactory.html" class="link">JMS::OracleAQConnectionFactory</a><br />
-Class <a href="JMS/SessionPool.html" class="link">JMS::SessionPool</a><br />
-
-    </div>
-
-
-
-
-      
-
-
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-
-      <div id="method-M000002" class="method-detail">
-        <a name="M000002"></a>
-
-        <div class="method-heading">
-          <a href="#M000002" class="method-signature">
-          <span class="method-name">logger</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-Returns the <a href="JMS.html#M000002">logger</a> being used by jruby-jms
-Unless previously set, it will try to use the Rails <a
-href="JMS.html#M000002">logger</a> and if it is not present, it will return
-a new Ruby <a href="JMS.html#M000002">logger</a>
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000002-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/jms/logging.rb, line 23</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">logger</span>
-    <span class="ruby-ivar">@logger</span> <span class="ruby-operator">||=</span> (<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rails_logger</span> <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">ruby_logger</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000003" class="method-detail">
-        <a name="M000003"></a>
-
-        <div class="method-heading">
-          <a href="#M000003" class="method-signature">
-          <span class="method-name">logger=</span><span class="method-args">(logger)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-Replace the <a href="JMS.html#M000002">logger</a> for jruby-jms
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000003-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/jms/logging.rb, line 28</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">logger=</span>(<span class="ruby-identifier">logger</span>)
-    <span class="ruby-ivar">@logger</span> = <span class="ruby-identifier">logger</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-      <div id="method-M000004" class="method-detail">
-        <a name="M000004"></a>
-
-        <div class="method-heading">
-          <a href="#M000004" class="method-signature">
-          <span class="method-name">ruby_logger</span><span class="method-args">(level=nil, target=STDOUT)</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-Use the ruby <a href="JMS.html#M000002">logger</a>, but add needed trace
-level logging which will result in debug log entries
-</p>
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000004-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/jms/logging.rb, line 34</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">ruby_logger</span>(<span class="ruby-identifier">level</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">target</span>=<span class="ruby-constant">STDOUT</span>)
-    <span class="ruby-identifier">require</span> <span class="ruby-value str">'logger'</span>
-
-    <span class="ruby-identifier">l</span> = <span class="ruby-operator">::</span><span class="ruby-constant">Logger</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">target</span>)
-    <span class="ruby-identifier">l</span>.<span class="ruby-identifier">instance_eval</span> <span class="ruby-value str">&quot;alias :trace :debug&quot;</span>
-    <span class="ruby-identifier">l</span>.<span class="ruby-identifier">instance_eval</span> <span class="ruby-value str">&quot;alias :trace? :debug?&quot;</span>
-    <span class="ruby-identifier">l</span>.<span class="ruby-identifier">level</span> = <span class="ruby-identifier">level</span> <span class="ruby-operator">||</span> <span class="ruby-operator">::</span><span class="ruby-constant">Logger</span><span class="ruby-operator">::</span><span class="ruby-constant">INFO</span>
-    <span class="ruby-identifier">l</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
-        </div>
-      </div>
-
-
-    </div>
-
-
-  </div>
-
-
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-
-</body>
-</html>