Incluindo uma etapa da parte em uma tarefa em lote Java
É possível incluir uma etapa da parte no arquivo XML de uma tarefa em lote Java™. É possível ler, processar e gravar itens individuais na etapa da parte e também reiniciar a etapa da parte.
Antes de Iniciar
- Instale o recurso em lote Java para o WebSphere Application Server Developer Tools for Eclipse. Esse recurso é opcional. É possível instalá-lo a partir de Ajuda > Instalar o software WebSphere.
- Crie um projeto em lote Java.
- Crie uma tarefa em lote Java no projeto em lote Java.
Sobre Esta Tarefa
Procedimento
- No editor JSL (Job Specification Language), abra o arquivo XML de sua tarefa em lote Java.
O editor JSL é aberto automaticamente ao clicar em Concluir depois de criar uma tarefa em lote Java. Um arquivo XML com o mesmo nome que a tarefa em lote é exibido no editor JSL.
Caso você esteja incluindo uma etapa no arquivo XML de uma tarefa em lote Java existente, execute as etapas a seguir para abrir o arquivo XML no editor JSL:- Na visualização Enterprise Explorer, selecione o projeto em lote Java criado.
- Selecione src > META-INF > batch-jobs.
- Dê um clique duplo no arquivo XML de sua tarefa em lote Java.
O arquivo é exibido no editor JSL.
- Selecione o nó da tarefa na guia Visão geral; clique em Incluir.
- Selecione Etapa; clique em OK.
- Opcional: Altere o ID no campo ID* da guia Detalhes.
- Selecione o nó da etapa na guia Visão geral; clique em Incluir.
- Selecione Chunk; clique em OK.
Na guia de visão geral do editor JSL, o nó do chunk é exibido como um filho da etapa. Um nó leitor e um nó gravador são exibidos como filhos do nó do chunk.
- Implemente o nó leitor.
- Na guia Visão geral, clique no nó leitor.
A guia Detalhes do nó leitor é exibida.
- Crie ou inclua uma classe leitora para implementar o nó leitor.
É possível criar uma classe leitora para o projeto, incluir uma classe leitora de outra etapa no projeto ou incluir uma classe leitora de uma etapa da parte em outro projeto. Execute uma das seguintes tarefas:
- Crie uma classe leitora para a etapa da parte.
- Clique no link de referência na guia Detalhes.
O assistente Criar classe leitora do item é exibido.
- No campo Pacote Java, especifique o nome do pacote.
- No campo Nome da classe, especifique o nome da classe.
- Opcional: No campo Superclasse, especifique o nome da superclasse ou selecione Usar classe de Lote Java abstrata como superclasse.
- Opcional: No campo Interfaces, inclua mais interfaces para serem implementadas pela classe.
- Para Opções de carregamento de artefato em lote, aceite o valor padrão de Usar o nome completo da classe.
- Ao selecionar a opção Usar o nome completo da classe, o ambiente de tempo de execução tratará a referência de artefato em lote como um nome de classe e carregará a referência por meio do carregador de classes de contexto de encadeamento. O carregamento é feito para resolver uma referência de artefato em lote quando o carregador de archive retorna nulo para essa referência.
- Ao selecionar a opção Usar injeção de contexto e dependência (CDI), o ambiente de tempo de execução usa o carregador específico da implementação de CDI para resolver a referência de artefato em lote, utilizando o nome de bean especificado.
- Ao selecionar a opção Incluir a classe no arquivo batch.xml, o ambiente de tempo de execução usa o carregador de archive para resolver a referência, procurando o identificador especificado no arquivo batch.xml.
- Clique em Concluir.
- Clique no link de referência na guia Detalhes.
- Utilize uma classe leitora existente para implementar a etapa da parte.
- Clique em Procurar na guia Detalhes.
- Procure as classes por nome, selecionando Procurar classes e, em seguida, digitando o nome da classe.
- Selecione o nome da classe a partir de Itens correspondentes.
- Como alternativa para a procura, se houver um arquivo batch.xml, selecione Procurar entradas em batch.xml e, em seguida, selecione uma das entradas da tabela.
- Clique em OK.
- Crie uma classe leitora para a etapa da parte.
- Na guia Visão geral, clique no nó leitor.
- Implemente o nó gravador.
- Na guia Visão geral, clique no nó gravador.
A guia Detalhes do nó gravador é exibida.
- Crie ou inclua uma classe gravadora para implementar o nó gravador. É possível criar uma classe gravadora para o projeto, incluir uma classe gravadora de outra etapa no projeto ou incluir uma classe gravadora de uma etapa da parte em outro projeto. Execute uma das seguintes tarefas:
- Crie uma classe gravadora para a etapa da parte.
- Clique no link de referência na guia Detalhes.
O assistente Criar classe gravadora do item é exibido.
As descrições mostradas a seguir sobre o assistente Criar classe gravadora do item são as mesmas descrições para o assistente Criar classe leitora do item. As informações são repetidas aqui no contexto.
- No campo Pacote Java, especifique o nome do pacote.
- No campo Nome da classe, especifique o nome da classe.
- Opcional: No campo Superclasse, especifique o nome da superclasse ou selecione Usar classe de Lote Java abstrata como superclasse.
- Opcional: No campo Interfaces, inclua mais interfaces para serem implementadas pela classe.
- Para Opções de carregamento de artefato em lote, aceite o valor padrão de Usar o nome completo da classe.
- Ao selecionar a opção Usar o nome completo da classe, o ambiente de tempo de execução tratará a referência de artefato em lote como um nome de classe e carregará a referência por meio do carregador de classes de contexto de encadeamento. O carregamento é feito para resolver uma referência de artefato em lote quando o carregador de archive retorna nulo para essa referência.
- Ao selecionar a opção Usar injeção de contexto e dependência (CDI), o ambiente de tempo de execução usa o carregador específico da implementação de CDI para resolver a referência de artefato em lote, utilizando o nome de bean especificado.
- Ao selecionar a opção Incluir a classe no arquivo batch.xml, o ambiente de tempo de execução usa o carregador de archive para resolver a referência, procurando o identificador especificado no arquivo batch.xml.
- Clique em Concluir.
- Clique no link de referência na guia Detalhes.
- Utilize uma classe gravadora existente para implementar a etapa da parte.
As etapas a seguir são as mesmas descritas anteriormente na classe leitora. As informações são repetidas aqui no contexto.
- Clique em Procurar na guia Detalhes.
- Procure as classes por nome, selecionando Procurar classes e, em seguida, digitando o nome da classe.
- Selecione o nome da classe a partir de Itens correspondentes.
- Como alternativa para a procura, se houver um arquivo batch.xml, selecione Procurar entradas em batch.xml e, em seguida, selecione uma das entradas da tabela.
- Clique em OK.
- Crie uma classe gravadora para a etapa da parte.
- Na guia Visão geral, clique no nó gravador.
- Opcional: Implemente o nó de processador para o nó de chunk.
O nó do processador é usado para processar entradas feitas na etapa da parte.
- Selecione o nó de chunk na guia Visão geral; clique em Incluir.
- Selecione Processador; clique em OK.
Na guia de visão geral do editor JSL, o nó do processador é exibido como um filho do nó de chunk.
- Clique no link de referência na guia Detalhes.
O assistente Criar classe do processador de item é exibido.
As descrições mostradas a seguir sobre o assistente Criar classe do processador de item são as mesmas descrições para o assistente Criar classe leitora do item. As informações são repetidas aqui no contexto.
- No campo Pacote Java, especifique o nome do pacote.
- No campo Nome da classe, especifique o nome da classe.
- Opcional: No campo Superclasse, especifique o nome da superclasse.
- Opcional: No campo Interfaces, inclua mais interfaces para serem implementadas pela classe.
- Para Opções de carregamento de artefato em lote, aceite o valor padrão de Usar o nome completo da classe.
- Ao selecionar a opção Usar o nome completo da classe, o ambiente de tempo de execução tratará a referência de artefato em lote como um nome de classe e carregará a referência por meio do carregador de classes de contexto de encadeamento. O carregamento é feito para resolver uma referência de artefato em lote quando o carregador de archive retorna nulo para essa referência.
- Ao selecionar a opção Usar injeção de contexto e dependência (CDI), o ambiente de tempo de execução usa o carregador específico da implementação de CDI para resolver a referência de artefato em lote, utilizando o nome de bean especificado.
- Ao selecionar a opção Incluir a classe no arquivo batch.xml, o ambiente de tempo de execução usa o carregador de archive para resolver a referência, procurando o identificador especificado no arquivo batch.xml.
- Clique em Concluir.
- Opcional: Verifique o nó do chunk para que seja possível reiniciar o nó.
É possível verificar o nó do chunk após o processamento de um número especificado de registros no chunk ou de acordo com um algoritmo de ponto de verificação.
- Verifique o nó do chunk após o processamento de um número especificado de registros no chunk.
- Selecione Item para a política de verificação
- Especifique o número de itens a serem processados por chunk, fornecendo um valor para Contagem de itens.
- Especifique a quantidade de tempo decorrido antes que haja uma verificação, fornecendo um valor para time-limit.
- Verifique o nó que se baseia em um algoritmo de ponto de verificação.
- Selecione Customizada para a política de verificação.
- Na guia Visão geral, clique em Incluir.
- Selecione Algoritmo de ponto de verificação; clique em OK.
A guia Detalhes do Algoritmo de ponto de verificação é exibida.
- Crie ou inclua uma classe de algoritmo de ponto de verificação para implementar o algoritmo de ponto de verificação.É possível criar uma nova classe de algoritmo de ponto de verificação para a etapa da parte, incluir uma classe de algoritmo de ponto de verificação de outra etapa no projeto ou incluir uma classe de algoritmo de ponto de verificação de uma etapa de algoritmo de ponto de verificação em outro projeto. Conclua um dos seguintes conjuntos de etapas:
- Crie uma classe de algoritmo de ponto de verificação para implementar o algoritmo de ponto de verificação.
- Clique no link de referência na guia Detalhes.
O assistente Criar classe de algoritmo de ponto de verificação é exibido.
As descrições mostradas a seguir sobre o assistente Criar classe de algoritmo de ponto de verificação são as mesmas descrições para o assistente Criar classe leitora do item. As informações são repetidas aqui no contexto.
- No campo Pacote Java, especifique o nome do pacote.
- No campo Nome da classe, especifique o nome da classe.
- Opcional: No campo Superclasse, especifique o nome da superclasse.
- Opcional: No campo Interfaces, inclua mais interfaces para serem implementadas pela classe.
- Para Opções de carregamento de artefato em lote, aceite o valor padrão de Usar o nome completo da classe.
- Ao selecionar a opção Usar o nome completo da classe, o ambiente de tempo de execução tratará a referência de artefato em lote como um nome de classe e carregará a referência por meio do carregador de classes de contexto de encadeamento. O carregamento é feito para resolver uma referência de artefato em lote quando o carregador de archive retorna nulo para essa referência.
- Ao selecionar a opção Usar injeção de contexto e dependência (CDI), o ambiente de tempo de execução usa o carregador específico da implementação de CDI para resolver a referência de artefato em lote, utilizando o nome de bean especificado.
- Ao selecionar a opção Incluir a classe no arquivo batch.xml, o ambiente de tempo de execução usa o carregador de archive para resolver a referência, procurando o identificador especificado no arquivo batch.xml.
- Clique em Concluir.
- Clique no link de referência na guia Detalhes.
- Use uma classe de algoritmo de ponto de verificação existente para implementar o algoritmo de ponto de verificação.
As etapas a seguir são as mesmas descritas anteriormente na classe leitora. As informações são repetidas aqui no contexto.
- Clique em Procurar na guia Detalhes.
- Procure as classes por nome, selecionando Procurar classes e, em seguida, digitando o nome da classe.
- Selecione o nome da classe a partir de Itens correspondentes.
- Como alternativa para a procura, se houver um arquivo batch.xml, selecione Procurar entradas em batch.xml e, em seguida, selecione uma das entradas da tabela.
- Clique em OK.
- Crie uma classe de algoritmo de ponto de verificação para implementar o algoritmo de ponto de verificação.
- Verifique o nó do chunk após o processamento de um número especificado de registros no chunk.
- Clique em Concluir.