Class: Del

WHERE句を設定します

条件は以下の方法で設定できます。

• オブジェクト
• 文字列

オブジェクトの場合、キーに『カラム名[半角スペース]オペレータ』、バリューに値を指定します。

例. IDが0以上100以下。

db.delete('USER').where({'ID >':0, 'ID <=':100})

オペレータで使用可能な文字は以下の通りです。

• <=
• <
• >=
• >
• =
• !=
• like (sqliteの仕様上大文字・小文字を区別しない)

条件を複数指定した場合、全てAND句で結合されます。 AND句以外の条件で結合したい場合は文字列で条件を指定して下さい。

エスケープ文字の指定方法
キーに『カラム名[半角スペース]オペレータ[半角スペース]エスケープ文字』のように指定します。
エスケープ文字はクォートやダブルクォートで囲わず、エスケープ文字のみ指定して下さい。

例. $をエスケープ文字として指定する場合

db.delete('USER').where({'NAME like $': 'SUZUKI$'});

文字列の場合、SQLステートメントに追加するWHERE文を指定します。

例. IDが0以上100以下。

db.delete('USER').where('ID >= 10 AND ID <= 100')

このオブジェクトに設定された情報からSQLステートメントとパラメータを生成し、SQLを実行します

実行結果は、Promiseオブジェクトのprogress()に指定したコールバック関数または、done()に指定したコールバック関数に、削除されたレコードの件数が返されます。

 db.del('USER').where({ID:10}).execute().done(function(rowsAffected) {
 　rowsAffected // 削除されたレコードの行数(Number型)
 });

また、progress()に指定したコールバック関数の第二引数には、トランザクションオブジェクトが格納され、このオブジェクトを使用することで、トランザクションを引き継ぐことができます。

 db.select('PRODUCT', ['ID']).where({NAME: 'ball'}).execute().progress(function(rs, tx) {
 　db.del('STOCK', tx).where({ID: rs.item(0).ID}).execute();
 });

db.select().execute()で返ってきたトランザクションを、db.del()の第二引数に指定することで、db.select()とdb.del()は同一トランザクションで実行されます。 *

ver1.1.8からの変更点

execute()が返すPromiseオブジェクトのprogressコールバックの第二引数(TransactionalExecutorインスタンス)に、 Select/Insert/Del/Update/Sqlインスタンスをaddすることができるようになりました。

下記のサンプルコードは、tx.add()で追加したStatementインスタンスを、一番最初に実行したdb.del()と同一トランザクションでSQLを実行します。

 db.del('USER').where({ID:1}).execute().progress(function(rs, tx) {
　　tx.add(db.del('ROLE').where({ID:1})).execute().done(function() {
　　　alert('success');
　　});
 });