TitanicLinux.Net:: Manual de DaoGen http://translate.googleusercontent.com/translate_c?hl=es&ie=UTF-8&sl=...

Manual DaoGen

Este es el manual de usuario final para DaoGen. Este manual trata de explicar cómo utilizar
el uso DaoGen para producir código correcto de alta calidad. Esto no es un manual para la
programación SQL, en general, ni es esta un manual de Java, PHP o cualquier otro lenguaje
de programación que podrían apoyar DaoGen. El Faq DaoGen tiene algunas respuestas para
las preguntas más frecuentes. Le damos la bienvenida a los foros de discusión DaoGen .

1. Concepto Básico

DaoGen es un generador de código fuente que produce el código de manejo de bases de

datos y los objetos asociados de valor. Funciona sin ningún tipo de instalaciones de
software.

DaoGen le pedirá que defina las opciones de generación de código básico que incluyen
nombre de la base de mesa, dando como resultado el nombre de clase, lengua de trabajo
(lenguaje de programación que desea que el generado por las fuentes) y el número de
atributos persistentes y no persistentes.

Es importante que usted proporcione la información correcta en cada campo, ya que el

código resultante se genere será muy afectados por sus selecciones. información con
formato incorrecto en cualquiera de los campos de entrada hará que genera un mal
funcionamiento o código compilable no.

Después de las opciones de generación de base se seleccionan, DaoGen le pedirá que

proporcione información detallada sobre cada columna de la tabla. Usted tendrá que
seleccionar un tipo de datos de columna, el nombre de la columna y optinally los nombres
de las variables que estas columnas se asignan a. También el orden preferido para los
métodos de regresar varios objetos de valor debe estar seleccionada.

El paso final es la generación de código real. Esto se hace DaoGen y sólo tendrá que copiar
y pegar el código resultante en su propio proyecto. Algunos consejos (como nombres de
archivo preferido) se suministrará junto con el código generado.

2. Tablas de nombres, clases, columnas y variables

DaoGen no limita los nombres de las tablas, columnas de clases o más allá de las
limitaciones de los lenguajes de programación generado. Por lo tanto, no se le permite
poner espacios o puntos en los nombres de las clases, las columnas o variables. SQL
permite los nombres de tabla que se especificarán en un formato especial "database.table",
donde se separará punto la base de datos y la mesa. No se permiten espacios en los
nombres de tabla tampoco. Si han puesto el nombre de las tablas con un punto de
separación, asegúrese de que usted proporciona un nombre de clase válido en las opciones
de generación de base, incluso si es othervise no es necesario. Si no se proporciona el
nombre de clase, DaoGen utilizará el nombre de la tabla que ha especificado como el
nombre de la clase generada. Esto provocará problemas de compilación, ya que los puntos
no están permitidos en nombres de clase.

Cuando se han puesto el nombre de las columnas de la base de datos, asegúrese de escribir
los nombres estrictamente la misma forma que estaban definidos en el comando SQL
CREATE TABLE. Si no ha preparado la base de datos antes, puede utilizar cualquier estilo de
nombres que te gusta. Sin embargo, si usted quiere que su programa de código generado a
obedecer algunas convenciones de nombres - aparte de la que es su base de datos con la
opción - usted debe proporcionar los nombres de las variables que las columnas se asignan
a. Por ejemplo, la tabla tiene una columna denominada "some_column" y desea que el
código Java generado a obedecer la nomenclatura estándar de Java, debe proporcionar el
nombre de variable "someColumn" para esta columna. Si usted no proporciona los nombres
de variables, los nombres de columna se utilizará como nombres de variables.

3. Persistentes y no persistentes Atributos

La función principal de DaoGen es el manejo de bases de datos y de los métodos y atributos.

Sin embargo DaoGen se atribuye un apoyo especial en valueObjects que no se asignan a
cualquier columna de la tabla de base de datos correspondiente. Los valores de estos
atributos se aprecia únicamente en la memoria del tiempo de ejecución, y DaoGen no
implementa los métodos de almacenamiento de estos atributos. En la mayoría de los casos,
estos atributos no son necesarios, pero para mayor comodidad, DaoGen tiene un soporte
para la generación de la fuente para ellos también, si desea hacerlo.

Para crear atributos que no son persistentes, que el número de los atributos necesarios en
las opciones de generación de base "variables no permanentes" sobre el terreno, y sus
1 de 2 nombres al igual que el nombre de la columna-variables en la tabla de base de datos. El 07/08/2010 05:12 PM EkP
 atributos se aprecia únicamente en la memoria del tiempo de ejecución, y DaoGen no
TitanicLinux.Net:: Manual de DaoGen http://translate.googleusercontent.com/translate_c?hl=es&ie=UTF-8&sl=...
implementa los métodos de almacenamiento de estos atributos. En la mayoría de los casos,
estos atributos no son necesarios, pero para mayor comodidad, DaoGen tiene un soporte
para la generación de la fuente para ellos también, si desea hacerlo.

Para crear atributos que no son persistentes, que el número de los atributos necesarios en
las opciones de generación de base "variables no permanentes" sobre el terreno, y sus
nombres al igual que el nombre de la columna-variables en la tabla de base de datos. El
resultado no se verá en el SQL generado, pero se puede encontrar el código de aplicación
en valueObject.

4. La extensión de la funcionalidad

La idea de DaoGen no es producir código para todos los posibles casos de uso en la
programación de DAO. Si usted tiene un proyecto grande y muchos de los cuadros, usted se
encontrará en una situación en la API básica DaoGen no proporciona métodos suficientes
para sus necesidades específicas. Sin embargo, esto no es un problema.

Desde DaoGen produce el código fuente, puede modificar fácilmente para hacer lo que
quieras. Sin embargo, hay por lo menos dos maneras de hacerlo, y una manera es mejor
que el otro. Ampliar la API siempre en lugar de cambiarla, si quieres hacerlo bien. Es decir,
si se necesita un método que devuelve 100 filas por primera vez en un poco de orden, no
modifique el "loadAll" para devolver las filas necesarias. En su lugar, sólo tienes que copiar
el código del método loadAll en un nuevo archivo, que se extiende la clase generada Dao.
La nueva clase puede tener otro nombre como "MyTableDaoExt" y el nuevo método puede
ser llamado "loadHundredFirst", por ejemplo. De esta manera, puede volver a generar su
Dao clases más tarde y todavía tiene la funcionalidad de su ampliación. La mayoría de los
programadores de Java saber que esto se puede hacer, pero esto funciona bien con el
lenguaje PHP también.

El propósito de este tipo de ampliar es que en la mayoría de los casos, muchas partes de un
programa se necesita hacer operaciones en las tablas. Si cambia el resultado de la API de
modo que incluso la funcionalidad básica no se comporta siempre a través de todas las
tablas, su programa será un desastre. Además, piense en una situación en la que otra
persona es la renovación del programa que ha creado (y que se sirve de acceso a datos en
DaoGen). Si por casualidad el loadAll método para devolver sólo 100 filas de una tabla, esta
persona, que necesita para cargar todas las filas * *, se encontrará la depuración de su
propio código para siempre sin entender a buscar dentro de los objetos DaoGen que
modificó.

5. Uso de XML generados meta-datos

La última mejora a DaoGen es el soporte para la importación de los DaoGen propia

meta-datos de vuelta al generador. Todas las versiones del generador a partir de 2.2.0
generará un adicional XML de metadatos de archivo para usted. Este archivo XML que
contiene toda la información que se necesita para re-producir el código generado en
cualquier momento. Esto es útil, por ejemplo, si desea volver a generar las clases DAO con
la versión más reciente DaoGen, o si quieres hacer una pequeña modificación a las opciones
del generador sin tener que volver a escribir toda la información de vuelta a DaoGen. Se
recomienda guardar los archivos generados XML para un uso posterior.

2 de 2 07/08/2010 05:12 PM EkP