鸿蒙OS ConditionHelper

ConditionHelper

java.lang.Object

|—ohos.utils.ConditionHelper

public class ConditionHelper
extends Object

一个帮助类,用于使用 java.util.concurrent.locks 包中内置的 Condition 类,而不处理 Lock 和 java.lang.InterruptedException 异常。

ConditionHelper 对象提供用于挂起线程(使其等待)或唤醒等待线程的接口。 它支持无限等待或定时等待。 线程在被唤醒或经过指定的等待时间后才会退出等待状态。

使用 ConditionHelper 类时要注意以下几点:

  • 如果线程被唤醒后不重置唤醒状态,下次调用ConditionHelper#await或ConditionHelper#await(long awaitMs)方法时会立即返回执行结果。
  • ConditionHelper#await(long awaitMs) 方法不能确保精确计时。
  • 如果在等待期间发生 java.lang.InterruptedException 异常,等待状态不会终止。 线程被唤醒或等待时间过去后,可以使用 Thread.currentThread().isInterrupted() 来检查线程是否被中断。

构造函数摘要

构造函数 描述
ConditionHelper() 用于创建具有默认唤醒状态 false 的 ConditionHelper 实例的构造函数。
ConditionHelper(boolean isWakeup) 用于创建具有指定唤醒状态的 ConditionHelper 实例的构造函数。

方法总结

修饰符和类型 方法 描述
void await() 挂起当前线程,直到它被唤醒。
boolean await(long awaitMs) 暂停当前线程,直到它被唤醒或等待时间过去。
void resetCondition() 将唤醒状态重置为 false,然后您可以调用 await()。
void wakeup() 唤醒当前对象的线程并将其唤醒状态设置为 true。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

ConditionHelper

public ConditionHelper()

用于创建具有默认唤醒状态 false 的 ConditionHelper 实例的构造函数。

ConditionHelper

public ConditionHelper(boolean isWakeup)

用于创建具有指定唤醒状态的 ConditionHelper 实例的构造函数。

参数:

参数名称 参数描述
isWakeup 指示要设置的唤醒状态。 true表示线程被唤醒,false表示线程未被唤醒。

方法详情

wakeup

public void wakeup()

唤醒当前对象的线程并将其唤醒状态设置为 true。

如果没有调用resetCondition()重置唤醒状态,下次调用await()或await(long awaitMs)方法时会立即返回执行结果。

resetCondition

public void resetCondition()

将唤醒状态重置为 false,然后您可以调用 await()。

await

public void await()

挂起当前线程,直到它被唤醒。

如果对象的唤醒状态为 true,则立即返回该方法的执行结果。

如果发生 java.lang.InterruptedException 异常,当前线程继续等待,直到被唤醒。 唤醒后,可以使用 Thread.currentThread().isInterrupted() 来检查线程是否被中断。

await

public boolean await(long awaitMs)

暂停当前线程,直到它被唤醒或等待时间过去。

如果对象的唤醒状态为 true,则立即返回该方法的执行结果。

如果发生 java.lang.InterruptedException 异常,当前线程继续等待。 线程被唤醒或等待时间过去后,可以使用 Thread.currentThread().isInterrupted() 来检查线程是否被中断。

请注意,此方法无法确保精确的时序,因为它使用系统时钟。 如果系统时钟发生变化,可能会影响时序精度。

参数:

参数名称 参数描述
awaitMs 表示等待时间,以毫秒为单位。 如果此参数设置为 0,则线程保持等待。

返回:

如果线程等待被唤醒,则返回 true; 如果线程一直等到等待时间过去,则返回 false。

版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS ConditionHelper》
文章链接:https://zhuji.vsping.com/313985.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。