Cordova Sqlite Storage プラグイン
この Cordova プラグイ ンは、HTML5/Web SQL API を使用して Android、iOS、Windows 上で sqlite データベースを開き、使用します。
- Plugin ID/Package Name:
cordova-sqlite-storage - Tested Version: 5.1.0
- 1.IDE メニューから
設定 → Cordova プラグインの管理へ移動します。 - 2.
Cordova プラグインのインポートボタンをクリックします。 次に、[ZIP ファイル] または [パッケージ名 / URL] を使用してプラグインをインポートします。
プラグインをプロジェクトへインポート後、データベースの初期化を開始できます。[deviceready] イベント後にプラグイン API を使用します。
var database = null;
document.addEventListener("deviceready", function(){
// Initialize the database after the Cordova is ready.
initDatabase();
});
function initDatabase() {
database = window.sqlitePlugin.openDatabase({name: 'sample.db', location: 'default'});
database.transaction(function(transaction) {
transaction.executeSql('CREATE TABLE SampleTable (name, score)');
});
}
このプラグインの Javascript とネイティブ部分の両方がアプリにインストールされていることを確認してください。
window.sqlitePlugin.echoTest(successCallback, errorCallback);
戻り値
Promise
プラグインがデータベースを開き、CRUD (作成、読み取り、更新、削除) 操作を実行し、正しくクリーンアップできることを確認します。
window.sqlitePlugin.selfTest(successCallback, errorCallback);
戻り値
Promise
データベースオブジェクトを開きます。
window.sqlitePlugin.openDatabase({name: String, [location: String],
[iosDatabaseLocation: String]}, [successCallback], [errorCallback]);
パラメーター
パラメーター名 | 型 | 説明 |
name | String | データベースの名前 |
location | String | [オプション] データベースの場所 |
iosDatabaseLocation | String | [オプション] iOSデータベースの場所。
|
戻り値
Promise
例
既定または指定された場所でデータベースアクセスハンドルオブジェクトを開く例：
// use the default location
var database = window.sqlitePlugin.openDatabase({name: 'my.db', location: 'default'});
// use a specified location for iOS only
var database = window.sqlitePlugin.openDatabase({name: 'my.db', iosDatabaseLocation: 'Library'});
success および error コールバックパラメーターはオプションですが、問題が発生した場合に非常に役立ちます。 例：
window.sqlitePlugin.openDatabase({name: 'my.db', location: 'default'}, function(db) {
db.transaction(function(tx) {
// ...
}, function(err) {
console.log('Open database ERROR: ' + JSON.stringify(err));
});
});
開いているデータベースで SQL を実行します。
database.executeSql(SQL_STATEMENT: String, [] , [successCallback], [errorCallback]);
戻り値
Promise
例
database.transaction(function(transaction) {
transaction.executeSql('SELECT count(*) AS recordCount FROM SampleTable', [], function(ignored, resultSet) {
$('#result').text('RECORD COUNT: ' + resultSet.rows.item(0).recordCount);
});
}, function(error) {
alert('SELECT count error: ' + error.message);
});
database.transaction(function(transaction) {
transaction.executeSql('DELETE FROM SampleTable');
}, function(error) {
alert('DELETE error: ' + error.message);
}, function() {
alert('DELETE OK');
});
データベースオブジェクトを削除します。
window.sqlitePlugin.deleteDatabase({name: String, [location: String],
[iosDatabaseLocation: String]}, [successCallback], [errorCallback]);
パラメーター
パラメーター名 | 型 | 説明 |
name | String | データベースの名前 |
location | String | [オプション] データベースの場所 |
iosDatabaseLocation | String | [オプション] iOSデータベースの場所。
|
戻り値
Promise
例
// use the default location
window.sqlitePlugin.deleteDatabase({name: 'my.db', location: 'default'}, successcb, errorcb);
// use a specified location for iOS only
window.sqlitePlugin.deleteDatabase({name: 'my.db', iosDatabaseLocation: 'Library'});
最終更新 1yr ago