Service Framework API/es: Difference between revisions
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
h2. This is Work in progress - Articulo en progreso | |||
'''Spanish''' [[ | '''Spanish''' [[Service_Framework_API_Spanish|English]] | ||
[[Category:Developing with Qt::QtMobility]] | |||
[[Category:Spanish]] | |||
== Caracteristicas de Qt Mobility 1.1.x == | |||
= | == Noticias : == | ||
"Qt Mobility 1.1.3 Release&quot;:http://labs.qt.nokia.com/2011/05/04/qt-4-7-3-and-qt-mobility-1-1-3-have-been-released/ actualmente disponible para desarrollo de aplicaciones comerciales para ser distribuidas en Ovi store<br />"Qt Mobility 1.2.0 release&quot;:http://labs.qt.nokia.com/2011/05/12/qt-mobility-1-2-0-released/ actualmente disponible | |||
= | = Service Framework = | ||
* Simplifica a | El API fuera de proceso de Service Framework simplifica a IPC. Permite que las aplicaciones puedan escuchar las señales, llamar slots, acceder a las propiedades e invocar métodos en QObjects en otros procesos. | ||
== Características principales == | |||
* Simplifica a IPC | |||
* Servicios de descubrimiento | * Servicios de descubrimiento | ||
* Sistema basado en QMetaObject | * Sistema basado en QMetaObject | ||
| Line 21: | Line 25: | ||
* Se puede tener acceso compartido o únicos a objetos remotos. Los objetos compartidos son compartidos entre todos los clientes. Objetos únicos son exclusivos de esa sesión y el cliente. | * Se puede tener acceso compartido o únicos a objetos remotos. Los objetos compartidos son compartidos entre todos los clientes. Objetos únicos son exclusivos de esa sesión y el cliente. | ||
==Descripción detallada== | == Descripción detallada == | ||
Una característica de QMetaObject es la comunicación local con signals y slots. Service Framework fuera del proceso de comunicación extiende las signals y los slots en otros procesos. La señal es interceptada, serializada y se pasa al proceso remoto en el que se recrea y se comporta como si fuera una signal local. Esto simplifica el | Una característica de QMetaObject es la comunicación local con signals y slots. Service Framework fuera del proceso de comunicación extiende las signals y los slots en otros procesos. La señal es interceptada, serializada y se pasa al proceso remoto en el que se recrea y se comporta como si fuera una signal local. Esto simplifica el IPC desde el cliente y el servidor puede usar QObject::connect y emit que es conocido por todos los programadores Qt. | ||
Junto con las signals y los slots el sistema MetaObject proporciona propiedades, llamadas a métodos a través de slots o Q_INVOKABLE y la identificación de tipos en tiempo de ejecución. Invoca funciones se serializa la solicitud, llama a la propiedad remota y devolver los resultados sin problemas a el proceso local. | Junto con las signals y los slots el sistema MetaObject proporciona propiedades, llamadas a métodos a través de slots o Q_INVOKABLE y la identificación de tipos en tiempo de ejecución. Invoca funciones se serializa la solicitud, llama a la propiedad remota y devolver los resultados sin problemas a el proceso local. | ||
| Line 29: | Line 33: | ||
El código del cliente para conectarse a un servicio remoto es: | El código del cliente para conectarse a un servicio remoto es: | ||
<code><br />// Create a service manager<br />QServiceManager manager; | |||
// Get the interface descriptor<br />QList&lt;QServiceInterfaceDescriptor&gt; ld = manager.findInterfaces("Service&quot;); | |||
Una vez que el QObject es creado puede ser tratado como cualquier QObject con respecto al sistema de meta objetos. Hay una diferencia importante, los servicios remotos puede fallar. Una signal especial es añadida a QObjects errorUnrecoverableIPCFault(QService::UnrecoverableIPCError) la cual es emitida cuando se produce un fallo en las comunicaciones. El objetivo entonces debe ser destruido. | // Get a local object<br />QObject '''obj = manager.loadInterface(ld[0]); | ||
<br />// Connect to a sample signal<br />connect(obj, SIGNAL (HelloWorld(QString)), this, SLOT (Hello(QString)));<br /></code> | |||
<br />Con 4 líneas de código IPC se ha establecido un servicio remoto. La primera línea crea una QServiceManager que gestiona descubrimiento de servicios. La segunda línea se busca la interfaz de nuestro objeto de prueba, y la tercera línea crear un nuevo QObject para el servicio remoto. | |||
<br />La última línea conecta las signal de los objetos remotos HelloWorld al slot local Hola. Cada vez que el objeto remoto emite una signal Hola se llamará. El argumento QString sera pasado con una copia de los datos remotos | |||
<br />Una vez que el QObject es creado puede ser tratado como cualquier QObject con respecto al sistema de meta objetos. Hay una diferencia importante, los servicios remotos puede fallar. Una signal especial es añadida a QObjects errorUnrecoverableIPCFault(QService::UnrecoverableIPCError) la cual es emitida cuando se produce un fallo en las comunicaciones. El objetivo entonces debe ser destruido. | |||
<br />Este lado del servicio requiere de dos partes, un archivo XML que describe el servicio y el registro con el servicio. A continuación un ejemplo del archivo XML: | |||
<br /><code>&lt;?xml version="1.0&quot; encoding="UTF-8&quot;?&gt;<br /><service&gt;<br /> <name&gt;IPCExampleService&lt;/name&gt;<br /> <filepath&gt;localsocket:qt_sfw_example&lt;/filepath&gt;<br /> <description&gt;Example XML file&lt;/description&gt;<br /> <interface&gt;<br /> <name&gt;com.nokia.qt.example&lt;/name&gt;<br /> <version&gt;1.0&lt;/version&gt;<br /> <description&gt;Descriptive text&lt;/description&gt;<br /> <capabilities&gt;</capabilities&gt;<br /> </interface&gt;<br /></service&gt;</code> | |||
<br />Mientras el archivo XML se explica asi mismo, el filepath es importante. Se debe comenzar con "localsocket&quot; que describe un proceso fuera de servicio. Para registrarse con el administrador de servicios: | |||
<br /><code>QServiceManager manager;<br />const QString path = QCoreApplication::applicationDirPath() + "/xmldata/exampleservice.xml&quot;;<br />m.add(path);<br />QRemoteServiceClassRegister::registerType&lt;SharedService&gt;(QRemoteServiceClassRegister::SharedInstance);<br />QRemoteServiceControl''' control = new QRemoteServiceControl();<br />control->publishServices("qt_sfw_example&quot;);<br />#ifdef Q_OS_SYMBIAN<br /> RProcess::Rendezvous(KErrNone); // will be removed after tech preview<br />#endif<br />app.exec&amp;#40;&#41;</code> | |||
Las 3 primeras lineas registran el XML con el administrador de servicios. Este sólo tiene que ser llamado una vez para registrar el servicio. Esto se puede hacer durante la instalación, por ejemplo. | |||
Las 3 primeras lineas registran el | |||
Los siguientes 3 líneas registran el objeto a ser exportado. | Los siguientes 3 líneas registran el objeto a ser exportado. | ||
| Line 47: | Line 55: | ||
El ifdef Q_OS_SYMBIAN es requerido temporalmente al arranque con la tech preview y sera removido en futuras versiones. | El ifdef Q_OS_SYMBIAN es requerido temporalmente al arranque con la tech preview y sera removido en futuras versiones. | ||
Luego de la registración QCoreApplication::exec | Luego de la registración QCoreApplication::exec&amp;#40;&#41; es llamado para comenzar a trabajar. | ||
SharedService puede ser definido así: | SharedService puede ser definido así: | ||
<code> | |||
class SharedService : public QObject<br />{<br /> Q_OBJECT<br /> Q_SERVICE(SharedService, "IPCExampleService&quot;, "com.nokia.qt.example&quot;, "1.0&quot;) | |||
public:<br /> SharedService(QObject* parent = 0)<br /> : QObject(parent)<br /> { | |||
} | |||
Q_INVOKABLE QString doSomething(int input)<br /> {<br /> // do something<br /> } | |||
Q_SIGNALS:<br /> void HelloWorld(QString string);<br />};<br /></code> | |||
Eso es todo lo que hay que hacer! | |||
== | == Ejemplos completos == | ||
Un ejemplo completo con chequeo de errores esta disponible en "Qt Mobility examples: Echo Client&quot;:http://doc.qt.nokia.com/qtmobility/sfwecho.html que proporciona un servicio y un UI de ejemplo que demuestra las comunicaciones fuera de proceso de Service Framework. | |||
Revision as of 06:18, 24 February 2015
h2. This is Work in progress - Articulo en progreso
Spanish English
Caracteristicas de Qt Mobility 1.1.x
Noticias :
"Qt Mobility 1.1.3 Release":http://labs.qt.nokia.com/2011/05/04/qt-4-7-3-and-qt-mobility-1-1-3-have-been-released/ actualmente disponible para desarrollo de aplicaciones comerciales para ser distribuidas en Ovi store
"Qt Mobility 1.2.0 release":http://labs.qt.nokia.com/2011/05/12/qt-mobility-1-2-0-released/ actualmente disponible
Service Framework
El API fuera de proceso de Service Framework simplifica a IPC. Permite que las aplicaciones puedan escuchar las señales, llamar slots, acceder a las propiedades e invocar métodos en QObjects en otros procesos.
Características principales
- Simplifica a IPC
- Servicios de descubrimiento
- Sistema basado en QMetaObject
- Multiplataforma y optimizado para cada plataforma. En Linux usa dBus, en Symbian usa CServer2. Operación de reserva para QLocalSocket.
- Se puede tener acceso compartido o únicos a objetos remotos. Los objetos compartidos son compartidos entre todos los clientes. Objetos únicos son exclusivos de esa sesión y el cliente.
Descripción detallada
Una característica de QMetaObject es la comunicación local con signals y slots. Service Framework fuera del proceso de comunicación extiende las signals y los slots en otros procesos. La señal es interceptada, serializada y se pasa al proceso remoto en el que se recrea y se comporta como si fuera una signal local. Esto simplifica el IPC desde el cliente y el servidor puede usar QObject::connect y emit que es conocido por todos los programadores Qt.
Junto con las signals y los slots el sistema MetaObject proporciona propiedades, llamadas a métodos a través de slots o Q_INVOKABLE y la identificación de tipos en tiempo de ejecución. Invoca funciones se serializa la solicitud, llama a la propiedad remota y devolver los resultados sin problemas a el proceso local.
El código del cliente para conectarse a un servicio remoto es:
<br />// Create a service manager<br />QServiceManager manager;
// Get the interface descriptor<br />QList&lt;QServiceInterfaceDescriptor&gt; ld = manager.findInterfaces("Service&quot;);
// Get a local object<br />QObject '''obj = manager.loadInterface(ld[0]);
<br />// Connect to a sample signal<br />connect(obj, SIGNAL (HelloWorld(QString)), this, SLOT (Hello(QString)));<br />
Con 4 líneas de código IPC se ha establecido un servicio remoto. La primera línea crea una QServiceManager que gestiona descubrimiento de servicios. La segunda línea se busca la interfaz de nuestro objeto de prueba, y la tercera línea crear un nuevo QObject para el servicio remoto.
La última línea conecta las signal de los objetos remotos HelloWorld al slot local Hola. Cada vez que el objeto remoto emite una signal Hola se llamará. El argumento QString sera pasado con una copia de los datos remotos
Una vez que el QObject es creado puede ser tratado como cualquier QObject con respecto al sistema de meta objetos. Hay una diferencia importante, los servicios remotos puede fallar. Una signal especial es añadida a QObjects errorUnrecoverableIPCFault(QService::UnrecoverableIPCError) la cual es emitida cuando se produce un fallo en las comunicaciones. El objetivo entonces debe ser destruido.
Este lado del servicio requiere de dos partes, un archivo XML que describe el servicio y el registro con el servicio. A continuación un ejemplo del archivo XML:
&lt;?xml version="1.0&quot; encoding="UTF-8&quot;?&gt;<br /><service&gt;<br /> <name&gt;IPCExampleService&lt;/name&gt;<br /> <filepath&gt;localsocket:qt_sfw_example&lt;/filepath&gt;<br /> <description&gt;Example XML file&lt;/description&gt;<br /> <interface&gt;<br /> <name&gt;com.nokia.qt.example&lt;/name&gt;<br /> <version&gt;1.0&lt;/version&gt;<br /> <description&gt;Descriptive text&lt;/description&gt;<br /> <capabilities&gt;</capabilities&gt;<br /> </interface&gt;<br /></service&gt;
Mientras el archivo XML se explica asi mismo, el filepath es importante. Se debe comenzar con "localsocket" que describe un proceso fuera de servicio. Para registrarse con el administrador de servicios:
QServiceManager manager;<br />const QString path = QCoreApplication::applicationDirPath() + "/xmldata/exampleservice.xml&quot;;<br />m.add(path);<br />QRemoteServiceClassRegister::registerType&lt;SharedService&gt;(QRemoteServiceClassRegister::SharedInstance);<br />QRemoteServiceControl''' control = new QRemoteServiceControl();<br />control->publishServices("qt_sfw_example&quot;);<br />#ifdef Q_OS_SYMBIAN<br /> RProcess::Rendezvous(KErrNone); // will be removed after tech preview<br />#endif<br />app.exec&amp;#40;&#41;
Las 3 primeras lineas registran el XML con el administrador de servicios. Este sólo tiene que ser llamado una vez para registrar el servicio. Esto se puede hacer durante la instalación, por ejemplo.
Los siguientes 3 líneas registran el objeto a ser exportado.
In this case the QObject is SharedService, and is a shared instance meaning only one instance will exist for all clients.
El ifdef Q_OS_SYMBIAN es requerido temporalmente al arranque con la tech preview y sera removido en futuras versiones.
Luego de la registración QCoreApplication::exec&#40;) es llamado para comenzar a trabajar.
SharedService puede ser definido así:
class SharedService : public QObject<br />{<br /> Q_OBJECT<br /> Q_SERVICE(SharedService, "IPCExampleService&quot;, "com.nokia.qt.example&quot;, "1.0&quot;)
public:<br /> SharedService(QObject* parent = 0)<br /> : QObject(parent)<br /> {
}
Q_INVOKABLE QString doSomething(int input)<br /> {<br /> // do something<br /> }
Q_SIGNALS:<br /> void HelloWorld(QString string);<br />};<br />
Eso es todo lo que hay que hacer!
Ejemplos completos
Un ejemplo completo con chequeo de errores esta disponible en "Qt Mobility examples: Echo Client":http://doc.qt.nokia.com/qtmobility/sfwecho.html que proporciona un servicio y un UI de ejemplo que demuestra las comunicaciones fuera de proceso de Service Framework.