@barchart/common-node-js/database/mysql/Client.js

Common classes, utilities, and functions for building Node.js servers

const log4js = require('log4js');

const uuid = require('uuid');

const assert = require('@barchart/common-js/lang/assert'),
	Disposable = require('@barchart/common-js/lang/Disposable'),
	promise = require('@barchart/common-js/lang/promise');

module.exports = (() => {
	'use strict';

	const logger = log4js.getLogger('common-node/database/mysql/Client');

	let queryCounter = 0;

	/**
	 * An abstract class for executing queries against a MySQL database.
	 *
	 * @public
	 * @abstract
	 */
	class Client extends Disposable {
		constructor(connection) {
			super();

			assert.argumentIsRequired(connection, 'connection', Object);

			this._id = uuid.v4();
			this._connection = connection;
		}

		/**
		 * A unique identifier to identify the client.
		 *
		 * @public
		 * @returns {String}
		 */
		get id() {
			return this._id;
		}

		/**
		 * Executes a query.
		 *
		 * @public
		 * @async
		 * @param {String} query
		 * @param {Array=} parameters
		 * @param {String=} name
		 * @returns {Promise<Object[]>}
		 */
		async query(query, parameters, name) {
			if (this.getIsDisposed()) {
				return Promise.reject(`Unable to execute MySQL query, the ${this.toString()} has been disposed`);
			}

			assert.argumentIsRequired(query, 'query', String);
			assert.argumentIsOptional(name, 'name', String);

			return promise.build((resolveCallback, rejectCallback) => {
				queryCounter = queryCounter + 1;

				const queryCount = queryCounter;

				logger.debug('Executing query [', queryCount, '] from client [', this._id, ']');

				this._connection.query(query, parameters || [ ], (e, result) => {
					if (e) {
						logger.debug('Query [', queryCount, '] from client [', this._id, '] failed');

						rejectCallback(e);
					} else {
						logger.debug('Query [', queryCount, '] from client [', this._id, '] finished');

						resolveCallback(result);
					}
				});
			});
		}

		toString() {
			return '[Client]';
		}
	}

	return Client;
})();