gio.proxy_resolver_mixin

Module for ProxyResolver interface mixin

tmpl ProxyResolverGidBuilderT ProxyResolverT

Templates 2

tmplProxyResolverT()

gio.proxy_resolver.ProxyResolver provides synchronous and asynchronous network proxy resolution. gio.proxy_resolver.ProxyResolver is used within gio.socket_client.SocketClient through the method gio.socket_connectable.SocketConnectable.proxyEnumerate.

Implementations of gio.proxy_resolver.ProxyResolver based on libproxy and GNOME settings can be found in glib-networking. GIO comes with an implementation for use inside Flatpak portals.

Functions

bool isSupported()

Checks if resolver can be used on this system. (This is used internally; gio.proxy_resolver.ProxyResolver.getDefault will only return a proxy resolver that returns true for this method.)

Returns

true if resolver is supported.

string[] lookup(string uri, gio.cancellable.Cancellable cancellable = null)

Looks into the system proxy configuration to determine what proxy, if any, to use to connect to uri. The returned proxy URIs are of the form <protocol>://[user[:password]@]host[:port] or direct://, where <protocol> could be http, rtsp, socks or other proxying protocol.

If you don't know what network protocol is being used on the socket, you should use none as the URI protocol. In this case, the resolver might still return a generic proxy type (such as SOCKS), but would not return protocol-specific proxy types (such as http).

direct:// is used when no proxy is needed. Direct connection should not be attempted unless it is part of the returned array of proxies.

Parameters

`uri`	a URI representing the destination to connect to
`cancellable`	a #GCancellable, or null

Returns

NULL-terminated array of proxy URIs. Must be freed with glib.global.strfreev.

Throws

ErrorWrap

void lookupAsync(string uri, gio.cancellable.Cancellable cancellable = null, gio.types.AsyncReadyCallback callback = null)

Asynchronous lookup of proxy. See gio.proxy_resolver.ProxyResolver.lookup for more details.

Parameters

`uri`	a URI representing the destination to connect to
`cancellable`	a #GCancellable, or null
`callback`	callback to call after resolution completes

string[] lookupFinish(gio.async_result.AsyncResult result)

Call this function to obtain the array of proxy URIs when gio.proxy_resolver.ProxyResolver.lookupAsync is complete. See gio.proxy_resolver.ProxyResolver.lookup for more details.

Parameters

result the result passed to your #GAsyncReadyCallback

Returns

NULL-terminated array of proxy URIs. Must be freed with glib.global.strfreev.

Throws

ErrorWrap

tmplProxyResolverGidBuilderT()

Fluent builder implementation template for gio.proxy_resolver.ProxyResolver