让Qt应用程序只运行一个实例

Question

在实际应用中，我们经常需要让应用程序只有一个实例，再打开新的文档或者页面时，只是替换现在的窗口或者新打开一个标签，而不是重新启动一次应用程序。Qt中是否可以做到这样呢，答案是肯定的，因为Qt本身可以直接调用系统API，肯定可以做到，但是我们希望找到一个跨平台的通用的解决方案。
这就要用到Qt的QLocalSocket，QLocalServer类了，这两个类从接口上看和网络通信socket没有区别，但是它并不是真正的网络API，只是模仿了而已。这两个类在Unix/Linux系统上采用Unix域socket实现，而在Windows上则采用有名管道（named pipe）来实现。

既然是网络API，那么思路就很简单了，应用程序启动时首先会去连一个服务器（这里通过应用程序的名字来标识，就像网络端口一样），如果连接失败，那么则自己是第一个实例，就创建这么一个服务器，否则将启动参数发送到服务器，然后自动退出，而服务器会在收到通知以后进行处理。

这些动作我想最好是放在创建Application实例后，因为Qt本身有很多操作没有Application实例是无法进行操作的（至少事件循环是在创立Application以后才能启动吧），因此最好的位置就是通过继承QApplicaiton或者QCoreApplication自定义一个YourOwnApplication，然后在构造函数中进行，下面是一个示意。

首先是YourOwnApplication构造函数：

1. QString serverName = QCoreApplication::applicationName();
3. QLocalSocket socket;
4. socket.connectToServer(serverName);
6. if (socket.waitForConnected(500)) { //如果能够连接得上的话，将参数发送到服务器，然后退出
8.     QTextStream stream(&socket);
9.     QStringList args = QCoreApplication::arguments();
11.     if (args.count() > 1)
12.         stream << args.last();
13.     else
14.         stream << QString();
15.     stream.flush();
16.     socket.waitForBytesWritten();
17.     qApp->quit();
19.     return;
20. }
22. //运行到这里，说明没有实例在运行，那么创建服务器。
24. m_localServer = new QLocalServer(this);
26. connect(m_localServer, SIGNAL(newConnection()),
27.             this, SLOT(newLocalSocketConnection())); //监听新到来的连接
29. if (!m_localServer->listen(serverName)) {
30.     if (m_localServer->serverError() == QAbstractSocket::AddressInUseError
31.             && QFile::exists(m_localServer->serverName())) { //确保能够监听成功
32.         QFile::remove(m_localServer->serverName());
33.         m_localServer->listen(serverName);
34.     }
35. }
36. // 这样就保证了新启动的程序在检测到有其他实例在运行时就会自动退出，
37. // 但是它发出的请求还没有被处理，
38. // 下面看一下处理函数，也就是前段代码中的newLocalSocketConnection()。
40. QLocalSocket *socket = m_localServer->nextPendingConnection();
42. if (!socket)
43.         return;
45. socket->waitForReadyRead(1000);
46. QTextStream stream(socket);
47. //其他处理
49. delete socket;
50. mainWindow()->raise();
51. mainWindow()->activateWindow(); //记得激活窗口哦

复制代码