com.github.edgar615.util.vertx.task.Tuple2Task Maven / Gradle / Ivy
The newest version!
package com.github.edgar615.util.vertx.task;
import com.github.edgar615.util.vertx.function.Consumer3;
import com.github.edgar615.util.vertx.function.Function3;
import com.github.edgar615.util.vertx.function.Tuple2;
import io.vertx.core.Future;
import java.util.function.BiConsumer;
import java.util.function.BiFunction;
/**
* Created by Edgar on 2016/7/26.
*
* @author Edgar Date 2016/7/26
*/
public interface Tuple2Task extends Task> {
/**
* 将Task> 转换为Tuple2Task
*
* @param task
* @param
* @param
* @return Tuple2Task
*/
default Tuple2Task cast(final Task> task) {
return new Tuple2TaskDelegate<>(task);
}
/**
* 任务完成之后，将结果转换为其他对象.
*
* @param function function类
* @param 转换后的类型
* @return task
*/
default Task map(BiFunction function) {
return mapWithFallback(function, null);
}
/**
* 任务完成之后，将结果转换为其他对象.
*
* @param function function类
* @param 转换后的类型
* @param fallback 如果function出现异常，回退的操作
* @return task
*/
default Task mapWithFallback(BiFunction function,
Function3 fallback) {
return mapWithFallback("map: " + function.getClass().getName(), function, fallback);
}
/**
* 任务完成之后，将结果转换为其他对象.
*
* @param desc 任务描述
* @param function function类
* @param 转换后的类型
* @return task
*/
default Task map(String desc, BiFunction function) {
return mapWithFallback(desc, function, null);
}
/**
* 任务完成之后，将结果转换为其他对象.
*
* @param desc 任务描述
* @param function function类
* @param fallback 如果function出现异常，回退的操作
* @param 转换后的类型
* @return task
*/
default Task mapWithFallback(String desc, BiFunction function,
Function3 fallback) {
if (fallback == null) {
return map(desc, t -> function.apply(t.getT1(), t.getT2()));
}
return mapWithFallback(desc, t -> function.apply(t.getT1(), t.getT2()),
(throwable, t) -> fallback.apply(throwable, t.getT1(), t.getT2()));
}
/**
* 任务完成后，根据结果做一些额外操作.
*
* @param consumer consumer类
* @return task
*/
default Tuple2Task andThen(BiConsumer consumer) {
return andThenWithFallback(consumer, null);
}
/**
* 任务完成后，根据结果做一些额外操作.
*
* @param consumer consumer类
* @param fallback 如果consumer出现异常，回退的操作
* @return task
*/
default Tuple2Task andThenWithFallback(BiConsumer consumer,
Consumer3 fallback) {
return andThenWithFallback("andThen: " + consumer.getClass().getName(), consumer, fallback);
}
/**
* 任务完成后，根据结果做一些额外操作.
*
* @param desc 任务描述
* @param consumer consumer类
* @return task
*/
default Tuple2Task andThen(String desc, BiConsumer consumer) {
return andThenWithFallback(desc, consumer, null);
}
/**
* 任务完成后，根据结果做一些额外操作.
*
* @param desc 任务描述
* @param consumer consumer类
* @param fallback 如果consumer出现异常，回退的操作
* @return task
*/
default Tuple2Task andThenWithFallback(String desc, BiConsumer consumer,
Consumer3 fallback) {
if (fallback == null) {
return cast(andThen(desc, t -> consumer.accept(t.getT1(), t.getT2())));
}
return cast(andThenWithFallback(desc, t -> consumer.accept(t.getT1(), t.getT2()),
(throwalbe, t) -> fallback
.accept(throwalbe, t.getT1(), t.getT2())));
}
/**
* 任务完成之后，让结果传递给另外一个任务执行，futureFunction用来使用结果创建一个新的任务.
*
* @param function function类，将结果转换为一个新的future
* @param
* @return
*/
default Task flatMap(BiFunction> function) {
return flatMapWithFallback(function, null);
}
/**
* 任务完成之后，让结果传递给另外一个任务执行，futureFunction用来使用结果创建一个新的任务.
*
* @param function function类，将结果转换为一个新的future
* @param
* @return
*/
default Task flatMapWithFallback(BiFunction> function,
Function3 fallback) {
return flatMapWithFallback("flatMap: " + function.getClass().getName(),
function, fallback);
}
/**
* 任务完成之后，让结果传递给另外一个任务执行，futureFunction用来使用结果创建一个新的任务.
*
* @param desc 任务描述
* @param function function类，将结果转换为一个新的future
* @param
* @return
*/
default Task flatMap(String desc, BiFunction> function) {
return flatMapWithFallback(desc, function, null);
}
/**
* 任务完成之后，让结果传递给另外一个任务执行，futureFunction用来使用结果创建一个新的任务.
*
* @param desc 任务描述
* @param function function类，将结果转换为一个新的future
* @param fallback 如果function出现异常，回退的操作. 这个回退操作，不再返回一个Future,而是直接返回一个特定的值
* @param
* @return
*/
default Task flatMapWithFallback(String desc, BiFunction> function,
Function3 fallback) {
if (fallback == null) {
return flatMap(desc, t -> function.apply(t.getT1(), t.getT2()));
} else {
return flatMapWithFallback(desc, t -> function.apply(t.getT1(), t.getT2()),
((throwable, t) -> fallback
.apply(throwable, t.getT1(), t.getT2())));
}
}
}