É 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.
|