本文将介绍自定义Model过程中数据库数据源的获取方法,我使用过以下三种方式获取数据库数据源:
- 创建 存储对应数据库所有字段的 结构体,将结构体置于容器中返回,然后根据索引值(QModelIndex)取出最终的字段值;
- 创建 存储对应数据库所有字段的 类,将类对象置于容器中返回,然后利用内省机制获取对象相应字段(属性)值。
- 不用自己造轮子,直接使用QVariantList类,将QVariantList 对象置于容器中,如QVector<QVariantList >,然后根据索引值(QModelIndex)取出最终的字段值;
本文重点介绍第二种,即利用QT的内省机制来获取数据。
1.自定义Model过程(通过内省功能获得字段值,也就是第二种方法)
本文中自定义Model继承于QAbstractTableModel ,重点描述setData(..)函数与data(...)函数的重载过程。
首先需要介绍 Parameter类,该类用于存储查询数据库中某表所得的字段值。
1 //Parameter.h
2 //加粗单词为成员变量
3 //假设数据库中某表有三个字段Index,Name,Describe
4
5 class Parameter : public QObject
6 {
7 Q_OBJECT
8 public:
9 explicit Parameter( QObject *parent = 0);
10
11 Q_INVOKABLE QVariant getIndex() const { return index;} //用Q_INVOKABLE声明后才能被元对象(QMetaObject)调用
12 Q_INVOKABLE void setIndex(const QVariant &value) { index = value.toInt(); }
13
14 Q_INVOKABLE QVariant getName() const { return name; }
15 Q_INVOKABLE void setName(const QVariant &value) { name = value.toString(); }
16
17 Q_INVOKABLE QVariant getDecribe() const { return describe; }
18 Q_INVOKABLE QVariant setDescribe(const QVariant &value) { describe = value; }
19
20 QMap<int, int> getMethodGETIndexs()const;//获得“取值器”函数(即getXX函数) 的索引值列表,这些函数都被Q_INVOKABLE声明过
21 QMap<int, int> getMethodSETIndexs() const;//获得“设置器”函数(即setXX函数) 的索引值列表,这些函数都被Q_INVOKABLE声明过
22
23 private:
24 void setMethodGETIndexs(); //设置“取值器”函数(即getXX函数) 的索引值列表,这些函数都被Q_INVOKABLE声明过
25 void setMethodSETIndexs(); //设置“设置器”函数(即setXX函数) 的索引值列表,这些函数都被Q_INVOKABLE声明过
26
27 static int getNewIndex();
28
29 int index;
30 QString name;
31 QString describe;
32
33 QMap<int,int> methodGETIndexs;
34 QMap<int,int> methodSETIndexs;
35 };
1 //Parameter.cpp
2
3 Parameter::Parameter(QObject *parent) :
4 QObject(parent),
5 index(getNewIndex()),
6 name("Unnamed"),
7 describe("")
8 {
9 setMethodGETIndexs();
10 setMethodSETIndexs();
11 }
12
13 void Parameter::setMethodGETIndex()
14 {
15 int index1 = this->metaObject()->indexOfMethod("getIndex()");
16 methodGETIndexs.insert(0,index1);
17
18 int index2 = this->metaObject()->indexOfMethod("getName()");
19 methodGETIndexs.insert(1,index2);
20
21 int index3 = this->metaObject()->indexOfMethod("getDecribe()");
22 methodGETIndexs.insert(2,index3);
23
24 }
25
26 void Parameter::setMethodSETIndexs()
27 {
28 int index1 = this->metaObject()->indexOfMethod("setIndex(QVariant)");
29 methodSETIndexs.insert(0,index1);
30
31 int index2 = this->metaObject()->indexOfMethod("setName(QVariant)");
32 methodSETIndexs.insert(1,index2);
33
34 int index3 = this->metaObject()->indexOfMethod("setDescribe(QVariant)");
35 methodSETIndexs.insert(2,index3);
36 }
37
38 QMap<int, int> Parameter::getMethodSETIndexs() const
39 {
40 return methodSETIndexs;
41 }
42
43 QMap<int, int> Parameter::getMethodGETIndexs() const
44 {
45 return methodGETIndexs;
46 }
47
48 int Parameter::getNewIndex()
49 {
50 //查询数据库
51 //返回最新的Index字段
52 }
Parameter类声明了对应数据库表中字段(field)的成员变量,并分别为这些成员变量编写了setxx()函数和getxx()函数,并对这些函数进行Q_INVOKABLE声明
然后,在setMethodGETIndexs()函数 与 setMethodSETIndexs()函数中,使用QMetaObject::indexOfMethod(...)函数获取每个函数在QMetaObject对象中的索引值,将该按顺序索引值存入到容器中,其插入顺序与TableModel中的字段顺序一致。
最后,在TableModel中调用Parameter类的getMethodSETIndexs()函数与getMethodGETIndexs()函数获得索引值列表。
1 //TableModel.h
2 class TableModel : public QAbstractTableModel
3 {
4 Q_OBJECT
5 public:
6 explicit TableModel(QObject *parent = 0);
7 int rowCount(const QModelIndex &parent = QModelIndex()) const;//
8 int columnCount(const QModelIndex &parent = QModelIndex()) const;
9 QVariant data(const QModelIndex &index, int role) const;
10 bool setData(const QModelIndex &index, const QVariant &value, int role);
11 private:
12 static QList<Parameter*> getTableParameters(); //该函数用于初始化dataParameters
13
14 QVariant specificIndexValue(const QModelIndex &index) const;
15 int getMethodGETIndex(const QModelIndex &index) const;
16 QMetaMethod getMetaMethod(const QModelIndex &index,int methodIndex) const;
17 bool setSpecificData(const QModelIndex &index, const QVariant &value);
18 int getMethodSETIndex(const QModelIndex &index);
19
20 QList<Parameter*> dataParameters; //存储从数据库表中查询所得的值,每个Parameter对象代表一条记录
//tablemodel.cpp
TableModel::TableModel(QObject *parent) :
QAbstractTableModel(parent),
dataParameters(getTableParameters())
{
}
static TableModel::QList<Parameter*> getTableParameters()
{
//查询数据库,返回字段值列表
}
int TableModel::rowCount(const QModelIndex &parent = QModelIndex())
{
dataParameters.size();
}
int TableModel::columnCount(const QModelIndex &parent) const
{
Q_UNUSED(parent);
return dataParameters.getMethodGETIndexs().size();
}
QVariant TableModel::data(const QModelIndex &index, int role) const
{
if(!index.isValid()){
return QVariant();
}
return specificData(index,role);
}
QVariant TableModel::specificData(const QModelIndex &index, int role)const
{
switch(role)
{
case Qt::TextAlignmentRole:
return int(Qt::AlignHCenter | Qt::AlignVCenter);
case Qt::DisplayRole:
return specificIndexValue(index);
case Qt::EditRole:
return specificIndexValue(index);
default:
return QVariant();
}
return QVariant();
}
QVariant TableModel::specificIndexValue(const QModelIndex &index) const
{
QVariant retValue;
int methodIndex = methodGETIndex(index);
QMetaMethod getMethod = getMetaMethod(index,methodIndex);
getMethod.invoke(dataParameters.at(index.row()),Qt::DirectConnection,Q_RETURN_ARG(QVariant,retValue));
return retValue;
}
int TableModel::getMethodGETIndex(const QModelIndex &index) const
{
int methodIndex = dataParameters.at(index.row())->getMethodGETIndexs().value(index.column());
return methodIndex;
}
QMetaMethod TableModel::getMetaMethod(const QModelIndex &index,int methodIndex) const
{
QMetaMethod method = dataParameters.at(index.row())->metaObject()->method(methodIndex);
return method;
}
bool TableModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
if(!isIndexValid(index))
return false;
if(role == Qt::EditRole && setSpecificData(index,value))
ResParameters::instance().modifyRecord(index);
return QAbstractTableModel::setData(index,value);
}
bool TableModel::setSpecificData(const QModelIndex &index,
const QVariant &value)
{
if( specificIndexValue(index) != value){
int methodIndex = getMethodSETIndex(index);
QMetaMethod setMethod = getMetaMethod( index, methodIndex);
return setMethod.invoke( dataParameters.at(index.row()), Qt::DirectConnection, Q_ARG(QVariant,value) );
}
return false;
}
int TableModel::getMethodSETIndex(const QModelIndex &index)
{
int methodIndex = dataParameters.at(index.row())->getMethodSETIndexs().value(index.column());
return methodIndex;
}
成员变量 QList<Parameter*> dataParameters中存储了数据库表中的字段值,且每个Parameter对象代表一条记录。
我们知道,TableModel数据的显示与rowCount()、columnCount()、data()函数息息相关,我们重载了这三个函数。
为了让model的行和列与dataParameters一一对应:
令rowCount()函数返回dataParameters的条目数(行数目);
令columnCount()返回dataParameters中每条记录的字段数目(列数目)。
对于Variant data(const QModelIndex &index, int role) const函数,在选定的role下,调用specificIndexValue(const QModelIndex &index)函数,根据索引值获得行号和列号,先根据行号确定容器中某一个Parameter对象(即某一条记录),然后再根据列号,获得该Parameter对象中支持 元对象调用的 函数的索引值(如getMethodGETIndex()函数所示),获取函数索引值后,如getMetaMethod()所示,可获得QMetaMethod对象,然后调用invoke()函数,赋予合适的参数值,就等价于调用当前函数索引值对应的那个函数。
这样做的好处在于,可直接通过行号与列号进行寻址,避免了条件判断语句,使代码大大提高了简洁性与复用性。
setData()函数与data()函数类似,不再详述。
总结:利用内省机制获得对象的成员函数,并调用之,能够避免复杂的条件判断逻辑,能够提高复用性。但是,在这里没有提及的有性能问题,我没有研究对性能会有什么影响,当然,简单的PC软件是基本看不到影响的,其次,利用Parameter类存储数据库表字段值,使Parameter只能用于同一个表,那么每个返回数据库字段值的函数也就只能服务于同一个表,这样也会有很多重复代码产生。所以接下来,我将进一步改进,放弃利用自定义类而使用QVariantList类来存储数据库表的每一条记录。