基于 Qt 的 BMP 图像数据存取至 SQLite 数据库的实现

基于 Qt 的 BMP 图像数据存取至 SQLite 数据库的实现说明

本项目通过 Qt 框架实现了将 BMP 图像文件以二进制形式存入 SQLite 数据库，并可从数据库中读取还原为 BMP 图像文件的功能，适用于需要图像与结构化数据统一管理的场景。

整个流程分为两个主要部分：

一、图像保存到数据库

程序首先连接指定的 SQLite 数据库，若数据库文件不存在将自动创建。在读取本地 BMP 图像文件后，将其内容作为二进制数据（BLOB）保存至数据库中的一张名为 Images 的数据表中。表结构简单，仅包含自增主键 id 和存储图像数据的 data 字段。若数据表尚未存在，程序会自动创建。

通过这种方式，图像内容不再依赖文件系统存储，而是与应用数据一同保存在数据库中，有利于集中管理、版本控制与数据传输。

二、从数据库读取图像并保存为文件

读取部分通过指定图像的 id 值从数据库中查询对应的 BLOB 数据，并将其以 BMP 格式写入本地文件。程序在执行过程中提供异常判断，例如数据库连接失败、图像记录不存在、文件写入失败等，确保操作的稳定性和可追踪性。

三、应用场景与扩展性

该方案适用于图像归档、数字资源管理、数据库驱动的图像浏览系统等场景。虽然本文示例以 BMP 图像为主，但该方法同样适用于任意格式的二进制文件，如 PNG、JPG、PDF 等，只需调整文件处理部分即可。此外，数据库结构可扩展，如添加图像名称、分类标签、时间戳等字段，实现更复杂的图像管理系统。

本项目展示了如何将 Qt 与 SQLite 结合，实现图像与数据库之间的数据交互，具有良好的通用性与可拓展性，为相关应用开发提供了一种简洁实用的实现思路。

cpp 复制代码

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QFile>
#include <QDebug>

void saveBmpToDatabase(const QString &imagePath, const QString &databasePath)
 {

    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName(databasePath);

    if (!db.open()) 
    {
        qDebug() << "无法打开数据库";
        return;
    }

    // 读取BMP图像文件
    QFile file(imagePath);
    if (!file.open(QIODevice::ReadOnly)) 
    {
        qDebug() << "无法打开图像文件";
        return;
    }

    QByteArray imageData = file.readAll();
    file.close();

    QSqlQuery query;
    query.exec("CREATE TABLE IF NOT EXISTS Images (id INTEGER PRIMARY KEY, data BLOB)");

    query.prepare("INSERT INTO Images (data) VALUES (:data)");
    query.bindValue(":data", imageData);

    if (!query.exec())
    {
        qDebug() << "插入图像数据失败";
    } else 
    {
        qDebug() << "图像数据插入成功";
    }

    db.close();
}

int main(int argc, char *argv[]) 
{
    QCoreApplication a(argc, argv);

    QString imagePath = "a.bmp";
    QString databasePath = "image.db";

    saveBmpToDatabase(imagePath, databasePath);

    return a.exec();
}

cpp 复制代码

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QFile>
#include <QDebug>

void loadBmpFromDatabase(const QString &outputPath, const QString &databasePath, int imageId)
 {

    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName(databasePath);

    if (!db.open()) 
    {
        qDebug() << "无法打开数据库";
        return;
    }

    QSqlQuery query;
    query.prepare("SELECT data FROM Images WHERE id = :id");
    query.bindValue(":id", imageId);

    if (!query.exec()) 
    {
        qDebug() << "读取图像数据失败";
        return;
    }

    if (query.next())
     {
        QByteArray imageData = query.value(0).toByteArray();

        QFile file(outputPath);
        if (!file.open(QIODevice::WriteOnly)) {
            qDebug() << "无法打开输出文件";
            return;
        }

        file.write(imageData);
        file.close();

        qDebug() << "图像已保存到" << outputPath;
    } else {
        qDebug() << "未找到指定的图像";
    }

    db.close();
}

int main(int argc, char *argv[]) 
{
    QCoreApplication a(argc, argv);

    QString outputPath = "b.bmp";
    QString databasePath = "image.db";
    int imageId = 1; 

    loadBmpFromDatabase(outputPath, databasePath, imageId);

    return a.exec();
}