Класс NetworkManager

(Aurora::Mdm::Connectivity::NetworkManager)

Класс NetworkManager используется для управления сетевыми службами. Подробнее…

Заголовочный файл:

#include <mdm-networkmanager.h>

Список всех членов класса, включая унаследованные

Свойства

scanning : bool
valid : const bool

Публичные методы

NetworkManager(QObject *parent = 0)
virtual ~NetworkManager()
QString createService(QVariantMap settings)
ServicesVector getAvailableServices(const QString &type)
QStringList getMissingMandatoryProps(const QVariantMap &settings) const
QStringList getMissingOptionalProps(const QVariantMap &settings) const
ServicesVector getSavedServices(const QString &type)
bool isValid() const
bool removeSavedService(const QString &path, const QString &type)
bool removeSavedServiceByName(const QString &name, const QString &type)
void requestAvailableServices(const QString &type)
bool requestConnect(const QString &path, const QString &type)
bool requestConnectByName(const QString &name, const QString &type)
void requestCreateService(QVariantMap settings)
bool requestDisconnect(const QString &path, const QString &type)
bool requestDisconnectByName(const QString &name, const QString &type)
void requestSavedServices(const QString &type)
bool scanning()
void setScanning(bool value)

Сигналы

void availableServicesChanged()
void availableServicesReady(ServicesVector newServices)
void errorCreateService()
void savedServicesChanged()
void savedServicesReady(ServicesVector newServices)
void scanningChanged()
void serviceCreated(const QString &path)
void validChanged()

Подробное описание

Класс NetworkManager используется для управления сетевыми службами.

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

и затем #include <mdm-networkmanager.h>.

Пример использования:

 #include <mdm-networkmanager.h>

 void example()
 {
     using namespace Aurora::Mdm::Connectivity

     NetworkService networkService;

     QVariantMap propsToSet = {
       {"Type", "wifi"},
       {"Access", "full"},
       {"Security", "psk"},
     };
     networkService.setProps(propsToSet);

     NetworkManager networkManager;
     netorkManager.createService(networkService);
 }

Описание свойств

scanning : bool

true, если сканирование сети активно, в противном случае — false. Для корректной работы getAvailableServices сканирование должно быть активным. Сканирование отключается при уничтожении экземпляра NetworkManager.

Методы доступа:

bool scanning()
void setScanning(bool value)

Сигнал уведомления:

void scanningChanged()

valid : const bool

true, если объект NetworkManager готов к использованию, иначе false.

Методы доступа:

bool isValid() const

Сигнал уведомления:

void validChanged()

Описание методов класса

NetworkManager::NetworkManager(QObject *parent = 0)

Создаёт объект NetworkManager с заданным родителем parent.

[virtual] NetworkManager::~NetworkManager()

Уничтожает объект NetworkManager.

[signal] void NetworkManager::availableServicesChanged()

Этот сигнал испускается при изменении списка доступных служб.

[signal] void NetworkManager::availableServicesReady(ServicesVector newServices)

Этот сигнал возвращает список служб по завершении работы getAvailableServicesAsync. Параметр newServices содержит обновлённый список доступных служб.

QString NetworkManager::createService(QVariantMap settings)

Создаёт сохранённую сетевую службу. Параметр settings представляет собой QVariantMap с настройками нового сохраняемого сервиса. Поддержка только для типа "wifi". См. NetworkService для получения подробностей о полях. Возвращает путь к сохранённой службе или пустую QString в случае ошибки.

[signal] void NetworkManager::errorCreateService()

Этот сигнал испускается при возникновении ошибки в createServiceAsync.

ServicesVector NetworkManager::getAvailableServices(const QString &type)

Находит доступные сетевые службы. Параметр type представляет собой QString с типом сетевой службы для возврата (например, wifi). Возвращает NetworkManager::ServicesVector (псевдоним для QVector<QSharedPointer<NetworkService>>).

QStringList NetworkManager::getMissingMandatoryProps(const QVariantMap &settings) const

Параметр settings представляет собой QVariantMap, содержащий уже установленные свойства. Возвращает набор обязательных свойств, которые должны быть установлены в соответствии с заданными свойствами.

QStringList NetworkManager::getMissingOptionalProps(const QVariantMap &settings) const

Параметр settings представляет собой QVariantMap, содержащий уже установленные свойства. Возвращает набор дополнительных (опциональных) свойств, которые можно установить в соответствии с заданными свойствами.

ServicesVector NetworkManager::getSavedServices(const QString &type)

Находит сохранённые сетевые службы. Параметр type содержит QString с типом возвращаемой сетевой службы (например, wifi). Возвращает значение типа NetworkManager::ServicesVector (псевдоним для QVector<QSharedPointer<NetworkService>>).

bool NetworkManager::removeSavedService(const QString &path, const QString &type)

Удаляет службу по указанным path и type из списка сохранённых. На данный момент доступен только тип "wifi". Возвращает true при успешном выполнении, false в случае ошибки.

bool NetworkManager::removeSavedServiceByName(const QString &name, const QString &type)

Удаляет службу с указанными name и type из списка сохранённых. На данный момент доступен только тип "wifi". Возвращает true при успешном выполнении, false в случае ошибки.

void NetworkManager::requestAvailableServices(const QString &type)

Асинхронно находит доступные сетевые службы. Параметр type представляет собой QString с типом сетевой службы (например, wifi). Испускает сигнал availableServicesReady при успешном выполнении.

bool NetworkManager::requestConnect(const QString &path, const QString &type)

Пытается подключиться к службе по указанным path и type. На данный момент доступен только тип "wifi". Возвращает true при успешном выполнении, false в случае ошибки.

bool NetworkManager::requestConnectByName(const QString &name, const QString &type)

Пытается подключиться к службе с указанными name и type. На данный момент доступен только тип "wifi". Возвращает true при успешном выполнении, false в случае ошибки.

void NetworkManager::requestCreateService(QVariantMap settings)

Асинхронно создает сохранённую сетевую службу. Параметр settings представляет собой QVariantMap с настройками нового сохраняемого сервиса. Испускает сигнал serviceCreated при успешном выполнении. Испускает сигнал errorCreateService() при возникновении ошибки.

bool NetworkManager::requestDisconnect(const QString &path, const QString &type)

Пытается отключиться от службы с указанными path и type. Возвращает true при успешном выполнении, false в случае ошибки.

bool NetworkManager::requestDisconnectByName(const QString &name, const QString &type)

Пытается отключиться от службы с указанными name и type. На данный момент доступен только тип "wifi". Возвращает true при успешном выполнении, false в случае ошибки.

void NetworkManager::requestSavedServices(const QString &type)

Асинхронно находит сохранённые сетевые службы. Параметр type содержит тип сетевой службы (QString), который требуется получить (например, wifi). Испускает сигнал savedServicesReady при успешном выполнении.

[signal] void NetworkManager::savedServicesChanged()

Этот сигнал испускается при изменении списка сохранённых служб.

[signal] void NetworkManager::savedServicesReady(ServicesVector newServices)

Этот сигнал возвращает список служб по завершении работы getSavedServicesAsync. Параметр newServices содержит обновлённый список сохранённых служб.

[signal] void NetworkManager::serviceCreated(const QString &path)

Этот сигнал возвращает path созданной службы с помощью createServiceAsync.