2023-02-21 12:18:03 +08:00
|
|
|
/* Copyright (c) 2019, 2023, Oracle and/or its affiliates. */
|
2019-05-03 07:13:32 +08:00
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
*
|
2023-02-21 09:43:43 +08:00
|
|
|
* This software is dual-licensed to you under the Universal Permissive License
|
|
|
|
* (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License
|
|
|
|
* 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose
|
|
|
|
* either license.
|
2019-05-03 07:13:32 +08:00
|
|
|
*
|
2023-02-21 09:43:43 +08:00
|
|
|
* If you elect to accept the software under the Apache License, Version 2.0,
|
|
|
|
* the following applies:
|
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
2019-05-03 07:13:32 +08:00
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
2023-02-21 09:43:43 +08:00
|
|
|
* https://www.apache.org/licenses/LICENSE-2.0
|
2019-05-03 07:13:32 +08:00
|
|
|
*
|
2023-02-21 09:43:43 +08:00
|
|
|
* 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.
|
2019-05-03 07:13:32 +08:00
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*
|
|
|
|
* NAME
|
|
|
|
* aqoptions.js
|
|
|
|
*
|
|
|
|
* DESCRIPTION
|
|
|
|
* Oracle Advanced Queuing (AQ) example setting options and message attributes.
|
|
|
|
*
|
2023-10-31 12:35:56 +08:00
|
|
|
* Warning: Creates and drops a new user for running AQ operations.
|
|
|
|
* Requires NODE_ORACLEDB_DBA_USER and NODE_ORACLE_DBA_PASSWORD env variables
|
|
|
|
* to be set for the AQ user to be created and dropped.
|
2019-05-03 07:13:32 +08:00
|
|
|
*
|
|
|
|
*****************************************************************************/
|
|
|
|
|
2023-05-23 22:20:06 +08:00
|
|
|
'use strict';
|
|
|
|
|
|
|
|
Error.stackTraceLimit = 50;
|
|
|
|
|
2019-05-03 07:13:32 +08:00
|
|
|
const oracledb = require('oracledb');
|
|
|
|
const dbConfig = require('./dbconfig.js');
|
2023-10-31 12:35:56 +08:00
|
|
|
const aqUtil = require('./aqutil.js');
|
2019-05-03 07:13:32 +08:00
|
|
|
|
2023-05-23 22:20:06 +08:00
|
|
|
// This example requires node-oracledb Thick mode.
|
|
|
|
//
|
|
|
|
// Thick mode requires Oracle Client or Oracle Instant Client libraries. On
|
|
|
|
// Windows and macOS Intel you can specify the directory containing the
|
|
|
|
// libraries at runtime or before Node.js starts. On other platforms (where
|
|
|
|
// Oracle libraries are available) the system library search path must always
|
|
|
|
// include the Oracle library path before Node.js starts. If the search path
|
|
|
|
// is not correct, you will get a DPI-1047 error. See the node-oracledb
|
|
|
|
// installation documentation.
|
|
|
|
let clientOpts = {};
|
2023-10-31 12:35:56 +08:00
|
|
|
// On Windows and macOS Intel platforms, set the environment
|
|
|
|
// variable NODE_ORACLEDB_CLIENT_LIB_DIR to the Oracle Client library path
|
|
|
|
if (process.platform === 'win32' || (process.platform === 'darwin' && process.arch === 'x64')) {
|
|
|
|
clientOpts = { libDir: process.env.NODE_ORACLEDB_CLIENT_LIB_DIR };
|
2021-05-20 14:47:23 +08:00
|
|
|
}
|
2023-05-23 22:20:06 +08:00
|
|
|
oracledb.initOracleClient(clientOpts); // enable node-oracledb Thick mode
|
2021-05-20 14:47:23 +08:00
|
|
|
|
2019-05-03 07:13:32 +08:00
|
|
|
const queueName = "DEMO_RAW_QUEUE";
|
2023-10-31 12:35:56 +08:00
|
|
|
const RAW_TABLE = "NODB_RAW_QUEUE_TAB";
|
|
|
|
const AQ_USER = "NODB_SCHEMA_AQTEST1";
|
|
|
|
const AQ_USER_PWD = aqUtil.generateRandomPassword();
|
2019-05-03 07:13:32 +08:00
|
|
|
|
2023-10-31 12:35:56 +08:00
|
|
|
let connection;
|
|
|
|
|
|
|
|
const credentials = {
|
|
|
|
user: AQ_USER,
|
|
|
|
password: AQ_USER_PWD,
|
|
|
|
connectString: dbConfig.connectString
|
|
|
|
};
|
2019-05-03 07:13:32 +08:00
|
|
|
|
2023-10-31 12:35:56 +08:00
|
|
|
async function aqSetup() {
|
|
|
|
await aqUtil.createAQtestUser(AQ_USER, AQ_USER_PWD);
|
|
|
|
connection = await oracledb.getConnection(credentials);
|
|
|
|
|
|
|
|
const plsql = `
|
|
|
|
BEGIN
|
|
|
|
DBMS_AQADM.CREATE_QUEUE_TABLE(
|
|
|
|
QUEUE_TABLE => '${AQ_USER}.${RAW_TABLE}',
|
|
|
|
QUEUE_PAYLOAD_TYPE => 'RAW'
|
|
|
|
);
|
|
|
|
DBMS_AQADM.CREATE_QUEUE(
|
|
|
|
QUEUE_NAME => '${AQ_USER}.${queueName}',
|
|
|
|
QUEUE_TABLE => '${AQ_USER}.${RAW_TABLE}'
|
|
|
|
);
|
|
|
|
DBMS_AQADM.START_QUEUE(
|
|
|
|
QUEUE_NAME => '${AQ_USER}.${queueName}'
|
|
|
|
);
|
|
|
|
END;
|
|
|
|
`;
|
|
|
|
await connection.execute(plsql);
|
|
|
|
await connection.close();
|
|
|
|
}
|
|
|
|
|
|
|
|
async function enq() {
|
2019-05-03 07:13:32 +08:00
|
|
|
try {
|
2023-10-31 12:35:56 +08:00
|
|
|
connection = await oracledb.getConnection(credentials);
|
2019-05-03 07:13:32 +08:00
|
|
|
|
2019-06-28 08:28:18 +08:00
|
|
|
const queue = await connection.getQueue(queueName);
|
2019-05-03 07:13:32 +08:00
|
|
|
queue.enqOptions.visibility = oracledb.AQ_VISIBILITY_IMMEDIATE; // Send a message immediately without requiring a commit
|
|
|
|
|
|
|
|
const messageString = 'This is my other message';
|
|
|
|
const message = {
|
|
|
|
payload: messageString, // the message itself
|
2023-10-31 12:35:56 +08:00
|
|
|
expiration: 1 // number of seconds that the message will remain in the queue if not dequeued
|
2019-05-03 07:13:32 +08:00
|
|
|
};
|
|
|
|
console.log('Enqueuing: ' + messageString);
|
|
|
|
await queue.enqOne(message);
|
|
|
|
} catch (err) {
|
|
|
|
console.error(err);
|
|
|
|
} finally {
|
|
|
|
if (connection) {
|
|
|
|
try {
|
|
|
|
await connection.close();
|
|
|
|
} catch (err) {
|
|
|
|
console.error(err);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
async function deq() {
|
|
|
|
let connection;
|
|
|
|
|
|
|
|
try {
|
2023-10-31 12:35:56 +08:00
|
|
|
connection = await oracledb.getConnection(credentials);
|
2019-05-03 07:13:32 +08:00
|
|
|
|
2019-06-28 08:28:18 +08:00
|
|
|
const queue = await connection.getQueue(queueName);
|
2019-05-28 15:51:53 +08:00
|
|
|
Object.assign(
|
|
|
|
queue.deqOptions,
|
|
|
|
{
|
|
|
|
visibility: oracledb.AQ_VISIBILITY_IMMEDIATE, // Change the visibility so no explicit commit is required
|
|
|
|
wait: 5 // Only wait 5 seconds if there are no messages
|
|
|
|
}
|
|
|
|
);
|
2019-05-03 07:13:32 +08:00
|
|
|
|
|
|
|
const msg = await queue.deqOne();
|
|
|
|
if (msg) {
|
|
|
|
console.log('Dequeued: ' + msg.payload.toString());
|
|
|
|
} else {
|
|
|
|
console.log('No message to dequeue');
|
|
|
|
}
|
|
|
|
} catch (err) {
|
|
|
|
console.error(err);
|
|
|
|
} finally {
|
|
|
|
if (connection) {
|
|
|
|
try {
|
|
|
|
await connection.close();
|
|
|
|
} catch (err) {
|
|
|
|
console.error(err);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-10-31 12:35:56 +08:00
|
|
|
async function run() {
|
|
|
|
await aqSetup();
|
|
|
|
await enq();
|
|
|
|
await deq();
|
|
|
|
await aqUtil.dropAQtestUser(AQ_USER);
|
|
|
|
}
|
|
|
|
|
|
|
|
run();
|