七个枚举
- NANOSECONDS 纳秒
- MICROSECONDS 微妙
- MILLISECONDS 毫秒
- SECONDS 秒
- MINUTES 分
- HOURS 小时
- DAYS 天
1秒=1,000毫秒=1,000,000微妙=1,000,000,000纳秒
枚举内部API
传入的参数long d 的单位是单前枚举,比如NANOSECONDS,那么d的单位就是纳秒
- toNanos 纳秒转纳秒,直接返回。
- toMicros 纳秒转毫秒,除以1000。直到toDays,都是同样的道理。
- convert 返回的结果的单位就是当前枚举,long d 的单位就是u的枚举类型
- excessNanos 特殊,后面会讲
枚举API
如图,这些方法只能内部去自己实现,不然就抛出异常。不过也调用不了。无需在意。
三个通用的方法(因为7个枚举类都通用)
- void timedWait(Object obj, long timeout) 底层是调用obj.wait方法,单位为单前枚举类型
- void timedJoin(Thread thread, long timeout) 底层是调用thread.join方法,单位为单前枚举类型
- void sleep(long timeout) 底层是调用Thread.sleep方法 ,单位为单前枚举类型
public void timedWait(Object obj, long timeout)
throws InterruptedException {
if (timeout > 0) {
//转化为毫秒
long ms = toMillis(timeout);
//计算纳秒
int ns = excessNanos(timeout, ms);
obj.wait(ms, ns);
}
}
public void timedJoin(Thread thread, long timeout)
throws InterruptedException {
if (timeout > 0) {
//转化为毫秒
long ms = toMillis(timeout);
//计算纳秒
int ns = excessNanos(timeout, ms);
thread.join(ms, ns);
}
}
//睡眠指定时间
public void sleep(long timeout) throws InterruptedException {
if (timeout > 0) {
//转化为毫秒
long ms = toMillis(timeout);
//计算纳秒,当睡眠的精度低于毫秒,就要计算这个纳秒。
int ns = excessNanos(timeout, ms);
//睡眠多少毫秒。
Thread.sleep(ms, ns);
}
}
excessNanos 方法
excessNanos方法官方API注释翻译:
计算wait、sleep、join的超纳秒参数的工具。
还是很懵,先看看Thread.sleep方法。
Thread.sleep(long millis, int nanos)方法
//方法使当前执行的线程睡眠指定的毫秒数加纳秒指定数量,受制于精度和系统计时器和调度程序精度。
public static void sleep(long millis, int nanos)
throws InterruptedException {
if (millis < 0) {
throw new IllegalArgumentException("timeout value is negative");
}
if (nanos < 0 || nanos > 999999) {
throw new IllegalArgumentException(
"nanosecond timeout value out of range");
}
//也就是当nanos大于等于500微秒时,millis就加1.当nanos小于500微秒时,不改变millis的值.
//当millis的值为0时,只要nanos不为0,就将millis设置为1.
if (nanos >= 500000 || (nanos != 0 && millis == 0)) {
millis++;
}
//可以看出,睡眠的最小单位为millis
sleep(millis);
}
所以,当睡眠的时间单位小于毫秒级别(微秒,纳秒),那么就要计算它的纳秒数,是为了使sleep方法更精确。Thread.join(ms, ns) 和 Object.wait(ms, ns)同理。
excessNanos的意义
NANOSECONDS {
//....忽略其他API
//c2是1,000,000
//参数的单位:d是纳秒,m是毫秒
int excessNanos(long d, long m) { return (int)(d - (m*C2)); }
},
MICROSECONDS {
//....忽略其他API
//c1 是1000 c2是1,000,000
//参数的单位:d是微秒,m是毫秒
int excessNanos(long d, long m) { return (int)((d*C1) - (m*C2)); }
},
//其他枚举该方法都是直接return 0。
//因为当单位大于等于毫秒,就可以忽略掉这点时间,因为单位大于等于毫秒,那点纳秒精确度可以忽略不计。
所以,这就是excessNanos方法的意义。
- 其中,为什么大于毫秒的单位,excessNanos方法都是返回0呢?
- 因为当单位大于等于毫秒,就可以忽略掉这点时间,因为单位大于等于毫秒,那点纳秒精确度可以忽略不计。