Assistentes SQLJ - Página Declaração do Iterador SQLJ

Utilize esta página para especificar informações para a cláusula de declaração do iterador SQLJ ou a cláusula de designação de SQLJ que está sendo criada.

Um iterador é utilizado para recuperar valores da tabela de resultados de uma consulta. Um iterador é um objeto de uma classe de iterador. Um arquivo SQLJ gera uma classe de iterador para cada cláusula de declaração do iterador especificada. Uma cláusula de declaração do iterador declara uma classe de iterador posicionada ou uma classe de iterador denominada em um arquivo SQLJ.

Esta página aparece no assistente Inserir Declaração do Iterador SQLJ e no assistente Inserir Cláusula SQL.

Nome
O identificador Java válido a ser utilizado para a classe de iterador gerada.
Modificadores
Os modificadores de acesso para a classe gerada. Você pode escolher um dos seguintes modificadores: público, protegido, privado ou padrão.
estático
Declara a classe estática gerada.
Implementa
sqlj.runtime.ForUpdate
Implementa a interface sqlj.runtime.ForUpdate para operações UPDATE ou DELETE posicionadas. Para operações UPDATE e DELETE posicionadas, o iterador deve ser declarado em um arquivo de origem e utilizado em um arquivo de origem diferente.

Se esta caixa de opções estiver selecionada, a opção Atualizar Colunas estará disponível.

sqlj.runtime.Scrollable
Implementa a interface sqlj.runtime.Scrollable quando você desejar declarar um iterador rolável. Um iterador rolável é um iterador no qual você pode avançar, retroceder em uma linha específica na tabela de resultados da consulta.

Se esta caixa de opções estiver selecionada, a opção Sensibilidade estará disponível.

Interface com o Usuário
Uma lista das classes de interface adicionais para implementação. As entradas na lista são separadas por vírgulas.
With
Especifica os atributos de uma cláusula SQLJ WITH.
Capacidade de Manutenção
Especifica se um iterador mantém sua posição em uma tabela após a emissão de um comando COMMIT. Você pode escolher:
true
O iterador mantém sua posição.
false
O iterador não mantém sua posição.
padrão
O atributo de capacidade de manutenção mantém seu valor padrão, que é false.
Sensibilidade
Especifica se as alterações feitas na tabela subjacente de um iterador podem ficar visíveis para o iterador depois de sua abertura. Você pode escolher:
SENSITIVE
As alterações feitas na tabela subjacente ficam visíveis. Quando esta opção estiver selecionada, a opção Dinâmico estará disponível.
INSENSITIVE
As alterações feitas na tabela subjacente não ficam visíveis.
padrão
O atributo de sensibilidade mantém seu valor padrão, que é INSENSITIVE.
Este atributo da cláusula SQLJ WITH estará disponível apenas quando a caixa de opções sqlj.runtime.Scrollable estiver selecionada.
Dinâmico
Para um iterador definido com a opção Sensibilidade configurada como SENSITIVE, especifica o estado dos seguintes casos:
  • Quando o aplicativo executa instruções UPDATE e DELETE posicionadas com o iterador, estas alterações ficam visíveis para o iterador.
  • Quando o aplicativo executa instruções INSERT, UPDATE e DELETE no aplicativo mas fora do iterador, estas alterações ficam visível para o iterador.
Você pode escolher:
true
Os dois casos são true.
false
Os dois casos são false.
padrão
O atributo dinâmico mantém seu valor padrão, que é false.
Se a opção Dinâmico estiver configurada como true, a origem de dados deverá suportar cursores roláveis dinâmicos.

A opção Dinâmico estará disponível apenas quando a caixa de opções sqlj.runtime.Scrollable estiver selecionada.

Atualizar Colunas
Os nomes das colunas que serão modificadas quando o iterador for utilizado para uma instrução UPDATE posicionada. Os nomes na lista são separados por vírgulas. Se o botão Selecionar Colunas for mostrado, será possível selecionar as colunas em vez de digitá-las.

Este atributo da cláusula SQLJ WITH estará disponível apenas quando a caixa de opções sqlj.runtime.ForUpdate estiver selecionada.

Declarações de Colunas
Define as declarações de colunas para as colunas na tabela de resultados da declaração do iterador SQLJ.
No assistente Inserir Declaração do Iterador SQLJ, você pode especificar qualquer um dos seguintes conjuntos de informações:
  • Os tipos de dados para as colunas na tabela de resultados, que declara um iterador posicionado. Os tipos de dados na lista são separados por vírgulas. A ordem dos tipos de dados na declaração do iterador posicionado deve ser igual à ordem das colunas na tabela de resultados.
  • Os pares tipo-nome de dados para as colunas na tabela de resultados, que declara um iterador denominado. Os pares tipo-nome de dados na lista são separados por vírgulas. O nome de uma coluna no iterador deve corresponder, exceto no tipo de letra, ao nome de uma coluna na tabela de resultados.
No assistente Inserir Cláusula SQL, você pode escolher qualquer uma das seguintes opções:
Posicionado
Os tipos de dados para as colunas na tabela de resultados. Selecionar esta opção cria uma declaração de coluna de iterador posicionado.
Denominado
Os nomes e tipos de dados para as colunas na tabela de resultados. Selecionar esta opção cria uma declaração de coluna de iterador denominado.
Tarefas relacionadas
Incluindo uma Cláusula de Designação SQLJ em um Arquivo SQLJ
Incluindo uma Cláusula de Declaração do Iterador SQLJ em um Arquivo SQLJ
Desempenhando Operações UPDATE e DELETE em um Aplicativo SQLJ
Utilizando Iteradores Roláveis em um Aplicativo SQLJ
Utilizando um Iterador Denominado em um Aplicativo SQLJ
Referências relacionadas
Cláusula de Declaração do Iterador SQLJ

Feedback