Contratos de interfaz de la infraestructura de interfaz de usuario web: gestión de transacciones

Puede gestionar transacciones a través de contratos de interfaz de la infraestructura de interfaz de usuario web.

Para obtener más información, consulte la documentación de la API de Java™ en el directorio de instalación (<DIR_INSTALACIÓN> /xapidocs/core_javadocs).


Contrato de interfaz Descripción Métodos
ISCUITransactionContext ISCUITransactionContext define el comportamiento esperado en cualquier implementación del contexto de transacciones de una aplicación.
  • empezará

    Se llama al principio de la transacción actual. Se puede utilizar para preparar las conexiones con orígenes de datos.

  • confirmar

    Confirma todos los cambios de la transacción actual. Se llama después de la ejecución satisfactoria de todas las tareas de la transacción actual.

  • retrotracción

    Se llama si falla alguna de las tareas de la transacción actual. Puede retrotraer todos los cambios realizados durante esa transacción.

  • final

    Se llama cuando la transacción actual finaliza. Puede utilizar este método para cerrar todas las conexiones con los orígenes de datos de dicha transacción.

  • addTransactionObject

    Añade varias conexiones a un contexto de transacciones.

  • removeTransactionObject

    Elimina las conexiones con un contexto de transacciones.

  • getTransactionObject

    Recupera un objeto de transacción ya añadido del contexto de transacciones.

ISCUITransactionContextFactory Define el comportamiento esperado en cualquier implementación de una fábrica de contexto de transacciones de una aplicación.
  • createTransactionContext

    Crea un contexto de transacciones para una transacción. Puede crear un contexto de transacciones nuevo o recuperarlo desde una agrupación de contexto de transacciones y devolverlo.

  • releaseTransactionContext

    Se llama cuando una transacción finaliza. Este método puede destruir un contexto de transacciones o devolverlo a la agrupación.

  • inicializar

    Crea una instancia de una clase cuando se realiza la primera llamada de un contexto de transacciones. Este método se llama una vez para una fábrica de transacciones durante la creación de la instancia.

  • sessionDestroyed

    Se llama cuando se destruye una sesión. Puede elegir realizar una acción en función de la sesión destruida.

    La clase ISCUITransactionContextFactory extiende la clase ISCUISessionAware, que es una clase de marcador que ayuda a la clase ISCUITransactionContextFactory a registrarse en la clase de implementación HttpSessionListener.

La gestión de transacciones también incluye la siguiente clase de ayudante que una aplicación necesita para las tareas relacionadas con la gestión de las transacciones.


Nombre de clase Descripción Métodos

SCUITransactionContextHelper

Actúa como un controlador de la gestión de transacciones.
  • setTransactionContextFactory

    Registra la fábrica de contexto de transacciones de una aplicación. Puede utilizar este método para inicializar y registrar una fábrica durante el inicio de una aplicación web.

    Para una solicitud de contexto de transacciones, la clase SCUITransactionContextHelper primero comprueba si se ha establecido una fábrica. Si no es así, la clase intenta crear una instancia de una fábrica mediante un parámetro de contexto. Si no se encuentra un parámetro, se emite un error. Una vez creada una instancia, se utiliza esta misma instancia para otras referencias a menos que se establezca otro contexto mediante el método setTransactionContextFactory.

  • getTransactionContextFactory

    Devuelve la fábrica de contexto de transacción actual para una aplicación. Devuelve null si no se ha establecido ni cargado ninguna fábrica.