Add async/await examples

Author: cjbj

INSTALL.md

@@ -358,7 +358,7 @@ module.exports = {
 Run one of the examples:
 
 ```
-node select1.js
+node example.js
 ```
 
 *Note:* Remember to set `LD_LIBRARY_PATH` or equivalent first.
@@ -493,7 +493,7 @@ module.exports = {
 Run one of the examples:
 
 ```
-node select1.js
+node example.js
 ```
 
 *Note:* Remember to set `LD_LIBRARY_PATH` or equivalent first.
@@ -608,7 +608,7 @@ module.exports = {
 Run one of the examples:
 
 ```
-node select1.js
+node example.js
 ```
 
 ### <a name="instosx"></a> 3.5 Node-oracledb Installation on macOS
@@ -726,7 +726,7 @@ module.exports = {
 Run one of the examples:
 
 ```
-node select1.js
+node example.js
 ```
 
 ### <a name="instwin"></a> 3.6 Node-oracledb Installation on Windows with Instant Client ZIP files
@@ -853,7 +853,7 @@ module.exports = {
 Run one of the examples:
 
 ```
-node select1.js
+node example.js
 ```
 
 ### <a name="instwinoh"></a> 3.7 Node-oracledb Installation on Windows with a Local Database or Full Client
@@ -942,7 +942,7 @@ module.exports = {
 Run one of the examples:
 
 ```
-node select1.js
+node example.js
 ```
 
 ### <a name="winbins"></a> 3.8 Copying node-oracledb Binaries on Windows
@@ -1097,7 +1097,7 @@ module.exports = {
 Run one of the examples:
 
 ```
-node select1.js
+node example.js
 ```
 
 ### <a name="instsolarisx8664"></a> 3.10 Node-oracledb Installation on Oracle Solaris x86-64 (64-Bit) with Instant Client ZIP files
@@ -1216,7 +1216,7 @@ module.exports = {
 Run one of the examples:
 
 ```
-node select1.js
+node example.js
 ```
 
 ### <a name="github"></a> 3.11 Node-oracledb Installation from Source Code

README.md

@@ -23,7 +23,7 @@ See [Documentation for the Oracle Database Node.js Add-on][32] and the [CHANGELO
 ## <a name="examples"></a> Examples
 
 See the [examples][30] directory.  Start with
-[examples/select1.js][31].
+[examples/example.js][31].
 
 ## <a name="help"></a> Help
 
@@ -65,7 +65,7 @@ limitations under the License.
 [3]: https://github.com/oracle/node-oracledb/issues
 [4]: https://oracle.github.io/node-oracledb
 [30]: https://github.com/oracle/node-oracledb/blob/master/examples
-[31]: https://github.com/oracle/node-oracledb/blob/master/examples/select1.js#L35
+[31]: https://github.com/oracle/node-oracledb/blob/master/examples/example.js#L32
 [32]: https://oracle.github.io/node-oracledb/doc/api.html
 [33]: https://github.com/oracle/node-oracledb/blob/master/CHANGELOG.md
 [34]: https://github.com/oracle/node-oracledb/blob/master/test/README.md

examples/example.js

@@ -0,0 +1,115 @@
+/* Copyright (c) 2018, Oracle and/or its affiliates. All rights reserved. */
+
+/******************************************************************************
+ *
+ * You may not use the identified files except in compliance with the Apache
+ * License, Version 2.0 (the "License.")
+ *
+ * You may obtain a copy of the License at
+ * http://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * NAME
+ *   example.js
+ *
+ * DESCRIPTION
+ *   A basic node-oracledb example using Node.js 8's async/await syntax.
+ *
+ *   For a connection pool example see webapp.js
+ *   For a ResultSet example see resultset2.js
+ *   For a query stream example see selectstream.js
+ *   For a Promise example see promises.js
+ *   For a callback example see select1.js
+ *
+ *****************************************************************************/
+
+var oracledb = require('oracledb');
+var dbConfig = require('./dbconfig.js');
+
+async function run() {
+  let connection;
+
+  try {
+
+    let sql, binds, options, result;
+
+    connection = await oracledb.getConnection(  {
+      user          : dbConfig.user,
+      password      : dbConfig.password,
+      connectString : dbConfig.connectString
+    });
+
+    // Create a table
+
+    await connection.execute(
+      `BEGIN
+         EXECUTE IMMEDIATE 'DROP TABLE mytab';
+         EXCEPTION
+         WHEN OTHERS THEN
+           IF SQLCODE NOT IN (-00942) THEN
+             RAISE;
+           END IF;
+       END;`);
+
+    await connection.execute(
+      `CREATE TABLE mytab (id NUMBER, data VARCHAR2(20))`);
+
+    // Insert some data
+
+    sql = `INSERT INTO mytab VALUES (:1, :2)`;
+
+    binds = [ [101, "Alpha" ], [102, "Beta" ], [103, "Gamma" ] ];
+
+    // For a complete list of options see the documentation.
+    options = {
+      autoCommit: true,
+      // batchErrors: true,  // continue processing even if there are data errors
+      bindDefs: [
+        { type: oracledb.NUMBER },
+        { type: oracledb.STRING, maxSize: 20 }
+      ]
+    };
+
+    result = await connection.executeMany(sql, binds, options);
+
+    console.log("Number of rows inserted:", result.rowsAffected);
+
+    // Query the data
+
+    sql = `SELECT * FROM mytab`;
+
+    binds = {};
+
+    // For a complete list of options see the documentation.
+    options = {
+      outFormat: oracledb.OBJECT   // query result format
+      // extendedMetaData: true,   // get extra metadata
+      // fetchArraySize: 100       // internal buffer allocation size for tuning
+    };
+
+    result = await connection.execute(sql, binds, options);
+
+    console.log("Column metadata: ", result.metaData);
+    console.log("Query results: ");
+    console.log(result.rows);
+
+  } catch (err) {
+    console.error(err);
+  } finally {
+    if (connection) {
+      try {
+        await connection.close();
+      } catch (err) {
+        console.error(err);
+      }
+    }
+  }
+}
+
+run();

examples/select1.js

@@ -25,6 +25,7 @@
  *   Scripts to create the HR schema can be found at:
  *   https://github.com/oracle/db-sample-schemas
  *
+ *   For an async/await example see selectawait.js
  *   For a connection pool example see webapp.js
  *   For a ResultSet example see resultset2.js
  *   For a query stream example see selectstream.js