#1879: DatabaseDialect.kt [ES]

Uso de características de Kotlin

Clase enum con propiedad: Cada constante enum lleva una propiedad asString: String a través del constructor primario
Objeto complementario: Proporciona métodos estáticos de fábrica y utilidad accesibles desde Java mediante @JvmStatic
Interoperabilidad con JVM: La anotación @JvmStatic en fromString() permite llamarlo como DatabaseDialect.fromString(...) desde código Java, en lugar de DatabaseDialect.Companion.fromString(...)

Constantes del Enum

Constante	Clase de Dialecto Hibernate	Proveedor Flyway	Contexto de Uso
`PostgreSQL`	`org.hibernate.dialect.PostgreSQLDialect`	`postgresql`	Despliegues en producción — la base de datos recomendada para producción
`HSQL`	`org.hibernate.dialect.HSQLDialect`	`hsqldb`	Desarrollo/pruebas, configuración embebida — utilizado por el asistente de configuración para instalaciones de un solo usuario/locales

Métodos del Objeto Complementario

fromString(asString: String): DatabaseDialect?

Busca un dialecto por su nombre de clase de Hibernate. Devuelve null si no se encuentra ninguna coincidencia — los llamadores deben manejar el caso nulo (generalmente predeterminando a HSQL para desarrollo). El método utiliza una cadena simple if-else en lugar de un mapa de búsqueda, apropiado para el pequeño número de dialectos compatibles.

getFlywayVendorName(databaseProductName: String): String

Asigna un nombre de producto del controlador JDBC al nombre del directorio del proveedor de Flyway. Esto es crítico para el descubrimiento de scripts de migración de base de datos de Flyway. Flyway organiza los scripts de migración en directorios específicos del proveedor:

flyway/{module}/migrate/postgresql/V1.1.0__RELEASE-RemoveMGC.sql
flyway/{module}/migrate/hsqldb/V1.1.0__RELEASE-RemoveMGC.sql

El método verifica si el nombre del producto contiene "hsql" (sin distinción de mayúsculas/minúsculas) y devuelve "hsqldb" o "postgresql" según corresponda. Esto permite que la misma lógica de migración funcione en todos los tipos de base de datos — las diferencias SQL específicas del proveedor (por ejemplo, sintaxis de tipos de columna, manejo de secuencias) se aíslan en los scripts de migración específicos del proveedor.

Contexto Histórico: Bases de Datos Comentadas

El archivo contiene un comentario que enumera el soporte de base de datos considerado o planificado anteriormente:

// Aún no compatible:
// MYSQL, ORACLE, MS_SQL_SERVER, DB2, INFORMIX, DERBY, UNKOWN;

Esto revela la intención de diseño de admitir múltiples bases de datos — un requisito común para el software empresarial. La implementación actual solo admite PostgreSQL (para producción) y HSQLDB (para embebido/desarrollo), con la arquitectura lista para extensión.

Arquitectura de Base de Datos en ProjectForge

El enum DatabaseDialect es parte de una abstracción de base de datos en capas:

Hibernate ORM: Mapeo objeto-relacional — la propiedad asString proporciona la clase de dialecto de Hibernate para hibernate.cfg.xml o la configuración automática de Spring Boot
Flyway: Gestión de migraciones de base de datos — el método getFlywayVendorName() dirige a los scripts de migración SQL específicos del proveedor
Asistente de Configuración: El asistente de configuración de ProjectForge (interfaces gráficas Swing y Lanterna) utiliza este enum para presentar opciones de base de datos a los administradores y configurar conexiones JDBC

Decisión de Diseño: ¿Por qué Kotlin?

Este archivo es uno de los primeros archivos Kotlin en el módulo projectforge-common (junto con otras clases de utilidad). Usar Kotlin para este enum proporciona:

Definición concisa del enum: Constructor primario con propiedad, en comparación con los constructores verbosos de enum en Java
Seguridad nula: El tipo de retorno DatabaseDialect? de fromString() obliga a los llamadores a manejar el caso nulo
Interpolación de cadenas: Manejo de cadenas más limpio en comparación con la concatenación de cadenas de Java

El método getFlywayVendorName() utiliza una simple coincidencia de subcadena (contains("hsql")) en lugar de una comparación exacta. Esto podría producir falsos positivos si un nombre de producto de base de datos contiene casualmente "hsql" como subcadena. Un enfoque más robusto sería comparar con una lista exacta de nombres de producto conocidos.

El patrón de ruta de migración de Flyway utiliza directorios separados para init/common (creación de esquema) y migrate/{vendor} (migraciones específicas de versión). Esta separación permite que el esquema base sea independiente de la base de datos, mientras que las migraciones específicas del proveedor manejan diferencias en la sintaxis SQL o características (como PostgreSQL vs HSQLDB para el manejo de secuencias o la migración "RemoveMGC" visible en los directorios flyway del proyecto).

#1879: `DatabaseDialect.kt`

Arquitectura