ruby-oci8 2.2.6.1 → 2.2.7

data/ChangeLog

@@ -1,11 +1,60 @@
-2018-09-16  Kubo Takehiro <kubo@jiubao.org>
-	* NEWS: Add changes between 2.2.6 and 2.2.6.1
-	* lib/oci8/version.rb: Update to 2.2.6.1
+2019-01-06  Kubo Takehiro <kubo@jiubao.org>
+	* NEWS: Add changes between 2.2.6.1 and 2.2.7.
+	* lib/oci8/version.rb: Update to 2.2.7
+
+2019-01-06  Kubo Takehiro <kubo@jiubao.org>
+	* mkpkg-win32.rb, ruby-oci8.gemspec: Build binary gems for ruby 2.6
+	    on Windows.
+
+2019-01-06  Kubo Takehiro <kubo@jiubao.org>
+	* ext/oci8/oci8.c: Updata doc comments for OCI8#long_read_len
+	    and OCI8#long_read_len=. These are deprecated.
+
+2019-01-03  Kubo Takehiro <kubo@jiubao.org>
+	* lib/oci8/check_load_error.rb: Use fiddle instead of Win32API
+	    to call WIN32 functions.
+
+2019-01-03  Kubo Takehiro <kubo@jiubao.org>
+	* lib/oci8/check_load_error.rb: Add more error diagnostics
+	    when 'require "oci8"' fails with "OCI.DLL: 126(The specified
+	    module could not be found.)".
+
+2019-01-03  Kubo Takehiro <kubo@jiubao.org>
+	* lib/oci8.rb, lib/oci8/check_load_error.rb: Exclude empty
+	    parts of PATH on Windows.
+
+2018-12-23  Kubo Takehiro <kubo@jiubao.org>
+	* lib/oci8/check_load_error.rb: Check OCI.DLL archtecture
+	  when load error. It worked for ruby installer but not
+	  for ruby installer2.
+
+2018-12-23  Kubo Takehiro <kubo@jiubao.org>
+	* docs/install-instant-client.md: Add information about
+	  the MSVC redistributable package required by Oracle 18.3 client.
 
 2018-09-16  Kubo Takehiro <kubo@jiubao.org>
 	* ext/oci8/hook_funcs.c: Fix "No shared library is found to hook." on macOS.
 	    (oracle-enhanced issue #1768)
 
+2018-09-11  Kubo Takehiro <kubo@jiubao.org>
+	* ext/oci8/object.c, lib/oci8/cursor.rb: Change the internal structure
+	    about object type binding to use array fetching for object types.
+
+2018-09-09  Kubo Takehiro <kubo@jiubao.org>
+	* ext/oci8/lob.c: Read lob data without checking readable size to
+	    reduce number of network round trips from two to one.
+
+2018-09-05  Kubo Takehiro <kubo@jiubao.org>
+	* ext/oci8/bind.c, ext/oci8/stmt.c, lib/oci8/cursor.rb,
+	  lib/oci8/oci8.rb, test/test_oci8.rb: Use array fetching when
+	    LOB colums are in a query and no object types are in the query.
+
+2018-09-02  Kubo Takehiro <kubo@jiubao.org>
+	* ext/oci8/apiwrap.yml, ext/oci8/bind.c, ext/oci8/stmt.c,
+	  lib/oci8/bindtype.rb, test/test_oci8.rb: Rewrite OCI8::BindType::Long
+	    and OCI8::BindType::LongRaw to handle up to 2 gigabyte data using
+	    dynamically allocated buffers.
+
 2018-08-22  Kubo Takehiro <kubo@jiubao.org>
 	* NEWS: Add changes between 2.2.5.1 and 2.2.6
 	* lib/oci8/version.rb: Update to 2.2.6

data/NEWS

@@ -1,15 +1,67 @@
 # @markup markdown
 
-2.2.6.1
-=======
+2.2.7 (2019-01-06)
+==================
+
+Incompatible Changes
+--------------------
+
+### `OCI8#long_read_len` and `OCI8#long_read_len=` do nothing.
+
+When `LONG`, `LONG RAW` or `XMLTYPE` data were fetched, the data were
+truncated at `OCI8#long_read_len`. The maximum size of data had
+been 4 gigabytes since this release.
+
+`OCI8#long_read_len` and `OCI8#long_read_len=` remain for code-compatibility
+but do nothing.
+
+Improvement
+-----------
+
+### The number of network round trips was reduced when LOB data are read.
+
+When LOB data are read, ruby-oci8 before 2.2.7 does the followings:
+
+1. Gets the size of the LOB.
+2. Allocate buffer to hold the data.
+3. Read the LOB contents.
+
+This requires two round trips.
+
+It now does the followings:
+
+1. Request the server to get LOB contents up to 4 gigabytes.
+2. Read the LOB contents and allocate buffer when the size is insufficient.
+3. If the total length of received data is less than 4 gigabytes, all data
+   are read. If not, go to the first step to read next 4 gigabytes.
+
+This requires only one round trip if the size is less than 4 gigabytes.
+
+### Use array fetching instead of prefetching when LOB columns are in queries 
+
+When LOB columns are in queries, prefetching doesn't seem to work. Rows
+are fetched one by one according to data captured by network packet sniffer.
+So array fetching is used instead of prefetching to reduce the number of
+network round trips.
+
+### Add error diagnostics when `'require "oci8"'` fails on Windows.
+
+When `'require "oci8"'` fails with "OCI.DLL: 126(The specified module could not be found.)"
+on Windows, the cause is not always that OCI.DLL is not found. It may
+be incorrect architecture, missing dependent DLLs and so on.
+Ruby-oci8 checks PATH and DLL files when the error is raised and change
+the error message to reasonable one as possible.
+
+2.2.6.1 (2018-09-16)
+====================
 
 Fixed issue
 -----------
 Fix "No shared library is found to hook." on macOS.
 (rsim/oracle-enhanced#1768)
 
-2.2.6
-=====
+2.2.6 (2018-08-22)
+==================
 
 This release fixed issues about Oracle 18c except one.
 
@@ -47,8 +99,8 @@ communication channel."
 
 (github issue #185)
 
-2.2.5.1
-=======
+2.2.5.1 (2017-12-27)
+====================
 
 No updates except tests. The version number was changed just to release
 binary gems for ruby 2.5 on Windows.
@@ -57,8 +109,8 @@ binary gems for ruby 2.5 on Windows.
 
 (github issue #180, #181)
 
-2.2.5
-=====
+2.2.5 (2017-10-21)
+==================
 
 New Features
 ------------
@@ -115,8 +167,8 @@ Other Changes
 See {file:docs/number-type-mapping.md Number Type Mapping between Oracle and Ruby}.
 (github issue #173)
 
-2.2.4.1
-=======
+2.2.4.1 (2017-06-17)
+====================
 
 Fixed issue
 -----------
@@ -130,8 +182,8 @@ differently, it may cause unexpected behavior.
 
 ### Fix compilation errors in 2.2.4 on cygwin
 
-2.2.4
-=====
+2.2.4 (2017-06-11)
+==================
 
 New Features
 ------------
@@ -169,8 +221,8 @@ Use Win32::Registry instead of Win32API to compile ruby-oci8 on the latest cygwi
 
 (contributed by davidbrs. [github issue #156](https://github.com/kubo/ruby-oci8/issues/156))
 
-2.2.3
-=====
+2.2.3 (2016-12-27)
+==================
 
 New Features
 ------------
@@ -183,8 +235,8 @@ New Features
 -   Suppress warnings outputted by Minitest in ruby 2.4.0
 -   Suppress warnings when compiling with ruby 2.4.0
 
-2.2.2
-=====
+2.2.2 (2016-04-24)
+==================
 
 New Features
 ------------
@@ -230,8 +282,8 @@ Other Changes
 -   Check the default value of DYLD_FALLBACK_LIBRARY_PATH after checking OCI_DIR on installation. (OS X only)
 
 
-2.2.1
-=====
+2.2.1 (2015-11-01)
+==================
 
 New Features
 ------------
@@ -259,16 +311,16 @@ Other Changes
 
 -   Delete unused code which was added to support old Oracle and ruby 1.8.
 
-2.2.0.2
-=======
+2.2.0.2 (2015-10-12)
+====================
 
 Nothing was changed except the version.
 
 The forth version was incremented to release binary gems for mingw32.
 The binary gems for 2.2.0.1 didn't work by faultily packaging.
 
-2.2.0.1
-=======
+2.2.0.1 (2015-10-11)
+====================
 
 If ruby-oci8 2.2.0 is installed, you have no need to update it to
 2.2.0.1. Source code itself was not changed between 2.2.0 and 2.2.0.1.
@@ -284,8 +336,8 @@ Ruby-oci8 2.2.0 documents had not been generated in rubydoc.info
 though the URLs are displayed on installation failure. They were
 changed to documents generated by the latest github repository.
 
-2.2.0
-=====
+2.2.0 (2015-10-04)
+==================
 
 ### Drop ruby 1.8 support
 
@@ -326,8 +378,8 @@ Other Changes
 -   Add OCI8.charset_name2id and OCI8.charset_id2name.
     Mark OCI8#charset_name2id and OCI8#charset_id2name as deprecated.
 
-2.1.8
-=====
+2.1.8 (2015-04-04)
+==================
 
 New Features
 ------------
@@ -387,8 +439,8 @@ Fixed Issues
 -   Don't use SYM2ID on ruby 2.2.0 or later not to make symbols unGCable
     by [Symbol GC](http://www.infoq.com/news/2014/12/ruby-2.2.0-released).
 
-2.1.7
-=====
+2.1.7 (2014-02-02)
+==================
 
 New Features
 ------------
@@ -400,8 +452,8 @@ Fixed Issues
 
 -   Fix OCI8#describe_table to follow synonyms in a remote database.
 
-2.1.6
-=====
+2.1.6 (2013-12-29)
+==================
 
 New Features
 ------------
@@ -441,8 +493,8 @@ Fixed Issues
 -   fix SEGV when one connection is used by more than two threads and temporary
     lobs are freed by GC.
 
-2.1.5
-=====
+2.1.5 (2013-03-09)
+==================
 
 New Features
 ------------
@@ -462,8 +514,8 @@ Fixed Issues
     instant client is 11.2.0.3 for Solaris x86 32-bit, the ruby
     version is 1.9.3 or upper and the ruby is compiled by gcc.
 
-2.1.4
-=====
+2.1.4 (2013-01-06)
+==================
 
 New Features
 ------------
@@ -503,8 +555,8 @@ Fixed Issues
 
     (reported by Brian Henderson)
 
-2.1.3
-=====
+2.1.3 (2012-11-11)
+==================
 
 New Features
 ------------
@@ -561,8 +613,8 @@ Fixed Issues
 -   Fix #<NoMethodError: undefined method `timezone' for Time:Class>
     when ruby is less than 1.9.2 and an object type's time attribute is accessed.
 
-2.1.2
-=====
+2.1.2 (2012-04-28)
+==================
 
 Specification changes
 ---------------------
@@ -583,8 +635,8 @@ Fixed Issues
 
     (reported by Yasuo Honda)
 
-2.1.1
-=====
+2.1.1 (2012-04-22)
+==================
 
 New Features
 ------------
@@ -631,8 +683,8 @@ Fixed Issues
 
     (repored by Leoš Bitto)
 
-2.1.0
-=====
+2.1.0 (2011-12-13)
+==================
 
 New Features
 ------------
@@ -747,8 +799,8 @@ Fixed Issues
 
     (reported by jbirdjavi)
 
-2.0.6
-=====
+2.0.6 (2011-06-14)
+==================
 
 Fixed issues
 ------------
@@ -759,8 +811,8 @@ Fixed issues
     a closed OCI handle's method is called. It was chaned in 2.0.5
     by mistake.
 
-2.0.5
-=====
+2.0.5 (2011-06-12)
+==================
 
 New Features
 ------------
@@ -848,8 +900,8 @@ Fixed issues
 
     (reported by Sebastian YEPES)
 
-2.0.4
-=====
+2.0.4 (2010-02-28)
+==================
 
 New Features
 ------------
@@ -910,8 +962,8 @@ Fixed issues
 
     (reported by Raimonds Simanovskis)
 
-2.0.3
-=====
+2.0.3 (2009-10-21)
+==================
 
 Incompatible Changes
 --------------------
@@ -1051,8 +1103,8 @@ Fixed installation issues
 
     (reported by Kazuya Teramoto)
 
-2.0.2
-=====
+2.0.2 (2009-05-17)
+==================
 
 *   add new methods
     -   {OCI8#select_one}
@@ -1092,8 +1144,8 @@ Fixed installation issues
 *   [ruby 1.9] fix to bind string data by the length got from String#bytesize
     converted to {OCI8.encoding}, not by String#size.
 
-2.0.1
-=====
+2.0.1 (2009-03-17)
+==================
 
 *   release a binary gem for Windows, which contains libraries for both
     ruby 1.8 and ruby 1.9.1.

data/dist-files

@@ -80,7 +80,7 @@ lib/oci8/oracle_version.rb
 lib/oci8/properties.rb
 lib/oci8/version.rb
 lib/ruby-oci8.rb
-test/README
+test/README.md
 test/config.rb
 test/setup_test_object.sql
 test/setup_test_package.sql

data/docs/install-instant-client.md

@@ -110,6 +110,7 @@ Package" or copy a runtime library to the directory where `ruby.exe` resides.
 
 | Oracle Version | Package | Runtime Library|
 |---|---|---|
+| 18.3     | [Microsoft Visual C++ 2013 Redistributable Package][2013] | MSVCR120.DLL |
 | 12.2.0.x | [Microsoft Visual C++ 2013 Redistributable Package][2013] | MSVCR120.DLL |
 | 12.1.0.x | [Microsoft Visual C++ 2010 Redistributable Package][2010] | MSVCR100.DLL |
 | 11.2.0.x | Microsoft Visual C++ 2005 SP1 Redistributable Package ([x86][2005SP1_x86], [x64][2005SP1_x64]) | MSVCR80.DLL(The file version must be 8.0.50727.762.) |

data/ext/oci8/apiwrap.yml

@@ -83,6 +83,17 @@ OCIBindByPos:
             - ub4 *curelep
             - ub4 mode
 
+# round trip: 0
+OCIBindDynamic:
+  :version: 800
+  :args:
+            - OCIBind *bindp
+            - OCIError *errhp
+            - void  *ictxp
+            - OCICallbackInBind icbfp
+            - void  *octxp
+            - OCICallbackOutBind ocbfp
+
 # round trip: 0
 OCIBindObject:
   :version: 800
@@ -180,6 +191,15 @@ OCIDefineByPos:
             - ub2 *rcodep
             - ub4 mode
 
+# round trip: 0
+OCIDefineDynamic:
+  :version: 800
+  :args:
+            - OCIDefine *defnp
+            - OCIError *errhp
+            - dvoid *octxp
+            - OCICallbackDefine ocbfp
+
 # round trip: 0
 OCIDefineObject:
   :version: 800