Liferay Objects y Batch: modela datos de negocio sin escribir Java

Liferay Objects y Batch: modela datos de negocio sin escribir Java
Liferay y portales
Alejandro Muñoz del Prado

Alejandro Muñoz del Prado

Equipo técnico

19 de noviembre de 2026
5 min lectura
Compartir:

Cuando alguien necesita gestionar entidades de negocio (clientes, contratos, pedidos, incidencias) dentro de un portal Liferay, la primera reacción suele ser pensar en un módulo Java con su entidad, su servicio y su capa de persistencia. Esa vía sigue existiendo, pero para la mayoría de casos ya no hace falta. Los Objects de Liferay DXP permiten definir el modelo de datos desde la propia interfaz de administración, con campos, relaciones, listas de valores y validaciones, y el sistema genera por debajo la tabla, el API REST y los formularios básicos.

Cambia el enfoque: la entidad se configura en lugar de programarse. El trabajo técnico sigue ahí, pero se desplaza. En lugar de escribir una clase de dominio, hay que pensar bien el modelo de datos y, sobre todo, cómo se van a cargar y consumir esos datos desde fuera. Para eso tenemos la API REST autogenerada y las client extensions de tipo batch.

Diseñar el modelo con campos, relaciones y validaciones

Un Object se define desde Control Panel > Objects. Lo primero es decidir los campos: texto, número, fecha, booleano, o un tipo especial llamado picklist, que es una lista de valores cerrada (por ejemplo, el estado de una incidencia: abierta, en curso, cerrada). Los picklists se gestionan aparte, como catálogos reutilizables entre varios Objects, lo cual evita el clásico problema de tener el mismo listado de valores duplicado y desincronizado en distintas pantallas.

Las relaciones se configuran igual de declarativamente: uno a muchos, muchos a muchos, con la opción de que la relación sea obligatoria o no. Imagina un Object Contrato relacionado con un Object Cliente en uno a muchos: un cliente puede tener varios contratos, y cada contrato pertenece exactamente a uno. Liferay genera automáticamente el campo de relación y, si se pide, un widget de selección en el formulario.

Las validaciones a nivel de campo (longitud máxima, formato, rango numérico) se definen en la propia configuración del Object, sin reglas externas. Para validaciones más complejas que dependan de varios campos a la vez, Liferay ofrece acciones de Object: reglas que se disparan en eventos concretos (al crear, al actualizar, al borrar) y que pueden ejecutar lógica condicional, enviar notificaciones o actualizar otros campos. Es la pieza que más se parece a "programar", pero sigue siendo configuración dentro de la plataforma, no un módulo Java aparte.

Consumir el Object por su API REST autogenerada

Cada Object que se marca como expuesto genera automáticamente un endpoint REST bajo /o/c/ seguido del nombre plural del Object. Sin escribir ni una línea de código, ya se puede hacer un GET, POST, PUT o DELETE contra esa entidad, con paginación, filtros y ordenación incluidos de serie.

Bash
curl -X GET "https://sede.example.com/o/c/contratos?filter=estado eq 'ABIERTO'" \
  -H "Authorization: Basic BASE64(usuario:password)"

Este punto es el que más cambia el trabajo diario: cualquier integración externa (un CRM, una app móvil, un script de migración) consume directamente ese API sin pasar por capas intermedias que había que mantener a mano. La contrapartida es que hay que cuidar los permisos a nivel de Object y de campo, porque lo que se expone por configuración se expone de verdad, y un filtro mal puesto en el control de acceso puede dejar visible más de lo que debería.

Portales y aplicaciones que aguantan años. Y alguien que los mantiene.

Construimos y mantenemos portales, intranets y aplicaciones. Y rescatamos los que ya existen: los actualizamos, los ordenamos y los dejamos mantenibles.

Ver portales y desarrollo

Cargar datos iniciales con una client extension batch

Definir el modelo y exponerlo está bien, pero en cualquier proyecto real hace falta poblarlo con datos de arranque: catálogos de picklists, clientes de prueba, configuraciones por defecto. Hacerlo a mano desde la interfaz no escala, y automatizarlo con un script externo que llama al REST uno por uno tampoco es lo ideal cuando hablamos de volúmenes grandes o de entornos que hay que repetir (desarrollo, preproducción, producción).

Para eso usamos una client extension de tipo batch: un artefacto independiente del core de Liferay que se ejecuta como un job y que puede leer ficheros (CSV, JSON) y volcarlos contra los Objects usando el propio API REST o la capa de persistencia interna, según el caso. En nuestro repositorio interno sede/client-extensions/sede-objetos-batch tenemos resuelto justo este patrón: un job batch que lee un conjunto de ficheros de datos y da de alta los Objects de negocio de la sede en el orden correcto, respetando las dependencias entre Object y Object (primero Cliente, después Contrato, por ejemplo).

El fichero de definición de la client extension es sencillo, algo así:

YAML
sede-objetos-batch:
  name: Sede Objetos Batch
  type: batch
  batch:
    jarPath: sede-objetos-batch.jar
    schedule:
      cron: "0 0 2 * * ?"

El orden importa, igual que en otros escenarios de carga de datos: si el job intenta crear un Contrato antes de que exista el Cliente al que referencia, la ejecución falla con un error de integridad referencial que, si no se mira bien el log, parece un fallo del Object cuando en realidad es un problema de secuencia en el script de carga.

Este mismo patrón (Objects más client extension batch) es el que desarrollamos paso a paso en el material S11 y S12 del curso de administración de Liferay DXP que impartimos, disponible en curso-liferay-chms/material. Ahí el ejercicio consiste en modelar un caso completo (desde el primer campo hasta el job de carga) para que quien lo sigue vea cómo se crea un Object y también cómo encaja en un flujo de despliegue real, con datos repetibles entre entornos.

Qué cambia cuando el equipo trabaja así

Con Objects el criterio técnico sigue haciendo falta, pero se aplica en otro sitio: en vez de discutir cómo se mapea una entidad en Java, la discusión importante es cómo se estructura el modelo de datos, qué validaciones van en el propio Object y cuáles conviene dejar a una acción, y cómo se automatiza la carga inicial para que no dependa de que alguien recuerde hacerlo a mano en cada entorno.

En proyectos donde ya trabajamos con agentes de IA para tareas internas, este tipo de configuración declarativa encaja bien: un Object bien definido, con su API REST expuesta, es una superficie mucho más fácil de consultar o actualizar por un agente que una base de datos con tablas y relaciones implícitas solo documentadas en el código. No es el punto de partida del proyecto, pero sí una pieza que facilita integrarlo más adelante.

Si el proyecto va a crecer en número de Objects y de relaciones, conviene invertir tiempo al principio en nombrar bien los campos y documentar las claves de los picklists compartidos. Ese pequeño orden inicial es lo que evita, meses después, tener tres Objects distintos representando el mismo concepto con nombres diferentes.

Etiquetas:liferay dxpapi restclient extensionsliferay objectsmodelado de datosbatch

Portales y aplicaciones que aguantan años. Y alguien que los mantiene.

Construimos y mantenemos portales, intranets y aplicaciones. Y rescatamos los que ya existen: los actualizamos, los ordenamos y los dejamos mantenibles.

Ver portales y desarrollo