菜鸟解读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