【QT5.9 + protobuf】二、图片二进制数据序列化反序列化踩坑记录

简介：

图片二进制序列化主要坑在：二进制数据读入char* 后再转为string ，有些‘\0’的字节会把数据直接截断，导致二进制数据不完整了。
下面记录一种可以正确序列化反序列化图片二进制数据的方法，并用qt将图片显示出来。

1. 创建一个图片的数据格式 image.proto

// [START declaration]
syntax = "proto2";
// [END declaration]
message Image {
    optional string format = 1;
    required int32 size= 2;    // 图片二进制数据的长度
    required bytes data = 3;  // 图片原数据
    optional string name = 5;
}

利用proto.exe 生成对应文件：

2. 新建一个qt工程导入文件 配置protobuf环境

新建一个普通ui的MainWindow工程。将image.pb.cc image.pb.h 复制到该文件夹下，并向工程中添加文件。

点开image-test.pro文件，右键点击空白处，添加protobuf的库：

同时，添加protobuf头文件，即源码的src 文件夹所在路径 如：INCLUDEPATH += $$PWD/…/…/3rd-party/protobuf/src

保存好后，环境就配置完成了，接下来开始 对图片进行序列化和反序列化，并验证反序列化后的数据没有改变，图片可以正常显示。

3.读取二进制数据 序列化 反序列化 并完整恢复

修改mainwindow.cpp文件增加如下内容；

#include "mainwindow.h"
#include "ui_mainwindow.h"

#include <QFile>
#include <image.pb.h>
#include <string>
#include <QImage>

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    // 图片文件改为自己的
    QString img_path = "E:\\cc++_files\\QT-program\\protobuf-test\\pic-test.jpg";
    qint32 img_size;
    //用来存储读取出来的字节数据
    char* img_data;
    Image img_proto;
    QFile file(img_path);
    if (file.open(QIODevice::ReadOnly))
    {
        //读取二进制文件的大小，即所占字节数
        img_size = file.size();
        //将文件内容读入img_data所指空间
        img_data = new char[img_size+1];
        file.read(img_data,img_size);
        img_proto.set_size(img_size);

        // 这里给 img_proto的data字段赋值，
        // 不能直接img_proto.set_data(img_data)
        // 也不能将img_data直接赋值给string，会因为有'\0'而截断
        // 尝试可行的办法如下
        std::string img_data_str;
        // 将img_data的img_size个数据赋值给img_data_str
        img_data_str.assign(img_data, img_size);
        img_proto.set_data(img_data_str);
        // 防止内存泄露
        delete img_data;

        // 序列化
        std::string img_proto_serial = img_proto.SerializeAsString();
        // 反序列化
        Image img_proto_reverse;
        img_proto_reverse.ParseFromString(img_proto_serial);

        // 验证反序列化后的数据是否完整
        // 即画出反序列化后的图片，如果能完整画出即反序列化完成
        QImage *img_reverse = new QImage;
        char* reverse_img_data = new char[img_size];
        // img_proto_reverse.data()为const string
        // img_proto_reverse.data().c_str()为const char*
        // const_cast<char*>(img_proto_reverse.data().c_str()) 为char*格式
        reverse_img_data = const_cast<char*>(img_proto_reverse.data().c_str());
        // 这里需要uchar*格式，即unsigned char* 通过reinterpret_cast<unsigned char*>转换
        img_reverse->loadFromData(reinterpret_cast<unsigned char*>(reverse_img_data), img_size);
        // 在ui界面画一个label,用来显示图片
        ui->label->setPixmap(QPixmap::fromImage(*img_reverse));
    }
}

MainWindow::~MainWindow()
{
    delete ui;
}

仅供练习测试！代码量不大，但是坑很多，踩了很多坑才总结出来的，创作不易，有问题请留言。