Curso de Apache Freemaker para equipos de desarrollo — Eficiencia

Crear proyecto Java o Spring Boot con FreeMarker

Añadir dependencia Maven/Gradle

Estructura del directorio de plantillas

Configuración del motor en Java

Configuración personalizada (charset, locales, fallback)

Cargar plantillas desde ruta externa o classpath

Validación de carga y renderizado

Tratamiento de errores comunes

Integración de logging (SLF4J, Logback)

Práctica: app básica con plantilla HTML renderizada desde Java

Interpolación: `${variable}`

Comentarios: `<#-- -->`

Literales: strings, números, booleanos

Encadenamiento de propiedades (`user.name`)

Funciones nativas: `?upper_case`, `?date`, `?string`

Tipos de datos: scalars, lists, hashes

Casting y funciones de verificación

Uso de variables temporales con `<#assign>`

Escapado automático de HTML

Práctica: plantilla con variables dinámicas y formato

Estructura `if/else` en FreeMarker

Operadores de comparación y lógicos

Estructura `switch/case`

Bucles con `<#list>` y `<#items>`

Control de índice, primero/último (`?index`, `?has_next`)

Iteraciones sobre maps (`key`, `value`)

Sentencias `break` y `continue`

Encadenamiento de condiciones (`?contains`, `?starts_with`)

Casos comunes de control condicional

Práctica: renderizado condicional de tabla de productos

Estructura de listas y mapas

Acceso a propiedades anidadas

Indexado dinámico

Uso de filtros sobre listas (`?filter`, `?sort`)

Agrupamiento y conteo

Manejo de listas vacías o nulas

Ordenación personalizada

Uso de `?size`, `?join`, `?chunk`

Aplicación de estilos en bucles (zebra, condicional)

Práctica: plantilla con tabla dinámica de usuarios

Includes con `<#include>` y `<#import>`

Variables globales entre plantillas

Creación de macros personalizados

Parámetros en macros (`<@macro param1, param2 />`)

Uso de `call`, `caller` y bloques anidados

Encapsulación de estructuras repetidas

Prácticas recomendadas para reuso de UI

Includes condicionales y contextuales

Organización modular de plantillas grandes

Práctica: creación de header, footer y macro de tarjeta de producto

Uso de locales (`Configuration.setLocale`)

Formato de fechas (`?date`, `?string["dd/MM/yyyy"]`)

Formato de números y monedas

Traducción de cadenas con ResourceBundle

Carga dinámica según idioma del usuario

Separación de textos mediante keys

Escapado correcto en idiomas con acentos

Templates por idioma o configuración por usuario

Detección automática de idioma

Práctica: plantilla bilingüe de factura con fecha y moneda

Uso de FreeMarker en plantillas de email (HTML y texto plano)

Integración con JavaMail y Spring Mail

Plantillas para PDF con iText o Flying Saucer

Renderizado de XML dinámico con FreeMarker

Generación de reports y documentos formales

Control de estilos e imágenes embebidas

Inyección de datos desde formularios o BBDD

Separación de layouts por tipo de documento

Validación de contenido antes del envío

Práctica: plantilla de notificación de alta de usuario con branding

Configuración de Spring Boot Starter FreeMarker

Directorio de plantillas por defecto (`/resources/templates`)

Controller MVC + plantilla dinámica

Inyección de datos en el `ModelMap`

Control de errores 404/500 personalizados con plantillas

Creación de layouts con `#include`

Seguridad en plantillas con Spring Security

Integración con formularios (`th:action`, `csrf`)

Configuración desde `application.properties`

Práctica: app web básica con FreeMarker y endpoints dinámicos

Escapado de HTML para evitar XSS

Filtro de inputs en bucles

Evitar ejecución de código arbitrario

Control de carga de plantillas externas

Limitación de acceso a rutas sensibles

Protección contra sobreescritura de macros

Validación de expresiones y tipos

Uso de `Configuration.setNewBuiltinClassResolver(null)`

Registros y trazabilidad de uso

Práctica: auditoría y protección en plantilla de login

Identificación de errores de template

Uso de `TemplateExceptionHandler`

Logs de ejecución (`logger.debug`)

Trazado de valores mal referenciados

Validación de templates en fase de despliegue

Renderizado parcial para debugging

Pruebas unitarias con JUnit y mocks

Plantillas de error customizadas

Herramientas visuales para prueba de templates

Práctica: simulación de fallo controlado en plantilla de email

Estructura recomendada de carpetas

Convenciones de nombres de archivos y macros

Separación entre datos y presentación

Uso de includes reutilizables

Variables descriptivas y contexto limitado

Modularización de bloques

Documentación de cada plantilla

Versionado y pruebas antes de despliegue

Checklist de revisión

Práctica: refactor de plantilla compleja según buenas prácticas

Qué son las `TemplateMethodModel`

Creación de funciones reutilizables

Registro de funciones desde Java

Paso de argumentos y control de tipos

Funciones como filtros (`input?myMethod`)

Ejemplos: formateo, cálculos, lógica de negocio

Validación de errores y excepciones

Documentación y reutilización

Integración con clases externas o librerías

Práctica: función Java personalizada para conversión de divisas

Carga en caliente vs preprocesado

Uso de templates cacheados

Minimizar acceso a estructuras anidadas

Evitar bucles pesados o anidados

Reutilización de macros y lógica común

Control de tamaño de listas

Lazy loading de estructuras complejas

Revisión de logs y tiempos de render

Monitorización de errores frecuentes

Práctica: profiling de plantilla con listas grandes y optimización

Diseño modular del sistema de plantillas

Plantilla maestra, includes y macros

Carga de datos desde JSON y POJOs

Plantillas para emails, reportes y vistas HTML

Internacionalización y formatos según usuario

Seguridad y validación de inputs

Integración con Spring Boot o Java puro

Exportación a PDF desde plantilla

Entrega de documentación y checklist

Validación de casos reales: notificación, factura y reporte