glibmm: Gio::NetworkService Class Reference
A GSocketConnectable for resolving SRV records. More...
#include <giomm/networkservice.h>
Public Member Functions | |
| virtual | ~NetworkService () |
| GNetworkService* | gobj () |
| Provides access to the underlying C GObject. | |
| const GNetworkService* | gobj () const |
| Provides access to the underlying C GObject. | |
| GNetworkService* | gobj_copy () |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
| Glib::ustring | get_service () const |
| Gets srv's service name (eg, "ldap"). | |
| Glib::ustring | get_protocol () const |
| Gets srv's protocol name (eg, "tcp"). | |
| Glib::ustring | get_domain () const |
| Gets the domain that srv serves. | |
| Glib::ustring | get_scheme () const |
| Get's the URI scheme used to resolve proxies. | |
| void | set_scheme (const Glib::ustring& scheme) |
| Set's the URI scheme used to resolve proxies. | |
| Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_domain () const |
| Network domain, eg, 'example.com'. | |
| Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_protocol () const |
| Network protocol, eg 'tcp'. | |
| Glib::PropertyProxy < Glib::ustring > | property_scheme () |
| Network scheme (default is to use service). | |
| Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_scheme () const |
| Network scheme (default is to use service). | |
| Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_service () const |
| Service name, eg 'ldap'. | |
Static Public Member Functions | |
| static Glib::RefPtr < NetworkService > | create (const Glib::ustring& service, const Glib::ustring& protocol, const Glib::ustring& domain) |
Related Functions | |
(Note that these are not member functions.) | |
| Glib::RefPtr< Gio::NetworkService > | wrap (GNetworkService* object, bool take_copy=false) |
| A Glib::wrap() method for this object. | |
Detailed Description
A GSocketConnectable for resolving SRV records.
Like NetworkAddress does with hostnames, 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 SrvTarget for more information about SRV records, and see SocketConnectable for and example of using the connectable interface.
Constructor & Destructor Documentation
| virtual Gio::NetworkService::~NetworkService | ( | ) | [virtual] |
Member Function Documentation
| static Glib::RefPtr<NetworkService> Gio::NetworkService::create | ( | const Glib::ustring& | service, |
| const Glib::ustring& | protocol, | ||
| const Glib::ustring& | domain | ||
| ) | [static] |
| Glib::ustring Gio::NetworkService::get_domain | ( | ) | const |
Gets the domain that srv serves.
This might be either UTF-8 or ASCII-encoded, depending on what srv was created with.
- Returns:
- srv's domain name.
| Glib::ustring Gio::NetworkService::get_scheme | ( | ) | const |
Get's the URI scheme used to resolve proxies.
By default, the service name is used as scheme.
- Returns:
- srv's scheme name.
| GNetworkService* Gio::NetworkService::gobj | ( | ) | [inline] |
Provides access to the underlying C GObject.
Reimplemented from Gio::SocketConnectable.
| const GNetworkService* Gio::NetworkService::gobj | ( | ) | const [inline] |
Provides access to the underlying C GObject.
Reimplemented from Gio::SocketConnectable.
| GNetworkService* Gio::NetworkService::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
Network domain, eg, 'example.com'.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Network protocol, eg 'tcp'.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Network scheme (default is to use service).
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Network scheme (default is to use service).
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Service name, eg 'ldap'.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
| void Gio::NetworkService::set_scheme | ( | const Glib::ustring& | scheme | ) |
Set's the URI scheme used to resolve proxies.
By default, the service name is used as scheme.
- Parameters:
-
scheme A URI scheme.
Friends And Related Function Documentation
| Glib::RefPtr< Gio::NetworkService > wrap | ( | GNetworkService * | object, |
| bool | take_copy = false |
||
| ) | [related] |
A Glib::wrap() method for this object.
- Parameters:
-
object The C instance. take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
- Returns:
- A C++ instance that wraps this C instance.