gupnp-bindingstool - Online in de cloud

PROGRAMMA:

NAAM

gupnp-binding-tool - creëert C-gemakswrappers voor UPnP-services

KORTE INHOUD

gupnp-bindingstool [--voorvoegsel {PREFIX}] [--modus {client|server}] {SCPD-bestand}

PRODUCTBESCHRIJVING

gupnp-bindingstool neemt een SCPD-bestand en genereert gemaks-C-functies die de
daadwerkelijke GUPnP-functies. De bindingen aan de clientzijde kunnen worden gezien als een servicespecifieke versie
van de GUPnPServiceProxy API en de bindingen aan de servicezijde zijn hetzelfde voor GUPnPService.

Deze gegenereerde functies zijn minder uitgebreid en ook veiliger als functieaanroepparameters
correct getypt. Actie-, variabele- en querynamen zijn gemakkelijker correct te krijgen met bindingen
(of in ieder geval zullen de fouten tijdens het compileren zijn in plaats van bij runtime), en dat zijn ze ook
beschikbaar in de automatische aanvulling van de editor.

CLIËNT KANT BINDINGEN

Als voorbeeld deze actie:


PortMapping verwijderen


NieuweRemoteHost
in
ExterneHost


Nieuwe Externe Poort
in
Externe poort


NieuwProtocol
in
PortMapping-protocol




Genereert de volgende synchrone client-side (controlepunt) functie:

statisch inline gbooleaans
igd_delete_port_mapping (GUPnPServiceProxy *proxy,
const gchar *in_new_remote_host,
const guint in_nieuwe_externe_poort,
const gchar *in_nieuw_protocol,
GError **fout);

Zoals u kunt zien, hebben de argumenten het juiste type en worden ze voorafgegaan door het argument
richting.

gupnp-bindingstool genereert zowel synchrone als asynchrone wrappers. De
igd_delete_port_mapping het bovenstaande voorbeeld is de synchrone vorm, de asynchrone vorm is as
volgt:

typedef ongeldig (*igd_delete_port_mapping_reply) (GUPnPServiceProxy *proxy,
GError *fout,
gpointer gebruikersgegevens);

statisch inline GUPnPServiceProxyAction *
igd_delete_port_mapping_async (GUPnPServiceProxy *proxy,
const gchar *in_new_remote_host,
const guint in_nieuwe_externe_poort,
const gchar *in_nieuw_protocol,
igd_delete_port_mapping_reply terugbellen,
gpointer gebruikersgegevens);

Het asynchrone formulier (geïmplementeerd met behulp van gupnp_service_proxy_begin_action() en
gupnp_service_proxy_end_action()) zal terugkeren zonder te blokkeren en later de
terugbellen vanuit de hoofdlus wanneer het antwoord wordt ontvangen.

De tool creëert ook bindingen voor meldingen van statusvariabelen. Deze statusvariabele
definitie:


Extern IP-adres
snaar


zal deze clientbinding creëren die kan worden gebruikt om meldingen te ontvangen
"Extern IP-adres" wijzigingen:

typedef ongeldig
(*igd_external_ip_address_changed_callback) (GUPnPServiceProxy *proxy,
const gchar *extern_ip_adres,
gpointer gebruikersgegevens);

statisch inline gbooleaans
igd_external_ip_address_add_notify (GUPnPServiceProxy *proxy,
igd_external_ip_address_changed_callback terugbellen,
gpointer gebruikersgegevens);

Alle voorbeelden zijn gemaakt met gupnp-binding-tool --prefix igd --mode client
WANIPConnection.xml.

SERVER KANT BINDINGEN

De overeenkomstige serverbindingen voor dezelfde UPnP-actie (DeletePortMapping) zien er uit
deze:

komen te vervallen
igd_delete_port_mapping_action_get (GUPnPServiceAction *actie,
gchar **in_nieuwe_remote_host,
guint *in_nieuwe_externe_poort,
gchar **in_nieuw_protocol);

goelong
igd_delete_port_mapping_action_connect (GUPnPService *service,
Terugbellen,
gpointer gebruikersgegevens);

De gegenereerde functie *_action_connect() kan worden gebruikt om de actie-handler te verbinden. De
De functies *_action_get() en *_action_set() kunnen vervolgens binnen de actie-handler worden gebruikt
actievariabelen ophalen/instellen. Als gemelde variabelen worden gewijzigd, wordt *_variable_notify()
moet worden gebruikt om de meldingen te verzenden (zie hieronder).

typedef gchar *(*igd_external_ip_address_query_callback) (GUPnPService *service,
gpointer gebruikersgegevens);

goelong
igd_external_ip_address_query_connect (GUPnPService *service,
igd_external_ip_address_query_callback terugbellen,
gpointer gebruikersgegevens);
komen te vervallen
igd_external_ip_address_variable_notify (GUPnPService *service,
const gchar *extern_ip_adres);

De functie *_query_connect() kan worden gebruikt om verbinding te maken met de servicespecifieke queryhandler.
De retourwaarde van de handler is de geretourneerde statusvariabelewaarde.

Alle voorbeelden zijn geproduceerd met gupnp-binding-tool --prefix igd --mode server
WANIPConnection.xml.

COPYRIGHT

Copyright © 2007, 2008, 2009 OpenedHand Ltd, Nokia Corporation

Toestemming wordt verleend voor het kopiëren, verspreiden en/of wijzigen van dit document onder de voorwaarden van:
de GNU-licentie voor gratis documentatie, versie 1.1 of een latere versie gepubliceerd door de Free
Software Foundation zonder invariante secties, zonder tekst op de voorpagina en zonder achterpagina
Teksten. U kunt een kopie van de GNU-licentie voor vrije documentatie verkrijgen via de Vrije Software
Stichting door te bezoeken hun Web website of door te schrijven naar:

De Free Software Foundation, Inc.,
59 Tempelplaats - Suite 330,
Boston, MA 02111-1307,
USA

Gebruik de gupnp-bindingstool online met behulp van onworks.net-services