spring-batch ExecutionContextPromotionListener 源码

spring-batch ExecutionContextPromotionListener 代码

文件路径：/spring-batch-core/src/main/java/org/springframework/batch/core/listener/ExecutionContextPromotionListener.java

/*
 * Copyright 2006-2021 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.springframework.batch.core.listener;

import org.springframework.batch.core.ExitStatus;
import org.springframework.batch.core.Job;
import org.springframework.batch.core.Step;
import org.springframework.batch.core.StepExecution;
import org.springframework.batch.core.StepExecutionListener;
import org.springframework.batch.item.ExecutionContext;
import org.springframework.batch.support.PatternMatcher;
import org.springframework.beans.factory.InitializingBean;
import org.springframework.lang.Nullable;
import org.springframework.util.Assert;

/**
 * This class can be used to automatically promote items from the {@link Step}
 * {@link ExecutionContext} to the {@link Job} {@link ExecutionContext} at the end of a
 * step. A list of keys should be provided that correspond to the items in the
 * {@link Step} {@link ExecutionContext} that should be promoted.
 *
 * Additionally, an optional list of statuses can be set to indicate for which exit status
 * codes the promotion should occur. These statuses will be checked using the
 * {@link PatternMatcher}, so wildcards are allowed. By default, promotion will only occur
 * for steps with an exit code of "COMPLETED".
 *
 * @author Dan Garrette
 * @author Mahmoud Ben Hassine
 * @since 2.0
 */
public class ExecutionContextPromotionListener implements StepExecutionListener, InitializingBean {

	private String[] keys = null;

	private String[] statuses = new String[] { ExitStatus.COMPLETED.getExitCode() };

	private boolean strict = false;

	@Nullable
	@Override
	public ExitStatus afterStep(StepExecution stepExecution) {
		ExecutionContext stepContext = stepExecution.getExecutionContext();
		ExecutionContext jobContext = stepExecution.getJobExecution().getExecutionContext();
		String exitCode = stepExecution.getExitStatus().getExitCode();
		for (String statusPattern : statuses) {
			if (PatternMatcher.match(statusPattern, exitCode)) {
				for (String key : keys) {
					if (stepContext.containsKey(key)) {
						jobContext.put(key, stepContext.get(key));
					}
					else {
						if (strict) {
							throw new IllegalArgumentException(
									"The key [" + key + "] was not found in the Step's ExecutionContext.");
						}
					}
				}
				break;
			}
		}

		return null;
	}

	@Override
	public void afterPropertiesSet() throws Exception {
		Assert.notNull(this.keys, "The 'keys' property must be provided");
		Assert.notEmpty(this.keys, "The 'keys' property must not be empty");
		Assert.notNull(this.statuses, "The 'statuses' property must be provided");
		Assert.notEmpty(this.statuses, "The 'statuses' property must not be empty");
	}

	/**
	 * @param keys A list of keys corresponding to items in the {@link Step}
	 * {@link ExecutionContext} that must be promoted.
	 */
	public void setKeys(String[] keys) {
		this.keys = keys;
	}

	/**
	 * @param statuses A list of statuses for which the promotion should occur. Statuses
	 * can may contain wildcards recognizable by a {@link PatternMatcher}.
	 */
	public void setStatuses(String[] statuses) {
		this.statuses = statuses;
	}

	/**
	 * If set to TRUE, the listener will throw an exception if any 'key' is not found in
	 * the Step {@link ExecutionContext}. FALSE by default.
	 * @param strict boolean the value of the flag.
	 */
	public void setStrict(boolean strict) {
		this.strict = strict;
	}

}

相关信息

spring-batch 源码目录

相关文章

spring-batch AbstractListenerFactoryBean 源码

spring-batch ChunkListenerSupport 源码

spring-batch CompositeChunkListener 源码

spring-batch CompositeItemProcessListener 源码

spring-batch CompositeItemReadListener 源码

spring-batch CompositeItemWriteListener 源码

spring-batch CompositeJobExecutionListener 源码

spring-batch CompositeSkipListener 源码

spring-batch CompositeStepExecutionListener 源码

spring-batch ItemListenerSupport 源码