菜鸟解读qt源码----qsqlresult.h

#ifndef QSQLRESULT_H

#define QSQLRESULT_H

#include <QtCore/qvariant.h>
#include <QtCore/qvector.h>
#include <QtSql/qsql.h>

QT_BEGIN_HEADER

QT_BEGIN_NAMESPACE

QT_MODULE(Sql)

class QString;
class QSqlRecord;
template <typename T> class QVector; //模板类,平时写gui，没有自己定义过这么复杂的用法
class QVariant;
class QSqlDriver;
class QSqlError;
class QSqlResultPrivate;

class Q_SQL_EXPORT QSqlResult
{
friend class QSqlQuery; //友元函数
friend class QSqlTableModelPrivate;
friend class QSqlResultPrivate;

public:
virtual ~QSqlResult(); //虚析构函数
virtual QVariant handle() const;

protected: //为什么下面的都是受保护的，分析的前几个头文件基本都是公共函数和私有函数，与前面的友元函数有些关系？
enum BindingSyntax {
PositionalBinding,
NamedBinding
#ifdef QT3_SUPPORT
, BindByPosition = PositionalBinding,
BindByName = NamedBinding
#endif
};

explicit QSqlResult(const QSqlDriver * db); //显式地，有什么特别的意义？？
int at() const;
QString lastQuery() const;
QSqlError lastError() const;
bool isValid() const;
bool isActive() const;
bool isSelect() const;
bool isForwardOnly() const;
const QSqlDriver* driver() const; //两个const，真够严谨的
virtual void setAt(int at); //全是虚的，无意义
virtual void setActive(bool a);
virtual void setLastError(const QSqlError& e);
virtual void setQuery(const QString& query);
virtual void setSelect(bool s);
virtual void setForwardOnly(bool forward);

// prepared query support //准备好的查询支持。
virtual bool exec();
virtual bool prepare(const QString& query);
virtual bool savePrepare(const QString& sqlquery);
virtual void bindValue(int pos, const QVariant& val, QSql::ParamType type);
virtual void bindValue(const QString& placeholder, const QVariant& val,
QSql::ParamType type);
void addBindValue(const QVariant& val, QSql::ParamType type);//能用const的都用上const，绝不含糊；平时自己写的时候，很难这么严谨啊，每一个变量，都要仔细想几遍，有没有什么捷径直接判断出来是否使用const呢？
QVariant boundValue(const QString& placeholder) const;
QVariant boundValue(int pos) const;
QSql::ParamType bindValueType(const QString& placeholder) const;
QSql::ParamType bindValueType(int pos) const;
int boundValueCount() const;
QVector<QVariant>& boundValues() const; //复杂的东东（矢量迭代？）
QString executedQuery() const;
QString boundValueName(int pos) const;
void clear();
bool hasOutValues() const;

BindingSyntax bindingSyntax() const;

virtual QVariant data(int i) = 0; //纯虚函数，几乎没有自己构造过大型复杂的类，看到这些心理没底啊。
virtual bool isNull(int i) = 0;
virtual bool reset(const QString& sqlquery) = 0;
virtual bool fetch(int i) = 0;
virtual bool fetchNext();
virtual bool fetchPrevious();
virtual bool fetchFirst() = 0;
virtual bool fetchLast() = 0;
virtual int size() = 0;
virtual int numRowsAffected() = 0;
virtual QSqlRecord record() const;
virtual QVariant lastInsertId() const;

enum VirtualHookOperation { BatchOperation, DetachFromResultSet, SetNumericalPrecision, NextResult };
virtual void virtual_hook(int id, void *data); // virtual_hook 虚钩子，什么意思？回去再把课本翻看一遍吧。
bool execBatch(bool arrayBind = false);
void detachFromResultSet();
void setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy policy);
QSql::NumericalPrecisionPolicy numericalPrecisionPolicy() const;
bool nextResult();

private:
QSqlResultPrivate* d;
void resetBindCount(); // HACK //不知所云，hack？

private:
Q_DISABLE_COPY(QSqlResult) //又是一宏,自己写程序，封装都不会想用这么多宏，不知这些该从哪里学到？
};

QT_END_NAMESPACE

QT_END_HEADER

#endif // QSQLRESULT_H本文出自 “人生得意须尽欢” 博客，请务必保留此出处http://no001.blog.51cto.com/1142339/346899