rjack-slf4j 1.5.11.0-java

data/History.rdoc

@@ -0,0 +1,42 @@
+=== 1.5.11.0 (2010-3-6)
+* Upgraded to SLF4J 1.5.11
+* Set gem platform to java
+* SLF4J.ruby_to_java_logger_name renamed/aliased SLF4J.to_log_name
+* Upgraded to tarpit ~> 1.2.0
+
+=== 1.5.10.0 (2009-12-19)
+* Upgraded to SLF4J 1.5.10
+* Upgraded to tarpit-1.1.0 (gemcutter)
+
+=== 1.5.8.1 (2009-10-10)
+* Renamed gem rjack-slf4j and as module RJack::SLF4J (with ::SLF4J
+  alias kept for backward compatibility.)
+* Use rjack-tarpit for build.
+* Upgraded to SLF4J 1.5.8
+* Added support for logging exceptions from ruby, with special
+  handling of NativeException#cause
+* Added support for converting from ruby style "Module::Class" to java
+  "module.Class" name in SLF4J::Logger.new
+* Added SLF4J::MDC (Mapped Diagnostic Context) support module
+* Added Logger.java_logger access
+
+=== 1.5.6.3 (2009-4-25)
+* Added SLF4J::JUL for controlling java.util.logging, including
+  JUL.replace_root_handlers which removes all existing handlers and
+  add SLF4JBridgeHandler for exclusive routing to SLF4J for use with
+  'jul-to-slf4j'.
+* Added require 'slf4j' to each adapter loader.
+* Use rdoc 2.4.3 and hoe 1.12.2 for build.
+
+=== 1.5.6.2 (2009-4-4)
+* Fixed previously lost rdoc due to base vs slf4j.rb manifest order.
+
+=== 1.5.6.1 (2008-12-6)
+* Upgraded to SLF4J 1.5.6
+* SLF4JBase -rename-> SLF4J
+
+=== 1.5.5.1 (2008-11-1)
+* Upgraded to SLF4J 1.5.5
+
+=== 1.5.3.1 (2008-10-8)
+* Initial release based on SLF4J 1.5.3

data/Manifest.static

@@ -0,0 +1,13 @@
+Manifest.static
+Manifest.txt
+README.rdoc
+History.rdoc
+Rakefile
+pom.xml
+assembly.xml
+lib/rjack-slf4j/base.rb
+lib/rjack-slf4j.rb
+lib/rjack-slf4j/jul-to-slf4j.rb
+lib/rjack-slf4j/jul.rb
+lib/rjack-slf4j/mdc.rb
+test/test_slf4j.rb

data/Manifest.txt

@@ -0,0 +1,29 @@
+Manifest.static
+Manifest.txt
+README.rdoc
+History.rdoc
+Rakefile
+pom.xml
+assembly.xml
+lib/rjack-slf4j/base.rb
+lib/rjack-slf4j.rb
+lib/rjack-slf4j/jul-to-slf4j.rb
+lib/rjack-slf4j/jul.rb
+lib/rjack-slf4j/mdc.rb
+test/test_slf4j.rb
+lib/rjack-slf4j/jcl-over-slf4j.rb
+lib/rjack-slf4j/jcl.rb
+lib/rjack-slf4j/jdk14.rb
+lib/rjack-slf4j/log4j-over-slf4j.rb
+lib/rjack-slf4j/log4j12.rb
+lib/rjack-slf4j/nop.rb
+lib/rjack-slf4j/simple.rb
+lib/rjack-slf4j/jcl-over-slf4j-1.5.11.jar
+lib/rjack-slf4j/jul-to-slf4j-1.5.11.jar
+lib/rjack-slf4j/log4j-over-slf4j-1.5.11.jar
+lib/rjack-slf4j/slf4j-api-1.5.11.jar
+lib/rjack-slf4j/slf4j-jcl-1.5.11.jar
+lib/rjack-slf4j/slf4j-jdk14-1.5.11.jar
+lib/rjack-slf4j/slf4j-log4j12-1.5.11.jar
+lib/rjack-slf4j/slf4j-nop-1.5.11.jar
+lib/rjack-slf4j/slf4j-simple-1.5.11.jar

data/README.rdoc

@@ -0,0 +1,70 @@
+= rjack-slf4j
+
+* http://rjack.rubyforge.org
+* http://rubyforge.org/projects/rjack
+
+== Description
+
+A JRuby adaption and gem packaging of the
+{Simple Logging Facade for Java}[http://www.slf4j.org/].
+Provides all jar dependencies and a Ruby Logger compatible
+facade.
+
+SLF4J is a java logging abstraction and set of adapters to various
+concrete logging implementations and legacy logging APIs.  The slf4j
+gem adds a ruby core Logger compatible facade to SLF4J, and makes any
+needed adapters available to JRuby applications. This makes it
+possible to unify and control logging output of both java and ruby
+components in a JRuby application.
+
+== Features
+
+* The complete set of SLF4J jars with ruby 'require' based selection
+  of input and output adapters.
+* A Ruby core Logger compatible SLF4J::Logger, allowing ruby code to
+  log through SLF4J.
+
+== Synopsis
+
+  require 'rjack-slf4j'
+  require 'rjack-slf4j/simple'
+
+  log = RJack::SLF4J[ "my.app.logger" ]
+  log.info "Hello World!"
+
+== License
+
+=== rjack-slf4j gem
+
+Copyright (c) 2008-2009 David Kellum
+All rights reserved.
+
+The SLF4J ruby wrapper and gem packaging is released under the same
+license terms as the SLF4J java binaries, see below. Note that these
+license terms are identical to the
+{MIT License}[http://en.wikipedia.org/wiki/MIT_License] and deemed
+compatible with GPL and the Apache Software License.
+
+=== SLF4J (java)
+
+Copyright (c) 2004-2008 QOS.ch
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,88 @@
+# -*- ruby -*-
+#--
+# Copyright (C) 2008-2009 David Kellum
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+$LOAD_PATH << './lib'
+require 'rjack-slf4j/base'
+
+require 'rubygems'
+gem     'rjack-tarpit', '~> 1.2.0'
+require 'rjack-tarpit'
+
+t = RJack::TarPit.new( 'rjack-slf4j', RJack::SLF4J::VERSION, :java_platform )
+
+t.specify do |h|
+  h.developer( "David Kellum", "dek-oss@gravitext.com" )
+  h.rubyforge_name = "rjack"
+  h.remote_rdoc_dir = "slf4j"
+end
+
+loaders =
+  begin
+    l = RJack::SLF4J::ADAPTERS.flatten.compact
+    l.delete( "jul-to-slf4j" ) # exception: maintained as source
+    l
+  end
+
+t.generated_files = loaders.map { |adp| "lib/#{t.name}/#{adp}.rb" }
+
+t.jars =
+  begin
+    j = [ 'slf4j-api' ]
+    j += RJack::SLF4J::ADAPTERS.map { |i,o| [ i, "slf4j-#{o}" ] }.flatten.compact
+    j.map { |n| "#{n}-#{RJack::SLF4J::SLF4J_VERSION}.jar" }
+  end
+
+file 'Manifest.txt' => [ "lib/#{t.name}/base.rb" ]
+
+t.assembly_version = 1.0
+
+task :check_pom_deps do
+  t.test_line_match( 'pom.xml',
+                     %r[<version>#{RJack::SLF4J::SLF4J_VERSION}</version>] )
+end
+
+task :check_history_version do
+  t.test_line_match( 'History.rdoc', /^==/, / #{t.version} / )
+end
+task :check_history_date do
+  t.test_line_match( 'History.rdoc', /^==/, /\([0-9\-]+\)$/ )
+end
+
+task :gem  => [ :check_pom_deps, :check_history_version                      ]
+task :tag  => [ :check_pom_deps, :check_history_version, :check_history_date ]
+task :push => [                                          :check_history_date ]
+
+t.define_tasks
+
+loaders.each do |adapter|
+  file "lib/#{t.name}/#{adapter}.rb" => [ "lib/#{t.name}/base.rb", 'Rakefile' ] do
+    open( "lib/#{t.name}/#{adapter}.rb", 'w' ) do |out|
+      out.write <<END
+require 'rjack-slf4j'
+RJack::SLF4J.require_adapter( '#{adapter}' )
+END
+    end
+  end
+end

data/assembly.xml

@@ -0,0 +1,24 @@
+<assembly>
+  <id>bin</id>
+  <formats>
+    <format>dir</format>
+  </formats>
+  <includeBaseDirectory>false</includeBaseDirectory>
+  <dependencySets>
+    <dependencySet>
+      <includes>
+        <include>org.slf4j:slf4j-api</include>
+        <include>org.slf4j:jcl-over-slf4j</include>
+        <include>org.slf4j:jul-to-slf4j</include>
+        <include>org.slf4j:log4j-over-slf4j</include>
+        <include>org.slf4j:slf4j-jcl</include>
+        <include>org.slf4j:slf4j-jdk14</include>
+        <include>org.slf4j:slf4j-log4j12</include>
+        <include>org.slf4j:slf4j-nop</include>
+        <include>org.slf4j:slf4j-simple</include>
+      </includes>
+    </dependencySet>
+
+  </dependencySets>
+
+</assembly>

data/lib/rjack-slf4j/base.rb

@@ -0,0 +1,42 @@
+#--
+# Copyright (C) 2008-2009 David Kellum
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+module RJack
+  module SLF4J
+
+    # SLF4J-java version
+    SLF4J_VERSION = '1.5.11'
+    # SLF4J gem version
+    VERSION = SLF4J_VERSION + '.0'
+
+    SLF4J_DIR = File.dirname(__FILE__) # :nodoc:
+
+    #              :input              :output (jar with slf4j- prefix)
+    ADAPTERS = [ [ "jul-to-slf4j",     "jdk14"   ],
+                 [ "jcl-over-slf4j",   "jcl"     ],
+                 [ "log4j-over-slf4j", "log4j12" ],
+                 [ nil,                "nop"     ],
+                 [ nil,                "simple"  ] ] # :nodoc:
+  end
+end

data/lib/rjack-slf4j/jcl-over-slf4j.rb

@@ -0,0 +1,2 @@
+require 'rjack-slf4j'
+RJack::SLF4J.require_adapter( 'jcl-over-slf4j' )

data/lib/rjack-slf4j/jcl.rb

@@ -0,0 +1,2 @@
+require 'rjack-slf4j'
+RJack::SLF4J.require_adapter( 'jcl' )

data/lib/rjack-slf4j/jdk14.rb

@@ -0,0 +1,2 @@
+require 'rjack-slf4j'
+RJack::SLF4J.require_adapter( 'jdk14' )

data/lib/rjack-slf4j/jul-to-slf4j.rb

@@ -0,0 +1,20 @@
+require 'rjack-slf4j'
+require 'rjack-slf4j/jul'
+
+RJack::SLF4J.require_adapter( 'jul-to-slf4j' )
+
+module RJack::SLF4J::JUL
+
+  # Replace any existing configured root java.util.Logger Handlers with
+  # the org.slf4j.bridge.SLF4JBridgeHandler
+  def self.replace_root_handlers
+    root_logger = root
+    root_logger.handlers.each do |handler|
+      root_logger.remove_handler( handler )
+    end
+    handler = Java::org.slf4j.bridge.SLF4JBridgeHandler.new
+
+    root_logger.add_handler( handler )
+  end
+
+end

data/lib/rjack-slf4j/jul.rb

@@ -0,0 +1,77 @@
+#--
+# Copyright (C) 2009 David Kellum
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+require 'rjack-slf4j'
+require 'java'
+
+# Utilities for finer grain control of the JDK java.util.logging
+# (JUL). In particular, unlike other logging API's reimplemented by
+# slf4j adapters, JUL log levels remain significant for enabling output
+# or avoiding log message generation cycles. For a particular
+# level to be output, both JUL and the destination SLF4J output adapter
+# must enable it.
+#
+# == Usage
+#
+# Adjust JUL levels (in conjunction with 'slf4j/jul-to-slf4j' or
+# 'slf4j/jdk14', see SLF4J.)
+#
+#   require 'rjack-slf4j/jul'
+#   SLF4J::JUL[ "my.jul.logger" ].level = SLF4J::JUL::FINER
+#
+# Direct all output to SLF4J (output adapter != 'jdk14')
+#
+#   require 'rjack-slf4j/jul-to-slf4j'
+#   RJack::SLF4J::JUL.replace_root_handlers
+#
+module RJack::SLF4J::JUL
+  LogManager         = Java::java.util.logging.LogManager
+  Logger             = Java::java.util.logging.Logger
+  Level              = Java::java.util.logging.Level
+
+  SEVERE  = Level::SEVERE
+  WARNING = Level::WARNING
+  INFO    = Level::INFO
+  CONFIG  = Level::CONFIG
+  FINE    = Level::FINE
+  FINER   = Level::FINER
+  FINEST  = Level::FINEST
+  ALL     = Level::ALL
+
+  # Global java.util.logging.LogManager reset: close any handlers and
+  # set root level to INFO.
+  def self.reset
+    LogManager.log_manager.reset
+  end
+
+  # Get java.util.logging.Logger by name (responds to level=, etc.)
+  def self.[]( name )
+    Logger.get_logger( name )
+  end
+
+  # Get the root logger (empty string name)
+  def self.root
+    Logger.get_logger( "" )
+  end
+end

data/lib/rjack-slf4j/log4j-over-slf4j.rb

@@ -0,0 +1,2 @@
+require 'rjack-slf4j'
+RJack::SLF4J.require_adapter( 'log4j-over-slf4j' )

data/lib/rjack-slf4j/log4j12.rb

@@ -0,0 +1,2 @@
+require 'rjack-slf4j'
+RJack::SLF4J.require_adapter( 'log4j12' )

data/lib/rjack-slf4j/mdc.rb

@@ -0,0 +1,47 @@
+#--
+# Copyright (C) 2008-2009 David Kellum
+#
+# 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.
+#++
+
+require 'rjack-slf4j'
+
+module RJack::SLF4J
+
+  # Mapped Diagnostic Context support module
+  #
+  # Note that this optional module can only be loaded after a output
+  # adapter has been loaded.  Otherwise the following output is
+  # printed and Exception will be thrown:
+  #
+  #   SLF4J: Failed to load class "org.slf4j.impl.StaticMDCBinder".
+  #   SLF4J: See http://www.slf4j.org/codes.html#no_static_mdc_binder for further details.
+  #   java.lang.NoClassDefFoundError: org/slf4j/impl/StaticMDCBinder
+  #
+  module MDC
+
+    # Get value associated with key, or nil.
+    def self.[]( key )
+      org.slf4j.MDC::get( key.to_s )
+    end
+
+    # Associate val with key, or remove key is value is nil.
+    def self.[]=( key, val )
+      if val
+        org.slf4j.MDC::put( key.to_s, val.to_s )
+      else
+        org.slf4j.MDC::remove( key.to_s )
+      end
+    end
+  end
+end

data/lib/rjack-slf4j/nop.rb

@@ -0,0 +1,2 @@
+require 'rjack-slf4j'
+RJack::SLF4J.require_adapter( 'nop' )

data/lib/rjack-slf4j/simple.rb

@@ -0,0 +1,2 @@
+require 'rjack-slf4j'
+RJack::SLF4J.require_adapter( 'simple' )

data/lib/rjack-slf4j.rb

@@ -0,0 +1,265 @@
+#--
+# Copyright (C) 2008-2009 David Kellum
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+require 'rjack-slf4j/base'
+require 'java'
+
+# Backward compatibility for top level ::SLF4J module
+SLF4J = RJack::SLF4J
+
+module RJack
+
+  # Wrapper and core Logger compatible adapter for the
+  # SLF4J[http://www.slf4j.org/] logging interface.
+  #
+  # == Usage
+  #
+  #   require 'rjack-slf4j'
+  #
+  #   log = RJack::SLF4J[ "my.app.logger" ]
+  #   log.info "Hello World!"
+  #
+  # == Adapters
+  #
+  # An output adapter must be required before the first log call.  All
+  # of the following output adapters are available via +require+ from
+  # the slf4j gem:
+  #
+  #   require 'rjack-slf4j/jcl'       # Output to Jakarta Commons Logging
+  #   require 'rjack-slf4j/jdk14'     # JDK java.util.logging (JUL)
+  #   require 'rjack-slf4j/log4j12'   # Log4j (provided elsewhere)
+  #   require 'rjack-slf4j/nop'       # NOP null logger (provided)
+  #   require 'rjack-slf4j/simple'    # Simple logger (provided)
+  #
+  # The rjack-logback[http://rjack.rubyforge.org/logback] gem may
+  # also be be used as the output adapter:
+  #
+  #   require 'rjack-logback'
+  #
+  # The first loaded output adapter wins (as with multiple adapters on
+  # the classpath). A warning will be logged to "slf4j" if an attempt is
+  # made to require a second output adapter.
+  #
+  # The following input adapters will intercept JCL, java.util.logging
+  # (JUL), or log4j log output and direct it through SLF4J:
+  #
+  #   require 'rjack-slf4j/jcl-over-slf4j'   # Route Jakarta Commons Logging to SLF4J
+  #   require 'rjack-slf4j/log4j-over-slf4j' # Log4j to SLF4J
+  #
+  #   require 'rjack-slf4j/jul-to-slf4j'     # JDK java.util.logging (JUL) to SLF4J
+  #   RJack::SLF4J::JUL.replace_root_handlers # Special case setup for JUL
+  #
+  # Multiple input adapters may be require'd.  However, a RuntimeError
+  # will be raised in the attempt to require both an output adapter and
+  # input adapter from/to the same interface, for example
+  # 'rjack-slf4j/jcl-over-slf4j' and 'rjack-slf4j/jcl', which would otherwise cause
+  # a circular logging loop (and stack overflow.)
+  #
+  # Adapter names match the corresponding SLF4J jars.
+  #
+  module SLF4J
+
+    # Require an adapter by name (add the jar to classpath)
+    # This is normally done via require 'slf4j/_name_'
+    def self.require_adapter( name )
+      row = ADAPTERS.assoc( name )
+      if row
+        name,ban = row
+        output = false
+      else
+        row = ADAPTERS.rassoc( name )
+        ban,name = row
+        output = true
+      end
+
+      if @@loaded[ ban ]
+        raise "Illegal attempt to load '#{name}' when '#{ban}' is loaded."
+      end
+
+      if output
+        if ! @@output_name.nil? && name != @@output_name
+          logger("slf4j").warn do
+            "Ignoring attempt to load #{name} after #{@@output_name} already loaded."
+          end
+          return
+        end
+        if java.lang.Thread::current_thread.context_class_loader != @@api_loader
+          $stderr.puts( "WARNING: Attempting to load #{name} in child class" +
+                        " loader of slf4j-api.jar loader." )
+        end
+        require_jar( 'slf4j-' + name )
+        @@output_name = name
+      else
+        require_jar( name )
+      end
+
+      @@loaded[ name ] = true
+    end
+
+    def self.require_jar( name ) # :nodoc:
+      require File.join( SLF4J_DIR, "#{name}-#{ SLF4J_VERSION }.jar" )
+    end
+
+    require_jar 'slf4j-api'
+
+    @@api_loader = org.slf4j.ILoggerFactory.java_class.class_loader
+    @@loaded = {}
+    @@output_name = nil
+
+    # Output adapter name if one has been added, or nil.
+    def self.output_name
+      @@output_name
+    end
+
+    # SLF4J severity levels
+    LEVELS = %w{ trace debug info warn error }
+
+    # Return a java style class name, suitable as a logger name, from the
+    # given ruby class or module, i.e:
+    #
+    #    to_log_name( Foo::Bar::Baz ) --> "foo.bar.Baz"
+    #
+    def self.to_log_name( clz )
+      clz.name.gsub( /::/, '.' ).gsub( /([^\.]+)\./ ) { |m| m.downcase }
+    end
+
+    class << self
+      alias ruby_to_java_logger_name to_log_name
+    end
+
+    # Logger compatible facade over org.slf4j.Logger
+    #
+    # === Generated Methods
+    #
+    # Corresponding methods are generated for each of the SLF4J levels:
+    #
+    # * trace
+    # * debug
+    # * info
+    # * warn
+    # * error
+    # * fatal (alias to error)
+    #
+    # These have the form (using _info_ as example):
+    #
+    #   log = Logger.new( "name" )
+    #   log.info?                    # Is this level enabled for logging?
+    #   log.info( "message" )        # Log message
+    #   log.info { "message" }       # Execute block if enabled
+    #                                  and log returned value
+    #   log.info( "message", ex )    # Log message with exception message/stack trace
+    #   log.info( ex ) { "message" } # Log message with exception message/stack trace
+    #   log.info( ex )               # Log exception with default "Exception:" message
+    #
+    # Note that the exception variants are aware of JRuby's
+    # NativeException class (a wrapped java exception) and will log
+    # using the Java ex.cause in this case.
+    #
+    class Logger
+      attr_reader :name
+
+      # Create new or find existing Logger by name. If name is a Module (Class, etc.)
+      # then use SLF4J.to_log_name( name ) as the name
+      #
+      # Note that loggers are arranged in a hiearchy by dot '.' name
+      # notation using java package/class name conventions:
+      #
+      # * "pmodule"
+      # * "pmodule.cmodule."
+      # * "pmodule.cmodule.ClassName"
+      #
+      # Which enables hierarchical level setting and abbreviation in some output adapters.
+      #
+      def initialize( name )
+        @name = name.is_a?( Module ) ? SLF4J.to_log_name( name ) : name
+        @logger = org.slf4j.LoggerFactory.getLogger( @name )
+      end
+
+      # Return underlying org.slf4j.Logger
+      def java_logger
+        @logger
+      end
+
+      # Define logging methods for each level: debug(), error(), etc.
+      LEVELS.each do |lvl|
+        module_eval( %Q{
+
+          def #{lvl}?
+            @logger.is#{lvl.capitalize}Enabled
+          end
+
+          def #{lvl}( msg=nil, ex=nil )
+            if msg.is_a?( Exception ) && ex.nil?
+              msg, ex = "Exception:", msg
+            end
+            msg = yield if ( block_given? && #{lvl}? )
+            if msg
+              if ex
+                #{lvl}_ex( msg, ex )
+              else
+                @logger.#{lvl}( msg.to_s )
+              end
+            end
+          end
+
+          def #{lvl}_ex( msg, ex )
+            if ex.is_a?( NativeException )
+              @logger.#{lvl}( msg.to_s, ex.cause )
+            elsif #{lvl}?
+              log = msg.to_s
+              log << '\n'
+              log << ex.class.name << ': ' << ex.message << '\n'
+              ex.backtrace.each do |b|
+                log << '\t' << b << '\n'
+              end
+              @logger.#{lvl}( log )
+            end
+          end
+
+        } )
+      end
+
+      # Alias fatal to error for Logger compatibility
+      alias_method :fatal, :error
+      alias_method :fatal?, :error?
+    end
+
+    # Get Logger by name
+    def logger( name = self.class.name )
+      Logger.new( name )
+    end
+    module_function :logger
+
+    # Synonym for Logger.new( name )
+    def self.[]( name )
+      Logger.new( name )
+    end
+
+    # The ILoggerFactory instance if an output adapter has been loaded
+    def self.linked_factory
+       org.slf4j.LoggerFactory.getILoggerFactory
+    end
+
+  end
+end

data/pom.xml

@@ -0,0 +1,104 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>rjack</groupId>
+  <artifactId>rjack-slf4j</artifactId>
+  <packaging>pom</packaging>
+  <version>1.0</version>
+  <name>SLF4J assembly</name>
+
+  <dependencies>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-api</artifactId>
+      <version>1.5.11</version>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>jcl-over-slf4j</artifactId>
+      <version>1.5.11</version>
+      <scope>runtime</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>jul-to-slf4j</artifactId>
+      <version>1.5.11</version>
+      <scope>runtime</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>log4j-over-slf4j</artifactId>
+      <version>1.5.11</version>
+      <scope>runtime</scope>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-jdk14</artifactId>
+      <version>1.5.11</version>
+      <scope>runtime</scope>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-log4j12</artifactId>
+      <version>1.5.11</version>
+      <scope>runtime</scope>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-jcl</artifactId>
+      <version>1.5.11</version>
+      <scope>runtime</scope>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-simple</artifactId>
+      <version>1.5.11</version>
+      <scope>runtime</scope>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>org.slf4j</groupId>
+      <artifactId>slf4j-nop</artifactId>
+      <version>1.5.11</version>
+      <scope>runtime</scope>
+      <optional>true</optional>
+    </dependency>
+
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <configuration>
+          <descriptors>
+            <descriptor>assembly.xml</descriptor>
+          </descriptors>
+          <tarLongFileMode>gnu</tarLongFileMode>
+        </configuration>
+        <executions>
+          <execution>
+            <id>assembly</id>
+            <phase>package</phase>
+            <goals>
+              <goal>attached</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+
+</project>

data/test/test_slf4j.rb

@@ -0,0 +1,146 @@
+#!/usr/bin/env jruby
+#--
+# Copyright (c) 2008-2009 David Kellum
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation files
+# (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge,
+# publish, distribute, sublicense, and/or sell copies of the Software,
+# and to permit persons to whom the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+$LOAD_PATH.unshift File.join( File.dirname(__FILE__), "..", "lib" )
+
+require 'rjack-slf4j'
+
+# Load jdk14 implementation for testing
+require 'rjack-slf4j/jdk14'
+
+# Now safe to load:
+require 'rjack-slf4j/mdc'
+
+# Load these only to confirm loading works
+require 'rjack-slf4j/jcl-over-slf4j'
+require 'rjack-slf4j/log4j-over-slf4j'
+
+require 'test/unit'
+
+class TestHandler < java.util.logging.Handler
+  attr_accessor :count, :last
+
+  def initialize
+    reset
+  end
+
+  def flush; end
+  def close; end
+
+  def publish( record )
+    @count += 1
+    @last = record
+  end
+
+  def reset
+    @count = 0
+    @last = nil
+  end
+end
+
+module Foo
+  module Bar
+    class Baz
+    end
+  end
+end
+
+class TestSlf4j < Test::Unit::TestCase
+
+  JdkLogger = java.util.logging.Logger
+
+  def setup
+    @handler = TestHandler.new
+    @jdk_logger = JdkLogger.getLogger ""
+    @jdk_logger.addHandler @handler
+    @jdk_logger.level = java.util.logging.Level::INFO
+    @log = SLF4J[ "my.app" ]
+  end
+
+  def teardown
+    @handler.reset
+  end
+
+  def test_logger
+    assert !@log.trace?
+    @log.trace( "not written" )
+    assert !@log.debug?
+    @log.debug { "also not written" }
+    assert @log.info?
+    @log.info { "test write info" }
+    assert @log.warn?
+    @log.warn { "test write warning" }
+    assert @log.error?
+    @log.error( "test write error" )
+    assert @log.fatal?
+    @log.fatal { "test write fatal --> error" }
+    assert_equal( 4, @handler.count )
+  end
+
+  def test_native_exception
+    jlist = Java::java.util.ArrayList.new
+    jlist.add( 33 )
+    ex = nil
+    begin
+      jlist.get( 666 ) # IndexOutOfBoundsException
+    rescue Java::java.lang.IndexOutOfBoundsException => x
+      ex = x
+      @log.error( "test java exception", x )
+    end
+    assert_equal( 1, @handler.count )
+    assert_same( ex.cause, @handler.last.thrown )
+  end
+
+  def test_ruby_exception
+    begin
+      0/0 # ZeroDivisionError
+    rescue ZeroDivisionError => x
+      @log.error( x )
+    end
+    assert_equal( 1, @handler.count )
+  end
+
+  def test_ruby_exception_block
+    begin
+      0/0 # ZeroDivisionError
+    rescue ZeroDivisionError => x
+      @log.error( x ) { "ruby exception" }
+    end
+    assert_equal( 1, @handler.count )
+  end
+
+  def test_to_log_name
+    assert_equal( "foo.bar.Baz",
+                  SLF4J.to_log_name( Foo::Bar::Baz ) )
+    assert_equal( "foo.bar.Baz", SLF4J[ Foo::Bar::Baz ].name )
+  end
+
+  def test_circular_ban
+    assert_raise( RuntimeError ) do
+      require 'rjack-slf4j/jul-to-slf4j'
+    end
+  end
+
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification 
+name: rjack-slf4j
+version: !ruby/object:Gem::Version 
+  version: 1.5.11.0
+platform: java
+authors: 
+  - David Kellum
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-06 00:00:00 -08:00
+default_executable: 
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: rjack-tarpit
+    type: :development
+    version_requirement: 
+    version_requirements: !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ~>
+          - !ruby/object:Gem::Version 
+            version: 1.2.0
+      version: 
+description: |-
+  A JRuby adaption and gem packaging of the
+  {Simple Logging Facade for Java}[http://www.slf4j.org/].
+  Provides all jar dependencies and a Ruby Logger compatible
+  facade.
+  
+  SLF4J is a java logging abstraction and set of adapters to various
+  concrete logging implementations and legacy logging APIs.  The slf4j
+  gem adds a ruby core Logger compatible facade to SLF4J, and makes any
+  needed adapters available to JRuby applications. This makes it
+  possible to unify and control logging output of both java and ruby
+  components in a JRuby application.
+email: 
+  - dek-oss@gravitext.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+  - Manifest.txt
+  - README.rdoc
+  - History.rdoc
+files: 
+  - Manifest.static
+  - Manifest.txt
+  - README.rdoc
+  - History.rdoc
+  - Rakefile
+  - pom.xml
+  - assembly.xml
+  - lib/rjack-slf4j/base.rb
+  - lib/rjack-slf4j.rb
+  - lib/rjack-slf4j/jul-to-slf4j.rb
+  - lib/rjack-slf4j/jul.rb
+  - lib/rjack-slf4j/mdc.rb
+  - test/test_slf4j.rb
+  - lib/rjack-slf4j/jcl-over-slf4j.rb
+  - lib/rjack-slf4j/jcl.rb
+  - lib/rjack-slf4j/jdk14.rb
+  - lib/rjack-slf4j/log4j-over-slf4j.rb
+  - lib/rjack-slf4j/log4j12.rb
+  - lib/rjack-slf4j/nop.rb
+  - lib/rjack-slf4j/simple.rb
+  - lib/rjack-slf4j/jcl-over-slf4j-1.5.11.jar
+  - lib/rjack-slf4j/jul-to-slf4j-1.5.11.jar
+  - lib/rjack-slf4j/log4j-over-slf4j-1.5.11.jar
+  - lib/rjack-slf4j/slf4j-api-1.5.11.jar
+  - lib/rjack-slf4j/slf4j-jcl-1.5.11.jar
+  - lib/rjack-slf4j/slf4j-jdk14-1.5.11.jar
+  - lib/rjack-slf4j/slf4j-log4j12-1.5.11.jar
+  - lib/rjack-slf4j/slf4j-nop-1.5.11.jar
+  - lib/rjack-slf4j/slf4j-simple-1.5.11.jar
+has_rdoc: true
+homepage: http://rjack.rubyforge.org
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+  - --main
+  - README.rdoc
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: rjack
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A JRuby adaption and gem packaging of the {Simple Logging Facade for Java}[http://www.slf4j.org/]
+test_files: 
+  - test/test_slf4j.rb