org.springframework.web.context.request.async.WebAsyncTask Maven / Gradle / Ivy

/*
 * Copyright 2002-2013 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
 *
 *      http://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.web.context.request.async;

import java.util.concurrent.Callable;

import org.springframework.beans.factory.BeanFactory;
import org.springframework.core.task.AsyncTaskExecutor;
import org.springframework.util.Assert;
import org.springframework.web.context.request.NativeWebRequest;

/**
 * Holder for a {@link Callable}, a timeout value, and a task executor.
 *
 * @author Rossen Stoyanchev
 * @since 3.2
 */
public class WebAsyncTask {

	private final Callable callable;

	private final Long timeout;

	private final String executorName;

	private final AsyncTaskExecutor executor;

	private Callable timeoutCallback;

	private Runnable completionCallback;

	private BeanFactory beanFactory;


	/**
	 * Create a {@code WebAsyncTask} wrapping the given {@link Callable}.
	 * @param callable the callable for concurrent handling
	 */
	public WebAsyncTask(Callable callable) {
		this(null, null, null, callable);
	}

	/**
	 * Create a {@code WebAsyncTask} with a timeout value and a {@link Callable}.
	 * @param timeout timeout value in milliseconds
	 * @param callable the callable for concurrent handling
	 */
	public WebAsyncTask(long timeout, Callable callable) {
		this(timeout, null, null, callable);
	}

	/**
	 * Create a {@code WebAsyncTask} with a timeout value, an executor name, and a {@link Callable}.
	 * @param timeout timeout value in milliseconds; ignored if {@code null}
	 * @param callable the callable for concurrent handling
	 */
	public WebAsyncTask(Long timeout, String executorName, Callable callable) {
		this(timeout, null, executorName, callable);
		Assert.notNull(executor, "Executor name must not be null");
	}

	/**
	 * Create a {@code WebAsyncTask} with a timeout value, an executor instance, and a Callable.
	 * @param timeout timeout value in milliseconds; ignored if {@code null}
	 * @param callable the callable for concurrent handling
	 */
	public WebAsyncTask(Long timeout, AsyncTaskExecutor executor, Callable callable) {
		this(timeout, executor, null, callable);
		Assert.notNull(executor, "Executor must not be null");
	}

	private WebAsyncTask(Long timeout, AsyncTaskExecutor executor, String executorName, Callable callable) {
		Assert.notNull(callable, "Callable must not be null");
		this.callable = callable;
		this.timeout = timeout;
		this.executor = executor;
		this.executorName = executorName;
	}


	/**
	 * Return the {@link Callable} to use for concurrent handling, never {@code null}.
	 */
	public Callable getCallable() {
		return this.callable;
	}

	/**
	 * Return the timeout value in milliseconds or {@code null} if not value is set.
	 */
	public Long getTimeout() {
		return this.timeout;
	}

	/**
	 * Return the AsyncTaskExecutor to use for concurrent handling, or {@code null}.
	 */
	public AsyncTaskExecutor getExecutor() {
		if (this.executor != null) {
			return this.executor;
		}
		else if (this.executorName != null) {
			Assert.state(this.beanFactory != null, "A BeanFactory is required to look up a task executor bean");
			return this.beanFactory.getBean(this.executorName, AsyncTaskExecutor.class);
		}
		else {
			return null;
		}
	}

	/**
	 * A {@link BeanFactory} to use to resolve an executor name. Applications are
	 * not expected to have to set this property when {@code WebAsyncTask} is used in a
	 * Spring MVC controller.
	 */
	public void setBeanFactory(BeanFactory beanFactory) {
		this.beanFactory = beanFactory;
	}


	/**
	 * Register code to invoke when the async request times out. This method is
	 * called from a container thread when an async request times out before the
	 * {@code Callable} has completed. The callback is executed in the same
	 * thread and therefore should return without blocking. It may return an
	 * alternative value to use, including an {@link Exception} or return
	 * {@link CallableProcessingInterceptor#RESULT_NONE RESULT_NONE}.
	 */
	public void onTimeout(Callable callback) {
		this.timeoutCallback = callback;
	}

	/**
	 * Register code to invoke when the async request completes. This method is
	 * called from a container thread when an async request completed for any
	 * reason including timeout and network error.
	 */
	public void onCompletion(Runnable callback) {
		this.completionCallback = callback;
	}

	CallableProcessingInterceptor getInterceptor() {
		return new CallableProcessingInterceptorAdapter() {

			@Override
			public  Object handleTimeout(NativeWebRequest request, Callable task) throws Exception {
				return (timeoutCallback != null) ? timeoutCallback.call() : CallableProcessingInterceptor.RESULT_NONE;
			}

			@Override
			public  void afterCompletion(NativeWebRequest request, Callable task) throws Exception {
				if (completionCallback != null) {
					completionCallback.run();
				}
			}
		};
	}

}