Actions
Manual Index
Print View
PDF version
Projects
Kumbia Enterprise
Kumbia Enterprise Framework for IBM WebSphere
Louder Clustering
Louder Cache
Louder Application Forms
Need help?
Community Forums

Note

The online documentation is produced by a web publishing technology created by us to read the documents origins in OpenOffice Writer (ODT) and Microsoft Word (docx) formats and produces native web and PDF versions. In this way we maintain Louder project documentation update and in sync on each of its formats.
Select a Language:
Recursos > Documentación en línea > 23. Componente TransactionManager
Anterior - 22. Componente EntityManager
Siguiente - 24. Presentación
Componente TransactionManager
Tabla de Contenido:
Introducción
El objetivo de este componente es administrar las transacciones globales requeridas por los procesos de negocio de una aplicación. Su API es utilizada para acceder a un gestor relacional en una unidad de trabajo en particular. Toda la arquitectura de este componente proporciona a las aplicaciones desarrolladas en Kumbia Enterprise un contenedor para administración de transacciones en PHP como los usados en Java EE.

Es responsable de abrir y cerrar transaciones manteniendo unidades de trabajo en forma controlada. Las transacciones pueden ser creadas programacionalmente ó declarativamente.
Contexto de Scope Persistente
El TransactionManager es el puente para que objetos del ORM puedan interactuar con su contexto persistente adecuado. Cada objeto que es ligado a una transacción administrada por el contenedor es notificado de otras transacciones activas en el mismo contexto. Los objetos mantienen su estado y este es replicado cuando se abre ó cierra la transacción informando el estado de la misma.
Event Listeners
El componente TransactionManager hace uso del CommonEventInfraestructure de Kumbia Enterprise para notificar eventos a los objetos dependientes de una transacción y también entre ellos mismos.

Los eventos soportados son:
Tabla: Event Listeners de TransactionManager
Evento
Descripción
deleteOcurre cuando un objeto es destruido cuando se replica el estado del mismo en la persistencia.
createOcurre cuando un objeto es creado.
updateOcurre cuando un objeto es actualizado.
preInsertOcurre antes de realizar una inserción de un registro.
preDeleteOcurre antes de realizar una eliminación de un registro.
preLoadOcurre al crear un objeto instanciado como resultado de una consulta.
postInsertOcurre después de realizar una inserción.
postDeleteOcurre después de realizar una eliminación.
postUpdateOcurre después de realizar una actualización.
Estados de las entidades
Las entidades pueden tener los siguientes estados cuando intervienen en procesos transaccionales:

  • Estado New: Cuando una entidad es creada mediante el operador new por defecto se encuentra ligada a una conexión no transaccional y no representa ningun registro de la base de datos.
  • Estado Managed: Cuando una entidad está asociada a una transacción creada por el TransactionManager se dice que se encuentra en estado administrado.
  • Estado Detached: Cuando la entidad perteneció a una transacción administrada pero la transacción ya fue cerrada ó su contexto fue cambiado a la conexión no transaccional.
  • Estado Removed: Cuando la entidad fue eliminada de la persistencia y por lo tanto no puede estar asociada a un contexto transaccional.
Asignar el objeto al estado administrado
Los métodos de ActiveRecord llamados setTransaction() y detachTransaction() permiten cambiar programacionalmente el estado transaccional de un objeto.
Ejemplo: Cambiar un objeto ActiveRecord a un estado administrado
<?php

$transaction = TransactionManager::getUserTransaction();
$customer = new Customer();
$customer->setTransaction($transaction);
$customer->setName("John");
$customer->setSurname("Smith");
$customer->save();
$transaction->commit();
$customer->detachTransaction();

Cuando la transacción es cerrada ya sea por un rollback ó commit los objetos no son automáticamente cambiados al estado detached. Las transacciones cerradas ya no son usables pero la unidad de trabajo mantiene su dependencia a la transacción. El desligamiento de los objetos de la transacción puede realizarse manualmente ó llamar el método detachDependencies() de ActiveRecordTransaction.
API de TransactionManager
static function ActiveRecordTransaction getUserTransaction(TransactionDefinition $definition='')
Crea ó obtiene una transacción ActiveRecordTransaction. Si se define una definición de transacción se crea una nueva.

static function void initializeManager()
Inicializa el administrador de transacciones. El desarrollador no debe invocar este método ya que es automáticamente llamado por el contenedor de aplicaciones al iniciar la petición.

static function void rollbackPendent()
Realiza un rollback sobre todas las transacciones administradas por el TransactionManager. Cuando ocurre una excepción no capturada el framework llama este método para cancelar cualquier operación pendiente y así cuidar la integridad de los datos.

static function void commit()
Realiza un commit sobre todas las transacciones administradas por el TransactionManager.

static function void rollback()
Realiza un rollback sobre todas las transacciones administradas por el TransactionManager.

static function void notifyRollback(ActiveRecordTransaction $transaction)
Permite notificar a otras transacciones administradas por el TransactionManager que una transacción realizo un rollback buscando que las demás también lo hagan.

static function void notifyCommit(ActiveRecordTransaction $transaction)
Permite notificar a otras transacciones administradas por el TransactionManager que una transacción realizo un commit buscando que las demás también lo hagan.