El mecanismo de herencia de resultMap en MyBatis facilita la reutilización de configuraciones de mapeo XML, reduciendo la redundancia y mejorando la mantenibilidad. Al definir un resultMap base con campos comunes, otros resultMap pueden extenderlo mediante el atributo extends, permitiendo agregar o sobrescribir definiciones específicas.
Para implementar esta herencia, se utiliza la sintaxis siguiente en los archivos de mapeo XML:
<resultMap id="mapaBase" type="Cliente">
<id property="identificador" column="cliente_id"/>
<result property="nombre_completo" column="nombre_cliente"/>
</resultMap>
<resultMap id="mapaExtendido" type="Empleado" extends="mapaBase">
<result property="departamento" column="dept_id"/>
</resultMap>
Este enfoque ofrece beneficios clave: minimiza configuraciones repetitivas, simplifica actualizaciones centralizadas y soporta extensión modular sin alterar estructuras existentes.
Internamente, MyBatis resuelve los resultMap en el orden de aparición en el archivo XML. El resultMap padre debe definirse antes de ser referenciado por hijos para evitar errores de carga. Durante el análisis, MyBatis construye un árbol jerárquico combinando las definiciones padre e hijo.
La tabla comparativa ilustra escenarios con y sin herencia:
| Caso de uso | Sin herencia | Con herencia |
|---|---|---|
| Mapeo de cliente y empleado | Definir repetidamente campos como id y nombre | Empleado hereda campos comunes de Cliente |
| Consultas con múltiples tablas | Cada resultMap configurado de forma independiente | Base abstracta para campos compartidos como fecha_creacion |
El siguiente diagrama visualiza la jerarquía típica de resultMap:
graph TD
A[mapaBase] --> B[mapaCliente]
A --> C[mapaEmpleado]
A --> D[mapaMiembro]
B --> E[(SELECT * FROM clientes)]
C --> F[(SELECT * FROM empleados JOIN clientes)]
En consultas complejas con múltiples tablas, un resultMap base para campos como estado y fecha_actualizacion puede ser extendido por entidades específicas, garantizando consistencia en el mapeo.
La interacción con la caché de MyBatis es crucial: cada resultMap genera una clave de caché única basada en su estructura. Por lo tanto, consultas que usan resultMap heredados no comparten entradas de caché con los padres si la estructura difiere, preservando el aislamiento de datos.
Las mejores prácticas incluyen diseñar resultMap base genéricos, aplicar convenciones de nomenclatura claras (por ejemplo, prefijos para propiedades protegidas) y combinar la herencia con typeHandler para manejar tipos personalizados, como enumeraciones genéricas que reducen código repetitivo.
Para configuraciones anidadas complejas, la herencia simplifica la deifnición al reutilizar componentes comunes, disminuyendo el tamaño del archivo XML y facilitando el mantenimiento a largo plazo.