Q_OBJECT宏的作用


转载https://www.cnblogs.com/WushiShengFei/p/9820835.html

QT框架里面最大的特色就是在C++的基础上增加了元对象系统(Meta-Object System),而元对象系统里面最重要的内容就是信号与槽机制,这个机制是在C++语法的基础上实现的,使用了函数、函数指针、回调函数等概念。当然与我们自己去写函数所不同的是槽与信号机制会自动帮我们生成部分代码,比如我们写的信号函数就不需要写它的实现部分,这是因为在我们编译程序的时候,编译器会自动生成这一部分代码,当我们调用connect函数的时候,系统会自动将信号函数与槽函数相连接,于是当我们调用信号函数的时候,系统就会自动回调槽函数,不管你是在同一线程下调用或者在不同线程下调用,系统都会自动评估,并在合理的时候触发函数,以此来保证线程的安全。信号与槽机制是线程安全的,这可以使得我们在调用的时候不用再额外的增加过多保证线程同步的代码,为了实现元对象系统,QT把所有相关实现写在了QObject类中,所以当你想使用元对象系统的时候,你所写的类需要继承自QObject,包括QT自带的所有类都是继承自QObject,所以分析QObject的代码,对了解QT的元对象机制有非常大的帮助,我并不打算把QObject类的每一行代码都写下来,只想把其中比较关键的内容或者对分析QT源码有帮助的内容介绍一下。

1.宏Q_OBJECT

这个宏展开以后是如下定义:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
#define Q_OBJECT \
public : \
     QT_WARNING_PUSH \
     Q_OBJECT_NO_OVERRIDE_WARNING \
     static  const  QMetaObject staticMetaObject; \
     virtual  const  QMetaObject *metaObject()  const ; \
     virtual  void  *qt_metacast( const  char  *); \
     virtual  int  qt_metacall(QMetaObject::Call,  int void  **); \
     QT_TR_FUNCTIONS \
private : \
     Q_OBJECT_NO_ATTRIBUTES_WARNING \
     Q_DECL_HIDDEN_STATIC_METACALL  static  void  qt_static_metacall(QObject *, QMetaObject::Call,  int void  **); \
     QT_WARNING_POP \
     struct  QPrivateSignal {}; \
QT_ANNOTATE_CLASS(qt_qobject,  "" )

  你可以看到这个宏定义了一些函数,并且函数名都带有meta,所以不难猜到这些函数和QT的元对象系统是有关系的,实际上你在qobject.cpp里面是找不到这些函数的实现的,它们的实现都在moc_qobject.cpp里面。QT的元对象系统是这样处理的,当你编译你的工程时,它会去遍历所有C++文件,当发现某一个类的私有部分有声明Q_OBJECT这个宏时,就会自动生成一个moc_*.cpp的文件,这个文件会生成信号的实现函数,Q_OBJECT宏里面定义的那些函数也会在这个文件里面实现,并生成与类相关的元对象。这就是为什么我们定义一个信号的时候,不需要实现它,因为它的实现已经写在moc_*.cpp文件里面了。

 

2.Q_PROPERTY(QString objectName READ objectName WRITE setObjectName NOTIFY objectNameChanged)

这个宏是定义一个属性,属性也是元对象系统的内容之一,实际上我们在做界面设计的时候经常会用到属性,比如修改Label的显示内容,需要用到Text属性,修改窗体长宽等等,在你做界面设计的时候,属性编辑框里面所显示的就是当前对象的所有属性,而这些属性的定义就是用上面的宏来定义的。实际上属性和变量是有点相似的,都是读值和写值的功能,那为什么不直接对变量操作就好了?虽然看起来相似,但是还是有不同点,第一属性可以定义为可读写的,也可以定义为只读的,比如有些数据我们只在类的内部做修改不允许在外部做修改,但是有时候又需要在外部查看这个值,就可以设置为只读属性,而变量是做不到这点的,你把变量放在public部分,那么这个变量就可以在任何地方被修改,这就破坏了类的封装性。第二属性可以定义信号,当属性变化的时候触发信号,这样我们可以在信号触发时做一些工作,比如当你设置LineEdit为readonly时,你会发现输入框的背景颜色被改变了,这就可以通过属性变化的信号来处理。

 

3.Q_DECLARE_PRIVATE(QObject)

这个宏的定义如下:

1
2
3
4
#define Q_DECLARE_PRIVATE(Class) \
     inline  Class##Private* d_func() {  return  reinterpret_cast <Class##Private *>(qGetPtrHelper(d_ptr)); } \
     inline  const  Class##Private* d_func()  const  return  reinterpret_cast < const  Class##Private *>(qGetPtrHelper(d_ptr)); } \
friend  class  Class##Private;

  这个宏首先创建了两个内联函数,返回值都是QObjectPrivate *,并且声明QObjectPrivate 为友元类,QObjectPrivate这个类是在qobject_p.h中定义,它继承至QObjectData,你可以看到d_func()是将d_prt强制转换为QObjectPrivate *类型,而d_prt这个指针在QObject里面定义的是QObjectData的指针类型,所以这里可以进行强转,QObjectPrivate这个类主要存放QOject类需要用到的一些子对象,变量等。为什么要介绍这个宏,如果你有看QT源码习惯的话,你会发现几乎每一个类都用到了这个宏,我们自己写的类会经常把类内部用的变量声明在private部分,但是QT源码并不是这样做的,它的做法是给每个类创建一个以类名+Private的类,例如QObject对应的就是QObjectPrivate,这个类实际上就是用来存放QObject需要用到的所有私有变量和私有对象,而QObject更多的是函数实现,你去看其他的源码也是如此,子对象声明在Q*Private中,而本类只实现函数

 

4.构造函数

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
QObject::QObject(QObject *parent)
     : d_ptr( new  QObjectPrivate)
{
     Q_D(QObject);
     d_ptr->q_ptr =  this ;
     d->threadData = (parent && !parent-> thread ()) ? parent->d_func()->threadData : QThreadData::current();
     d->threadData->ref();
     if  (parent) {
         QT_TRY {
             if  (!check_parent_thread(parent, parent ? parent->d_func()->threadData : 0, d->threadData))
                 parent = 0;
             setParent(parent);
         } QT_CATCH(...) {
             d->threadData->deref();
             QT_RETHROW;
         }
     }
#if QT_VERSION < 0x60000
     qt_addObject( this );
#endif
     if  (Q_UNLIKELY(qtHookData[QHooks::AddQObject]))
         reinterpret_cast <QHooks::AddQObjectCallback>(qtHookData[QHooks::AddQObject])( this );
}

 

(1)首先第一步就创建d_ptr指针。

(2)Q_D(QObject);这个宏你可以在QT的很多源码里面看到。它展开以后是下面的样子:#define Q_D(Class) Class##Private * const d = d_func();

    d_fun()函数前面讲到了,其实就是返回d_ptr了。所以这个宏的意思是定义一个指针d指向d_ptr;

(3)d_ptr->q_ptr = this;

   q_ptrQOject类型,这里把this指针赋给了它,所以使得QObjectPrivate可以回调QOject的函数。

(4)初始化threadData

 

5.moveToThread

(1)如果要移动的线程和Object本身就是同一线程,那么直接返回

 

1
2
3
4
5
Q_D(QObject);
     if  (d->threadData-> thread  == targetThread) {
         // object is already in this thread
         return ;
     }

 

(2)如果parent不为空,不允许移动到其他线程,子类必需与父类在同一线程。

 

1
2
3
4
if  (d->parent != 0) {
         qWarning( "QObject::moveToThread: Cannot move objects with a parent" );
         return ;
     }

 

(3)如果对象是窗体类,不允许移动到线程,窗体类必需在主线程运行,在子线程去直接调用窗体控件都是不安全的,可能导致程序崩溃,合理的做法是通过信号槽机制。

1
2
3
4
if  (d->isWidget) {
         qWarning( "QObject::moveToThread: Widgets cannot be moved to a new thread" );
         return ;
}

(4)只有在对象所在线程才能将对象移动到另一个线程,不能在其他线程将对象移动到某个线程,这种操作是不被允许的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
QThreadData *currentData = QThreadData::current();
     QThreadData *targetData = targetThread ? QThreadData::get2(targetThread) : Q_NULLPTR;
     if  (d->threadData-> thread  == 0 && currentData == targetData) {
         // one exception to the rule: we allow moving objects with no thread affinity to the current thread
         currentData = d->threadData;
     else  if  (d->threadData != currentData) {
         qWarning( "QObject::moveToThread: Current thread (%p) is not the object's thread (%p).\n"
                  "Cannot move to target thread (%p)\n" ,
                  currentData-> thread .load(), d->threadData-> thread .load(), targetData ? targetData-> thread .load() : Q_NULLPTR);
 
#ifdef Q_OS_MAC
         qWarning( "You might be loading two sets of Qt binaries into the same process. "
                  "Check that all plugins are compiled against the right Qt binaries. Export "
                  "DYLD_PRINT_LIBRARIES=1 and check that only one set of binaries are being loaded." );
#endif
 
         return ;
}

(5)线程转移

1
2
3
4
5
6
7
8
9
10
11
12
13
     //为转移线程准备,遍历所有子对象,并给每一个子对象发送一个QEvent::ThreadChange的事件。
     d->moveToThread_helper();
     if  (!targetData)
         targetData =  new  QThreadData(0);
//为转移事件上锁
     QOrderedMutexLocker locker(&currentData->postEventList.mutex,
                                &targetData->postEventList.mutex);
 
currentData->ref();
//遍历所有子对象及自身,将currentData的postEventList里面的对象转移到targetData,将所有子对象及自身的threadData设置为targetData
     d_func()->setThreadData_helper(currentData, targetData);
     locker.unlock();
currentData->deref();

 

6.connect函数

 

 

connet的重构函数很多,这里选择其中一个来分析。

 

1
2
3
QMetaObject::Connection QObject::connect( const  QObject *sender,  const  QMetaMethod & signal ,
                                      const  QObject *receiver,  const  QMetaMethod &method,
                                      Qt::ConnectionType type)

 

(1)首选senderreceiver不能为空,signal必须是Signal类型,也就是声明在signals:下面,method不能为构造函数,不满足这几个条件则返回。

 

1
2
3
4
5
6
7
8
9
10
11
if  (sender == 0
             || receiver == 0
             ||  signal .methodType() != QMetaMethod::Signal
             || method.methodType() == QMetaMethod::Constructor) {
         qWarning( "QObject::connect: Cannot connect %s::%s to %s::%s" ,
                  sender ? sender->metaObject()->className() :  "(null)" ,
                  signal .methodSignature().constData(),
                  receiver ? receiver->metaObject()->className() :  "(null)" ,
                  method.methodSignature().constData() );
         return  QMetaObject::Connection(0);
     }

 

2)检查signalmethod是否真实存在,在编译期即使传入的信号不存在也不会报错,在运行期会检查是否存在,所以在写connect函数的时候要仔细检查,尽量使用&ClassName::functionName的方式让系统自动补全,当然也可以通过connect的返回值来判断调用是否成功,如调用不成功则抛出异常。

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
int  signal_index;
     int  method_index;
     {
         int  dummy;
         QMetaObjectPrivate::memberIndexes(sender,  signal , &signal_index, &dummy);
         QMetaObjectPrivate::memberIndexes(receiver, method, &dummy, &method_index);
     }
 
     const  QMetaObject *smeta = sender->metaObject();
     const  QMetaObject *rmeta = receiver->metaObject();
     if  (signal_index == -1) {
         qWarning( "QObject::connect: Can't find signal %s on instance of class %s" ,
                  signal .methodSignature().constData(), smeta->className());
         return  QMetaObject::Connection(0);
     }
     if  (method_index == -1) {
         qWarning( "QObject::connect: Can't find method %s on instance of class %s" ,
                  method.methodSignature().constData(), rmeta->className());
         return  QMetaObject::Connection(0);
}

 

(3)检查signalmethod的参数个数和类型是否是一致的,不一致则返回。

 

1
2
3
4
5
6
7
if  (!QMetaObject::checkConnectArgs( signal .methodSignature().constData(), method.methodSignature().constData())) {
         qWarning( "QObject::connect: Incompatible sender/receiver arguments"
                  "\n        %s::%s --> %s::%s" ,
                  smeta->className(),  signal .methodSignature().constData(),
                  rmeta->className(), method.methodSignature().constData());
         return  QMetaObject::Connection(0);
}

 

4)如果你设置的连接方式为QueuedConnection,那么所有的参数都必须是元数据类型,自定义的类型,如自定义的结构体或枚举必须注册为元数据类型,否则无法作为信号和槽的参数,因为最终要将这些参数加入到消息队列里面。

 

1
2
3
4
int  *types = 0;
     if  ((type == Qt::QueuedConnection)
             && !(types = queuedConnectionTypes( signal .parameterTypes())))
         return  QMetaObject::Connection(0);

 

5)所有的检查完毕,调用QMetaObjectConnection函数,而QMetaObjectConnection会创建一个Connection的对象,这个对象会保存信号和槽的函数对象,然后会把这个Connection对象保存到sender的一个数组中,当你触发信号的时候,因为Connection对象保存在了sender中,所以可以找到原来绑定的槽函数,然后回调槽函数。

 

1
2
3
QMetaObject::Connection handle = QMetaObject::Connection(QMetaObjectPrivate::connect(
         sender, signal_index,  signal .enclosingMetaObject(), receiver, method_index, 0, type, types));
     return  handle;


免责声明!

本站转载的文章为个人学习借鉴使用,本站对版权不负任何法律责任。如果侵犯了您的隐私权益,请联系本站邮箱yoyou2525@163.com删除。



 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM