PDF de programación - Manual de GNOME-DB

Manual de GNOME-DB

Michael Lausch

[email protected]

Rodrigo Moya
[email protected]

Vivien Malerba
[email protected]

Sean Allen

[email protected]

David Vaquero
[email protected]

Manual de GNOME-DB
por Michael Lausch, Rodrigo Moya, Vivien Malerba, Sean Allen, y David Vaquero

Copyright © 1999-2001 por The Free Software Foundation

GNOME-DB es parte del Proyecto GNOME (http://www.gnome.org). Es un front-end de la
biblioteca libgda , que provee una arquitectura de acceso universal a diferentes tipos de fuentes de
datos (bases de datos, servidores de información, ficheros de texto plano, etc).

GNOME-DB es también parte del proyecto GNOME Office
(http://www.gnome.org/gnome-office/) , que es una suite libre de aplicaciones para GNOME que
tienen como finalidad la productividad en el escritorio. GNOME-DB provee la parte de acceso a
bases de datos de la suite.

Esta licencia asegura la copia, distribución y/o modificación de este documento bajo las normas de la GNU Free
Documentation License, Version 1.1 or o cualquier otra version versión posterior publicada por la Free Software
Foundation contando variaciones en las Secciones, Portada y Contraportada. Se puede encontrar una copia de la licencia
en Licencia FDL (fdl-apendix.html)
Muchos de los nombres usados por compañías para distinguir sus productos y servicios están asumidos como trademarks.
Cuando estos nombre aparezcan en cualquier parte de la documentación de GNOME, y esas trademarks están adcritas a
los miembros del Projecto de Documentation de GNOME, los nombres o acrónimos estarán impresos en mayúsculas.

Tabla de contenidos

1. Introducción ...............................................................................................................1
2. Biblioteca de Componentes de GNOME-DB...........................................................2
3. Biblioteca de Widgets de GNOME-DB ....................................................................3
3.1. Introdución........................................................................................................3
3.2. Vista previa de los widgets de GNOME-DB ....................................................4
3.2.1. El widget GnomeDbLogin .....................................................................4
3.2.2. El widgetGnomeDbLoginDlg................................................................5
3.2.3. El widgetGnomeDbDsnConfig .............................................................5
3.2.4. El widgetGnomeDbBrowser..................................................................5
3.2.5. El widgetGnomeDbGrid ........................................................................5
3.2.6. El widgetGnomeDbDataset..................................................................5
3.2.7. El widgetGnomeDbCombo ......................................................................6
3.2.8. El widgetGnomeDbList ........................................................................6
3.2.9. El widgetGnomeDbReport ....................................................................6
3.2.10. El widgetGnomeDbIconList..............................................................6
3.2.11. El widgetGnomeDbError ....................................................................7
3.2.12. El widgetGnomeDbErrorDlg..............................................................7
4. Componentes Bonobo ................................................................................................8
4.1. Introducción ......................................................................................................8
5. Configurador de GNOME-DB..................................................................................9
5.1. Introducción ......................................................................................................9
5.2. Componentes de Configuración........................................................................9
6. Aplicación Front-End ..............................................................................................10
6.1. Introduction.....................................................................................................10

iv

Capítulo 1. Introducción

GNOME-DB puede ser tomado como una extensión del proyecto libgda. Ya que se
dedican a los mismo: a proveer un acceso universal a fuentes de datos para aplicaciones
cliente, y también como bibliotecas y herramientas de desarrollo con esta finalidad.
GNOME-DB es una arquitectura del proyecto GNOME.

Ambos proyectos se unifican bajo el proyecto GNOME-DB, pero libgda se separó de él
para que tuviera una mayor usabilidad fuera de los entornos GNOME. Todas la
dependencias de GNOME serán quitadas cuando esta separación sea finalizada.

Pero GNOME-DB no es sólo un front-end de libgda para el proyecto GNOME.
Debiado a que, hace uso de diferentes tecnologías de GNOME , como Bonobo, XML ,
GConf, etc, que extienden libgda con el fin de facilitar el desarrollo de aplicaciones
GNOME relacionadas con la bases de datos. A través del uso de Bonobo, el sistema de
componentes de GNOME, se provee una gran cantidad de servicios y utilidades en
forma de componentes, que permiten su reutilización en otras aplicaciones basadas en
Bonobo. De hecho, esta es la manera de intercomunicación con otras aplicaciones
contenidas en la suite GNOME Office.

Esto provee bibliotecas que son usadas en el desarrollo de GNOME-DB aplicaciones, y
multitud de herramientas y utilidades para ayudar en todas aquellas tareas relacionadas
con bases de datos. Y también incluye un entorno de dasarrollo para acelerar el
desarrollo del aplicaciones basadas en GNOME-DB.

1

Capítulo 2. Biblioteca de Componentes
de GNOME-DB

2

Capítulo 3. Biblioteca de Widgets de
GNOME-DB

3.1. Introdución

Esta biblioteca contiene un completo conjunto de widgets GNOME que permiten
incluir de una manera sencilla el modelo GDA en sus aplicaciones GNOME.

Todos los widgets son widgets GTK+, con lo que se tiene una aproximación orientada a
objetos en la interfaz de usuario. Que le permitirá, por ejemplo, escribir un widget a
medida para su aplicación, simplemente implementando una funcionalidad extra. La
funcionalidad básica ya está implementada por el widget GDA.

Esto también significa que puede asociar procedimientos a las señales recibidas por los
widget, tal como se hace con los widgets GTK+/GNOME. De hecho, los widgets
GNOME-DB informan de su comportamiento emitiendo señales que pueden ser
capturadas por su aplicación para obtener información de aquellos eventos señalizados.

Por ejemplo, el widget GnomeDbBrowser contiene multitud de widgets hijos , que con
el fin de capturar eventos de usuario, que son capturados por el propio widget
GnomeDbBrowser. Las posteriores propagaciones de algunos de estos eventos se
realizan emitiendo sus propias señales. Éstas pueden, por ejemplo, conocer la
interacción que el usuario está haceiendo con el widget y actualizar una mensaje en la
barra de estados, mostrar una ventana de diálogo cuando ocurre algún error, etc.

Los widgets que provee la biblioteca de GNOME-DB cubren casi todos aquellos
requisitos para el desarrollo de interfaces de usuario para sus aplicaciones orientadas a
bases de datos. Si aún así sus requisitos no estan cubiertos, tiene dos opciones:
comunicarse con nostros para que hagamos el widget que quiere, o, implementar usted
mismo su propia subclase para que realice aquellas funciones que necesite. Si elige la
segunda opción, debiera mirar la documentación de GTK+, especialmente el capítulo
’Writing your Own Widgets’.

Los widgets contenidos en la biblioteca son:

• GnomeDbLogin

• GnomeDbLoginDlg

• GnomeDbDsnConfig

3

Capítulo 3. Biblioteca de Widgets de GNOME-DB

• GnomeDbHelpViewer

• GnomeDbBrowser

• GnomeDbGrid

• GnomeDbDataset

• GnomeDbCombo

• GnomeDbList

• GnomeDbIconList

• GnomeDbReport

• GnomeDbDesigner

• GnomeDbHelp

• GnomeDbShortcut

• GnomeDbWindow

• GnomeDbError

• GnomeDbErrorDlg

3.2. Vista previa de los widgets de GNOME-DB

Esta sección contiene una Vista previa sobre qué puede hacer con los widgets que
provee la biblioteca GNOME-DB. Contiene también una breve explicación de su
funcionalidad básica y cómo usar cada widget.

3.2.1. El widget GnomeDbLogin

El widget GnomeDbLogin provee una manera personalizable de conectar visualmente
su aplicación a con un proveedor GDA. Se puede añadir a cualquier contenedor de
widgets, para crear, por ejemplo, una cuadro de diálogo, y después añadir el widget
GnomeDbLogin dentro de él.

En su inicialización, lee la configuración de GDA y provee un cuadro que contiene
todas las fuentes de datos configuradas para los usuarios. El ususario sólo tiene que
seleccionar la fuente de datos y dar su nombre de usuario y contraseña. También
muestra una lista de las fuentes de datos usadas más recientemente para que pueda
rápidamente conectar con su bases de datos "favoritas".

4

3.2.2. El widgetGnomeDbLoginDlg

Capítulo 3. Biblioteca de Widgets de GNOME-DB

Este es el widget adecuado que sólo contiene un widget GnomeDbLogin. Es una
subclase de GnomeDialog, así que se espera que tenga el mismo aspecto que el resto
de su aplicación.

Este widget no sólo contiene el widget GnomeDbLogin , ya que captura las señales del
contenedor, para que, sí lo usa, debiera conectarlo tanto a las señales de
GnomeDbLoginDlg como a las de GnomeDbLogin.

3.2.3. El widgetGnomeDbDsnConfig

El widget GnomeDbDsnConfig provee una manera de permitir visualmente al usuario
manejar fuentes de datos GDA. Este widget puede ser insertado fácilmente en un
cuadro de diálogo de configuración, por ejemplo, y proveer un interfaz visual de
configuración de los ficheros de configuración de GDA.

Este widget es un visual wrapper sobre las funciones de manejo de GdaDsn.

3.2.4. El widgetGnomeDbBrowser

Este es un widget verdaderamente completo que permite explorar la base de datos
entera: tablas, vistas, usuarios y los procedimientos almacenados, etc. El caso más
sencil