Contratos de Interface do Web UI Framework - Gerenciamento de Transação

É possível gerenciar transações por meio dos contratos da interface do Web UI Framework.

Para obter mais informações, consulte a documentação da API Java™ no diretório de instalação (<INSTALL_DIR> /xapidocs/core_javadocs).


Contrato da Interface Descrição Métodos
ISCUITransactionContext ISCUITransactionContext define o comportamento esperado em qualquer implementação do contexto de transação em um aplicativo.
  • iniciar

    Chamado no início da transação atual. Pode ser usado para preparar conexões com origens de dados.

  • confirmar

    Confirma todas as mudanças da transação atual. Chamado após uma execução bem-sucedida de todas as tarefas da transação atual.

  • retrocesso

    Chamado se qualquer das tarefas para a transação atual falhar. É possível recuperar todas as mudanças feitas durante essa transação.

  • terminar

    Chamado quando a transação atual termina. É possível usar esse método para fechar todas as conexões estabelecidas com as origens de dados para essa transação.

  • addTransactionObject

    Inclui diversas conexões em um contexto de transação.

  • removeTransactionObject

    Remove conexões de um contexto de transação.

  • getTransactionObject

    Busca um objeto de transação já incluído a partir do contexto de transação.

ISCUITransactionContextFactory Define o comportamento esperado em qualquer implementação de um Factory de Contexto de Transação em um aplicativo.
  • createTransactionContext

    Cria um Contexto de Transação para uma transação. É possível criar um novo Contexto de Transação para buscá-lo a partir de um conjunto de Contextos de Transação e retorná-lo

  • releaseTransactionContext

    Chamado quando uma transação é concluída. Este método pode destruir um Contexto de Transação ou retorná-lo para o conjunto.

  • inicialização

    Instancia uma classe quando a primeira chamada de um Contexto de Transação é feita. Esse método é chamado uma vez para um Factory de Transação durante a instanciação.

  • sessionDestroyed

    Chamado quando uma sessão é destruída. Você pode escolher executar uma ação com base na sessão destruída.

    A classe ISCUITransactionContextFactory estende a classe ISCUISessionAware, que é uma classe marcadora que ajuda a classe ISCUITransactionContextFactory a registrar a si mesmo na classe de implementação HttpSessionListener.

O gerenciamento de transação também inclui a seguinte classe auxiliar que um aplicativo precisa para as tarefas relacionadas ao gerenciamento de transação.


Nome de Classe Descrição Métodos

SCUITransactionContextHelper

Age como um controlador para o gerenciamento de transação.
  • setTransactionContextFactory

    Registra o factory de contexto de transação de um aplicativo. É possível usar este método para inicializar e registrar um factory durante o início de um aplicativo da web.

    Para qualquer solicitação de contexto de transação, a classe SCUITransactionContextHelper primeiro verifica se um factory está configurado. Se não estiver, a classe tenta instaciar um factory usando um parâmetro de contexto. Se um parâmetro não for localizado, um erro será emitido. Depois de instanciado, a mesma instância será usada para obter referências adicionais, a menos que outro contexto esteja configurado usando o método setTransactionContextFactory.

  • getTransactionContextFactory

    Retorna o Factory de Contexto de Transação Atual para um aplicativo. Retornará nulo se nenhum Factory estiver configurado ou carregado.