Initial Documentation and test updates

Author: sharadraju

doc/src/api_manual/dbobject.rst

@@ -8,9 +8,11 @@ Calling :meth:`connection.getDbObjectClass()` returns a prototype object
 representing a named Oracle Database object or collection. Use
 ``dbObject.prototype`` on the class to see the available attributes.
 
-Objects of a named DbObject type are: - created from a DbObject
-prototype by calling ``new()`` - returned by queries - returned when
-using BIND_OUT for an Oracle Database object.
+Objects of a named DbObject type are:
+
+- created from a DbObject prototype by calling ``new()``
+- returned by queries
+- returned when using BIND_OUT for an Oracle Database object
 
 See :ref:`Oracle Database Objects and Collections <objects>` for more
 information.
@@ -26,10 +28,10 @@ The properties of a DbObject object are listed below.
 
 .. attribute:: dbObject.attributes
 
-    This property is an object. When ``dbObject.isCollection`` is *false*,
-    this will be an object containing attributes corresponding to the Oracle
-    Database object attributes. The name of each attribute follows normal
-    Oracle casing semantics.
+    This read-only property is an object. When :attr:`dbObject.isCollection`
+    is *false*, this will be an object containing attributes corresponding to
+    the Oracle Database object attributes. The name of each attribute follows
+    normal Oracle casing semantics.
 
     Each attribute will have an object that contains:
 
@@ -57,19 +59,19 @@ The properties of a DbObject object are listed below.
 
 .. attribute:: dbObject.elementType
 
-    This read-only property is a number. When ``dbObject.isCollection`` is
+    This read-only property is a number. When :attr:`dbObject.isCollection` is
     *true*, this will have a value corresponding to one of the
     :ref:`Oracle Database Type Constants <oracledbconstantsdbtype>`.
 
 .. attribute:: dbObject.elementTypeClass
 
-    This read-only property is an object. When ``dbObject.isCollection`` is
-    *true* and the elements in the collection refer to database objects, this
-    property provides the type class information of the elements.
+    This read-only property is an object. When :attr:`dbObject.isCollection`
+    is *true* and the elements in the collection refer to database objects,
+    this property provides the type class information of the elements.
 
 .. attribute:: dbObject.elementTypeName
 
-    This read-only property is a string. When ``dbObject.isCollection`` is
+    This read-only property is a string. When :attr:`dbObject.isCollection` is
     *true*, this will have the name of the element type, such as “VARCHAR2”
     or “NUMBER”.
 
@@ -85,7 +87,7 @@ The properties of a DbObject object are listed below.
 
 .. attribute:: dbObject.length
 
-    This read-only property is a number. When ``dbObject.isCollection`` is
+    This read-only property is a number. When :attr:`dbObject.isCollection` is
     *true*, this will have the number of elements in the collection. It is
     undefined for non-collections.
 

doc/src/release_notes.rst

@@ -28,18 +28,18 @@ Common Changes
 
 #)  Added support for fetching BLOB columns which have the
     ``IS JSON FORMAT OSON`` constraint enabled in the same way as columns of
-    type JSON. In node-oracledb :ref:`Thick mode <enablingthick>` this requires
-    Oracle Client 21c or later. Applications can get this new fetch behaviour
-    by setting the oracledb property :attr:`oracledb.future.oldJsonColumnAsObj`
-    to `true`. The default value for this property is `false` which retains
-    the existing fetch behaviour.
+    type JSON. In node-oracledb :ref:`Thick mode <enablingthick>`, this
+    requires Oracle Client 21c or later. Applications can get this new fetch
+    behaviour by setting the oracledb property
+    :attr:`oracledb.future.oldJsonColumnAsObj` to `true`. The default value
+    for this property is `false` which retains the existing fetch behaviour.
     In a future version, the new fetch behaviour will become default and
     setting this property will no longer be needed.
 
 #)  Added methods :meth:`connection.decodeOSON()` and
     :meth:`connection.encodeOSON()` to support fetching and inserting into
-    columns which have the check constraint ``IS JSON FORMAT OSON``
-    enabled. See :ref:`osontype` for more information.
+    columns that have the ``IS JSON FORMAT OSON`` check constraint enabled.
+    See :ref:`osontype` for more information.
 
 #)  Connections to standby database opened `MOUNTED` return
     `NAN <https://github.com/nodejs/nan>`__ for

test/dataTypeVector1.js

@@ -1839,4 +1839,33 @@ describe('294. dataTypeVector1.js', function() {
     const result = await connection.execute(`select Vector64Col from ${tableName}`);
     assert.deepStrictEqual(result.rows[0][0], [1, 0, 3, 4, 5, 6, 7, 8, 9, 0]);
   }); // 294.71
+
+  it('294.72 inserting empty vector in Fixed and Flex vector columns', async function() {
+    const emptyVector = [];
+    const columns = ['VectorFixedCol', 'VectorFlexCol', 'VectorFlex32Col',
+      'VectorFlex64Col',
+      'VectorFlex8Col'
+    ];
+
+    const binds = [
+      { type: oracledb.DB_TYPE_VECTOR, dir: oracledb.BIND_IN, val: emptyVector }
+    ];
+
+    for (let i = 0; i < columns.length; i++) {
+      const sql = `INSERT INTO ${tableName} (IntCol, ${columns[i]})
+                       VALUES (2, :embed_array)`;
+
+      await assert.rejects(
+        async () => await connection.execute(
+          sql,
+          binds
+        ),
+        /ORA-51803:/
+        /*
+          ORA-51803: Vector dimension count must match the dimension count
+          specified in the column definition (actual: , required: ).
+       */
+      );
+    }
+  }); // 294.72
 });

test/list.txt

@@ -4190,6 +4190,9 @@ oracledb.OUT_FORMAT_OBJECT and resultSet =  true
     163.12 numIterations - No parameters
     163.13 numIterations - DML RETURNING
     163.14 Negative - set numIterations to be negative value
+    163.15 getting dmlrowcounts after executemany with dmlrowcounts=False
+    163.16 executemany() with an invalid row
+    163.17 calls PL/SQL, with round trip count check
 
 164. soda1.js
     164.1 getSodaDatabase() creates a sodaDatabase Object
@@ -5721,6 +5724,13 @@ oracledb.OUT_FORMAT_OBJECT and resultSet =  true
     294.63 test binding a vector with inf values (negative)
     294.64 fetch JSON value with an embedded vector
     294.65 bind JSON value with an embedded vector
+    294.66 with type Int16Array invalid typed arrays
+    294.67 typed arrays with strings
+    294.68 typed arrays with objects
+    294.69 typed arrays with boolean values
+    294.70 typed arrays with undefined value
+    294.71 typed arrays with null values
+    294.72 inserting empty vector in Fixed and Flex vector columns
 
 295. dataTypeVector2.js
     295.1 verify fetch information for older clients