Qt系列文章之 QDataStream

上一篇文章介绍了如何使用QFileDialog来选择文件路径并读入项目界面，本文介绍如何使用Qt的序列化技术来将用户定义的一些变量保存到文件，用到的主要模块是QDataStream。

对象序列化 QDataStream

Qt提供了两个关键的二进制序列化模块：QDataStream和QTextStream，本文主要介绍常用简单对象二进制序列化技术QDataStream。希望在界面关闭的时候自动将用户修改的界面属性值保存到一个文件之中，以便后面读入的时候使用。 当然这种操作还有更好的方式，比如编写配置文件或者QSettings，此处只是为了使用模块而构造的一个场景。

开始之前，我们需要先引入一个关键的事件QCloseEvent，这个事件是用户在关闭界面时自动调用。 按照前面对事件的介绍，Qt中的事件函数一般都是基于事件虚函数重写即可。首先我们要在头文件包含QCloseEvent。
#include <QCloseEvent>

然后在头文件的protected区域重定义这个事件处理函数：

protected:
    void closeEvent(QCloseEvent *event) override;   //重写事件函数

在CPP源文件中重写事件处理代码，一般的开发习惯是在最后将事件处理权限交回父类对象之中。

void mainWindow::closeEvent(QCloseEvent *event)
{
    /*编写你的事件处理函数*/

    return QMainWindow::closeEvent(event); //最后将事件处理交回父类
}

下一步构造一个属性序列化类，在关闭窗口的时候将界面的一些属性保存到本地硬盘之中，方便下次打开界面时读入上次的配置参数。

和前面一样，首先构造一个文件写操作，判断文件是否打开正常：

    QFile file("config.ini");
    if(!file.open(QIODevice::WriteOnly | QIODevice::Text))
        return; //打开失败关闭

然后基于某IO对象（此处是file）构造一个数据序列化对象 out:
QDataStream out(&file);

为了保险，设置out的数据版本：

out.setVersion(QDataStream::Qt_4_0);  //最好设置数据保存版本

依次写入界面的一些信息，此处主要写入了下拉菜单、编辑框和表格的信息：

    out<<ui->lineEdit_input->text()              //写入编辑框的值
        <<qint8(ui->downList->currentIndex());   //写入下拉菜单编号

    qint8 rowCount = ui->tableWidget->rowCount(); //写入表格行数
    out<<rowCount;

    for (int i=0;i<rowCount;i++) {               //写入表格每行内容
        out<<ui->tableWidget->item(i,0)->text()<<ui->tableWidget->item(i,1)->text();
    }

最后关闭文件：

file.close();                                //关闭文件

打开界面修改之后，项目时会将一些信息保存到文件config.ini之中。可以在文件夹路径打开文件，由于保存的是二进制文件，所以有一些信息无法以文本形式显示：

下次再打开界面时，我们希望能够直接读入这些信息进入界面，下面来实现这个读入的操作：

这个过程也可以使用界面打开时的事件函数paintEvent(QPaintEvent *event)或者showEvent(QShowEvent *event)来处理。 但是此处我们采用槽函数的方式来处理，下面定义一个槽函数：

void readIniFile(); //读入配置信息

在cpp源文件之中对槽函数进行实现：

void mainWindow::readIniFile()
{
}

下面在槽函数之中来对读入文件信息的代码进行实现，首先构造一个文件对象，然后判断是否打开正常，然后基于文件构造一个in对象：

    QFile file("config.ini");
    if(!file.open(QIODevice::ReadOnly | QIODevice::Text))
        return; //打开失败关闭

    QDataStream in(&file);
    in.setVersion(QDataStream::Qt_4_0);  //最好设置数据保存版本

然后依次读入信息并修改界面的值，注意读入的顺序需要前面写入的一样，同时读入的值类型也要一样，特别是qint8的使用，读者可以分析一下原因。

    QString lineEditText;
    qint8 comboBoxIndex;
    in>>lineEditText>>comboBoxIndex;              //读入信息
    ui->lineEdit_input->setText(lineEditText);    //修改编辑框的值
    ui->downList->setCurrentIndex(int(comboBoxIndex));  //修改下拉菜单序号

    qint8 rowCount;
    in>>rowCount;
    for (int i=0;i<int(rowCount);i++)          //读入并修改表格各个单元格的值
    {
        QString str1;
        QString str2;
        in>>str1>>str2;
        ui->tableWidget->item(i,0)->setText(str1);
        ui->tableWidget->item(i,1)->setText(str2);
    }

最后记得关闭文件对象：
file.close(); //关闭文件对象

最后如果界面再打开始时就能读入信息，需要在构造函数中调用定义的槽函数：

    ui->tableWidget->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch); //表格均匀布满水平内容

    connect(ui->btu_click,&QPushButton::clicked,this,&mainWindow::btnClicked); //建立信号和槽的联系
    connect(ui->lineEdit_input,&QLineEdit::editingFinished,this,&mainWindow::inputFinished); //建立信号和槽的联系
    connect(ui->downList,&QComboBox::currentTextChanged,this,&mainWindow::chooseChanged); //建立信号和槽的联系

    readIniFile();  //构造函数中调用槽函数

然后编译运行代码，修改一些界面值：

关闭界面，然后再打开界面，界面会记录上次修改的值：

本文以界面配置信息保存为例来介绍如何使用QDataStream进行序列化的读写操作过程。不是所有的对象都能够被QDataStream序列化处理，Qt给出了可以处理的序列化对象如下，对于用户自己开发的复杂对象想要序列化，需要自己构造对象的“<<”和“>>”运算符。

欢迎同好沟通交流，批评指正，欢迎关注我的公号：不如起而行之