Gio.NetworkService

g GObject.GInterface GObject.GInterface Gio.SocketConnectable Gio.SocketConnectable GObject.GInterface->Gio.SocketConnectable GObject.Object GObject.Object Gio.NetworkService Gio.NetworkService GObject.Object->Gio.NetworkService Gio.SocketConnectable->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

protocol

str

r/w/co

scheme

str

r/w

service

str

r/w/co

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 [class`Gio`.NetworkAddress] does with hostnames, GNetworkService 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 [struct`Gio`.SrvTarget] for more information about SRV records, and see [iface`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, for example example.com.

New in version 2.22.

Gio.NetworkService.props.protocol
Name:

protocol

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT_ONLY

Network protocol, for example tcp.

New in version 2.22.

Gio.NetworkService.props.scheme
Name:

scheme

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE

Network scheme (default is to use service).

New in version 2.22.

Gio.NetworkService.props.service
Name:

service

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT_ONLY

Service name, for example ldap.

New in version 2.22.