OSON encode/decoder to support field name length > 255 bytes & relative offsets + Code refactoring for fetching Oracle Client and DB server versions in Thick mode

Author: sharadraju

doc/src/release_notes.rst

@@ -17,6 +17,12 @@ Common Changes
     returned by SODA in Oracle Database 23.4 and higher in the ``_id``
     attribute of documents stored in native collections.
 
+#)  Added support for an Oracle Database 23c JSON feature allowing for field
+    names with more than 255 UTF-8 encoded bytes.
+
+#)  Added support for an Oracle Database 23c JSON feature improving JSON
+    storage usage.
+
 Thin Mode Changes
 ++++++++++++++++++
 

lib/connection.js

@@ -860,7 +860,7 @@ class Connection extends EventEmitter {
   //---------------------------------------------------------------------------
   encodeOSON(value) {
     const encoder = new oson.OsonEncoder();
-    return encoder.encode(transformer.transformJsonValue(value));
+    return encoder.encode(transformer.transformJsonValue(value), this._impl._osonMaxFieldNameSize);
   }
 
   //---------------------------------------------------------------------------

lib/errors.js

@@ -358,7 +358,7 @@ messages.set(ERR_INTEGER_TOO_LARGE,                     // NJS-112
 messages.set(ERR_UNEXPECTED_DATA,                       // NJS-113
   'unexpected data received: %s');
 messages.set(ERR_OSON_FIELD_NAME_LIMITATION,            // NJS-114
-  'OSON field names may not exceed 255 UTF-8 encoded bytes');
+  'OSON field names may not exceed %d UTF-8 encoded bytes');
 messages.set(ERR_ORACLE_NUMBER_NO_REPR,                 // NJS-115
   'value cannot be represented as an Oracle Database number');
 messages.set(ERR_UNSUPPORTED_VERIFIER_TYPE,             // NJS-116

lib/impl/connection.js

@@ -37,6 +37,7 @@ class ConnectionImpl {
     this._inProgress = false;
     this._dbObjectTypes = new Map();
     this._requestQueue = [];
+    this._osonMaxFieldNameSize = 255;
   }
 
   //---------------------------------------------------------------------------

lib/impl/datahandlers/constants.js

@@ -44,7 +44,8 @@ module.exports = {
   TNS_JSON_MAGIC_BYTE_1: 0xff,
   TNS_JSON_MAGIC_BYTE_2: 0x4a,       // 'J'
   TNS_JSON_MAGIC_BYTE_3: 0x5a,       // 'Z'
-  TNS_JSON_VERSION: 1,
+  TNS_JSON_VERSION_MAX_FNAME_255: 1,
+  TNS_JSON_VERSION_MAX_FNAME_65535: 3,
   TNS_JSON_FLAG_HASH_ID_UINT8: 0x0100,
   TNS_JSON_FLAG_HASH_ID_UINT16: 0x0200,
   TNS_JSON_FLAG_NUM_FNAMES_UINT16: 0x0400,
@@ -56,6 +57,7 @@ module.exports = {
   TNS_JSON_FLAG_LEN_IN_PCODE: 0x04,
   TNS_JSON_FLAG_NUM_FNAMES_UINT32: 0x08,
   TNS_JSON_FLAG_IS_SCALAR: 0x10,
+  TNS_JSON_FLAG_SEC_FNAMES_SEG_UINT16: 0x100,
 
   // JSON data types
   TNS_JSON_TYPE_NULL: 0x30,