QNetworkInformation Class

Description détaillée

QNetworkInformation fournit une interface multiplateforme pour les informations relatives au réseau par l'intermédiaire de plugins.

Les plugins peuvent prendre en charge différentes fonctionnalités, et vous pouvez donc charger des plugins en fonction des fonctionnalités dont vous avez besoin.

Dans la plupart des cas, l'approche recommandée consiste à charger le backend spécifique à la plate-forme en appelant loadDefaultBackend(). Cela permet de sélectionner automatiquement le backend le plus approprié disponible sur la plateforme actuelle et convient à la majorité des applications.

#include <QCoreApplication>#include <QNetworkInformation>#include <QDebug>void onReachabilityChanged(QNetworkInformation::Reachability reachability) { switch (reachability) { case QNetworkInformation::Reachability::Unknown :        qDebug() << "Network reachability is unknown.";
       break; case QNetworkInformation::Reachability::Disconnected :        qDebug() << "Network is disconnected.";
       break; case QNetworkInformation::Reachability::Local :        qDebug() << "Network is locally reachable.";
       break; case QNetworkInformation::Accessibilité::Site :        qDebug() << "Network can reach the site.";
       break; case QNetworkInformation::Atteignabilité::En ligne :        qDebug() << "Network is online.";
       break; } }int main(int argc, char *argv[]) { QCoreApplication a(argc, argv) ; // Vérifie si QNetworkInformation est pris en charge si (!QNetworkInformation::loadDefaultBackend()) {        qWarning() << "QNetworkInformation is not supported on this platform or backend.";
       return 1; } QNetworkInformation* netInfo = QNetworkInformation::instance() ; // Connexion au signal reachabilityChanged   QObject::connect(netInfo, &QNetworkInformation::reachabilityChanged, &onReachabilityChanged) ; // Affiche l'état initialonReachabilityChanged(netInfo>reachability()) ; return a.exec() ; }

Pour des cas d'utilisation plus avancés, les développeurs peuvent préférer charger un backend en fonction de capacités ou de préférences spécifiques. loadBackendByFeatures() permet de sélectionner un backend qui prend en charge un ensemble spécifique de fonctionnalités, telles que l'indication du médium de transport ou de l'intensité du signal. Par ailleurs, loadBackendByName() permet de charger un plugin par son nom, ce qui peut inclure des implémentations de backend spécifiques à une plateforme ou personnalisées.

QNetworkInformation est un singleton et reste en vie depuis le premier chargement réussi jusqu'à la destruction de l'objet QCoreApplication. Si vous détruisez et recréez l'objet QCoreApplication, vous devez le charger à nouveau pour réinitialiser le plugin.

Un cas d'utilisation possible de QNetworkInformation est la surveillance de l'état de la connectivité du réseau. reachability() indique si le système est considéré comme étant en ligne, sur la base des informations communiquées par le système d'exploitation ou le plugin sous-jacent. Toutefois, ces informations ne sont pas toujours exactes. Par exemple, sous Windows, la vérification en ligne peut reposer sur la connectivité à un serveur appartenant à Microsoft ; si ce serveur est inaccessible (par exemple, en raison de règles de pare-feu), le système peut indiquer à tort qu'il est hors ligne. Ainsi, reachability() ne doit pas être utilisé comme un contrôle préalable définitif avant de tenter une connexion réseau, mais plutôt comme un signal général de l'état de la connectivité.

Pour utiliser efficacement reachability(), l'application doit également comprendre le type de destination qu'elle tente d'atteindre. Par exemple, si la cible est une adresse IP locale, Reachability::Local ou Reachability::Site peut suffire. Si la destination se trouve sur l'internet public, il faut alors utiliser Reachability::Online. Sans ce contexte, l'interprétation de l'accessibilité signalée peut conduire à des hypothèses erronées sur l'accès réel au réseau.

// Aide simple pour déterminer si une adresse IP est "locale"bool isLocalAddress(const QHostAddress &address) { return address.isInSubnet(QHostAddress("192.168.0.0"), 16) ||address.isInSubnet(QHostAddress("10.0.0.0"), 8)    |address.isInSubnet(QHostAddress("172.16.0.0"), 12) |address.isLoopback() ; }int main(int argc, char *argv[]) { ... // Adresse IP cible (par défaut : Google DNS)   QString targetIpStr = argc > 1 ? argv[1]: "8.8.8.8"; QHostAddress targetIp(targetIpStr) ; if (targetIp.isNull()) {        qWarning() << "Invalid IP address:" << targetIpStr;
       return 1; } // Décider du niveau de joignabilité nécessaire pour la cible   QNetworkInformation::Reachability requiredReachability =isLocalAddress(targetIp) ? QNetworkInformation::Reachability::Local : QNetworkInformation::Reachability::Online ; // Récupérer la joignabilité actuelle rapportée par le système   QNetworkInformation::Reachability currentReachability =  networkInfo->reachability() ;
    qDebug() << "Target IP:" << targetIp.toString();
    qDebug() << "Target is considered"
            << (isLocalAddress(targetIp)) ? "local/site.": "external/online.") ;    qDebug() << "Required reachability level:" << requiredReachability;
    qDebug() << "Current reachability:" << currentReachability;

   if (currentReachability < requiredReachability) {        qWarning() << "Current network state may not allow reaching the target address.";
    } else {        qDebug() << "Target may be reachable based on current network state.";
    } ...