Difference between revisions of "FPC and DBus/es"

From Lazarus wiki
Jump to navigationJump to search
Line 46: Line 46:
 
</pre>
 
</pre>
  
After you no longer need the bus you should close the connect. A good place to do this on most cases is right before the application terminates.
+
Después, una vez que ya no se necesita el bus, se debería cerrar la conexión. Una buena forma de hacerlo en la mayoría de los casos es justamente antes del punto donde la aplicación termina:
  
 
<pre>
 
<pre>
   { Finalization }
+
   { Finalización }
 
   dbus_connection_close(conn);
 
   dbus_connection_close(conn);
 
</pre>
 
</pre>
  
==== Sending a Signal ====
+
==== Enviando una señal ====
  
==== Receiving a Signal ====
+
==== Recibiendo una señal ====
  
==== Calling a Method ====
+
==== Llamando a un método ====
  
==== Responding to Method calls ====
+
==== Respondiendo a llamadas a método ====
  
=== Authors ===
+
=== Autores ===
  
 
[[User:Sekelsenmat|Felipe Monteiro de Carvalho]]
 
[[User:Sekelsenmat|Felipe Monteiro de Carvalho]]
  
  
=== License ===
+
=== Licencia ===
  
  
=== Download ===
+
=== Descarga ===
  
Status: Beta
+
Stado: Beta
  
=== Subversion ===
+
=== Subversión ===
  
The FPC package for dbus resides in packages/[[dbus]] in the FPC (2.2.2/2.3.x+) packages tree.
+
El paquete de FPC para dbus se encuentra en packages/[[dbus]] en el árbol de paquetes de  FPC (2.2.2/2.3.x+).  
  
You can download the subversion version of this project using this command:
+
Se puede descargar la subversión de esta proyecto utilizando el mandato:
  
 
svn checkout http://svn.freepascal.org/svn/fpc/trunk/packages/dbus dbus
 
svn checkout http://svn.freepascal.org/svn/fpc/trunk/packages/dbus dbus
  
You can also download a full fpc 2.2.2+/2.3.1 repository and it will be included.
+
Por otra parte se puede descargar un repositorio completo de fpc 2.2.2+/2.3.1 que ya lo lleva incluido.
  
=== Bug Reporting ===
+
=== Reporte de errores ===
  
Tests are necessary to verify if all functions and structures are declared properly. Tests were done on Windows,FreeBSD and Linux operating systems. It is necessary to test if the modules work correctly in other operating system.
+
Se precisan pruebas para verificar si todas las funciones y estructuras están declaradas correctamente. Se han realizado ya pruebas para los sistemas operativos Windows, FreeBSD y Linux. Se necesitan pruebas adicionales en otros sistemas operativos para saber si el funcionamiento de estos módulos es correcto.
  
You can post Bug Reports here:
+
Puedes postear los reportes de error aquí si es necesario:
  
=== Change Log ===
+
 
 +
=== Registro de cambios ===
  
 
*??.??.06 DBus headers version 0.1
 
*??.??.06 DBus headers version 0.1
# Under construction
+
# Bajo construcción
  
 
=== Help ===
 
=== Help ===
Line 98: Line 99:
 
Please send help requests to the Free Pascal mailling list or on apache-modules mailling list.
 
Please send help requests to the Free Pascal mailling list or on apache-modules mailling list.
  
=== External Links ===
+
=== Links Externos ===
  
 
* [http://www.matthew.ath.cx/misc/dbus] - A Tutorial about using the DBUS C API
 
* [http://www.matthew.ath.cx/misc/dbus] - A Tutorial about using the DBUS C API

Revision as of 21:54, 9 September 2009

English (en) español (es)

Documentación

DBUS es una librería GNU relativamente nueva que implementa la comunicación entre procesos. Es la librería por defecto dentro de su genero para aplicaciones GNU.

Esta librería provee de lo necesario para que las aplicaciones se comuniquen unas con otras, utilizando el bus del sistema. Estas cabeceras (headers) son la traducción de la API C de bajo nivel. En un futuro sería deseable que estas cabeceras se envolviesen en una clase para facilitar su uso.

Common Code

Independientemente de lo que se quiera lograr con un programa, una gran cantidad del código contenido en el mismo tendrá grandes similitudes por el hecho de utilizar DBUS. Esta similitud la tendremos en el código de comienzo y finalización. En el comienzo porque se hace necesaria la conexión con el bus. Usualmente hay un sistema y una sesión de bus. Dependiendo de la configuración del sistema puede que no se tenga acceso al bus del sistema. A continuación se necesita una petición para obtener un nombre en el bus. Lo siguiente muestra de forma simplificada el código para el comienzo:

var
  err: DBusError;
  conn: PDBusConnection;
  ret: cint;
begin
  { Initializes the errors }
  dbus_error_init(@err);
  
  { Connection }
  conn := dbus_bus_get(DBUS_BUS_SESSION, @err);

  if dbus_error_is_set(@err) <> 0 then
  begin
    WriteLn('Connection Error: ' + err.message);
    dbus_error_free(@err);
  end;
  
  if conn = nil then Exit;
  
  { Request the name of the bus }
  ret := dbus_bus_request_name(conn, 'test.method.server', DBUS_NAME_FLAG_REPLACE_EXISTING, @err);

  if dbus_error_is_set(@err) <> 0 then
  begin
    WriteLn('Name Error: ' + err.message);
    dbus_error_free(@err);
  end;
  
  if ret <> DBUS_REQUEST_NAME_REPLY_PRIMARY_OWNER then Exit;

  ....

Después, una vez que ya no se necesita el bus, se debería cerrar la conexión. Una buena forma de hacerlo en la mayoría de los casos es justamente antes del punto donde la aplicación termina:

  { Finalización }
  dbus_connection_close(conn);

Enviando una señal

Recibiendo una señal

Llamando a un método

Respondiendo a llamadas a método

Autores

Felipe Monteiro de Carvalho


Licencia

Descarga

Stado: Beta

Subversión

El paquete de FPC para dbus se encuentra en packages/dbus en el árbol de paquetes de FPC (2.2.2/2.3.x+).

Se puede descargar la subversión de esta proyecto utilizando el mandato:

svn checkout http://svn.freepascal.org/svn/fpc/trunk/packages/dbus dbus

Por otra parte se puede descargar un repositorio completo de fpc 2.2.2+/2.3.1 que ya lo lleva incluido.

Reporte de errores

Se precisan pruebas para verificar si todas las funciones y estructuras están declaradas correctamente. Se han realizado ya pruebas para los sistemas operativos Windows, FreeBSD y Linux. Se necesitan pruebas adicionales en otros sistemas operativos para saber si el funcionamiento de estos módulos es correcto.

Puedes postear los reportes de error aquí si es necesario:


Registro de cambios

  • ??.??.06 DBus headers version 0.1
  1. Bajo construcción

Help

Please send help requests to the Free Pascal mailling list or on apache-modules mailling list.

Links Externos

  • [1] - A Tutorial about using the DBUS C API