Cláusula de declaración de iterador de SQLJ
Una cláusula de declaración de iterador declara una clase de iterador de posición o de iterador de nombre dentro de un programa de aplicación SQLJ.
Un iterador contiene la tabla de resultados de una consulta. SQLJ genera una clase de iterador para cada cláusula de declaración de iterador especificada por el usuario. Un iterador es un objeto de una clase de iterador.
Una cláusula de declaración de iterador tiene formatos diferentes para un iterador de posición y un iterador de nombre. Los dos tipos de iteradores son tipos Java distintos e incompatibles que se implementan con interfaces diferentes.
Sintaxis
Declaraciones de columna-iterador-posición:
Declaraciones de columna-iterador-nombre:
Descripción
- Java-modifiers
- Cualquier modificador que sea válido para declaraciones de clase Java, como static, public, private o protected.
- Java-class-name
- Cualquier identificador Java válido. Durante el proceso de preparación del programa, SQLJ genera una clase de iterador cuyo nombre es este identificador.
- implements-clause
- Consulte "Cláusula implements de SQLJ" para obtener una descripción de esta cláusula. Para una cláusula de declaración de iterador que declara un iterador para una operación UPDATE o DELETE de posición, la cláusula implements debe especificar la interfaz sqlj.runtime.ForUpdate. Para una cláusula de declaración de iterador que declara un iterador desplazable, la cláusula implements debe especificar la interfaz sqlj.runtime.Scrollable.
- with-clause
- Consulte "Cláusula with de SQLJ" para obtener una descripción de esta cláusula.
- positioned-iterator-column-declarations
- Especifica una lista de tipos de datos Java, que son los tipos de datos de las columnas en el iterador posicionado. Los tipos de datos contenidos en la lista deben estar separados por comas. El orden de los tipos de datos en la declaración de iterador de posición es el mismo que el orden de las columnas en la tabla de resultados. Para que sea efectiva la comprobación en línea durante la personalización del perfil serializado, los tipos de datos de las columnas del iterador deben ser compatibles con los tipos de datos de las columnas de la tabla de resultados. Consulte «Java, JDBC, y tipos de datos SQL» para obtener una lista de tipos de datos compatibles.
- named-iterator-column-declarations
- Especifica una lista de tipos de datos Java e identificadores Java, que son los tipos de datos y nombres de las columnas en el iterador nombrado. Los pares tipo de datos-nombre deben estar separados por comas. El nombre de una columna del iterador debe coincidir con el nombre de una columna de la tabla de resultados, excepto en lo que respecta al uso de letras mayúsculas y minúsculas. Para que sea efectiva la comprobación en línea durante la personalización del perfil serializado, los tipos de datos de las columnas del iterador deben ser compatibles con los tipos de datos de las columnas de la tabla de resultados. Consulte «Java, JDBC, y tipos de datos SQL» para obtener una lista de tipos de datos compatibles.
Notas de uso
- Una cláusula de declaración iteradora puede aparecer en cualquier lugar de un programa Java en el que pueda aparecer una declaración de clase Java.
- Cuando una declaración iteradora nombrada contiene más de un par de tipos de datos Java e identificadores Java, todos los identificadores Java de la lista deben ser únicos. Dos ID de Java no son únicos si solo difieren en el caso.