Add a note about Thread.Factory for Java 21+ users. See #7427

RELNOTES=n/a PiperOrigin-RevId: 685860825
google · Oct 14, 2024 · 77243d6 · 77243d6
1 parent 9be5c72
commit 77243d6
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 0 deletions.
diff --git a/android/guava/src/com/google/common/util/concurrent/ThreadFactoryBuilder.java b/android/guava/src/com/google/common/util/concurrent/ThreadFactoryBuilder.java
@@ -42,6 +42,10 @@
  * <p>If no backing thread factory is provided, a default backing thread factory is used as if by
  * calling {@code setThreadFactory(}{@link Executors#defaultThreadFactory()}{@code )}.
  *
+ * <p><b>Java 21+ users:</b> consider using the {@code Thread.Builder} interface instead. E.g.,
+ * instead of {@code new ThreadFactoryBuilder().setPriority(priority).setDaemon(false).build()}, use
+ * {@code Thread.ofPlatform().priority(priority).daemon(false).factory()}.
+ *
  * @author Kurt Alfred Kluever
  * @since 4.0
  */

diff --git a/guava/src/com/google/common/util/concurrent/ThreadFactoryBuilder.java b/guava/src/com/google/common/util/concurrent/ThreadFactoryBuilder.java
@@ -42,6 +42,10 @@
  * <p>If no backing thread factory is provided, a default backing thread factory is used as if by
  * calling {@code setThreadFactory(}{@link Executors#defaultThreadFactory()}{@code )}.
  *
+ * <p><b>Java 21+ users:</b> consider using the {@code Thread.Builder} interface instead. E.g.,
+ * instead of {@code new ThreadFactoryBuilder().setPriority(priority).setDaemon(false).build()}, use
+ * {@code Thread.ofPlatform().priority(priority).daemon(false).factory()}.
+ *
  * @author Kurt Alfred Kluever
  * @since 4.0
  */