HTML5 本地数据库及应用

HTML5本地数据库及应用

目录


WebSQL

WebSQL 是 HTML5 规范中提出的一种基于 SQL 的客户端数据库存储技术,允许在浏览器端创建和操作关系型数据库。尽管 WebSQL 曾被纳入 HTML5 草案,但由于种种原因(如标准化进程停滞、缺乏跨浏览器支持等),它并未成为正式的 W3C 标准,且已被主流浏览器厂商弃用。目前,推荐使用 IndexedDB 作为浏览器端的数据库解决方案.

数据库创建与打开

使用 window.openDatabase() 函数创建或打开一个 WebSQL 数据库:

js 复制代码
let db = null;
try {
  db = openDatabase('myDatabase', '1.0', 'My Database Description', 2 * 1024 * 1024); // 最后一个参数是数据库大小限制,单位为字节
} catch (err) {
  console.error('Error creating/opening database:', err);
}

执行SQL

WebSQL 提供 transaction() 方法来开启一个事务,并在其回调函数中执行 SQL 查询。查询通过 executeSql() 方法执行,该方法接受 SQL 语句和参数数组(如果有),以及两个回调函数:一个用于处理查询结果,另一个用于处理执行错误。

js 复制代码
db.transaction(function(tx) {
  tx.executeSql('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT, email TEXT)', [], function(tx, result) {
    console.log('Table "users" created or already exists.');
  }, function(tx, error) {
    console.error('Error creating table:', error);
  });
});

插入、查询、更新、删除数据

js 复制代码
// 插入数据
db.transaction(function(tx) {
  tx.executeSql('INSERT INTO users (name, email) VALUES (?, ?)', ['John Doe', '[email protected]'], function(tx, result) {
    console.log('User inserted successfully:', result.insertId);
  }, function(tx, error) {
    console.error('Error inserting user:', error);
  });
});

// 查询数据
db.transaction(function(tx) {
  tx.executeSql('SELECT * FROM users WHERE name = ?', ['John Doe'], function(tx, result) {
    for (let i = 0; i < result.rows.length; i++) {
      const row = result.rows.item(i);
      console.log('User:', row.id, row.name, row.email);
    }
  }, function(tx, error) {
    console.error('Error querying users:', error);
  });
});

// 更新数据
db.transaction(function(tx) {
  tx.executeSql('UPDATE users SET email = ? WHERE id = ?', ['[email protected]', 1], function(tx, result) {
    console.log('User updated successfully:', result.rowsAffected);
  }, function(tx, error) {
    console.error('Error updating user:', error);
  });
});

// 删除数据
db.transaction(function(tx) {
  tx.executeSql('DELETE FROM users WHERE id = ?', [1], function(tx, result) {
    console.log('User deleted successfully:', result.rowsAffected);
  }, function(tx, error) {
    console.error('Error deleting user:', error);
  });
});

事务处理

WebSQL 中的所有操作都必须在一个事务(Transaction)中进行。事务确保一组操作要么全部成功,要么全部失败(回滚)。上面的例子中,每个操作都已经封装在 transaction() 方法提供的回调函数中。

限制与弃用

尽管 WebSQL 为浏览器端的离线存储提供了关系型数据库的便利,但由于以下原因,它并未成为广泛接受的标准:

  • 标准化停滞:WebSQL 的标准化工作在 W3C 停滞不前,导致其未能成为正式的 HTML5 标准。
  • 跨浏览器支持问题:只有 Safari、Chrome 和 Opera 浏览器曾提供对 WebSQL 的支持。Firefox、IE/Edge 从未实现该技术。
  • 替代技术出现:IndexedDB,一种更灵活、更适合现代 web 应用的键值对存储机制,逐渐成为浏览器端数据库的首选方案。

IndexDB

IndexedDB用于在浏览器端存储大量结构化数据。与传统的 cookie、localStorage、sessionStorage 等基于字符串键值对的存储方式不同,IndexedDB 允许存储复杂的对象(包括二进制数据),并提供了索引、查询和事务处理等功能,使其更适合于构建复杂的离线应用和丰富的 web 客户端体验。

打开数据库

使用 indexedDB.open() 方法打开或创建数据库。该方法接受数据库名称和版本号作为参数,并返回一个 IDBRequest 对象。在 onsuccess 事件处理器中,可以访问到 IDBDatabase 对象,用于后续的数据库操作。

js 复制代码
let db;
const request = indexedDB.open('myDatabase', 1);

request.onerror = function(event) {
  console.error('Error opening IndexedDB:', event.target.error);
};

request.onsuccess = function(event) {
  db = event.target.result;
  console.log('Database opened successfully.');
};

request.onupgradeneeded = function(event) {
  // 如果数据库版本升级或首次创建,需要在此处创建或修改对象商店(Object Store)
  const db = event.target.result;
  const objectStore = db.createObjectStore('users', { keyPath: 'id' });
  objectStore.createIndex('nameIndex', 'name', { unique: false });
};

创建/修改对象

对象商店是 IndexedDB中存放数据的基本单元,类似于关系型数据库中的表。在 onupgradeneeded事件处理器中,可以使用createObjectStore()方法创建新的对象商店,或者通过deleteObjectStore()方法删除已有的对象商店。同时,可以为对象商店创建索引,以便进行高效查询。

插入数据

插入数据需先获取事务(Transaction),然后在事务上下文中使用 put()add() 方法将数据写入对象商店。put()会覆盖已有键值的数据,而 add() 在键值已存在时会抛出错误。

js 复制代码
const transaction = db.transaction(['users'], 'readwrite');
const objectStore = transaction.objectStore('users');

const newUser = {
  id: 1,
  name: 'John Doe',
  email: '[email protected]'
};

objectStore.add(newUser).onsuccess = function(event) {
  console.log('User added successfully:', newUser);
};

transaction.oncomplete = function() {
  console.log('Transaction completed.');
};

transaction.onerror = function(event) {
  console.error('Transaction error:', event.target.error);
};

查询数据

查询数据同样需要获取事务和对象商店,然后使用 get()、getAll()、openCursor() 等方法进行查询。

js 复制代码
const transaction = db.transaction(['users'], 'readonly');
const objectStore = transaction.objectStore('users');

// 查询单个用户
const request = objectStore.get(1);
request.onsuccess = function(event) {
  const user = event.target.result;
  if (user) {
    console.log('Found user:', user);
  } else {
    console.log('User not found.');
  }
};

// 查询所有用户
const getAllRequest = objectStore.getAll();
getAllRequest.onsuccess = function(event) {
  const allUsers = event.target.result;
  console.log('All users:', allUsers);
};

// 使用游标遍历所有用户
const cursorRequest = objectStore.openCursor();
cursorRequest.onsuccess = function(event) {
  const cursor = event.target.result;
  if (cursor) {
    console.log('User:', cursor.value);
    cursor.continue();
  } else {
    console.log('End of cursor.');
  }
};

更新和删除数据

更新数据使用 put() 方法,删除数据使用 delete() 方法。与插入数据类似,这些操作应在事务上下文中进行。

js 复制代码
const transaction = db.transaction(['users'], 'readwrite');
const objectStore = transaction.objectStore('users');

// 更新用户
const updatedUser = {
  id: 1,
  name: 'John Smith',
  email: '[email protected]'
};
objectStore.put(updatedUser).onsuccess = function(event) {
  console.log('User updated successfully:', updatedUser);
};

// 删除用户
objectStore.delete(1).onsuccess = function(event) {
  console.log('User deleted successfully.');
};

// 事务处理同插入数据示例

索引优化查询

创建索引后,可以在查询时指定使用索引来加速查找。例如,使用 index() 方法获取索引对象,然后调用索引对象的查询方法。

js 复制代码
const transaction = db.transaction(['users'], 'readonly');
const objectStore = transaction.objectStore('users');
const nameIndex = objectStore.index('nameIndex');

// 查询所有名为 'John Doe' 的用户
const request = nameIndex.getAll('John Doe');
request.onsuccess = function(event) {
  const usersWithNameJohnDoe = event.target.result;
  console.log('Users named John Doe:', usersWithNameJohnDoe);
};
相关推荐
Hamm7 分钟前
用一种全新的方式来实现i18n,和魔法字符串彻底说拜拜
前端·vue.js·typescript
二年级程序员20 分钟前
SQL语句(一)—— DDL
数据库·sql·mysql
摸鱼仙人~23 分钟前
React: hook相当于函数吗?
前端·javascript·react.js
百锦再24 分钟前
React编程高级主题:错误处理(Error Handling)
前端·javascript·react.js·前端框架·vue·web·angular
阿里巴巴首席技术官25 分钟前
CSS 高级用法
前端·css
邴越27 分钟前
不同向量数据库(FAISS / Pinecone / Weaviate)在 RAG 中的优缺点
数据库·faiss
Allen Bright28 分钟前
【MySQL基础-21】MySQL事务机制详解:原理、实现与最佳实践
数据库·mysql
movie__movie42 分钟前
Spring AI MCP 客户端实战:轻松连接高德地图等工具
数据库·人工智能·spring
墨绿色的摆渡人43 分钟前
论文笔记(七十五)Auto-Encoding Variational Bayes
前端·论文阅读·chrome
清风198144 分钟前
kafka消息可靠性传输语义
数据库·分布式·kafka