Adición de un paso de fragmentos a un trabajo por lotes Java
Puede añadir un paso de fragmentos al archivo xml de un trabajo por lotes Java™. Puede leer, procesar y escribir elementos individuales en el paso de fragmentos y también reiniciar el paso de fragmentos.
Antes de empezar
- Instale la característica por lotes Java para WebSphere Application Server Developer Tools for Eclipse. Esta característica es opcional. Puede instalarla desde Ayuda > Instalar WebSphere Software.
- Cree un proyecto por lotes Java.
- Cree un trabajo por lotes Java en el proyecto por lotes Java.
Acerca de esta tarea
Procedimiento
- En el editor JSL (Job Specification Language), abra el archivo xml para su trabajo por lotes Java.
El editor JSL se abre automáticamente si pulsa Finalizar cuando cree un trabajo por lotes Java. En el editor JSL se visualiza un archivo xml con el mismo nombre que el trabajo por lotes.
Si está añadiendo un paso a un archivo xml de trabajo por lotes Java, lleve a cabo los pasos siguientes para abrir el archivo xml en el editor JSL:- En la vista Explorador empresarial, seleccione el proyecto por lotes Java que ha creado.
- Seleccione src > META-INF > batch-jobs.
- Efectúe una doble pulsación en el archivo xml de su trabajo por lotes Java.
El archivo se visualiza en el editor JSL.
- Seleccione el nodo de trabajo en la pestaña Visión general y pulse Añadir.
- Seleccione Paso y pulse Aceptar.
- Opcional: Cambie el ID en el campo ID* de la pestaña Detalles.
- Seleccione el nodo de paso en la pestaña Visión general y pulse Añadir.
- Seleccione Fragmento y pulse Aceptar.
En la pestaña Visión general del editor JSL, el nodo de fragmentos se visualiza como un hijo del paso. Un nodo lector y un nodo grabador se visualizan como hijos del nodo de fragmentos.
- Implemente el nodo lector.
- En la pestaña Vista general, pulse el nodo lector.
Aparecerá la pestaña Detalles para el nodo lector.
- Cree o incluya una clase de lector para implementar el nodo lector.
Puede crear una clase de lector para el proyecto, incluir una clase de lector de otro paso en el proyecto o incluir una clase de lector de un paso de fragmentos de otro proyecto. Realice una de las tareas siguientes:
- Cree una clase de lector para el paso de fragmentos.
- Pulse el enlace de referencia en la pestaña Detalles.
Se visualizará el asistente Crear clase de lector de elementos.
- En el campo Paquete Java, especifique el nombre del paquete.
- En el campo Nombre de clase, especifique el nombre de la clase.
- Opcional: en el campo Superclase, especifique el nombre de la superclase o seleccione Utilizar clase abstracta de Java Batch como superclase.
- Opcional: en el campo Interfaces, añada más interfaces para la clase que se va a implementar.
- Para Opciones de carga de artefactos por lotes, acepte el valor predeterminado de
Utilizar el nombre completo de la clase.
- Si selecciona la opción Utilizar el nombre completo de la clase, el entorno de ejecución trata la referencia de artefacto por lotes como un nombre de clase y carga la referencia a través del cargador de clases de contexto de hebras. La carga se realiza para resolver una referencia de artefacto por lotes cuando el cargador de archivado devuelve un valor nulo para esta referencia.
- Si selecciona la opción Utilizar CDI (Context and Dependency Injection), el entorno de ejecución utiliza el cargador específico de la implementación CDI para resolver la referencia de artefacto por lotes utilizando el nombre del bean que ha especificado.
- Si selecciona la opción Añadir la clase al archivo batch.xml, el entorno de ejecución utiliza el cargador de archivado para resolver la referencia buscando el identificador especificado en el archivo batch.xml.
- Pulse Finalizar.
- Pulse el enlace de referencia en la pestaña Detalles.
- Utilice una clase de lector existente para implementar el paso de fragmentos.
- Pulse Examinar en la pestaña Detalles.
- Busque clases por nombre seleccionando Buscar clases y, a continuación, escriba el nombre de la clase.
- Seleccione el nombre de la clase de Elementos coincidentes.
- Como alternativa a la búsqueda, si existe un archivo batch.xml, seleccione Examinar entradas en batch.xml y, a continuación, seleccione una de las entradas de la tabla.
- Pulse Aceptar.
- Cree una clase de lector para el paso de fragmentos.
- En la pestaña Vista general, pulse el nodo lector.
- Implemente el nodo grabador.
- En la pestaña Vista general, pulse el nodo grabador.
Aparecerá la pestaña Detalles para el nodo grabador.
- Cree o incluya una clase de grabador para implementar el nodo grabador. Puede crear una clase de grabador para el proyecto, incluir una clase de grabador de otro paso en el proyecto o incluir una clase de grabador de un paso de fragmentos de otro proyecto. Realice una de las tareas siguientes:
- Cree una clase de grabador para el paso de fragmentos.
- Pulse el enlace de referencia en la pestaña Detalles.
Se visualizará el asistente Crear clase de grabador de elementos.
Las descripciones siguientes sobre el asistente Crear clase de grabador de elementos son las mismas que las descripciones para el asistente Crear clase de lector de elementos. La información se repite aquí en contexto.
- En el campo Paquete Java, especifique el nombre del paquete.
- En el campo Nombre de clase, especifique el nombre de la clase.
- Opcional: en el campo Superclase, especifique el nombre de la superclase o seleccione Utilizar clase abstracta de Java Batch como superclase.
- Opcional: en el campo Interfaces, añada más interfaces para la clase que se va a implementar.
- Para Opciones de carga de artefactos por lotes, acepte el valor predeterminado de
Utilizar el nombre completo de la clase.
- Si selecciona la opción Utilizar el nombre completo de la clase, el entorno de ejecución trata la referencia de artefacto por lotes como un nombre de clase y carga la referencia a través del cargador de clases de contexto de hebras. La carga se realiza para resolver una referencia de artefacto por lotes cuando el cargador de archivado devuelve un valor nulo para esta referencia.
- Si selecciona la opción Utilizar CDI (Context and Dependency Injection), el entorno de ejecución utiliza el cargador específico de la implementación CDI para resolver la referencia de artefacto por lotes utilizando el nombre del bean que ha especificado.
- Si selecciona la opción Añadir la clase al archivo batch.xml, el entorno de ejecución utiliza el cargador de archivado para resolver la referencia buscando el identificador especificado en el archivo batch.xml.
- Pulse Finalizar.
- Pulse el enlace de referencia en la pestaña Detalles.
- Utilice una clase de grabador existente para implementar el paso de fragmentos.
Los pasos siguientes son los mismos que los descritos en la clase de lector anteriormente. La información se repite aquí en contexto.
- Pulse Examinar en la pestaña Detalles.
- Busque clases por nombre seleccionando Buscar clases y, a continuación, escriba el nombre de la clase.
- Seleccione el nombre de la clase de Elementos coincidentes.
- Como alternativa a la búsqueda, si existe un archivo batch.xml, seleccione Examinar entradas en batch.xml y, a continuación, seleccione una de las entradas de la tabla.
- Pulse Aceptar.
- Cree una clase de grabador para el paso de fragmentos.
- En la pestaña Vista general, pulse el nodo grabador.
- Opcional: Implemente el nodo de procesador para el nodo de fragmentos.
El nodo de procesador se utiliza para procesar entradas al paso de fragmentos.
- Seleccione el nodo de fragmentos en la pestaña Visión general y pulse Añadir.
- Seleccione Procesador y pulse Aceptar.
En la pestaña Vista general del editor JSL, el nodo procesador aparece como hijo del nodo de fragmentos.
- Pulse el enlace de referencia en la pestaña Detalles.
Se visualizará el asistente Crear clase de procesador de elementos
Las descripciones siguientes sobre el asistente Crear clase de procesador de elementos son las mismas que las descripciones para el asistente Crear clase de lector de elementos. La información se repite aquí en contexto.
- En el campo Paquete Java, especifique el nombre del paquete.
- En el campo Nombre de clase, especifique el nombre de la clase.
- Opcional: En el campo Superclase, especifique el nombre de la superclase.
- Opcional: En el campo Interfaces, añada más interfaces para la clase que se va a implementar.
- Para Opciones de carga de artefactos por lotes, acepte el valor predeterminado de
Utilizar el nombre completo de la clase.
- Si selecciona la opción Utilizar el nombre completo de la clase, el entorno de ejecución trata la referencia de artefacto por lotes como un nombre de clase y carga la referencia a través del cargador de clases de contexto de hebras. La carga se realiza para resolver una referencia de artefacto por lotes cuando el cargador de archivado devuelve un valor nulo para esta referencia.
- Si selecciona la opción Utilizar CDI (Context and Dependency Injection), el entorno de ejecución utiliza el cargador específico de la implementación CDI para resolver la referencia de artefacto por lotes utilizando el nombre del bean que ha especificado.
- Si selecciona la opción Añadir la clase al archivo batch.xml, el entorno de ejecución utiliza el cargador de archivado para resolver la referencia buscando el identificador especificado en el archivo batch.xml.
- Pulse Finalizar.
- Opcional: Marque como punto de comprobación el nodo de fragmentos para que pueda reiniciar el nodo.
Puede marcar como punto de comprobación el nodo de fragmentos después de procesar un número especificado de registros en el fragmento o según un algoritmo de punto de comprobación.
- Marque como punto de comprobación el nodo de fragmentos después de procesar un número especificado de registros en el fragmento.
- Seleccione Elemento para la política de punto de comprobación
- Especifique el número de elementos que se van a procesar por fragmento proporcionando un valor para Recuento de elementos.
- Especifique la cantidad de tiempo que pasa antes de tomar punto de comprobación proporcionando un valor para time-limit.
- Marque como punto de comprobación el nodo que se basa en un algoritmo de punto de comprobación.
- Seleccione Personalizar para la política del punto de comprobación.
- En la pestaña Vista general, pulse Añadir.
- Seleccione Algoritmo de punto de comprobación y pulse Aceptar.
Aparecerá la pestaña Detalles para Algoritmo de punto de comprobación.
- Cree o incluya una clase de algoritmo de punto de comprobación para implementar el algoritmo de punto de comprobación. Puede crear una nueva clase de algoritmo de punto de comprobación para el paso de fragmentos, incluir una clase de algoritmo de punto de comprobación de otro paso en el proyecto o incluir una clase de algoritmo de punto de comprobación de un paso de fragmentos de otro proyecto. Complete uno de los siguientes conjuntos de pasos:
- Cree una clase de algoritmo de punto de comprobación para implementar el algoritmo de punto de comprobación.
- Pulse el enlace de referencia en la pestaña Detalles.
Se visualizará el asistente Crear clase de algoritmo de punto de comprobación.
Las descripciones siguientes sobre el asistente Crear clase de algoritmo de punto de comprobación son las mismas que las descripciones para el asistente Crear clase de lector de elementos. La información se repite aquí en contexto.
- En el campo Paquete Java, especifique el nombre del paquete.
- En el campo Nombre de clase, especifique el nombre de la clase.
- Opcional: en el campo Superclase, especifique el nombre de la superclase.
- Opcional: en el campo Interfaces, añada más interfaces para la clase que se va a implementar.
- Para Opciones de carga de artefactos por lotes, acepte el valor predeterminado de
Utilizar el nombre completo de la clase.
- Si selecciona la opción Utilizar el nombre completo de la clase, el entorno de ejecución trata la referencia de artefacto por lotes como un nombre de clase y carga la referencia a través del cargador de clases de contexto de hebras. La carga se realiza para resolver una referencia de artefacto por lotes cuando el cargador de archivado devuelve un valor nulo para esta referencia.
- Si selecciona la opción Utilizar CDI (Context and Dependency Injection), el entorno de ejecución utiliza el cargador específico de la implementación CDI para resolver la referencia de artefacto por lotes utilizando el nombre del bean que ha especificado.
- Si selecciona la opción Añadir la clase al archivo batch.xml, el entorno de ejecución utiliza el cargador de archivado para resolver la referencia buscando el identificador especificado en el archivo batch.xml.
- Pulse Finalizar.
- Pulse el enlace de referencia en la pestaña Detalles.
- Utilizar una clase de algoritmo de punto de comprobación existente para implementar el algoritmo de punto de comprobación.
Los pasos siguientes son los mismos que los descritos en la clase de lector anteriormente. La información se repite aquí en contexto.
- Pulse Examinar en la pestaña Detalles.
- Busque clases por nombre seleccionando Buscar clases y, a continuación, escriba el nombre de la clase.
- Seleccione el nombre de la clase de Elementos coincidentes.
- Como alternativa a la búsqueda, si existe un archivo batch.xml, seleccione Examinar entradas en batch.xml y, a continuación, seleccione una de las entradas de la tabla.
- Pulse Aceptar.
- Cree una clase de algoritmo de punto de comprobación para implementar el algoritmo de punto de comprobación.
- Marque como punto de comprobación el nodo de fragmentos después de procesar un número especificado de registros en el fragmento.
- Pulse Finalizar.