Класс NetworkService

(Aurora::Mdm::Connectivity::NetworkService)

Класс NetworkService представляет системные сетевые службы (например, wifi). Подробнее…

Заголовочный файл:	#include <mdm-networkservice.h>
Наследники:	Aurora::Mdm::Connectivity::WifiNetworkService

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

Публичные типы

• enum OwnerType { OwnerUser, OwnerMdm, OwnerAll }
• enum SecurityType { SecurityUnknown, SecurityNone, SecurityWEP, SecurityPSK, SecurityIEEE802 }

Свойства

• autoConnect : bool
• available : const bool
• connected : const bool
• connecting : const bool
• domains : const QStringList
• domainsConfig : QStringList
• error : const QString
• ethernet : const QVariantMap
• favorite : const bool
• ipv4 : const QVariantMap
• ipv6 : const QVariantMap
• ipv4Config : QVariantMap
• ipv6Config : QVariantMap
• lastConnectError : const QString
• managed : const bool
• name : const QString
• nameservers : const QStringList
• nameserversConfig : QStringList
• ownerType : const OwnerType
• path : QString
• proxy : const QVariantMap
• proxyConfig : QVariantMap
• roaming : const bool
• saved : const bool
• security : const QStringList
• securityType : const SecurityType
• state : const QString
• strength : const uint
• timeservers : const QStringList
• timeserversConfig : QStringList
• type : const QString
• valid : const bool

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

• NetworkService(const QString &path, const QVariantMap &properties, QObject *parent = nullptr)
• virtual ~NetworkService()
• bool autoConnect() const
• bool available() const
• bool connected() const
• bool connecting() const
• QStringList domains() const
• QStringList domainsConfig() const
• QString error() const
• QVariantMap ethernet() const
• bool favorite() const
• QVariantMap ipv4() const
• QVariantMap ipv6() const
• QVariantMap ipv4Config() const
• QVariantMap ipv6Config() const
• bool isValid() const
• QString lastConnectError() const
• bool managed() const
• QString name() const
• QStringList nameservers() const
• QStringList nameserversConfig() const
• OwnerType ownerType() const
• QString path() const
• QVariantMap proxy() const
• QVariantMap proxyConfig() const
• void remove()
• void requestConnect()
• void requestDisconnect()
• void resetCounters()
• bool roaming() const
• bool saved() const
• QStringList security() const
• SecurityType securityType() const
• void setAutoConnect(bool autoconnect)
• void setDomainsConfig(const QStringList &domains)
• void setIpv4Config(const QVariantMap &ipv4)
• void setIpv6Config(const QVariantMap &ipv6)
• void setNameserversConfig(const QStringList &nameservers)
• void setPath(const QString &path)
• void setProxyConfig(const QVariantMap &proxy)
• void setTimeserversConfig(const QStringList &servers)
• QString state() const
• uint strength() const
• QStringList timeservers() const
• QStringList timeserversConfig() const
• QString type() const

Сигналы

• void autoConnectChanged()
• void availableChanged()
• void connectRequestFailed()
• void connectedChanged()
• void connectingChanged()
• void domainsChanged()
• void domainsConfigChanged()
• void errorChanged()
• void ethernetChanged()
• void favoriteChanged()
• void ipv4Changed()
• void ipv4ConfigChanged()
• void ipv6Changed()
• void ipv6ConfigChanged()
• void lastConnectErrorChanged()
• void managedChanged()
• void nameChanged()
• void nameserversChanged()
• void nameserversConfigChanged()
• void ownerTypeChanged()
• void pathChanged()
• void propertiesReady()
• void proxyChanged()
• void proxyConfigChanged()
• void roamingChanged()
• void savedChanged()
• void securityChanged()
• void securityTypeChanged()
• void serviceConnectionStarted()
• void serviceDisconnectionStarted()
• void stateChanged()
• void strengthChanged()
• void timeserversChanged()
• void timeserversConfigChanged()
• void typeChanged()
• void validChanged()

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

Класс NetworkService представляет системные сетевые службы (например, wifi).

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

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

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

 #include <mdm-networkservice.h>
 #include <mdm-networkmanager.h>

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

     QVariantMap propsToSet = {
       {"Type", "wifi"},
       {"Access", "full"},
       {"Security", "psk"},
     };

     NetworkManager networkManager;
     networkManager.createService(propsToSet);
 }

Свойство	Тип	Возможные значения
Тип	QString	"wifi"
Security	QString	"none", "wep", "psk" (WPA/WPA2 PSK), "ieee8021x" (WPA EAP)
Access	QString	"mdm", "full"
Name	QString	Name
AutoConnect	bool	[true, false]
IPv4.Configuration	QVariantMap	"<Method> <Address> <Netmask> <Gateway>"
IPv6.Configuration	QVariantMap	"<Method> <Address> <PrefixLength> <Gateway> <Privacy>"
Nameservers.Configuration	QStringList	"<Config1>...<ConfigN>"
Domains.Configuration	QStringList	"<Config1>...<ConfigN>"
Proxy.Configuration	QVariantMap	"<Method> <URL> <Servers> <Excludes>"
CACert	QString	"<CACert>"
CACertFile	QString	"<Cert path>"
ClientCert	QString	"<ClientCert>"
ClientCertFile	QString	"<Cert path>"
DomainSuffixMatch	QString	"<DomainSuffixMatch>"
Phase2	QString	"[PAP, MSCHAP, MSCHAPV2, GTC]"
AnonymousIdentity	QString	"<AnonymousIdentity>"
Passphrase	QString	"<Passphrase>"
Timeservers.Configuration	QStringList	"<Config1>...<ConfigN>"
EAP	QString	"[none, peap, tls, ttls]"
Identity	QString	"<Identity>"
"PeapVersion"	QString	"<PeapVersion>"
"PrivateKeyFile"	QString	"<PrivateKeyFile path>"

Свойства IPv4.Configuration:

Свойство	Тип	Возможные значения
Method	QString	[dhcp, manual]
Address	QString	<IP-адрес>
Netmask	QString	<Сетевая маска>
Gateway	QString	<Адрес API-шлюза>

Свойства IPv6.Configuration:

Свойство	Тип	Возможные значения
Method	QString	[dhcp, manual]
Address	QString	<IP-адрес>
PrefixLength	int	<Длина префикса>
Gateway	QString	<Адрес API-шлюза>
Privacy	QString	[prefered, enabled]

Свойства Proxy.Configuration:

Свойство	Тип	Возможные значения
Method	QString	[auto, manual]
URL	QString	<URL прокси>
Servers	QStringList	<Список серверов>
Excludes	QStringList	<Список исключений>
Privacy	QString	[prefered, enabled]

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

enum NetworkService::OwnerType

Указывает владельца сетевого подключения.

Константа	Значение	Описание
Aurora::Mdm::Connectivity::NetworkService::OwnerUser	1	Пользовательское или несохранённое сетевое подключение. Данное сетевое подключение невозможно удалить через приложение MDM.
Aurora::Mdm::Connectivity::NetworkService::OwnerMdm	2	Сетевое подключение, созданное MDM. Пользователь не может удалить эту сеть.
Aurora::Mdm::Connectivity::NetworkService::OwnerAll	3	Сетевое подключение, созданное MDM. Пользователь может удалить эту сеть.

enum NetworkService::SecurityType

Определяет типы безопасности для сетевых подключений.

Константа	Значение	Описание
Aurora::Mdm::Connectivity::NetworkService::SecurityUnknown	0	Неизвестно
Aurora::Mdm::Connectivity::NetworkService::SecurityNone	1	Ничего
Aurora::Mdm::Connectivity::NetworkService::SecurityWEP	2	Безопасность WEP
Aurora::Mdm::Connectivity::NetworkService::SecurityPSK	3	Безопасность PSK
Aurora::Mdm::Connectivity::NetworkService::SecurityIEEE802	4	Безопасность IEEE802

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

autoConnect : bool

Флаг, определяющий автоматическое подключение к сетевой службе.

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

• bool autoConnect() const
• void setAutoConnect(bool autoconnect)

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

• void autoConnectChanged()

available : const bool

Свойство истинно, если сетевая служба доступна для использования.

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

• bool available() const

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

• void availableChanged()

connected : const bool

Флаг, указывающий на подключение к сетевой службе.

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

• bool connected() const

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

• void connectedChanged()

connecting : const bool

Свойство истинно, если в данный момент выполняется подключение к сетевой службе.

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

• bool connecting() const

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

• void connectingChanged()

domains : const QStringList

Список доменных суффиксов для сетевой службы.

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

• QStringList domains() const

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

• void domainsChanged()

domainsConfig : QStringList

Настраиваемый список доменных суффиксов для сетевой службы.

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

• QStringList domainsConfig() const
• void setDomainsConfig(const QStringList &domains)

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

• void domainsConfigChanged()

error : const QString

Строка с описанием ошибки, связанной с сетевой службой.

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

• QString error() const

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

• void errorChanged()

ethernet : const QVariantMap

Детали Ethernet-подключения для сетевой службы.

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

• QVariantMap ethernet() const

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

• void ethernetChanged()

favorite : const bool

Свойство истинно, если сетевая служба в избранное.

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

• bool favorite() const

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

• void favoriteChanged()

ipv4 : const QVariantMap

Конфигурация IPv4 для сетевой службы.

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

• QVariantMap ipv4() const

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

• void ipv4Changed()

ipv6 : const QVariantMap

Конфигурация IPv6 для сетевой службы.

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

• QVariantMap ipv6() const

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

• void ipv6Changed()

ipv4Config : QVariantMap

Настраиваемые параметры IPv4 для сетевой службы.

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

• QVariantMap ipv4Config() const
• void setIpv4Config(const QVariantMap &ipv4)

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

• void ipv4ConfigChanged()

ipv6Config : QVariantMap

Настраиваемые параметры IPv6 для сетевой службы.

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

• QVariantMap ipv6Config() const
• void setIpv6Config(const QVariantMap &ipv6)

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

• void ipv6ConfigChanged()

lastConnectError : const QString

Содержит последнюю ошибку подключения, возникшую у сетевой службы.

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

• QString lastConnectError() const

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

• void lastConnectErrorChanged()

managed : const bool

Свойство истинно, если сетевая служба управляется вышестоящей системой.

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

• bool managed() const

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

• void managedChanged()

name : const QString

Имя сетевой службы.

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

• QString name() const

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

• void nameChanged()

nameservers : const QStringList

Настроенные DNS-серверы для сетевой службы.

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

• QStringList nameservers() const

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

• void nameserversChanged()

nameserversConfig : QStringList

Настраиваемые параметры DNS-серверов для сетевой службы.

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

• QStringList nameserversConfig() const
• void setNameserversConfig(const QStringList &nameservers)

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

• void nameserversConfigChanged()

ownerType : const OwnerType

Указывает владельца сетевого подключения.

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

• OwnerType ownerType() const

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

• void ownerTypeChanged()

path : QString

Путь к конфигурации сетевой службы.

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

• QString path() const
• void setPath(const QString &path)

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

• void pathChanged()

proxy : const QVariantMap

Настройки прокси для сетевой службы.

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

• QVariantMap proxy() const

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

• void proxyChanged()

proxyConfig : QVariantMap

Настраиваемые параметры прокси для сетевой службы.

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

• QVariantMap proxyConfig() const
• void setProxyConfig(const QVariantMap &proxy)

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

• void proxyConfigChanged()

roaming : const bool

Флаг, указывающий на активность режима роуминга.

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

• bool roaming() const

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

• void roamingChanged()

saved : const bool

Свойство истинно, если сохранена текущая конфигурация сетевой службы.

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

• bool saved() const

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

• void savedChanged()

security : const QStringList

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

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

• QStringList security() const

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

• void securityChanged()

securityType : const SecurityType

Тип безопасности, установленный для сетевой службы.

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

• SecurityType securityType() const

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

• void securityTypeChanged()

state : const QString

Текущее состояние сетевой службы.

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

• QString state() const

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

• void stateChanged()

strength : const uint

Уровень сигнала сетевой службы (обычно измеряется в dBm).

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

• uint strength() const

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

• void strengthChanged()

timeservers : const QStringList

Список настроенных серверов времени для сетевой службы.

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

• QStringList timeservers() const

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

• void timeserversChanged()

timeserversConfig : QStringList

Настраиваемый список серверов времени для сетевой службы.

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

• QStringList timeserversConfig() const
• void setTimeserversConfig(const QStringList &servers)

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

• void timeserversConfigChanged()

type : const QString

Тип сетевой службы.

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

• QString type() const

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

• void typeChanged()

valid : const bool

Флаг корректности сетевой службы.

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

• bool isValid() const

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

• void validChanged()

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

NetworkService::NetworkService(const QString &path, const QVariantMap &properties, QObject *parent = nullptr)

Конструктор для класса NetworkService с указанными параметрами path, properties и parent.

[virtual] NetworkService::~NetworkService()

Деструктор для класса NetworkService.

[signal] void NetworkService::connectRequestFailed()

Сигнал, испускаемый при неудачном запросе подключения.

[signal] void NetworkService::propertiesReady()

Сигнал, испускаемый при готовности сетевых параметров к использованию.

void NetworkService::remove()

Удаляет конфигурацию сетевой службы.

void NetworkService::requestConnect()

Запрашивает подключение к сетевой службе.

См. также requestDisconnect().

void NetworkService::requestDisconnect()

Запрашивает отключение от сетевой службы.

См. также requestConnect().

void NetworkService::resetCounters()

Сбрасывает все счётчики трафика.

[signal] void NetworkService::serviceConnectionStarted()

Сигнал, испускаемый при запуске процесса подключения к сетевой службе.

[signal] void NetworkService::serviceDisconnectionStarted()

Сигнал, испускаемый при запуске процесса отключения от сетевой службы.