rubeus 0.0.6-java → 0.0.7-java

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'rubygems'
+require 'rmaven'
+require 'tasks/mvn'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the selectable_attr plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << File.join(File.dirname(__FILE__), 'lib') 
+  t.pattern = File.join(File.dirname(__FILE__), 'test', 'rubeus', '**', 'test_*.rb')
+  t.verbose = true
+end
+
+desc 'Generate documentation for the selectable_attr plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Rubeus'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/examples/jdbc_example.rb

@@ -1,34 +1,15 @@
+# -*- coding: utf-8 -*-
 require 'java'
 require 'rubygems'
 require 'rubeus'
 
-def setup_derby
-  return if ENV_JAVA['java.class.path'].split(File::PATH_SEPARATOR).any?{|path| /derby[\-\.\d]*\.jar$/ =~ path}
-  if ENV_JAVA["java.specification.version"] == "1.6"
-    begin
-      require File.join(ENV_JAVA['java.home'], 'db', 'lib', 'derby.jar')
-      return
-    rescue LoadError
-      # ignore error if not installed JavaDB
-      # Apple's JDK doesn't include Apache Derby
-    end
-  end
-  puts "JavaDB is not installed."
-  puts "Please add derby.jar to your CLASSPATH."
-end
-
-setup_derby
-
 class JdbcExample
-  include Rubeus::Jdbc
-
-  def initialize
-    # Register Driver
-    Java::OrgApacheDerbyJdbc::EmbeddedDriver
-  end
+  # includeしててもOKだけど、参照するのは基本DriverManagerしかないので、
+  # DriverManager => Rubeus::Jdbc::DriverManager を使うようにすればOK
+  # include Rubeus::Jdbc
 
   def test
-    DriverManager.connect("jdbc:derby:test;create = true", "", "") do |con|
+    Rubeus::Jdbc::DriverManager.connect("jdbc:derby:test;create = true", "", "") do |con|
       con.statement do |stmt|
         # Drop table TEST if exists
         begin

data/lib/rubeus.rb

@@ -1,13 +1,29 @@
+require File.join(File.dirname(__FILE__), 'rubeus.jar')
+
 require "rubygems"
-gem "activesupport", ">=2.0.2"
+gem "activesupport", "=2.1.2"
 # require "active_support"
 require "active_support/core_ext/string"
 
+Kernel.module_eval <<-EOS
+  def jp
+    JavaUtilities.get_package_module_dot_format('jp')    
+  end
+EOS
+
 module Rubeus
-  VERSION = "0.0.6"
+  VERSION = '0.0.7'
+  EMAIL_GROUP = 'rubeus@googlegroups.com'
+  WEB_SITE = 'http://code.google.com/p/rubeus/'
+  
+  autoload :Verbosable, "rubeus/verboseable"
+  
   autoload :Awt, "rubeus/awt"
   autoload :Swing, "rubeus/swing"
   autoload :Jdbc, "rubeus/jdbc"
+
+  def self.verbose; @verbose; end
+  def self.verbose=(value); @verbose = value; end
 end
 
 unless File.basename($PROGRAM_NAME) == 'gem' and ARGV.first == 'build'

data/lib/rubeus/component_loader.rb

@@ -1,6 +1,7 @@
+# -*- coding: utf-8 -*-
+require 'rubeus/verboseable'
 module Rubeus
   class ComponentLoader < Module
-
     def self.class_names(*package_names)
       patterns = Regexp.union(
         *package_names.map{|package_name|
@@ -15,15 +16,21 @@ module Rubeus
       classes
     end
     
+    include ::Rubeus::Verboseable
+    
+    attr_accessor :verbose
     attr_reader :java_package
     attr_reader :class_to_package
 
     def initialize(java_package, &block)
+      self.verbose = Rubeus.verbose
       build_class_to_package_table(java_package)
       java_package = JavaUtilities.get_package_module_dot_format(java_package)
       class << java_package
         include Rubeus::JavaPackage
+        include Verboseable
       end
+      java_package.verbose = self.verbose
       super(&block)
     end
     
@@ -38,14 +45,14 @@ module Rubeus
         next if class_name.include?('$')
         package = parts.join('.')
         @class_to_package[class_name] = @class_to_package.key?(class_name) ?
-          [@class_to_package[class_name], package] : package
+        [@class_to_package[class_name], package] : package
       end
     end
     
     def included(mod)
       mod.extend(self)
     end
-   
+    
     def extended(object)
       class_name_for_method = self.name.underscore.gsub('/', '_')
       const_missing_with = "const_missing_with_#{class_name_for_method}"
@@ -62,7 +69,7 @@ module Rubeus
       end
       object.extend(mod)
       object.instance_variable_set(loader_name, self)
-      object.instance_eval <<-EOS
+      object.instance_eval(<<-"EOS")
         alias :#{const_missing_without} :const_missing
         alias :const_missing :#{const_missing_with}
       EOS
@@ -74,8 +81,11 @@ module Rubeus
     
     def const_missing(java_class_name)
       if autoload?(java_class_name)
+        log_if_verbose("autoloading... #{java_class_name.to_s}")
         feature = autolodings.delete(java_class_name.to_s)
-        require(feature)
+        log_if_verbose("require(#{feature})") do
+          require(feature)
+        end
         return const_get(java_class_name)
       end
       package = @class_to_package[java_class_name.to_s]
@@ -84,12 +94,14 @@ module Rubeus
         raise NameError, "cannot specified package name for #{java_class_name}: #{package.join(', ')}"
       end
       java_fqn = package.empty? ? java_class_name.to_s : "#{package}.#{java_class_name.to_s}"
-      result = instance_eval(java_fqn)
+      extension = Rubeus::Extensions.apply_for(java_fqn)
+      result = log_if_verbose("instance_eval(#{java_fqn})") do
+        instance_eval(java_fqn)
+      end
       self.const_set(java_class_name, result)
       result
     rescue
-      puts $!
-      puts $!.backtrace.join("\n  ")
+      log_if_verbose($!)
       super
     end
 
@@ -108,36 +120,29 @@ module Rubeus
     def depend_on(*java_class_names)
       java_class_names.each{|java_class_name| self.const_get(java_class_name)}
     end
-
   end
 
   module JavaPackage
     def self.included(object)
       raise "JavaPackage must be extended by a Module" unless object.is_a?(Module)
       object.module_eval do
+        attr_accessor :verbose
         alias :method_missing_without_rubeus :method_missing
         alias :method_missing :method_missing_with_rubeus
         alias :const_missing_without_rubeus :const_missing
         alias :const_missing :const_missing_with_rubeus
       end
     end
-
+    
     def method_missing_with_rubeus(method, *args)
       java_fqn = "#{@package_name}#{method.to_s}"
-      extension = Rubeus::Extensions.find_for(java_fqn)
-      if extension
-        @extension_applied ||= [] 
-        unless @extension_applied.include?(java_fqn)
-          JavaUtilities.extend_proxy(java_fqn) do
-            include extension
-          end
-          @extension_applied << java_fqn
-        end
-      end
+      extension = Rubeus::Extensions.apply_for(java_fqn)
       result = method_missing_without_rubeus(method, *args)
       class << result
         include ::Rubeus::JavaPackage
+        include Verboseable
       end
+      result.verbose = self.verbose
       result
     end
 

data/lib/rubeus/extensions.rb

@@ -1,16 +1,33 @@
+require 'rubeus/verboseable'
 module Rubeus
   module Extensions
     autoload :Java, 'rubeus/extensions/java'
     autoload :Javax, 'rubeus/extensions/javax'
 
+    RUBEUS_EXTRA_PACKAGE = "jp.rubybizcommons.rubeus.extensions".freeze
+    RUBEUS_EXTRA_PACKAGE_PARTS = RUBEUS_EXTRA_PACKAGE.split('.').freeze
+    
     class << self
-      def path_for(java_fqn_or_parts)
+      def verbose; ::Rubeus.verbose; end
+      
+      private
+      def package_parts(java_fqn_or_parts)
         parts = java_fqn_or_parts.is_a?(Array) ? java_fqn_or_parts : java_fqn_or_parts.split('.')
+        if parts[0, RUBEUS_EXTRA_PACKAGE_PARTS.length] == RUBEUS_EXTRA_PACKAGE_PARTS
+          parts = parts[RUBEUS_EXTRA_PACKAGE_PARTS.length..-1]
+        end
+        parts
+      end
+      
+      public
+      
+      def path_for(java_fqn_or_parts)
+        parts = package_parts(java_fqn_or_parts)
         "rubeus/extensions/%s" % parts.map{|part|part.underscore}.join('/')
       end
 
       def class_name_for(java_fqn_or_parts)
-        parts = java_fqn_or_parts.is_a?(Array) ? java_fqn_or_parts : java_fqn_or_parts.split('.')
+        parts = package_parts(java_fqn_or_parts)
         "Rubeus::Extensions::%s" % parts.map{|part|part.camelize}.join('::')
       end
 
@@ -18,18 +35,41 @@ module Rubeus
         parts = java_fqn.split('.')
         extension_path = path_for(parts)
         begin
-          require(extension_path)
+          log_if_verbose("require(#{extension_path.inspect})") do
+            require(extension_path)
+          end
         rescue LoadError => e
           # puts "warning: #{e}"
           return nil
         end
         begin
-          instance_eval(class_name_for(parts))
+          klass_name = class_name_for(parts)
+          log_if_verbose("instance_eval(#{klass_name.inspect})") do
+            instance_eval(klass_name)
+          end
         rescue NameError => e
           # puts "warning: #{e}"
           return nil
         end
       end
+      
+      def apply_for(java_fqn)
+        log_if_verbose("apply_for(#{java_fqn.inspect})") do
+          extension = self.find_for(java_fqn)
+          return nil unless extension
+          @extension_applied ||= []
+          unless @extension_applied.include?(java_fqn)
+            log_if_verbose("JavaUtilities.extend_proxy(#{java_fqn})") do
+              JavaUtilities.extend_proxy(java_fqn) do
+                include extension
+              end
+            end
+            @extension_applied << java_fqn
+          end
+        end
+      end
+      
     end
+    extend ::Rubeus::Verboseable
   end
 end

data/lib/rubeus/extensions/java/awt/dimension.rb

@@ -7,7 +7,9 @@ module Rubeus::Extensions::Java::Awt
     module ClassMethods
       def create(*args)
         values = args
-        if args.length == 1
+        if args.length == 0
+          return new
+        elsif args.length == 1
           if args.first.is_a?(Array)
             return create(*args.first)
           elsif args.first.is_a?(Rubeus::Awt::Dimension)
@@ -16,7 +18,11 @@ module Rubeus::Extensions::Java::Awt
             values = args.first.to_s.split("x", 2)
           end
         end
-        new(*values.map{|s|s.to_i})
+        if values.length == 2
+          new(*values.map{|s|s.to_i})
+        else
+          raise ArgumentError, "Unsupported arguments: #{args.inspect}"
+        end
       end
     end
   end

data/lib/rubeus/extensions/java/sql/driver_manager.rb

@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 Rubeus::Jdbc.depend_on("Connection")
 
 module Rubeus::Extensions::Java::Sql
@@ -8,9 +9,247 @@ module Rubeus::Extensions::Java::Sql
     end
 
     module ClassMethods
-      def connect(url, user, password, &block)
+      CONNECT_DEFAULT_OPTIONS = {
+        :auto_setup_manager => true # trueならconnectメソッドの引数urlからドライバを探してロードします
+      }.freeze
+      
+      def connect(url, user = '', password = '', options = CONNECT_DEFAULT_OPTIONS, &block)
+        setup_for(url, options) if options[:auto_setup_manager]
         with_close(get_connection(url, user, password), &block)
       end
+      
+      def setup_for(url, options = nil)
+        DriverManager::Loader.setup_for(url, options)
+      end
     end
+    
+    class Loader
+      def self.entries
+        @entries ||= []
+      end
+      
+      def self.entry(name, pattern, driver, driver_type = :unknown, options = nil, &block)
+        result = entry_with(name) do |db|
+          db.pattern(pattern, driver, driver_type)
+          db.options = options
+        end
+        result.instance_eval(&block) if block_given?
+        result
+      end
+      
+      def self.entry_with(name, &block)
+        result = self.new(name)
+        result.instance_eval(&block) if block_given?
+        entries << result
+        result
+      end
+      
+      def self.setup_for(url, setup_options = nil)
+        entries.each do |entry|
+          driver = entry.setup_for(url, setup_options)
+          return driver if driver
+        end
+        raise ArgumentError, "DriverManager catalog not found for #{url}"
+      end
+      
+      attr_reader :name
+      
+      def initialize(name)
+        @name = name
+        @patterns = []
+      end
+      
+      def pattern(pattern, driver, driver_type = :unknown)
+        @patterns << {:pattern => pattern, :driver => driver, :driver_type => driver_type}
+      end
+      
+      def options
+        @options ||= {} 
+      end
+      
+      def options=(value)
+        @options = value
+      end
+      
+      def driver_for(url, driver_type = nil)
+        patterns = driver_type ? @patterns.select{|pattern| pattern[:driver_type] == driver_type} : @patterns
+        pattern = patterns.detect{|pattern| pattern[:pattern] =~ url}
+        pattern ? pattern[:driver] : nil
+      end
+      
+      def setup_for(url, setup_options = nil)
+        driver_name = driver_for(url)
+        return nil unless driver_name
+        begin
+          return JavaUtilities.get_proxy_class(driver_name)
+        rescue NameError => name_error
+          requirements = options[:gem_require]
+          raise name_error unless requirements
+          requirements = [requirements] unless requirements.is_a?(Array)
+          load_error_messages = []
+          requirements.each do |requirement|
+            begin
+              require(requirement)
+            rescue LoadError => load_error
+              msg = "failure to load '#{requirement}' of '#{options[:gem]}'."
+              msg << " Try 'jruby -S gem install #{options[:gem]}'" unless /\.jar$/ =~ requirement
+              load_error_messages << msg
+              next
+            end
+            begin
+              return JavaUtilities.get_proxy_class(driver_name)
+            rescue NameError => name_error_again
+              msg = "#{driver_name} not found for #{url}"
+              msg << ", but loaded '#{requirement}' of '#{options[:gem]}' successfully."
+              msg << " It might be a serious problem. Please let us know by email '#{Rubeus::EMAIL_GROUP}'. "
+              raise NameError, msg
+            end
+          end
+          raise LoadError, "#{driver_name} not found for #{url} because of " << load_error_messages.join(" AND ")
+        end
+      end
+    end
+    
+    # http://wiki.paulownia.jp/java/jdbc
+    class Loader
+      # JDBC-ODBC Bridge
+      # (Type1) sun.jdbc.odbc.JdbcOdbcDriver
+      # jdbc:odbc:DataSourceName
+      # Type1はODBCを使用してデータベースにアクセス。ODBCドライバのインストールと
+      # ODBCアドミニストレータ設定が必要。DataSourceNameにはODBCで設定した名前を入れる。
+      entry("ODBC", /jdbc:odbc:.*/, "sun.jdbc.odbc.JdbcOdbcDriver", :type1)
+      
+      # DB2
+      # Type2  COM.ibm.db2.jdbc.app.DB2Driver (v8.1まで)
+      # com.ibm.db2.jcc.DB2Driver (DB2 v8.1.2以降)
+      # jdbc:db2:DataSourceName
+      # DB2クライアントのインストールが必要。DataSourceNameには、DB2構成アシスタントで
+      # 設定したデータソース名を記述する。新しいドライバはType4と同じクラスで、URLでどちらのTypeを使うか区別する。
+      #
+      # DB2
+      # Type3 COM.ibm.db2.jdbc.net.DB2Driver
+      # jdbc:db2://127.0.0.1:50000/DataBaseName
+      # JDBC Type3ドライバのサポートは終了しており、Type4の使用が推奨されている。
+      # 
+      # DB2
+      # Type4 com.ibm.db2.jcc.DB2Driver
+      # jdbc:db2://127.0.0.1:50000/DataBaseName
+      # DB2バージョン8.1からサポートされた。DB2クライアントのインストールは不要。
+      entry_with "DB2" do |db|
+        db.pattern(/jdbc:db2:\/\/.*\/.*/, 'com.ibm.db2.jcc.DB2Driver'     , :type4)
+        db.pattern(/jdbc:db2:\/\/.*\/.*/, 'COM.ibm.db2.jdbc.net.DB2Driver', :type3)
+        db.pattern(/jdbc:db2:.*/        , 'COM.ibm.db2.jdbc.app.DB2Driver', :type2)
+      end
+      
+      # Oracle
+      # Type4 oracle.jdbc.driver.OracleDriver
+      # jdbc:oracle:thin:@127.0.0.1:1521:SID
+      # オラクルは他のDBと違い、URLのプロトコルとホストの区切りが // ではなく @ となっている。
+      # 
+      # Oracle 
+      # Type2 oracle.jdbc.driver.OracleDriver
+      # jdbc:oracle:oci8:@TNS (for Oracle 8i)
+      # jdbc:oracle:oci:@TNS (for Oracle 9i or 10g)
+      # tnsnames.oraファイルにデータソースの設定を書く。Oracleクライアントが必要。
+      # 10gは9i用クライアントでも使用可能のようだ。
+      entry_with "Oracle" do |db|
+        db.pattern(/jdbc:oracle:thin:@.*(:.*)*(:.*)*/, 'oracle.jdbc.driver.OracleDriver', :type4)
+        db.pattern(/jdbc:oracle:oci8:@.*/            , 'oracle.jdbc.driver.OracleDriver', :type2)
+        db.pattern(/jdbc:oracle:oci:@.*/             , 'oracle.jdbc.driver.OracleDriver', :type2)
+      end
+      
+      # SQL Server 2000
+      # Type4  com.microsoft.jdbc.sqlserver.SQLServerDriver
+      # jdbc:microsoft:sqlserver://127.0.0.1:1433;DatabaseName=DBName
+      # MS製なのでWindows版しかないが、導入が容易でバランスのとれたチューニングが施されている。
+      # このドライバはMSDE 2000でも使用可能。
+      entry("SQL Server 2000", /jdbc:microsoft:sqlserver:.*/, "com.microsoft.jdbc.sqlserver.SQLServerDriver", :type4)
+
+      # SQL Server 2005
+      # Type4  com.microsoft.sqlserver.jdbc.SQLServerDriver
+      # jdbc:sqlserver://localhost:1433;DatabaseName=DBName
+      # SQLServer 2005。旧バージョンからドライバクラスもURLも微妙に変更されているので注意。参考
+      entry("SQL Server 2005", /jdbc:sqlserver:.*/, "com.microsoft.sqlserver.jdbc.SQLServerDriver", :type4)
+      
+      # Firebird
+      # Type 4  org.firebirdsql.jdbc.FBDriver
+      # jdbc:firebirdsql://127.0.0.1:3050/DataBasePath
+      # オープンソースのRDB。DataBasePathにはサーバ上のデータベースファイル(.gdb)への絶対パスを指定するらしい。
+      entry("Firebird", /jdbc:firebirdsql:.*/, "org.firebirdsql.jdbc.FBDriver", :type4)
+      
+      # MySQL
+      # Type 4  com.mysql.jdbc.Driver
+      # jdbc:mysql://127.0.0.1:3306/DBName
+      # GPLライセンスと商用ライセンスで利用できるRDB。Movable Type等のBlogツールでも採用されている。
+      entry("MySQL", /jdbc:mysql:.*/, "com.mysql.jdbc.Driver", :type4,
+        :gem => "jdbc-mysql", :gem_require => "jdbc/mysql")
+      
+      # PostgreSQL
+      # Type 4  org.postgresql.Driver
+      # jdbc:postgresql://127.0.0.1:5432/DBName
+      # BSDライセンスで配布されており、商用でも無償で使用可能。中小規模システム、個人用DBとしてMySQLと並んで人気。
+      entry("PostgreSQL", /jdbc:postgresql:.*/, "org.postgresql.Driver", :type4, 
+        :gem => "jdbc-postgres", :gem_require => "jdbc/postgres")
+      
+      # HSQLDB  org.hsqldb.jdbcDriver
+      # jdbc:hsqldb:hsql://127.0.0.1:9001/databasename
+      # 高速、軽量、Pure Javaの組み込み向けRDBMS。jarファイル一つで動作する。このURLはサーバモードで起動したHSQLDBにアクセスするURL。
+      # 
+      # org.hsqldb.jdbcDriver
+      # jdbc:hsqldb:file:databasename
+      # HSQLDBをインプロセスモードで起動する。javaアプリケーションと同じVM上で起動し、組み込みのデータベースとして使う。
+      # 終了時にSHUTDOWN命令を送らないとデータが永続化されない。URLの最後に;shutdown=trueを付加すると終了時にデータが自動的に保存される。
+      #
+      # org.hsqldb.jdbcDriver
+      # jdbc:hsqldb:mem:databasename
+      # HSQLDBをインメモリモードで起動する。インメモリモードはスタンドアロンモードと同じだがデータを永続化しない。JavaVMを終了するとデータが失われる。
+      entry_with "HSQLDB" do |db|
+        db.pattern(/jdbc:hsqldb:hsql:.*/, "org.hsqldb.jdbcDriver")
+        db.pattern(/jdbc:hsqldb:file:.*/, "org.hsqldb.jdbcDriver")
+        db.pattern(/jdbc:hsqldb:mem:.*/ , "org.hsqldb.jdbcDriver")
+        db.options = {:gem => "jdbc-hsqldb", :gem_require => "jdbc/hsqldb"}
+      end
+      
+      # Derby  org.apache.derby.jdbc.EmbeddedDriver
+      # jdbc:derby:databasename;create=true
+      # Java言語で書かれた組み込み用のデータベース。create=trueはオプションで、databasenameが見つからない場合に新規データベースを作成する。
+      entry("Derby", /jdbc:derby:.*/, "org.apache.derby.jdbc.EmbeddedDriver", :unknown,
+        :gem => 'jdbc-derby', :gem_require => [
+          'jdbc/derby',
+          (ENV_JAVA['java.specification.version'] > '1.5' ? File.join(ENV_JAVA['java.home'], 'db', 'lib', 'derby.jar') : nil)
+        ].compact)
+      
+      # OpenBase
+      # Type4  com.openbase.jdbc.ObDriver
+      # jdbc:openbase://localhost/DataBaseName
+      # MacOSXの前身NEXTSTEP/OPENSTEP上で開発されたRDBMSらしい。Linux版、Windows版もあるようだ。
+      entry("OpenBase", /jdbc:openbase:.*/, "com.openbase.jdbc.ObDriver", :type4)
+      
+      # H2   org.h2.Driver
+      # jdbc:h2:tcp://localhost:9092/DataBasePath
+      # HSQLの開発者が作成した組み込みDB。DBをサーバとして起動した場合のURL。
+      # org.h2.Driver
+      # jdbc:h2:DataBasePath
+      # 組み込みDBとして使用する場合のURL。
+      entry_with "H2" do |db|
+        db.pattern(/jdbc:h2:tcp:.*/, "org.h2.Driver")
+        db.pattern(/jdbc:h2:.*/    , "org.h2.Driver")
+        db.options = {:gem => "jdbc-h2", :gem_require => "jdbc/h2"}
+      end
+      
+      # Sybase ASE
+      # Type4  com.sybase.jdbc.SybDriver
+      # jdbc:sybase:Tds:localhost:8001/databasename
+      # 一時期MSSQLServerとして提供されていたこともあるRDBMS。そのためか両製品をサポートしているサードパーティ製やオープンソースのドライバがある。
+      entry("Sybase ASE", /jdbc:sybase:Tds:.*/, "com.sybase.jdbc.SybDriver", :type4)
+      
+      # SQLite
+      # Type4(?)  org.sqlite.JDBC
+      # jdbc:sqlite:databasefile_path
+      # SQLiteにアクセスするJDBCドライバ。NestedVMというものをつかってPure Javaのドライバとしている？らしい…    
+      entry("SQLite", /jdbc:sqlite:.*/, "org.sqlite.JDBC", :type4, 
+        :gem => "jdbc-sqlite3", :gem_require => "jdbc/sqlite3")
+    end
+
   end
 end