Gio.NetworkService¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37), Gio.SocketConnectable (3)
Structs:: GObject.ObjectClass (5)

class	`new` (service, protocol, domain)
	`get_domain` ()
	`get_protocol` ()
	`get_scheme` ()
	`get_service` ()
	`set_scheme` (scheme)

Virtual Methods¶

Inherited:: GObject.Object (7), Gio.SocketConnectable (3)

Properties¶

Name	Type	Flags	Short Description
`domain`	`str`	r/w/co	Network domain, eg, “example.com”
`protocol`	`str`	r/w/co	Network protocol, eg “tcp”
`scheme`	`str`	r/w	Network scheme (default is to use service)
`service`	`str`	r/w/co	Service name, eg “ldap”

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Gio.NetworkService(**kwargs)¶

Bases:: GObject.Object, Gio.SocketConnectable
Abstract:: No
Structure:: Gio.NetworkServiceClass

Like Gio.NetworkAddress does with hostnames, Gio.NetworkService provides an easy way to resolve a SRV record, and then attempt to connect to one of the hosts that implements that service, handling service priority/weighting, multiple IP addresses, and multiple address families.

See Gio.SrvTarget for more information about SRV records, and see Gio.SocketConnectable for an example of using the connectable interface.

classmethod new(service, protocol, domain)[source]¶

Parameters:

service (str) – the service type to look up (eg, “ldap”)
protocol (str) – the networking protocol to use for service (eg, “tcp”)
domain (str) – the DNS domain to look up the service in

Returns:

a new Gio.NetworkService

Return type:

Gio.NetworkService

Creates a new Gio.NetworkService representing the given service, protocol, and domain. This will initially be unresolved; use the Gio.SocketConnectable interface to resolve it.

New in version 2.22.

get_domain()[source]¶

Returns:: self's domain name
Return type:: str

Gets the domain that self serves. This might be either UTF-8 or ASCII-encoded, depending on what self was created with.

New in version 2.22.

get_protocol()[source]¶

Returns:: self's protocol name
Return type:: str

Gets self's protocol name (eg, “tcp”).

New in version 2.22.

get_scheme()[source]¶

Returns:: self's scheme name
Return type:: str

Gets the URI scheme used to resolve proxies. By default, the service name is used as scheme.

New in version 2.26.

get_service()[source]¶

Returns:: self's service name
Return type:: str

Gets self's service name (eg, “ldap”).

New in version 2.22.

set_scheme(scheme)[source]¶

Parameters:: scheme (str) – a URI scheme

Set’s the URI scheme used to resolve proxies. By default, the service name is used as scheme.

New in version 2.26.

Property Details¶

Gio.NetworkService.props.domain¶

Name:: domain
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

Network domain, eg, “example.com”

Gio.NetworkService.props.protocol¶

Name:: protocol
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

Network protocol, eg “tcp”

Gio.NetworkService.props.scheme¶

Name:: scheme
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

Network scheme (default is to use service)

Gio.NetworkService.props.service¶

Name:: service
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

Service name, eg “ldap”