JDK8的api文档 完整版

1、JAVA API(Java Application Interface)是JAVA的应用编程接口。作为Sun开发的Java程序，用于Java编程人员使用的程序接口，并不是说使用Java和接口有关，而是表示Java所提供的现成的类库，供编程人员使用。这与 Win32 中的 dll 文件有点像，封装了好多函数，只暴露也函数名、参数等信息，不提供具体实体，暴露出来的这些就称为API了。也就是说 Java 也是封装了好多的方法，提供了些方法名和参数等信息，便于别人使用啊。

2、JAVA API文档提供了很多官方的介绍和类、方法、变量的解释。一般很系统，涉及所有的方面，如果开发人员对正在使用的类不熟悉，想查看类里面的变量或者方法，就可以打开JavaAPI文档进行阅读和查看。很多开发语言都提供了官方的文档，可以让开发人员迅速地提高能力。

3、简单的讲，API就是一个帮助文档，让您能快速了解java的属性，方法。API就像学汉字时候的汉语字典一样，编程的时候需要用到的基本类都在API里面存在了，并且随着时间的推移，这些类的数量会越来越多。

一、分类

1、时间对象

TemporalAccessor: 顶级接口
Temporal: 子接口，继承TemporalAccessor接口
Era: 子接口，继承TemporalAccessor接口
Instant: 时间戳，有时区（UTC时区），实现Temporal、TemporalAdjuster接口
LocalDate: 日期，无指定时区，实现Temporal、TemporalAdjuster接口
LocalTime: 时间，无指定时区，实现Temporal、TemporalAdjuster接口
LocalDateTime: 日期时间，无指定时区，实现Temporal、TemporalAdjuster接口
OffsetTime: 偏移后时间，无指定时区，实现Temporal、TemporalAdjuster接口
OffsetDateTime: 偏移后日期时间，无指定时区，实现Temporal、TemporalAdjuster接口
ZonedDateTime: 时区日期时间，无指定时区，实现Temporal、TemporalAdjuster接口

2、时区、偏移量

ZoneId: 时区
ZoneOffset: 时区偏移量

3、工具类

TemporalAdjuster: 功能型接口
TemporalAdjusters: 工具类，每个方法中生成一个匿名类，实现了TemporalAdjuster接口

// 下一个周几
public static TemporalAdjuster next(DayOfWeek dayOfWeek) {
    int dowValue = dayOfWeek.getValue();
    return (temporal) -> {
        int calDow = temporal.get(DAY_OF_WEEK);
        int daysDiff = calDow - dowValue;
        return temporal.plus(daysDiff >= 0 ? 7 - daysDiff : -daysDiff, DAYS);
    };
}

// 下一个周一时间
LocalDate ld = LocalDate.now();
System.out.println("LocalDate: " + ld);
ld = ld.with(TemporalAdjusters.next(DayOfWeek.MONDAY));
System.out.println("LocalDate next TUESDAY: " + ld);

// LocalDate: 2019-12-30
// LocalDate next MONDAY: 2020-01-06

// with方法内部调用了匿名类的adjustInto方法
public LocalDate with(TemporalAdjuster adjuster) {
    // optimizations
    if (adjuster instanceof LocalDate) {
        return (LocalDate) adjuster;
    }
    return (LocalDate) adjuster.adjustInto(this);
}