node-firebird-driver/src/lib/impl/client.ts

Firebird Driver Interfaces for Node.js

import { AbstractAttachment } from './attachment';

import {
	Client,
	ConnectOptions,
	CreateDatabaseOptions,
	ExecuteOptions,
	ExecuteQueryOptions,
	FetchOptions,
	PrepareOptions,
	TransactionOptions
} from '..';


/** AbstractClient implementation. */
export abstract class AbstractClient implements Client {
	connected = true;
	attachments = new Set<AbstractAttachment>();

	/** Default connect options. */
	defaultConnectOptions: ConnectOptions;

	/** Set default create database options. */
	defaultCreateDatabaseOptions: CreateDatabaseOptions;

	/** Default transaction options. */
	defaultTransactionOptions: TransactionOptions;

	/** Default query's prepare options. */
	defaultPrepareOptions: PrepareOptions;

	/** Default query's execute options. */
	defaultExecuteOptions: ExecuteOptions;

	/** Default query's executeQuery options. */
	defaultExecuteQueryOptions: ExecuteQueryOptions;

	/** Default result set's fetch options. */
	defaultFetchOptions: FetchOptions;

	/** Disposes this client's resources. */
	async dispose(): Promise<void> {
		this.check();

		try {
			await Promise.all(Array.from(this.attachments).map(attachment => attachment.disconnect()));
		}
		finally {
			this.attachments.clear();
		}

		await this.internalDispose();

		this.connected = false;
	}

	/** Connects to a database. */
	async connect(uri: string, options?: ConnectOptions): Promise<AbstractAttachment> {
		this.check();

		const attachment = await this.internalConnect(uri, options || this.defaultConnectOptions);
		this.attachments.add(attachment);
		return attachment;
	}

	/** Creates a database. */
	async createDatabase(uri: string, options?: CreateDatabaseOptions): Promise<AbstractAttachment> {
		this.check();

		const attachment = await this.internalCreateDatabase(uri, options || this.defaultCreateDatabaseOptions);
		this.attachments.add(attachment);
		return attachment;
	}

	get isValid(): boolean {
		return !!this.connected;
	}

	private check() {
		if (!this.isValid)
			throw new Error('Client is already disposed.');
	}

	protected abstract internalDispose(): Promise<void>;
	protected abstract internalConnect(uri: string, options?: ConnectOptions): Promise<AbstractAttachment>;
	protected abstract internalCreateDatabase(uri: string, options?: CreateDatabaseOptions): Promise<AbstractAttachment>;
}