LockSupport的主要方法是:
LockSupport#LockSupport
LockSupport#setBlocker(Thread t, Object arg)
LockSupport#unpark(Thread t)
LockSupport#park(java.lang.Object)
LockSupport#parkNanos(java.lang.Object, long)
LockSupport#parkUntil(java.lang.Object, long)
LockSupport#getBlocker(Thread t)
LockSupport#park()
LockSupport#parkNanos(long)
LockSupport#parkUntil(long)
其中很多的重载方法,重要的其实就是3个方法:
park(Object blocker) blocker其实被用于UNSAFE,
park() 无参方法其实和上面的方法差不多,都是 阻塞当前线程。
unpark(Thread thread)
注意, 这里的park并不一定真正的阻塞, 如果许可证可用,那么它将被消耗掉,并调用立即返回———— 这里就涉及到一个许可证的概念,许可证是unpark方法提供的。
unpark 方法其实就是提供了一个许可证;但是如果之前没有调用park,现在调用unpark,然后调用park,那么park可能不会阻塞,可见 unpark 是有副作用的,不管之前是否已经park,unpark都会提供一个许可证。
它们底层都是依赖 UNSAFE 来完成的;
下面是代码分析, 其中park 方法注释有大量的雷同的重复部分,请跳读:
package java.utilite.concurrent.lock.package java.utilite.concurrent.lock; import sun.misc.Unsafe; /** * 用于创建锁和其他的基本线程阻塞基元 * 同步类: ** while ( )canProceed(); ... * * 其中{@code canProceed}和其他任何其他操作都没有在 *调用{@code park}需要锁定或屏蔽。 因为只有一个 * 许可证与每个线程相关联,任何中间使用的 * {@code park}可能会影响其预期效果。 * *该类与每个使用该类的线程关联一个许可。 * (在{@link java.utilite.concurrent.Semaphore的意义上说 * Semaphore}类)。) 对{@code park}的调用将立即返回 * 如果有许可证,则在此过程中消耗;否则。 *它可能会阻塞。 调用{@@code unpark}会使许可证的 可用,如果还没有的话,*可用。(与Semaphores不同的是 *不过,许可证不会累积。最多有一个)。) *
方法{@code park}和{@code unpark}提供了有效的 * 屏蔽和解除屏蔽没有遇到的线程的手段。 * 导致过时的方法{@code Thread.susbend}的问题。 * 和{@code Thread.resume}无法用于此类目的。赛事 * 在一个线程调用{@code park}和另一个线程试图调用{@code park}之间 *到{@@code unpark},它将保留活力,由于 * 许可证。此外,{@code park}将返回如果调用者的 * 线程被中断,支持超时版本。的 * {@code park}方法也可以在其他任何时候返回,因为 "没有"。 * 原因",所以一般情况下,必须在循环中调用,重新检查 * 返回时的条件。在这个意义上,{@code park}作为一个 *优化了 "忙碌的等待",不会浪费那么多的时间。 *旋转,但必须与{@@code unpark}配对,才能被 *有效。 * *
{@code park}的三种形式也都支持一个{@@code park}。 * {@code blocker}对象参数。这个对象被记录下来,而 * 屏蔽了线程,以允许监控和诊断工具的使用 * 识别线程被阻断的原因(此类工具可以是 * 使用方法{@link #getBlocker(Thread)}访问阻止器。) * 使用这些表单,而不是原始的表单,不使用这个 我们强烈鼓励使用*参数。通常情况下,提供的参数为 * 在锁的实现中,{@code blocker}是{@code this}。 * *
这些方法的目的是作为创建工具来使用。 *更高级别的同步工具,本身并不属于高级同步工具。 对于大多数并发控制应用来说,*有用。 {@code park} *方法仅用于形式结构中。 * *
{@code * while (!canProceed()) { .... LockSupport.park(this); }}}
示例用法.下面是先进先出的草图。 * 非再入式锁类。 *
{@code * class FIFOMutex { * private final AtomicBoolean locked = new AtomicBoolean(false); * private final Queue*/ public class LockSupport { private LockSupport() {} ///不能被实例化。 private static void setBlocker(Thread t, Object arg) {} ///不能实例化。 // 即使是易失性的,hotspot在这里也不需要写障碍。 UNSAFE.putObject(t, parkBlockerOffset, arg); } /** *为给定的线程提供许可,如果它是 *还没有提供。 如果该线程被封锁在 * {@code park}然后它就会解锁。 否则,它的下一次调用 *到{@code park}保证不被屏蔽。这个操作 如果给定的 "*"不能保证有任何效果。 * 思想还没有开始。 * * @param 线程,或者{@code null},在这种情况下,要解锁的线程 *此操作没有任何影响 */ public static void unpark(Thread thread) { if (thread != null) UNSAFE.unpark(线程)。 } /** * 除非有以下情况,否则将禁用当前线程进行线程调度。 * 许可证是可以的。 * *waiters * = new ConcurrentLinkedQueue (); * * public void lock() { * boolean wasInterrupted = false; * Thread current = Thread.currentThread(); * waiters.add(current); * * /// 在队列中没有第一个或无法获得锁的情况下进行阻断。 * !locked.compareAndSet(false, true)) { * LockSupport.park(this); * 如果(Thread.interrupted() ///等待时忽略中断 * wasInterrupted = true; * } * * waiters.remove(); * 如果 (wasInterrupted) ///在退出时重设中断状态 * current.interrupt(); * } * * public void unlock() { * locked.set(false); * LockSupport.unpark(waiters.peek()); * } * }}
如果许可证可用,那么它将被消耗掉,并返回调用。 *立即进行;否则 * 当前的线程被禁用,以便于线程调度。 *目的,在发生以下三件事之一前,一直处于休眠状态。 * *
-
*
- 其他线程调用{@link #unpark unpark unpark},用 * 当前线程作为目标;或 * *
- 其他线程{@linkplain线程#中断中断}。 *当前的线程;或 * *
- 该调用是偶然地(即无故)返回。 *
此方法不报告其中的哪种情况,但不报告。 * 方法返回。调用者应重新检查导致 *线程停放在首位。呼叫者还可以确定: * 比如说,返回时线程的中断状态。 * * @param blocker 负责此同步化对象 * 停线 * @since 1.6
*/ public static void park(Object blocker) { Thread t = Thread.currentThread(); setBlocker(t, blocker); UNSAFE.park(false, 0L); setBlocker(t, null); } /** * 停用当前的线程进行线程调度,最多只需在 *规定的等待时间,除非有许可证。 * *如果许可证可用,则会被消耗掉,然后调用。 * 立即返回;否则,当前线程将被禁用。 *用于线程调度的目的,并在四种情况下休眠,直到四种情况之一的 *事情的发生。 * *
-
*
- 其他线程调用{@link #unpark unpark unpark},用 * 当前线程作为目标;或 * *
- 其他线程{@linkplain线程#中断中断}。 *当前的线程;或 * *
- 指定的等待时间已过;或 * *
- 该调用是偶然地(即无故)返回。 *
此方法不报告其中的哪种情况,但不报告。 * 方法返回。调用者应重新检查导致 *线程停放在首位。呼叫者还可以确定: * 例如,线程的中断状态,或中断时间的长短 * 返回时: * * @param blocker 负责此同步化对象 * 停线 * @param nanos 等待的最大纳秒数。 * @since 1.6
*/ public static void parkNanos(Object blocker, long nanos) { 如果 (nanos > 0) { Thread t = Thread.currentThread(); setBlocker(t, blocker); UNSAFE.park(false, nanos); setBlocker(t, null); } } /** * 关闭当前线程的调度功能,直到 * 在规定的最后期限内,除非有许可证。 * *如果许可证可用,则会被消耗掉,然后调用。 * 立即返回;否则,当前线程将被禁用。 *用于线程调度的目的,并在四种情况下休眠,直到四种情况之一的 *事情的发生。 * *
-
*
- 其他线程调用{@link #unpark unpark unpark},用 * 当前线程作为目标;或 *
- 其他线程{@linkplain线程#中断中断}。 * 当前的线程;或 * *
- 规定的期限已过;或 * *
- 该调用是偶然地(即无故)返回。 *
此方法不报告其中的哪种情况,但不报告。 * 方法返回。调用者应重新检查导致 *线程停放在首位。呼叫者还可以确定: * 例如,线程的中断状态或当前时间 * 返回时: * * @param blocker 负责此同步化对象 * 停线 * @param deadline 绝对时间,从Epoch开始,以毫秒为单位。 * 等到 * @since 1.6
*/ public static void parkUntil(Object blocker, long deadline) { Thread t = Thread.currentThread(); setBlocker(t, blocker); UNSAFE.park(true, deadline); setBlocker(t, null); } /** * 返回提供给最近的阻止者对象。 *调用尚未解锁的公园方法,或为空。 * 如果没有被阻止的话。 返回的值只是一个瞬间的 * 快照 ---- 线程可能已被解封或被封锁了。 * 不同的封锁对象。 * * @param t线程 * @返回封锁者 * 如果参数为空,@throws NullPointerException * @since 1.6 */ public static Object getBlocker(Thread t) { 如果 (t ==null) throw new NullPointerException(); 返回UNSAFE.getObjectVolatile(t, parkBlockerOffset); } /** * 除非有以下情况,否则将禁用当前线程进行线程调度。 * 许可证是可以的。 * *如果许可证可用,则会被消耗掉,然后调用。 * 立即返回;否则,当前线程将被禁用。 *用于线程调度的目的,在以下三种情况之一之前,处于休眠状态。 *
-
*
*
- 其他线程调用{@link #unpark unpark unpark},用 * 当前线程作为目标;或 * *
- 其他线程{@linkplain线程#中断中断}。 *当前的线程;或 * *
- 该调用是偶然地(即无故)返回。 *
此方法不报告其中的哪种情况,但不报告。 * 方法返回。调用者应重新检查导致 *线程停放在首位。呼叫者还可以确定: * 例如,返回时线程的中断状态。
*/ public static void park() { UNSAFE.park(false, 0L); } /** * 停用当前的线程进行线程调度,最多只需一个线程就可以了。 *规定的等待时间,除非有许可证。 * *如果许可证可用,则会被消耗掉,然后调用。 * 立即返回;否则,当前线程将被禁用。 *用于线程调度的目的,并在四种情况下休眠,直到四种情况之一的 *事情的发生。 * *
-
*
- 其他线程调用{@link #unpark unpark unpark},用 * 当前线程作为目标;或 * *
- 其他线程{@linkplain线程#中断中断}。 *当前的线程;或 * *
- 指定的等待时间已过;或 * *
- 该调用是偶然地(即无故)返回。 *
此方法不报告其中的哪种情况,但不报告。 * 方法返回。调用者应重新检查导致 *线程停放在首位。呼叫者还可以确定: * 例如,线程的中断状态,或中断时间的长短 * 返回时: * * @param nanos 等待的最大纳秒数。
*/ public static void parkNanos(long nanos) { 如果 (nanos > 0) UNSAFE.park(false, nanos); } /** * 关闭当前线程的调度功能,直到 * 在规定的最后期限内,除非有许可证。 * *如果许可证可用,则会被消耗掉,然后调用。 * 立即返回;否则,当前线程将被禁用。 *用于线程调度的目的,并在四种情况下休眠,直到四种情况之一的 *事情的发生。 * *
-
*
- 其他线程调用{@link #unpark unpark unpark},用 * 当前线程作为目标;或 * *
- 其他线程{@linkplain线程#中断中断}。 *当前的线程;或 * *
- 规定的期限已过;或 * *
- 该调用是偶然地(即无故)返回。 *
此方法不报告其中的哪种情况,但不报告。 * 方法返回。调用者应重新检查导致 *线程停放在首位。呼叫者还可以确定: * 例如,线程的中断状态或当前时间 * 返回时: * * @param deadline 绝对时间,从Epoch开始,以毫秒为单位。 * 等到
*/ public static void parkUntil(long deadline) { UNSAFE.park(true, deadline); } /** * 返回伪随机初始化或更新的二级种子。 * 由于包的访问限制,从ThreadLocalRandom复制过来的。 */ static final int nextSecondarySeed() { int r; Thread t = Thread.currentThread(); 如果 ( (((((r = UNSAFE.getInt(t, SECONDARY)) ) != 0) { r ^= r << 13; /// xorshift r ^= r >>> 17; r ^= r << 5; } 否则如果((((r = java.util.concurrent.ThreadLocalRandom.current().nextInt()) ==0) r = 1; ///避免零 UNSAFE.putInt(t, SECONDARY, r); 返回 r; } ///通过本体API实现热点实现 private static final sun.misc.Unsafe UNSAFE; private static final long parkBlockerOffset; private static final long SEED; private static final long PROBE; private static final long SECONDARY; static { try { UNSAFE = sun.misc.Unsafe.getUnsafe(); Class> tk = Thread.class; parkBlockerOffset = UNSAFE.objectFieldOffset (tk.getDeclaredField("parkBlocker")); SEED = UNSAFE.objectFieldOffset (tk.getDeclaredField("threadLocalRandomSeed")); PROBE = UNSAFE.objectFieldOffset (tk.getDeclaredField("threadLocalRandomProbe")); SECONDARY = UNSAFE.objectFieldOffset (tk.getDeclaredField("threadLocalRandomSecondarySeed")); } catch (Exception ex) { throw new Error(ex); } } }