auto-async

auto-async是一个基于java APT自动生成异步接口和Facade抽象实现类的库

Download

Maven

<dependency>
    <groupId>net.vakilla</groupId>
    <artifactId>auto-async</artifactId>
    <version>1.0.2</version>
</dependency>

or Gradle

compile 'net.vakilla:auto-async:1.0.2'

使用方法

• Example 1: 生成异步接口

@AutoAsync
public interface SimpleService {

    String echo(String message);

    @Asyncable
    List<Complex> complex(Map<String, List<Date>> map);
}

自动生成接口

@AutoGenerated("net.vakilla.auto.async.processor.AutoAsyncProcessor")
public interface Unified_SimpleService extends SimpleService {
  ListenableFuture<List<Complex>> async_complex(Map<String, List<Date>> map);
}

• Example 2: 生成异步接口和抽象实现类

@AutoAsync(generateFacade = true)
public interface SimpleService {

    String echo(String message);

    @Asyncable
    List<Complex> complex(Map<String, List<Date>> map);
}

自动生成接口

@AutoGenerated(
    generateFacade = true,
    value = "net.vakilla.auto.async.processor.AutoAsyncProcessor"
)
public interface Unified_SimpleService extends SimpleService {
  ListenableFuture<List<Complex>> async_complex(Map<String, List<Date>> map);
}

自动生成抽象实现类

@AutoGenerated("net.vakilla.auto.async.processor.AutoGeneratedProcessor")
public abstract class Facade_Unified_SimpleService implements Unified_SimpleService {
  public ListenableFuture<List<Complex>> async_complex(Map<String, List<Date>> map) {
    return null;
  }
}

依赖

<dependency>
    <groupId>com.google.auto.service</groupId>
    <artifactId>auto-service</artifactId>
    <version>1.0-rc3</version>
</dependency>

<dependency>
    <groupId>com.squareup</groupId>
    <artifactId>javapoet</artifactId>
    <version>1.7.0</version>
</dependency>

注意事项

• 生成的异步接口基于guava的ListenableFuture
• 生成代码使用javapoet库，没有检查方法返回类型，如果方法标记了@Asyncable就会扫描生成异步方法，即使原本的返回类型是Future。 所以，可以使用AutoAsync的strict模式（strict = true），这样会检查方法的返回类型是不是Future或者子类，如果是会报错
  strict模式会影响编译的效率，默认是不开启的，使用时注意不要在返回类型是Future的方法上添加@Asyncable注解