使用说明
在 Spring 框架中,@Async 注解用于标识一个方法是异步执行的。当一个方法被 @Async 注解修饰后,调用该方法时会在新的线程中执行,而不会阻塞当前线程。
@Async
注解在使用中的失效原因
- 注解@Async的方法不是public方法
- 注解@Async的返回值只能为void或者Future
- 注解@Async方法使用static修饰也会失效
- spring无法扫描到异步类,没加注解@Async 或 @EnableAsync注解
- 调用方与被调方不能在同一个类
- Spring 在扫描bean的时候会扫描方法上是否包含@Async注解,动态地生成一个子类(即proxy代理类),当这个有注解的方法被调用的时候,实际上是由代理类来调用的,代理类在调用时增加异步作用。
- 如果这个有注解的方法是被同一个类中的其他方法调用的,那么该方法的调用并没有通过代理类,而是直接通过原来的那个 bean,所以就失效了。
- 调用方与被调方不能在同一个类,主要是使用了动态代理,同一个类的时候直接调用,不是通过生成的动态代理类调用。
- 一般将要异步执行的方法单独抽取成一个类。
- 类中需要使用@Autowired或@Resource等注解自动注入,不能自己手动new对象
- 在Async 方法上标注@Transactional是没用的,但在Async 方法调用的方法上标注@Transactional是有效的
附说明
- 直接使用 @Async 注解没指定线程池的话,即未设置TaskExecutor时默认使用Spring创建
- ThreadPoolTaskExecutor
- 核心线程数:8
- 最大线程数:Integer.MAX_VALUE (21亿多)
- 队列使用LinkedBlockingQueue
- 容量:Integer.MAX_VALUE
- 空闲线程保留时间:60s
- 线程池拒绝策略:AbortPolicy
无返回值
定义异步任务
@Async
@Override
public void testAsync1() {
// 业务逻辑
}
调用异步任务
@GetMapping("/test")
public Object test() {
asyncService.testAsync1();
return "testAsync1";
}
有返回值
定义异步任务
@Async
@Override
public Future<String> testAsync2() {
String str = "testAsync2";
return new AsyncResult<>(str);
}
调用异步任务
@GetMapping("/test")
public Object test() {
Future<String> f = asyncService.testAsync2();
return f.get();
}
多任务有返回值
可以延用Future或使用CompletableFuture
定义异步任务
@Async
@Override
public CompletableFuture<String> testAsync1() {
String str = "testAsync1";
return CompletableFuture.completedFuture(str);
}
@Async
@Override
public CompletableFuture<String> testAsync2() {
String str = "testAsync2";
return CompletableFuture.completedFuture(str);
}
@Async
@Override
public CompletableFuture<String> testAsync3() {
String str = "testAsync3";
return CompletableFuture.completedFuture(str);
}
调用异步任务
@GetMapping("/test")
public Object test() {
CompletableFuture<Integer> f1 = asyncService.testAsync1();
CompletableFuture<Integer> f2 = asyncService.testAsync2();
CompletableFuture<Integer> f3 = asyncService.testAsync3();
Map<String, Integer> map = CompletableFuture.allOf(f1, f2, f3).thenApply(v ->
new HashMap<String, Integer>() {{
try {
put("task_1", f1.get());
put("task_2", f2.get());
put("task_3", f3.get());
} catch (InterruptedException | ExecutionException e) {
throw new RuntimeException(e);
}
}}).join();
return map;
}
同类中调用
同一个类中使用@Async
调用异步方法会失效,这是因为 Spring
在同一个类中调用异步方法时,实际上是通过代理对象来调用方法的,而代理对象会绕过原始对象的自我调用,导致异步方法的注解失效。
解决方法是在同一个类中手动获取当前类的代理对象来调用@Async
异步方法,而不是直接调用该方法。
@RestController
public class MyClass {
@Autowired
private ApplicationContext context;
@GetMapping("/test")
public Object test() throws Exception {
// 通过 ApplicationContext 获取 MyClass 类的一个代理对象
MyClass proxy = context.getBean(MyClass.class);
// 调用异步方法
proxy.testAsync();
// 返回字符串 "testAsync" 给客户端
return "testAsync";
}
@Async
public void testAsync() {
// 异步方法,可以在这里编写业务逻辑
}
}