オブジェクト組み込みオブジェクト

オブジェクトデータベース接続

DBConnection はデータベース接続の基本クラスであり、データベース接続セッションの確立と維持に使用されます。これは接続の基本操作を実装し、派生クラスの基礎として機能します。また、トランザクションの開始、トランザクションのコミット、トランザクションのロールバックなどの操作もサポートします。

DBConnection のサブクラスには次のものがあります。OdbcMySQLSQLite, 各サブクラスをインスタンス化することで、さまざまな種類のデータベースに簡単にアクセスできます。

DBConnection は直接作成できません。db.open他の方法で作成された場合、たとえば次のようになります。

1 2
var db = require("db"); var conn = db.open("mysql://root:123456@localhost:3306/test");

相続関係

メンバーのプロパティ

type

文字列、現在の接続データベースの種類を照会します。

1
readonly String DbConnection.type;

メンバー関数

close

現在のデータベース接続を閉じます

1
DbConnection.close() async;

use

現在のデータベース接続のデフォルトのデータベースを選択します

1
DbConnection.use(String dbName) async;

呼び出しパラメータ:

  • dbName: 文字列、データベース名を指定します

begin

現在のデータベース接続でトランザクションを開始します

1
DbConnection.begin(String point = "") async;

呼び出しパラメータ:

  • point: 文字列。トランザクションの名前を指定します。デフォルトでは指定されていません

commit

現在のデータベース接続でトランザクションをコミットします

1
DbConnection.commit(String point = "") async;

呼び出しパラメータ:

  • point: 文字列。トランザクションの名前を指定します。デフォルトでは指定されていません

rollback

現在のデータベース接続でトランザクションをロールバックする

1
DbConnection.rollback(String point = "") async;

呼び出しパラメータ:

  • point: 文字列。トランザクションの名前を指定します。デフォルトでは指定されていません

trans

トランザクションを入力して関数を実行し、関数の実行に基づいてコミットまたはロールバックします。

1
Boolean DbConnection.trans(Function func);

呼び出しパラメータ:

  • func: 関数、トランザクション方式で実行される関数

返される結果:

  • Boolean、トランザクションがコミットされているかどうかを返し、通常のコミットの場合は true を返し、ロールバックの場合は false を返し、トランザクションが失敗した場合はエラーをスローします。

func の実行結果は 3 つあります。

  • 関数は、操作の終了とアクティブな戻りを含めて通常に戻り、その時点でトランザクションは自動的にコミットされます。
  • 関数は false を返し、トランザクションはロールバックされます。
  • 関数操作エラー、トランザクションは自動的にロールバックされます

トランザクションを入力して関数を実行し、関数の実行に基づいてコミットまたはロールバックします。

1 2
Boolean DbConnection.trans(String point, Function func);

呼び出しパラメータ:

  • point: 文字列、トランザクションの名前を指定します
  • func: 関数、トランザクション方式で実行される関数

返される結果:

  • Boolean、トランザクションがコミットされているかどうかを返し、通常のコミットの場合は true を返し、ロールバックの場合は false を返し、トランザクションが失敗した場合はエラーをスローします。

func の実行結果は 3 つあります。

  • 関数は、操作の終了とアクティブな戻りを含めて通常に戻り、その時点でトランザクションは自動的にコミットされます。
  • 関数は false を返し、トランザクションはロールバックされます。
  • 関数操作エラー、トランザクションは自動的にロールバックされます

execute

SQLコマンドを実行し、実行結果を返す

1
NArray DbConnection.execute(String sql) async;

呼び出しパラメータ:

  • sql:文字列、文字列

返される結果:

  • NArrayは、結果レコードを含む配列を返します。要求が UPDATE または INSERT の場合、返される結果には、影響を受ける Id と insertId も含まれます。mssql は、insertId をサポートしません。

SQLコマンドを実行し、実行結果を返します。文字列はパラメータに従ってフォーマットできます。

1 2
NArray DbConnection.execute(String sql, ...args) async;

呼び出しパラメータ:

  • sql: 文字列、書式文字列、オプションのパラメータは?で指定します。例: 「SELECT FROM TEST WHERE [id]=?」
  • args: ...、オプションのパラメータリスト

返される結果:

  • NArrayは、結果レコードを含む配列を返します。要求が UPDATE または INSERT の場合、返される結果には、影響を受ける Id と insertId も含まれます。mssql は、insertId をサポートしません。

createTable

データテーブルの作成

1
DbConnection.createTable(Object opts) async;

呼び出しパラメータ:

  • opts:オブジェクト、パラメータリスト

dropTable

データテーブルの削除

1
DbConnection.dropTable(Object opts) async;

呼び出しパラメータ:

  • opts:オブジェクト、パラメータリスト

createIndex

データテーブルのインデックスを作成する

1
DbConnection.createIndex(Object opts) async;

呼び出しパラメータ:

  • opts:オブジェクト、パラメータリスト

dropIndex

データテーブルインデックスの削除

1
DbConnection.dropIndex(Object opts) async;

呼び出しパラメータ:

  • opts:オブジェクト、パラメータリスト

insert

新しいレコードを挿入

1
Number DbConnection.insert(Object opts) async;

呼び出しパラメータ:

  • opts:オブジェクト、パラメータリスト

返される結果:

  • Number、挿入を含む ID を返します。エンジンがサポートしていない場合は 0 を返します。

find

指定した条件に基づいてデータをクエリする

1
NArray DbConnection.find(Object opts) async;

呼び出しパラメータ:

  • opts:オブジェクト、パラメータリスト

返される結果:

  • NArray、結果を含むレコードを返します

count

指定した条件に基づいてデータのレコード数をカウントします

1
Integer DbConnection.count(Object opts) async;

呼び出しパラメータ:

  • opts:オブジェクト、パラメータリスト

返される結果:

  • Integer、結果を含むレコードの数を返します。

update

指定した条件に基づいてデータを更新します

1
Integer DbConnection.update(Object opts) async;

呼び出しパラメータ:

  • opts:オブジェクト、パラメータリスト

返される結果:

  • Integer、更新を含むレコードの数を返します。

remove

指定した条件に基づいてデータを削除します

1
Integer DbConnection.remove(Object opts) async;

呼び出しパラメータ:

  • opts: オブジェクト、オプションのパラメータリスト

返される結果:

  • Integer、更新を含むレコードの数を返します。

format

SQLコマンドをフォーマットし、フォーマットされた結果を返します。

1 2
String DbConnection.format(String method, Object opts);

呼び出しパラメータ:

  • method: 文字列、要求されたメソッドを指定します
  • opts: オブジェクト、オプションのパラメータリスト

返される結果:

  • String、フォーマットされたSQLコマンドを返します。

SQLコマンドをフォーマットし、フォーマットされた結果を返します。

1 2
String DbConnection.format(String sql, ...args);

呼び出しパラメータ:

  • sql: 文字列、書式文字列、オプションのパラメータは?で指定します。例: 「SELECT FROM TEST WHERE [id]=?」
  • args: ...、オプションのパラメータリスト

返される結果:

  • String、フォーマットされたSQLコマンドを返します。

toString

オブジェクトの文字列表現を返します。通常、「[Native Object]」が返されます。オブジェクトは、独自の特性に従って再実装できます。

1
String DbConnection.toString();

返される結果:

  • String、オブジェクトの文字列表現を返します。

toJSON

オブジェクトの JSON 形式表現を返します。通常は、オブジェクトによって定義された読み取り可能なプロパティのコレクションを返します。

1
Value DbConnection.toJSON(String key = "");

呼び出しパラメータ:

  • key: 文字列、使用されません

返される結果:

  • Value、シリアル化可能な JSON を含む値を返します