Java 23 ：有何新變化？

最終，JEP 所有者必須決定預(yù)覽功能的命運(yùn)。如果決定移除預(yù)覽功能，那么所有者必須在 JBS 中提交一個(gè)問題，以便在下次 JDK 功能發(fā)布中移除該功能；無需新的 JEP。

這里就是這么做的。

long l =...;
switch (l) {
    case 1L              ->...;
    case 2L              ->...;
    case 10_000_000_000L ->...;
    default ->...;
}

if (i instanceof byte) {  // i 的值適合存儲(chǔ)在一個(gè)字節(jié)中
   ... (byte)i...       // 需要傳統(tǒng)的強(qiáng)制類型轉(zhuǎn)換
}

switch (x.getStatus()) {
    case 0 -> "okay";
    case 1 -> "warning";
    case 2 -> "error";
    case int i -> "unknown status: " + i;
}

switch (x.getStatus()) {
    case 0 -> "okay";
    case 1 -> "warning";
    case int i when i > 1 && i < 100 -> "client error: " + i;
    case int i when i > 100 -> "server error: " + i;
}

if (i instanceof byte b) {
   ... b...
}

// JSON 沒有區(qū)分整數(shù)和雙精度數(shù)，所以 JSON 數(shù)字應(yīng)該是雙精度數(shù)。
record JsonNumber(double number) implements JsonValue { }
var number = new JsonNumber(30);
// 以前我們只能通過其確切的組件類型（long）來解構(gòu)這個(gè)記錄，
// 現(xiàn)在我們可以解構(gòu)并匹配不同的基本類型
if (json instanceof JsonObject(int number)) {
    //...
}

/**
 * 返回對(duì)象的哈希碼值。此方法是為了哈希表（如由{@link java.util.HashMap}提供的那些）的利益而支持的。
 * <p>
 * {@code hashCode}的一般約定是：
 * <ul>
 * <li>在 Java 應(yīng)用程序的一次執(zhí)行過程中，每當(dāng)對(duì)同一對(duì)象多次調(diào)用它時(shí)，只要在對(duì)象的{@code equals}比較中使用的信息沒有被修改，{@code hashCode}方法就必須始終返回相同的整數(shù)。這個(gè)整數(shù)在同一應(yīng)用程序的不同執(zhí)行之間不需要保持一致。</li>
 * <li>如果根據(jù){@link #equals(Object)}方法兩個(gè)對(duì)象相等，那么對(duì)這兩個(gè)對(duì)象中的每一個(gè)調(diào)用{@code hashCode}方法必須產(chǎn)生相同的整數(shù)結(jié)果。</li>
 * <li>如果根據(jù){@link #equals(Object)}方法兩個(gè)對(duì)象不相等，那么對(duì)這兩個(gè)對(duì)象中的每一個(gè)調(diào)用{@code hashCode}方法并不要求必須產(chǎn)生不同的整數(shù)結(jié)果。然而，程序員應(yīng)該意識(shí)到，為不相等的對(duì)象產(chǎn)生不同的整數(shù)結(jié)果可能會(huì)提高哈希表的性能。</li>
 * </ul>
 *
 * @implSpec
 * 在合理可行的范圍內(nèi)，由類{@code Object}定義的{@code hashCode}方法為不同的對(duì)象返回不同的整數(shù)。
 *
 * @return 這個(gè)對(duì)象的哈希碼值。
 * @see     java.lang.Object#equals(java.lang.Object)
 * @see     java.lang.System#identityHashCode
 */

用 Markdown 可以這樣寫：

/// 返回對(duì)象的哈希碼值。此方法是為了哈希表（如由[java.util.HashMap]提供的那些）的利益而支持的。
///
/// `hashCode`的一般約定是：
///
///   - 在 Java 應(yīng)用程序的一次執(zhí)行過程中，每當(dāng)對(duì)同一對(duì)象多次調(diào)用它時(shí)，只要在對(duì)象的`equals`比較中使用的信息沒有被修改，`hashCode`方法就必須始終返回相同的整數(shù)。這個(gè)整數(shù)在同一應(yīng)用程序的不同執(zhí)行之間不需要保持一致。
///   - 如果根據(jù)[equals][#equals(Object)]方法兩個(gè)對(duì)象相等，那么對(duì)這兩個(gè)對(duì)象中的每一個(gè)調(diào)用`hashCode`方法必須產(chǎn)生相同的整數(shù)結(jié)果。
///   - 如果根據(jù)[equals][#equals(Object)]方法兩個(gè)對(duì)象不相等，那么對(duì)這兩個(gè)對(duì)象中的每一個(gè)調(diào)用`hashCode`方法并不要求必須產(chǎn)生不同的整數(shù)結(jié)果。然而，程序員應(yīng)該意識(shí)到，為不相等的對(duì)象產(chǎn)生不同的整數(shù)結(jié)果可能會(huì)提高哈希表的性能。
///
/// @implSpec
/// 在合理可行的范圍內(nèi)，由類`Object`定義的`hashCode`方法為不同的對(duì)象返回不同的整數(shù)。
///
/// @return 這個(gè)對(duì)象的哈希碼值。
/// @see     java.lang.Object#equals(java.lang.Object)
/// @see     java.lang.System#identityHashCode

• 階段 1：在 Java 23（這個(gè) JEP）中棄用。
• 階段 2：在 Java 24 或 25 中如果在運(yùn)行時(shí)使用則記錄警告。
• 階段 3：在 Java 26 或更高版本中默認(rèn)拋出異常（行為可通過命令行選項(xiàng)修改）。
• 階段 4 和 5：在 Java 26 之后移除這些方法（先移除堆上內(nèi)存訪問方法，然后移除堆外內(nèi)存訪問方法）。

• 用語句import java.util.*;導(dǎo)入一個(gè)包中的所有類。
• 用語句import java.util.Map;導(dǎo)入單個(gè)類。
• 用語句import static org.junit.jupiter.api.Assertions.*;導(dǎo)入一個(gè)類的所有靜態(tài)方法和變量。
• 用語句import static org.junit.jupiter.api.Assertions.assertTrue;導(dǎo)入單個(gè)靜態(tài)方法或變量。

• JEP 466—— 類文件 API：第二次預(yù)覽，用于解析、生成和轉(zhuǎn)換 Java 類文件的標(biāo)準(zhǔn) API。根據(jù)用戶反饋進(jìn)行了改進(jìn)。在 Java 23 中，JDK 繼續(xù)向使用這個(gè)新 API 遷移。
• JEP 469—— 向量 API：第八次孵化，用于表示向量計(jì)算的 API，在運(yùn)行時(shí)編譯為支持的 CPU 架構(gòu)的向量指令。沒有變化：JEP 同意向量 API 將繼續(xù)處于孵化狀態(tài)，直到 Valhalla 項(xiàng)目的功能作為預(yù)覽可用。這是預(yù)期的，因?yàn)橄蛄?API 將能夠利用 Valhalla 項(xiàng)目預(yù)期的性能和內(nèi)存表示改進(jìn)。
• JEP 473—— 流收集器：第二次預(yù)覽，通過支持自定義中間操作增強(qiáng)了 Stream API。沒有變化。
• JEP 477—— 隱式聲明的類和實(shí)例主方法：第三次預(yù)覽，通過允許在隱式類（無需聲明）和void main()實(shí)例方法中定義簡(jiǎn)單程序，簡(jiǎn)化了簡(jiǎn)單程序的編寫。有兩個(gè)變化：隱式類自動(dòng)導(dǎo)入新的java.io.IO類的三個(gè)靜態(tài)方法print(Object)、println(Object)和readln(Object)，并且它們根據(jù)需要自動(dòng)導(dǎo)入java.base模塊中的包中的類。
• JEP 480—— 結(jié)構(gòu)化并發(fā)：第三次預(yù)覽，一個(gè)新的 API，通過允許將多個(gè)并發(fā)任務(wù)視為單個(gè)處理單元，簡(jiǎn)化了多線程代碼的編寫。沒有變化。
• JEP 481—— 作用域值：第三次預(yù)覽，允許在線程內(nèi)部和線程之間共享不可變數(shù)據(jù)。有一個(gè)小變化。
• JEP 482—— 靈活的構(gòu)造函數(shù)體：第二次預(yù)覽，一個(gè)允許在父構(gòu)造函數(shù)之前調(diào)用指令的功能，只要它們不訪問當(dāng)前正在創(chuàng)建的實(shí)例。構(gòu)造函數(shù)現(xiàn)在可以在顯式調(diào)用構(gòu)造函數(shù)之前初始化同一類的字段。

• 隨著 JEP 477—— 隱式聲明的類和實(shí)例主方法的推出，除了新的IO類之外，相同的三個(gè)方法也被添加到了Console類中：print(Object)、println(Object)和readln(Object)。
• Console類增加了三個(gè)使用帶有區(qū)域設(shè)置格式化的字符串的新方法：format(Locale, String, Object)、printf(Locale, String, Object)和readLine(Locale, String, Object)。
• Console.readPassword(Locale, String, Object)：與Console.readPassword(String, Object)相同，但接受一個(gè)區(qū)域設(shè)置作為參數(shù)用于字符串本地化。
• Inet4Address.ofPosixLiteral(String)：根據(jù)以 POSIX 兼容形式inet_addr提供的 IPv4 地址的文本表示創(chuàng)建一個(gè)Inet4Address。
• java.text.NumberFormat及其后代增加了setStrict(boolean)和isScript()方法，可用于更改格式化模式；默認(rèn)模式是嚴(yán)格模式。
• Instant.until(Instant)：計(jì)算到另一個(gè)Instant的持續(xù)時(shí)間。

• Thread.resume()和Thread.suspend()。
• ThreadGroup.resume()、ThreadGroup.stop()和ThreadGroup.suspend()。