首页 > 其他分享 >vavr使用文档

vavr使用文档

时间:2022-08-15 22:23:02浏览次数:76  
标签:vavr System 元组 API 文档 使用 println public out

目录

vavr官方文档

maven依赖

        <!--vavr-->
        <dependency>
            <groupId>io.vavr</groupId>
            <artifactId>vavr</artifactId>
            <version>0.10.4</version>
        </dependency>

Vavr 使用文档

1. Tuples 元组(重点)

参考文档地址1: Vavr - Java8函数式编程拓展库使用指南

参考文档地址2:Java元组Tuple介绍与使用

参考文档地址3: Java Tuple类代码示例

元组是将多个不同类型的数据包裹的一个容器,比如可以将字符串,数字,数组用一个元组包裹,这样即可以通过一个元组变量获取到包括的任一数据

1.1、元组介绍

仅仅一次方法调用就可以返回多个对象,你应该经常需要这样的功能吧.可以return语句只允许返回单个对(可能有人说返回一个集合就可以了,请记住,一个集合也只是一个对象而已)因此,解决办法就是创建一个对象,用它来持有想要返回的对象.当然,可以在每次需要的时候,专门创建一个类来完成这样的工作.可是有了泛型,我们就能够一次性的解决问题,以后再也不用再这种问题上浪费时间了.同时,我们再编译器就可以确保类型安全.

上述概念称为元组(tuple),它是将一组对象直接打包存储与其中的一个单一对象.这个容器对象允许读取其中的元素.但是不允许向其中存放新的对象.(这个概念也称为数据传送对象,或信使)

通常元素具有任意长度,同时,元组中的对象可以是任何不同的类型.不过,我们希望能够为每一个对象指明其类型,并且从容器中读取出来时,能够得到正确的类型.要处理不同长度的问题,我们需要创建不同的元组.采用下面的编码形式无疑是更安全的做法,这样的话,如果程序员想要使用具有不同元素的元组,就强制要求他们创建一个新的元组对象.并且可以利用继承机制实现长度更长的元组.

元组和列表list一样,都可能用于数据存储,包含多个数据;但是和列表不同的是:列表只能存储相同的数据类型,而元组不一样,它可以存储不同的数据类型,比如同时存储int、string、list等,并且可以根据需求无限扩展。

比如说在web应用中,经常会遇到一个问题就是数据分页问题,查询分页需要包含几点信息:当前页数、页大小;查询结果返回数据为:当前页的数据记录,但是如果需要在前台显示当前页、页大小、总页数等信息的时候,就必须有另外一个信息就是:数据记录总数,然后根据上面的信息进行计算得到总页数等信息。这个时候查询某一页信息的时候需要返回两个数据类型,一个是list(当前也的数据记录),一个是int(记录总数)。当然,完全可以在两个方法、两次数据库连接中得到这两个值。事实上在查询list的时候,已经通过sql查询得到总计录数,如果再开一个方法,再做一次数据库连接来查询总计录数,不免有点多此一举、浪费时间、浪费代码、浪费生命。言重了~在这种情况下,我们就可以利用二元组,在一次数据库连接中,得到总计录数、当前页记录,并存储到其中,简单明了!(http://www.cnblogs.com/davidwang456/p/4514659.html)

1.2、元组的示例

二元组常见代码形式可以如下所示:

public class TwoTuple<A, B> {

    public final A first;

    public final B second;

    public TwoTuple(A a, B b){
        first = a;
        second = b;
    }

    public String toString(){
        return "(" + first + ", " + second + ")";
    }

}
//利用继承机制实现长度更长的元组.将上述二元组扩展为三元组代码形式可以如下所示:
public class ThreeTuple<A, B, C> extends TwoTuple<A, B>{

    public final C third;

    public ThreeTuple(A a, B b, C c) {
        super(a, b);
        third = c;
    }

    public String toString(){
        return "(" + first + "," + second + "," + third + ")";
    }

}
//利用继承机制实现长度更长的元组.将上述三元组扩展为四元组代码形式可以如下所示:
public class FourTuple<A, B, C, D> extends ThreeTuple<A,B,C>{

    public final D fourth;

    public FourTuple(A a, B b, C c, D d) {
        super(a, b, c);
        fourth = d;
    }

    public String toString(){
        return "(" + first + "," + second + "," + third + "," + fourth + ")";
    }

}

为了使用元组,你只需定义一个长度适合的元组,将其作为方法的返回值,然后在return语句中创建该元组,并返回即可.例如下面使用方式:

1.3 实际运用

我们使用vavr包下的Tuple,以下为测试代码

import io.vavr.Tuple;
import io.vavr.Tuple2;

/**
 *
 * @author : lyn
 */
public class TestTuples {
    public static void main(String[] args) {
        test1();
    }
    private static void  test1(){
        // 1.1Create a tuple 创建一个元组
        Tuple2<String, Integer> java8 = Tuple.of("Java", 8);
        String str = java8._1;
        Integer num = java8._2;
        // 1.2Map a tuple 改变元组内部元素值
        Tuple2<String, Integer> map = java8.map(s -> s.substring(2) + "vr", c -> c / 8);
        System.out.println(map);
        Tuple2<String, Integer> vavr = java8.map((s, i) -> Tuple.of("vavr", 1));
        System.out.println(vavr);
        //1.3 Transform a tuple 元组转换
        String apply = java8.apply((s, i) -> s.substring(2) + "var" + i / 8);
        System.out.println(apply);
        //(vavr, 1)
        //(vavr, 1)
        //vavar1
    }

}

2. Try(重点)

import org.junit.Test;

import static io.vavr.API.$;
import static io.vavr.API.Case;
import static io.vavr.Predicates.instanceOf;

/**
 * Try.of
 * 描述: 测试代码
 *
 * @author lyn
 * @date 2022/8/9 13:33
 */

public class TryOfTest {
    /**
     * 1 如果有异常则执行getOrElseThrow,抛出指定异常
     */
    @Test
    public void test1() {
        Integer dd = Try.of(() -> {
            return 1 / 0;
        }).getOrElseThrow(() -> new RuntimeException("dd"));
    }

    /**
     * 2 如果有异常则执行getOrElse,返回零
     */
    @Test
    public void test2() {
        Integer dd = Try.of(() -> {
            return 1 / 0;
        }).getOrElse(0);
        System.out.println(dd);
    }

    /**
     * 3 如果有异常则执行先匹配case中的异常,有则执行对应的方法,没有匹配上则执行getOrElse
     */
    @Test
    public void test3() {
        Integer dd = Try.of(() -> {
            return 1 / 0;
        }).recover(x -> API.Match(x).of(
                Case($(instanceOf(NullPointerException.class)), t -> print(t)),
                Case($(instanceOf(ArithmeticException.class)), t -> print(t))
        )).getOrElse(3);
        System.out.println(dd);
    }

    private Integer print(NullPointerException t) {
        System.out.println("空指针异常");
        return null;
    }

    private Integer print(ArithmeticException t) {
        System.out.println("数学异常");
        return null;
    }
}

3 Functions 方法

建议: 对Function函数不了解的先学习 Function接口的使用文档

这里的Functions是对Java8Function做的拓展,其中最大的拓展是Java8中的Function只支持定义一个参数和一个结果,但实际运用当中的话我们得有多个参数,那这样Java8的Function中必须得将参数包装成一个Bean,在Bean中去封装多个参数值,而Vavr则直接将其拓展,使Function可以支持多个参数,最多支持8个参数

4.0 创建示例如下:

    /**
     * functions的三种创建方式
     */
    @Test
    public void test1() {
        // 创建方式一
        Function2<Integer, Integer, Integer> f1 = (a, b) -> a + b;
        // 创建方式二
        Function2<Integer, Integer, Integer> f2 = new Function2<Integer, Integer, Integer>() {
            @Override
            public Integer apply(Integer a, Integer b) {
                return a + b;
            }
        };
        // 创建方式三
        Function2<Integer, Integer, Integer> f3 = Function2.of((a, b) -> a + b);
    }

4.1 Composition 方法组合

  • Composition 方法组合
  • 用法和function的compose/andThen方法类似,都是指定那个规则先执行
  • compose是传入的参数规则先执行,andThen相反
    @Test
    public void test2() {
        Function1<Integer, Integer> func1 = a -> a + 1;
        Function1<Integer, Integer> func2 = a -> a * 2;
        Function1<Integer, Integer> func3 = func1.compose(func2);
        //2*2+1=5
        System.out.println(func3.apply(2));
        //
        System.out.println(func1.andThen(func2).apply(2));
    }

注意: 组合是只有Function1才有的方法,因为Function1继承自Function,而Function中就有compose方法,compose方法是先执行参数里的方法,即func1,将返回值作为func2的参数。

4.2 Lifting 返回值包装

返回值包装即返回Option包装对象

    @Test
    public void test3() {
        Function2<Integer, Integer, Integer> divide = (a, b) -> a / b;
        Function2<Integer, Integer, Option<Integer>> safeDivide = Function2.lift(divide);
        Option<Integer> option = safeDivide.apply(4, 0);
        System.out.println(option);
        //None,没有报错
    }

待补充:返回值用Option包装对象的优点

4.3 Partial application 分部应用

用途: 例如有两个算式 2*5+8 和2*5+4 ,可以利用分布应用,达到对2*5的重复利用
    @Test
    public void test4() {
        Function2<Integer,Integer,Integer> function2=(a,b)->a*b;
        Function1<Integer, Integer> function1 = function2.apply(2);
        System.out.println(function1.apply(4));
        //结果: 8
        //等效于
        Function2<Integer,Integer,Integer> function3=(a,b)->a*b;
        Function1<Integer, Integer> function4 = b->2*b;
        System.out.println(function4.apply(4));
    }

    /**
     * Partial application 分部应用
     * 顺序测试:按传入顺序依次填充
     */
    @Test
    public void test5() {
        Function3<Integer,Integer,Integer,Integer> function=(a,b,c)->a*b+c;
        Function1<Integer, Integer> function1 = function.apply(2, 4);
        System.out.println(function1.apply(3));
        //结果: 11
    }

4.4 Currying 颗粒性

拆分成以个参数的Function去执行,用途待调研

  	@Test
    public void test6() {
        Function3<Integer,Integer,Integer,Integer> sum=(a,b,c)->a+b+c;
        final Function1<Integer,Function1<Integer,Integer>> add2= sum.curried().apply(2);
        System.out.println(add2.apply(3));   // Function3
        System.out.println(add2.apply(3).apply(4));
    }

4.5 Memoization 内存存储

节约内存

    @Test
    public void test7() {
        Function0<Double> hashCache =
                Function0.of(Math::random).memoized();
        double randomValue1 = hashCache.apply();
        double randomValue2 = hashCache.apply();
        //这里两个输出的值一致,randomValue1时产生之后就已缓存,第二次调用直接获取缓存值
        System.out.println(randomValue1);
        System.out.println(randomValue2);
        Function2<Integer,Integer,Integer> sum=(a, b) -> a + b;
        Function2<Integer, Integer, Integer> function2 = sum.memoized();
        Integer num1 = function2.apply(128, 136);
        Integer num2 = function2.apply(128, 136);
        System.out.println(num1==num2);
        //true
        Integer num3 = sum.apply(128, 136);
        Integer num4 = sum.apply(128, 136);
        System.out.println(num3==num4);
        //false

    }

4 API.Match (switch)

在Vavr中,通过Match方法替换switch块。

import io.vavr.API;
import org.junit.Test;
/**
 * 在Vavr中,通过Match方法替换switch块。
 * 每个条件检查都通过Case方法调用来替换。
 * $()来替换条件并完成表达式计算得到结果。
 *
 * @author : lyn
 * 技术点 :
 * @date : 2022-08-09 21:53
 */
public class MatchTest {
    /**
     * 等同于switch语句,最后一个相当于default
     * 1 用途:返回vo时将数字处理成对应的汉字
     */
    @Test
    public void test1() {
        int num = 3;
        String result = API.Match(num).of(
                API.Case(API.$(1), "one"),
                API.Case(API.$(2), "two"),
                API.Case(API.$(3), "three"),
                API.Case(API.$(), "其他")
        );
        System.out.println(result);

        //等同于java的switch语句
        String op = null;
        switch (num) {
            case 1:
                op = "one";
                break;
            case 2:
                op = "two";
                break;
            case 3:
                op = "three";
                break;
            default:
                op = "其他";
        }
        System.out.println(op);
    }

    /**
     * 类似switch 执行不同的逻辑,可能太过繁琐,需要定义很多方法
     * 优点: 清晰
     */
    @Test
    public void test2() {
        int num = 3;
        String result = API.Match(num).of(
                API.Case(API.$(1), t -> method1(t)),
                API.Case(API.$(2), t -> method2()),
                API.Case(API.$(3), method3()),
                API.Case(API.$(), method())
        );

    }

    private String method() {
        //逻辑其他
        return null;
    }

    private String method1(Integer num) {
        //逻辑 1
        return null;
    }

    private String method2() {
        //逻辑 2
        return null;
    }

    private String method3() {
        //逻辑 3
        return null;
    }

    /**
     * 3 类似使用switch执行不同的逻辑,避免了定义很多方法
     */
    @Test
    public void test3() {
        int num = 3;
        String result = API.Match(num).of(
                API.Case(API.$(1), () -> {
                    System.out.println("ijij");
                    //必须有返回值
                    return "";
                }),
                API.Case(API.$(2), t -> {
                    System.out.println(t);
                    return "two";
                }),
                API.Case(API.$(3), () -> {
                    throw new RuntimeException("抛出异常");
                }),
                API.Case(API.$(), method())
        );

    }
}

5 其他

用处极小

5.1 Lazy 惰性加载

Lazy表示一个延迟计算的值,计算会被推迟,直到需要时才计算。此外,计算的值会被缓存或存储起来,当需要时被返回,而不需要重新计算,具体如下:

import io.vavr.Lazy;
import org.junit.Test;

/**
 * Lazy 惰性加载
 *
 * Lazy表示一个延迟计算的值,计算会被推迟,直到需要时才计算。
 * 此外,计算的值会被缓存或存储起来,当需要时被返回,而不需要重新计算
 * @author : lyn
 * @date : 2022-08-15 21:19
 */
@SuppressWarnings("all")
public class LazyTest {
    @Test
    public void test1() {
        Lazy<Double> lazy = Lazy.of(Math::random);
        System.out.println(lazy.isEvaluated());  // = false
        lazy.get();         // = 0.123 (random generated)
        System.out.println(lazy.isEvaluated()); // = true
        lazy.get();         // = 0.123 (memoized)
    }

}

5.2 Either 两者之一

/**
 * Either 两者之一
 * 有什么用???
 *
 * @author : lyn
 * @date : 2022-08-15 21:19
 */
@SuppressWarnings("all")
public class EitherTest {
    @Test
    public void test1() {
        Function<Integer, Either<Integer, Integer>> function =
                i -> i > 0 ? Either.right(i) : Either.left(-100);
        Either<Integer, Integer> either = function.apply(100);
        System.out.println(either.map(r -> r * 100).get());

        //等效于
        Integer num = new Random().nextInt(10)-5;
        System.out.println(num);
       if (num<=0){
           num=-100;
       }
        System.out.println(num * 100);

    }

}

更多见参考文档地址1: Vavr - Java8函数式编程拓展库使用指南

code地址: https://gitee.com/li-yanning/concise-code

标签:vavr,System,元组,API,文档,使用,println,public,out
From: https://www.cnblogs.com/lyn8100/p/16564491.html

相关文章

  • JVM查看内存使用状况
    1、jps:查看本地正在运行的java进程和进程ID(pid)2、jinfopid,查看指定pid的所有JVM信息1)jinfo-flagspid查询虚拟机运行参数信息。2)jinfo-flagnamepid,查询......
  • python教程:一个 list 使用 for 遍历,边循环边删除的问题
    今天由于要对一个list数据类型写一个循环删除的程序(这是小编第一次对于list操作),但发现一个奇异问题,来,我们来看看代码跟效果:#初始化一个list列表,为了下边的方便比较......
  • nodejs环境下使用redis(基础入门)
    redis-server--service-start 启动redis服务winptyredis-cli进入redis-cli,可查看存入的数据redis环境配好之后,先[email protected]安装nodejs环境下的redis库......
  • git pull 的使用
    gitpull的使用如果这个项目以前提交到远程仓库过,然后在其他电脑修改之后,上传到了远程仓库.当我想要把远程仓库的代码拉去到本地,就是使用这个命令......
  • DOM4J使用XPath解析含有xmlns的xml文档
    一、没有引入Shema约束的XML文档<?xmlversion="1.0"encoding="UTF-8"?><书架><书><书名>JavaWeb开发大全</书名><作者>班长</作者>......
  • shallowRef和shallowReactive使用误区-视图更新了
    按照vue3文档中得说明,在使用shallowRef和shallowReactive是浅响应得,即修改深层数据视图应该是不更新得,但是使用过程中往往会出现视图更新得情况,如下:修改前:    ......
  • mybatis_3_使用xml构建SqlSeesionFactory
    使用xml构建SqlSeesionFactory,分为两步:第一步:创建一个XML配置文件;第二步:创建SqlSessionFactory实例;示例:第一步:创建mybatis-config2.xml文件<?xmlversion="1.0"enco......
  • sessionStorage的使用
    //保存数据到sessionStoragesessionStorage.setItem('key','value');//从sessionStorage获取数据letdata=sessionStorage.getItem('key');//从sessionSto......
  • 经纬恒润激光雷达集成系统全面提升激光雷达的使用体验
    汽车自动驾驶系统通常可分为感知层、决策层、执行层,以激光雷达、摄像头为代表的传感器是自动驾驶感知层不可或缺的组成部分,但在传感器整车集成方面,主机厂却面临着几大痛点:......
  • 使用iterator调用map中的(first)键和(second)值
    #include<iostream>#include<string>#include<map>usingnamespacestd;intmain(){//c++里面的map容器的迭代器里面有个first和second,分别指向键值和数......