Отправка заданий в пакетную среду выполнения

Интерфейс JobOperator пакета javax.batch.operations позволяет отправлять задания в пакетную среду выполнения и получать информацию о существующих заданиях. Этот интерфейс обеспечивает следующую функциональность.

Получение имён всех известных задач.
Запуск, остановка, перезапуск и отмена заданий.
Получение заданий и выполнение заданий.

Класс BatchRuntime пакета javax.batch.runtime предоставляет фабричный метод getJobOperator для получения объектов JobOperator.

Запуск задания

В следующем примере кода показано, как получить объект JobOperator и отправить пакетное задание:

JobOperator jobOperator = BatchRuntime.getJobOperator();
Properties props = new Properties();
props.setProperty("parameter1", "value1");
...
long execID = jobOperator.start("simplejob", props);

Первым аргументом метода JobOperator.start является имя задания, указанное в файле определения задания. Второй параметр — это объект Properties, который представляет параметры для выполнения этого задания. Вы можете использовать параметры задания для передачи информации о задании, известной только во время выполнения.

Проверка статуса задания

Интерфейс JobExecution в пакете javax.batch.runtime предоставляет методы для получения информации об отправленных заданиях. Этот интерфейс обеспечивает следующую функциональность.

Получение пакета и статуса завершения выполнения задания.
Получение времени запуска, изменения или завершения выполнения.
Получение названия задания.
Получение ID выполнения.

В следующем примере кода показано, как получить статус пакета задания, используя его идентификатор выполнения:

JobExecution jobExec = jobOperator.getJobExecution(execID);
String status = jobExec.getBatchStatus().toString();

Вызов пакетной среды выполнения из приложения

Компонент, из которого вызывается пакетная среда выполнения, зависит от архитектуры конкретного приложения. Например, вы можете вызвать пакетную среду выполнения из Enterprise-бина, сервлета, Managed-бина и т. д.

См. Пример webserverlog и Пример phonebilling для получения подробной информации о том, как вызвать пакетную среду выполнения из Managed-бина, управляемого пользовательским интерфейсом JavaServer Faces.