ruby-plsql 0.2.4 → 0.3.0

data/lib/plsql/schema.rb

@@ -26,15 +26,12 @@ module PLSQL
     
     def connection=(raw_conn)
       @connection = raw_conn ? Connection.create(raw_conn) : nil
-      if @connection
-        @procedures = {}
-        @packages = {}
-        @schemas = {}
-      else
-        @procedures = nil
-        @packages = nil
-        @schemas = nil
-      end
+      reset_instance_variables
+    end
+
+    def activerecord_class=(ar_class)
+      @connection = ar_class ? Connection.create(nil, ar_class) : nil
+      reset_instance_variables
     end
     
     def logoff
@@ -63,7 +60,44 @@ module PLSQL
       connection.rollback
     end
     
+    # Set to :local or :utc
+    @@default_timezone = nil
+    def default_timezone
+      @@default_timezone ||
+        # Use ActiveRecord class default_timezone when ActiveRecord connection is used
+        (@connection && (ar_class = @connection.activerecord_class) && ar_class.default_timezone) ||
+        # default to local timezone
+        :local
+    end
+    
+    def default_timezone=(value)
+      if [:local, :utc].include?(value)
+        @@default_timezone = value
+      else
+        raise ArgumentError, "default timezone should be :local or :utc"
+      end
+    end
+
+    # Same implementation as for ActiveRecord
+    # DateTimes aren't aware of DST rules, so use a consistent non-DST offset when creating a DateTime with an offset in the local zone
+    def local_timezone_offset
+      ::Time.local(2007).utc_offset.to_r / 86400
+    end
+    
     private
+
+    def reset_instance_variables
+      if @connection
+        @procedures = {}
+        @packages = {}
+        @schemas = {}
+      else
+        @procedures = nil
+        @packages = nil
+        @schemas = nil
+      end
+      @@default_timezone = nil
+    end
     
     def method_missing(method, *args)
       raise ArgumentError, "No PL/SQL connection" unless connection

data/lib/ruby_plsql.rb

@@ -6,7 +6,6 @@ end
 unless defined?(JRUBY_VERSION)
   begin
     require "oci8"
-    require "oradate_patch"
   rescue LoadError
       puts <<-EOS
     To use ruby_plsql you must install ruby-oci8 library.
@@ -25,12 +24,12 @@ else
     else
       require ojdbc_jar
     end
-    import java.sql.Statement
-    import java.sql.Connection
-    import java.sql.SQLException
-    import java.sql.Types
-    import java.sql.DriverManager
-    DriverManager.registerDriver Java::oracle.jdbc.driver.OracleDriver.new
+    # import java.sql.Statement
+    # import java.sql.Connection
+    # import java.sql.SQLException
+    # import java.sql.Types
+    # import java.sql.DriverManager
+    java.sql.DriverManager.registerDriver Java::oracle.jdbc.driver.OracleDriver.new
   rescue LoadError
       puts <<-EOS
     To use ruby_plsql you must have Oracle JDBC driver installed.

data/lib/ruby_plsql/version.rb

@@ -1,9 +1,3 @@
 module RubyPlsql #:nodoc:
-  module VERSION #:nodoc:
-    MAJOR = 0
-    MINOR = 2
-    TINY  = 4
-
-    STRING = [MAJOR, MINOR, TINY].join('.')
-  end
+  VERSION = '0.3.0'
 end

data/spec/plsql/connection_spec.rb

@@ -0,0 +1,336 @@
+# encoding: utf-8
+
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "Connection" do
+
+  before(:all) do
+    @raw_conn = get_connection
+  end
+
+  after(:all) do
+    unless defined?(JRUBY_VERSION)
+      @raw_conn.logoff rescue nil
+    else
+      @raw_conn.close rescue nil
+    end
+  end
+
+  before(:each) do
+    @conn = PLSQL::Connection.create( @raw_conn )
+  end
+
+  it "should create connection" do
+    @conn.raw_connection.should == @raw_conn
+  end
+
+  unless defined?(JRUBY_VERSION)
+    it "should be oci connection" do
+      @conn.should be_oci
+      @conn.raw_driver.should == :oci
+    end
+  else
+    it "should be jdbc connection" do
+      @conn.should be_jdbc
+      @conn.raw_driver.should == :jdbc
+    end
+  end
+  
+  it "should logoff connection" do
+    @conn.logoff.should be_true
+  end
+  
+  # Ruby 1.8 and 1.9
+  if !defined?(RUBY_ENGINE) || RUBY_ENGINE == 'ruby'
+    describe "OCI data type conversions" do
+      it "should translate PL/SQL VARCHAR2 to Ruby String" do
+        @conn.plsql_to_ruby_data_type("VARCHAR2", 100).should == [String, 100]
+        @conn.plsql_to_ruby_data_type("VARCHAR2", nil).should == [String, 32767]
+      end
+
+      it "should translate PL/SQL CLOB to Ruby String" do
+        @conn.plsql_to_ruby_data_type("CLOB", 100_000).should == [OCI8::CLOB, nil]
+        @conn.plsql_to_ruby_data_type("CLOB", nil).should == [OCI8::CLOB, nil]
+      end
+
+      it "should translate PL/SQL NUMBER to Ruby OraNumber" do
+        @conn.plsql_to_ruby_data_type("NUMBER", 15).should == [OraNumber, nil]
+      end
+
+      it "should translate PL/SQL DATE to Ruby DateTime" do
+        @conn.plsql_to_ruby_data_type("DATE", nil).should == [DateTime, nil]
+      end
+
+      it "should translate PL/SQL TIMESTAMP to Ruby Time" do
+        @conn.plsql_to_ruby_data_type("TIMESTAMP", nil).should == [Time, nil]
+      end
+
+      it "should not translate Ruby Fixnum when OraNumber type specified" do
+        @conn.ruby_value_to_ora_value(100, OraNumber).should eql(100)
+      end
+
+      it "should translate Ruby Bignum value to OraNumber when OraNumber type specified" do
+        ora_number = @conn.ruby_value_to_ora_value(12345678901234567890, OraNumber)
+        ora_number.class.should == OraNumber
+        ora_number.to_s.should == "12345678901234567890"
+        # OraNumber has more numeric comparison methods in ruby-oci8 2.0
+        ora_number.should == OraNumber.new("12345678901234567890") if OCI8::VERSION >= '2.0.0'
+      end
+
+      it "should translate Ruby String value to OCI8::CLOB when OCI8::CLOB type specified" do
+        large_text = "x" * 100_000
+        ora_value = @conn.ruby_value_to_ora_value(large_text, OCI8::CLOB)
+        ora_value.class.should == OCI8::CLOB
+        ora_value.size.should == 100_000
+        ora_value.rewind
+        ora_value.read.should == large_text
+      end
+
+      it "should translate Oracle OraNumber integer value to Fixnum" do
+        @conn.ora_value_to_ruby_value(OraNumber.new(100)).should eql(100)
+      end
+
+      it "should translate Oracle OraNumber float value to BigDecimal" do
+        @conn.ora_value_to_ruby_value(OraNumber.new(100.11)).should eql(BigDecimal("100.11"))
+      end
+
+      # ruby-oci8 2.0 returns DATE as Time or DateTime
+      if OCI8::VERSION < '2.0.0'
+        it "should translate Oracle OraDate value to Time" do
+          now = OraDate.now
+          @conn.ora_value_to_ruby_value(now).should eql(now.to_time)
+        end
+      end
+
+      it "should translate Oracle CLOB value to String" do
+        large_text = "x" * 100_000
+        clob = OCI8::CLOB.new(@raw_conn, large_text)
+        @conn.ora_value_to_ruby_value(clob).should == large_text
+      end
+      
+    end
+
+  elsif RUBY_ENGINE == 'jruby'
+    
+    describe "JDBC data type conversions" do
+      it "should translate PL/SQL VARCHAR2 to Ruby String" do
+        @conn.plsql_to_ruby_data_type("VARCHAR2", 100).should == [String, 100]
+        @conn.plsql_to_ruby_data_type("VARCHAR2", nil).should == [String, 32767]
+      end
+
+      it "should translate PL/SQL NUMBER to Ruby BigDecimal" do
+        @conn.plsql_to_ruby_data_type("NUMBER", 15).should == [BigDecimal, nil]
+      end
+      
+      it "should translate PL/SQL DATE to Ruby DateTime" do
+        @conn.plsql_to_ruby_data_type("DATE", nil).should == [Time, nil]
+      end
+      
+      it "should translate PL/SQL TIMESTAMP to Ruby Time" do
+        @conn.plsql_to_ruby_data_type("TIMESTAMP", nil).should == [Time, nil]
+      end
+      
+      it "should not translate Ruby Fixnum when BigDecimal type specified" do
+        @conn.ruby_value_to_ora_value(100, BigDecimal).should eql(100)
+      end
+      
+      it "should translate Ruby Bignum value to BigDecimal when BigDecimal type specified" do
+        big_decimal = @conn.ruby_value_to_ora_value(12345678901234567890, BigDecimal)
+        big_decimal.class.should == BigDecimal
+        big_decimal.should == BigDecimal("12345678901234567890")
+      end
+      
+      # it "should translate Ruby OraDate value to DateTime when DateTime type specified" do
+      #   now = OraDate.now
+      #   @conn.ruby_value_to_ora_value(now, DateTime).should eql(now.to_datetime)
+      # end
+      
+      it "should translate Ruby String value to Java::OracleSql::CLOB when Java::OracleSql::CLOB type specified" do
+        large_text = "x" * 100_000
+        ora_value = @conn.ruby_value_to_ora_value(large_text, Java::OracleSql::CLOB)
+        ora_value.class.should == Java::OracleSql::CLOB
+        ora_value.length.should == 100_000
+        ora_value.getSubString(1, ora_value.length) == large_text
+        ora_value.freeTemporary
+      end
+
+      it "should translate Ruby nil value to empty Java::OracleSql::CLOB when Java::OracleSql::CLOB type specified" do
+        ora_value = @conn.ruby_value_to_ora_value(nil, Java::OracleSql::CLOB)
+        ora_value.class.should == Java::OracleSql::CLOB
+        ora_value.isEmptyLob.should be_true
+      end
+
+      it "should translate Oracle BigDecimal integer value to Fixnum" do
+        @conn.ora_value_to_ruby_value(BigDecimal("100")).should eql(100)
+      end
+      
+      it "should translate Oracle BigDecimal float value to BigDecimal" do
+        @conn.ora_value_to_ruby_value(BigDecimal("100.11")).should eql(BigDecimal("100.11"))
+      end
+      
+      # it "should translate Oracle OraDate value to Time" do
+      #   now = OraDate.now
+      #   @conn.ora_value_to_ruby_value(now).should eql(now.to_time)
+      # end
+
+      it "should translate Oracle CLOB value to String" do
+        large_text = "āčē" * 100_000
+        clob = @conn.ruby_value_to_ora_value(large_text, Java::OracleSql::CLOB)
+        @conn.ora_value_to_ruby_value(clob).should == large_text
+        clob.freeTemporary
+      end
+
+      it "should translate empty Oracle CLOB value to nil" do
+        clob = @conn.ruby_value_to_ora_value(nil, Java::OracleSql::CLOB)
+        @conn.ora_value_to_ruby_value(clob).should be_nil
+      end
+
+    end
+    
+  end  
+
+  describe "SQL statements" do
+
+    it "should execute SQL statement and return first result" do
+      @now = Time.local(2008,05,31,23,22,11)
+      @conn.select_first("SELECT 'abc',123,123.456,
+        TO_DATE('#{@now.strftime("%Y-%m-%d %H:%M:%S")}','YYYY-MM-DD HH24:MI:SS')
+        FROM dual").should == ["abc",123,123.456,@now]
+    end
+
+    it "should execute SQL statement with bind parameters and return first result" do
+      @today = Date.parse("2008-05-31")
+      @now = Time.local(2008,05,31,23,22,11)
+      @conn.select_first("SELECT :1,:2,:3,:4,:5 FROM dual",
+        'abc',123,123.456,@now,@today).should == ["abc",123,123.456,@now,Time.parse(@today.to_s)]
+    end
+    
+    it "should execute SQL statement with NULL values and return first result" do
+      @now = Time.local(2008,05,31,23,22,11)
+      @conn.select_first("SELECT NULL,123,123.456,
+        TO_DATE('#{@now.strftime("%Y-%m-%d %H:%M:%S")}','YYYY-MM-DD HH24:MI:SS')
+        FROM dual").should == [nil,123,123.456,@now]
+    end
+
+    if defined?(JRUBY_VERSION)
+
+      it "should execute SQL statement with NULL values as bind parameters and return first result" do
+        @today = Date.parse("2008-05-31")
+        @now = Time.local(2008,05,31,23,22,11)
+        @conn.select_first("SELECT :1,:2,:3,:4,:5 FROM dual",
+          nil,123,123.456,@now,@today).should == [nil,123,123.456,@now,Time.parse(@today.to_s)]
+      end
+    
+    end
+
+    it "should execute SQL statement and return all results" do
+      @now = Time.local(2008,05,31,23,22,11)
+      @conn.select_all("SELECT 'abc',123,123.456,
+          TO_DATE('#{@now.strftime("%Y-%m-%d %H:%M:%S")}','YYYY-MM-DD HH24:MI:SS')
+          FROM dual
+          UNION ALL SELECT 'abc',123,123.456,
+          TO_DATE('#{@now.strftime("%Y-%m-%d %H:%M:%S")}','YYYY-MM-DD HH24:MI:SS')
+          FROM dual").should == [["abc",123,123.456,@now],["abc",123,123.456,@now]]
+    end
+    
+    it "should execute SQL statement with bind parameters and return all results" do
+      @now = Time.local(2008,05,31,23,22,11)
+      @conn.select_all("SELECT :1,:2,:3,:4 FROM dual UNION ALL SELECT :1,:2,:3,:4 FROM dual",
+        'abc',123,123.456,@now,'abc',123,123.456,@now).should == [["abc",123,123.456,@now],["abc",123,123.456,@now]]
+    end
+    
+    it "should execute SQL statement and yield all results in block" do
+      @now = Time.local(2008,05,31,23,22,11)
+      @conn.select_all("SELECT 'abc',123,123.456,
+          TO_DATE('#{@now.strftime("%Y-%m-%d %H:%M:%S")}','YYYY-MM-DD HH24:MI:SS')
+          FROM dual
+          UNION ALL SELECT 'abc',123,123.456,
+          TO_DATE('#{@now.strftime("%Y-%m-%d %H:%M:%S")}','YYYY-MM-DD HH24:MI:SS')
+          FROM dual") do |r|
+        r.should == ["abc",123,123.456,@now]
+      end.should == 2
+    end
+    
+    it "should execute SQL statement with bind parameters and yield all results in block" do
+      @now = Time.local(2008,05,31,23,22,11)
+      @conn.select_all("SELECT :1,:2,:3,:4 FROM dual UNION ALL SELECT :1,:2,:3,:4 FROM dual",
+        'abc',123,123.456,@now,'abc',123,123.456,@now) do |r|
+        r.should == ["abc",123,123.456,@now]
+      end.should == 2
+    end
+
+  end
+  
+  describe "PL/SQL procedures" do
+    before(:each) do
+      @random = rand(1000)
+      @now = Time.local(2008,05,31,23,22,11)
+      sql = <<-EOS
+        CREATE OR REPLACE FUNCTION test_add_random (p_number NUMBER, p_varchar IN OUT VARCHAR2, p_date IN OUT DATE)
+          RETURN NUMBER
+        IS
+        BEGIN
+          RETURN p_number + #{@random};
+        END test_add_random;
+      EOS
+      @conn.exec(sql).should be_true
+    end
+
+    # it "should execute PL/SQL procedure definition" do
+    #   @conn.select_first("SELECT test_add_random(1) FROM dual").should == [@random + 1]
+    # end
+
+    it "should parse PL/SQL procedure call and bind parameters and exec and get bind parameter value" do
+      sql = <<-EOS
+        BEGIN
+          :result := test_add_random (:p_number, :p_varchar, :p_date);
+        END;
+      EOS
+      cursor = @conn.parse(sql)
+      cursor.bind_param(":result",nil,Fixnum,nil,'OUT')
+      cursor.bind_param(":p_number",100,Fixnum,3)
+      cursor.bind_param(":p_varchar","abc",String,100,'IN/OUT')
+      cursor.bind_param(":p_date",@now,Time,100,'IN/OUT')
+      cursor.exec
+      cursor[":result"].should == @random + 100
+      cursor[":p_varchar"].should == "abc"
+      cursor[":p_date"].should == @now
+      cursor.close.should be_nil
+    end
+  
+  end
+  
+  describe "commit and rollback" do
+    before(:each) do
+      sql = "CREATE TABLE test_commit (dummy VARCHAR2(100))"
+      @conn.exec(sql).should be_true
+      @conn.autocommit = false
+      @conn.should_not be_autocommit
+    end
+    after(:each) do
+      sql = "DROP TABLE test_commit"
+      @conn.exec(sql).should be_true      
+    end
+    
+    it "should do commit" do
+      @conn.exec("INSERT INTO test_commit VALUES ('test')")
+      @conn.commit
+      @conn.select_first("SELECT COUNT(*) FROM test_commit")[0].should == 1
+    end
+
+    it "should do rollback" do
+      @conn.exec("INSERT INTO test_commit VALUES ('test')")
+      @conn.rollback
+      @conn.select_first("SELECT COUNT(*) FROM test_commit")[0].should == 0
+    end
+
+    it "should do commit and rollback should not undo commited transaction" do
+      @conn.exec("INSERT INTO test_commit VALUES ('test')")
+      @conn.commit
+      @conn.rollback
+      @conn.select_first("SELECT COUNT(*) FROM test_commit")[0].should == 1
+    end
+
+  end
+
+end

data/spec/plsql/package_spec.rb

@@ -46,3 +46,61 @@ describe "Package" do
   end
 
 end
+
+describe "Synonym to package" do
+  
+  before(:all) do
+    plsql.connection = get_connection
+    plsql.connection.exec <<-EOS
+      CREATE OR REPLACE PACKAGE hr.test_package IS
+        FUNCTION test_procedure ( p_string VARCHAR2 )
+          RETURN VARCHAR2;
+      END;
+    EOS
+    plsql.connection.exec <<-EOS
+      CREATE OR REPLACE PACKAGE BODY hr.test_package IS
+        FUNCTION test_procedure ( p_string VARCHAR2 )
+          RETURN VARCHAR2
+        IS
+        BEGIN
+          RETURN UPPER(p_string);
+        END test_procedure;
+      END;
+    EOS
+    plsql.connection.exec "CREATE SYNONYM test_pkg_synonym FOR hr.test_package"
+  end
+  
+  after(:all) do
+    plsql.connection.exec "DROP SYNONYM test_pkg_synonym" rescue nil
+    plsql.logoff
+  end
+  
+  it "should find synonym to package" do
+    PLSQL::Package.find(plsql, :test_pkg_synonym).should_not be_nil
+  end
+
+  it "should execute package function using synonym and return correct value" do
+    plsql.test_pkg_synonym.test_procedure('xxx').should == 'XXX'
+  end
+
+end
+
+describe "Public synonym to package" do
+  
+  before(:all) do
+    plsql.connection = get_connection
+  end
+  
+  after(:all) do
+    plsql.logoff
+  end
+  
+  it "should find public synonym to package" do
+    PLSQL::Package.find(plsql, :utl_encode).should_not be_nil
+  end
+
+  it "should execute package function using public synonym and return correct value" do
+    plsql.utl_encode.base64_encode('abc').should == '4372773D'
+  end
+
+end