从此

Java编程语言、JDK新特性语法、集成开发环境IDE、JVM、JAVA_HOME Guava、Netty

综合/最新

Java高级编程/日志/JRE、Java老专题、Nginx HTTP C/S、Jetty Server、Java Web/Network、Android应用开发、JDK源码、Gradle构建

Javadoc、Quarkus原生AOT、jpackage、音视频流、GUI/FFM、VCS/GIT
新：
  Vector API - 利用 CPU SIMD 单次并行计算多个数组或表达式。
  Java 26+ 新特性 - HttpClient 支持 HTTP/3。
    不可变字段懒加载/按需延迟赋值 static final LazyConstant LAZY = LazyConstant.of(() -> new Object()); 用处 Object obj = LAZY.get();
  Java 25+ 预览特性 - PEMDecoder.of().decode(pemString); ScopedValue 取代 ThreadLocal
  Oracle GraalVM 仅支持 CycloneDX 生成 SBOM，暂不支持 SPDX 格式。
  JDK 24+：
    支持 ASM 能力 java.lang.classfile.ClassFile.of().parse(byte[] bytes)
    通过预缓存加快启动速度 java -XX:AOTCache=app.aot -jar app.jar
    通过--enable-linkable-runtime减少JDK镜像尺寸，从JDK_HOME\jmods\抽取所用classes。
  Stream.of(1, 2, 3).gather(Gatherers.mapConcurrent(3, (item) -> {
    return item * item; // Thread.currentThread().isVirtual()
  })).toList(); // map 未使用 VirtualThread；JDK 24+ 首选 mapConcurrent


原则：
  主用JDK版本选择安装版，备用JDK则用压缩版。
  安装版依然分为包含 javac 的 default-jdk，以及较小的 default-jre，想用较新版本可 apt install openjdk-25-jdk-headless or openjdk-25-jre，Headless 版不支持 Swing。
  主动注册的版本列表  sudo    update-alternatives --config java
  处于 PATH 的 Java Shim（会去注册表查 Java 实际目录）： C:\Program Files\Common Files\Oracle\Java\javapath\java.exe
  C:\Program Files\Java\latest\jdk-25 会软链接至小版本的目录 C:\Program Files\Java\jdk-25.0.2
  查看版本 java --version  终端跑代码：
    Java Shell（PowerShell 入参需转义 C:\\Windows\\notepad.exe）脚本  echo 'IO.println(Files.size(Path.of("/etc/hosts")))' | jshell -

  参数分为 Build Time(-parameters)、Run Time(-XX:+UseCompactObjectHeaders) 及通用型(--enable-preview)。
  查参数默认值（Linux 换用 grep）： java -XX:+UnlockExperimentalVMOptions -XX:+PrintFlagsFinal -version | Select-String "UseCompactObjectHeaders"
  新特性不仅要启用 --enable-preview，若未合并到 JEP 主分支（状态分为未合并的Submitted、已合并的Integrated、Targeted），还得配套使用特供版 JDK，以及通过 Gradle 构建指定 org.gradle.java.installations.paths=[Project Valhalla 专用 JDK 路径]。
  判断参数 ManagementFactory.getRuntimeMXBean().getInputArguments().contains("--enable-preview");

兼容性：
  Java 程序和网站应用均配置为 Java 26（跟随Gradle兼容的Java版本/可被 NetBeans 拉低）。
  不上新特性，但要提升性能，可 maxOrNull 限制下 Java toolchain 版本上限。
  特化环境 - NetBeans 29 最高兼容 Java 25；GAE 最高兼容 Java 25。

JDK/JRE：
  Java/JDK版本重大变化：
    新 - JSpecify @NonNull 标准化 https://openjdk.org/jeps/8303099
    Java 25+ 支持模块儿导入 import module java.net.http; 简化 import java.net.http.HttpClient; 紧凑对象头（省内存） -XX:+UseCompactObjectHeaders
    Java 18+ 默认编码统一为 StandardCharsets.UTF_8
    Java 9+  引入了JPMS（Java Platform Module System）

  Java程序部署运行实战：
    Java Virtual Machine 首选 Oracle 的 HotSpot，其他则有 J9 等。
    源码编译用javac命令，最终运行用java，常见的加参数调优通常指后者。
    非容器好排查 ./gradlew distTar && tar -x -f build\distributions\*.tar

    单jar包启动： java -jar ./app.jar com.jpkg.App 或MANIFEST.MF用Class-Path: other.jar指定额外*.jar
    多jar包启动(不能带后缀名统配 *.jar)： java -cp ./app.jar;./* pkg.App

    实验性选项启用(更精确时钟等)：java -XX:+UnlockExperimentalVMOptions -XX:-UseFastUnorderedTimeStamps App
    低延迟实时场景（游戏等） java -XX:+UseShenandoahGC -XX:ShenandoahGCMode=generational
    内存资源大户：堆（Heap）内存（new 出来的对象及引用成员 / -XX:MaxRAMPercentage=95）、栈（Stack）内存（基于线程的调用栈/后进先出LIFO）、内存映射（Jetty 有用到 / MappedByteBuffer / -XX:MaxDirectMemorySize=40M），相加不能超出总内存上限，比如 docker run -m 200m ... 分配 - 虚拟机=50m、栈=10m、堆+内存映射=140m，前两者为下限，后两者共享剩余内存，文件读写应用则内存映射占比大一些，总内存再冗余 10m 变为 210m 吧。

    JVM参数查看  java -XX:+PrintFlagsFinal -version
      jinfo -flags 

    [容器]生产用JVM参数
      -XX:MaxRAMPercentage=95 -XX:+UseCompactObjectHeaders -Xss256k
      说明 - 最大内存百分比默认值为过于保守的25%(等同-Xmx初始值)，故改为95%来充分利用；推荐值为75%，会被显式参数-Xmx1024m覆盖。

    [非容器]生产用JVM参数
      ... -XX:+UseZGC
      说明 - 多用10%内存和CPU计算，来换取低延迟(STW/Stop-The-World/时空停顿)的垃圾回收器。

    [非容器]生产用JVM参数
      ... -XX:+CrashOnOutOfMemoryError
      说明 - 为了Docker能感知到，进而触发容器自动重启，应在内存不足时就使其Crash强退JVM，且输出hs_err_pid123.log文件（比*.hprof轻量很多）。
        如果程序很重要，可在OOM时换为通过脚本或Systemd来重启 -XX:OnOutOfMemoryError=/script/use-systemd-restart.sh

    [非容器]开发用JVM参数
      ... -XX:+HeapDumpOnOutOfMemoryError
      说明 - OOM时让JVM在程序当前目录生成排查信息，生成时资源消耗过大，应只用在重现阶段，可加个 -XX:HeapDumpPath=/tmp/hd.hprof 来指定路径。

     -XX:+ExitOnOutOfMemoryError

    JVM优雅退出 - https://www.bilibili.com/opus/679791639661641744

  JDK/JRE 完全版：
    Java/JDK下载地址
    Linux安装：apt install default-jre  （Debian默认为JDK21） 或用解压缩方式：
      wget https://download.oracle.com/java/24/latest/jdk-24_linux-aarch64_bin.tar.gz  或 jdk-24_linux-x64_bin.tar.gz
      tar -xf jdk-24_linux-*64_bin.tar.gz
      JAVA_HOME

死记、偏门：
  Java 25+ IO.println(1) 已取代 System.out.println(1)
  常量 - 编码方式 StandardCharsets.UTF_8、换行符 System.linSeparator()、本机地址 InetAddress.getLocalHost().getHostAddress()
    遍历系统环境变量 System.getenv().entrySet().stream().forEach(System.out::println);
    var isWin = System.getProperty("os.name").startsWith("Win");

  语法 - if (!create) 等同 if (create == false)
    switch case 比对枚举时比 if else 多个条件感知。
    _ArrayList.addFirst("首项");
    String.join(",", arr); 指定间隔符拼接数组。
    Arrays.copyOf(arr, arr.length - 1); 删除最后项。
    分页/批次：
      IntStream.range(0, list.size()).boxed().collect(Collectors.groupingBy(
        index -> index / 10, Collectors.mapping(list::get, Collectors.toList()))).values();
    数组、SQL IN 拼接：
      new StringJoiner("\",\"", "[\"", "\"]").add("s").add("ss").setEmptyValue("[]").toString();
      ids.stream().map(name -> "'" + name + "'").collect(Collectors.joining(", ", "id IN (", ")"));

  源码：
    打包发布时，主源码 classpath 最靠前，故 src/main/java/ 会覆盖第三方 jar 包同名类，类文件存在但被全文注释则会忽略；另 java.base 等模块儿类则无法覆盖。

  防御性捕获运行时异常：
    try { /* JDBC 操作 */ } catch (SQLException ex) { } catch (Throwable ex) { /* 包括 CJCommunicationsException 等 RuntimeException */ }
    Jakarta 统一处理 - @Provider public class EM implements ExceptionMapper { }

  日志 - System.getLogger("global").log(Level.ERROR, "msg"); 无需引入 java.logging 模块，入参为 Logger.getGlobal() GLOBAL_LOGGER_NAME。

  配置文件 - x.properties
    格式：k=v 等号左右的key、value均会trim前后空格；#或!开头均为注释；反斜杠\用于转义或换行(单行用\n)。
      k=v \
        line 2\nline 3
      windows.path = C:\\Users\\App

    _Properties.storeToXML(b, "x");

  IO/URL - 当前目录 System.getProperty("user.dir") 在MAC DOCK上启动则总为“/”，Windows正常; Path对象不含结尾的斜杠。
    File.createTempFile("x".repeat(3), ".txt") 返回 File，而 Files.createTempFile(...) 则返回 Path。
    URI格式不允许存在反斜杠和空格：URI.create("file://C:\\d.txt".replaceAll("\\\\", "/").replaceAll(" ", "%20"); // or new URL(已过时);

    资源目录文件(未解压情况换用getResourceAsStream) - new File(Thread.currentThread().getContextClassLoader().getResource("x.txt").toURI());
      File不支持URI为 jar:file:/app/classpath/x.jar!/network/ 的入参，比如 jib packaged 的 getResource。

    macOS *.app 必须用 open 命令启动：String[] cmd = {"open","-a","/Users/my/x.app"}; new ProcessBuilder(cmd).start();
    Desktop.getDesktop().open(new File("C:\\Windows\\win.ini")); // *.exe、*.bat 无关联程序，故只能换方式打开：
      new ProcessBuilder("cmd.exe", "/c", "start", "F:\\x\\x.bat").start(); // start 参数会新开控制台。

  其他 - Gradle判断>=Java版本：org.gradle.api.JavaVersion.current().isCompatibleWith(JavaVersion.VERSION_17); 也可用Guava库com.google.common.base.JavaVersion
  国名代码 - Locale.getISOCountries(); // 输出2字母大写，等同域名后缀，3字母则更清晰；全名用 locale.getDisplayCountry(Locale.ENGLISH)
  时区 - PRC or CTT 即 China Standard Time 上海时区，简短易记。
    TimeZone.getTimeZone("PRC").toZoneId();
    ZoneId.SHORT_IDS.get("CTT"); // 输出 Asia/Shanghai
    ZoneId.of("Asia/Shanghai"); // 完整写法
    ZoneOffset.UTC.normalized() // 规范化

  时间
    时间比对不适用大小于号，而是直接调函数：
      var last = Instant.now().minus(Duration.ofMinutes(11)); Instant.now().isAfter(last.plus(10, ChronoUnit.MINUTES));

  字符串拼接首选线程安全的： var sb = new StringBuffer(); sb.append(request.getProtocol()); sb.toString();
  无法跳读，直接获取最后一个元素，仍然会接收之前所有元素文件流 - request.getParts().stream().findLast().getInputStream();

  时间 - 周年份（Week Year）指跨年周的天数低于4天就归属到新年份了，1月1日永远属于新年份第一周。Java中用YYYY表示周年份，常规年份使用yyyy；
    文件路径不允许冒号 - Instant.now().toString().replace(":", "_")
    去除毫秒或更细分时间 LocalDateTime.now().truncatedTo(ChronoUnit.SECONDS)


  JSON字段存在和null值都得判定  _JsonObject.containsKey("text") && jo.isNull("text")

  错误响应标准(RFC 9457) - org.springframework.http.ProblemDetail
  NetBeans控制台中文乱码解决(macOS无此问题)：计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage 将 ACP 值改为 65001。

IDE:
  NetBeans - 
    解决 Output 窗口乱码：Windows → 控制面板 → 时钟和区域 → 区域 → 管理 → 更改系统区域设置 → 勾选“Beta版：使用Unicode UTF-8 提供全球语言支持”。
    兼容性亲测 - NB 29 Gradle、JavaWeb 最高支持到 Java Platform 25；GlassFish 8.0.0 则最高支持到 24，Payara 是其下游增强版，Headless 环境首选 TomEE。

    图标写死了JDK目录："C:\netbeans64.exe" --jdkhome "C:\Program Files\Apache NetBeans\jdk" 非完整JDK，未包含 jmods 目录。
    离线模式 NetBeans -> Tools -> Options -> Java -> Gradle -> ✔Offline
    macOS安装包为Apache-NetBeans-25.pkg。
    Git -> Show Changes 为空但项目图标上有变动(估计把staged也算为了变动)图标，可通过 git status 查看并修复 git restore --staged x/src/main/java/pkg/name/X.java；若存在转义 x/src/main/resources/[\346\234\252\344\275\277\347\224\250].xhtml，可通过x/src/main/resources/*.xhtml 通配掉。






内容



  
常用

  
OOP:
  实例化空入参：
    public class NewClass {
      public NewClass(String... varargs) { } // 可变参数构造函数也能直接 new NewClass();
      public NewClass() { } // 比String...空入参更优先
    }

Stream API:
  按字段排序 - items.stream().sorted(Comparator.comparing(Item::getName)).toList();
  按多个字段倒序排序 - items.stream().sorted(Comparator.comparing(Item::getName).reversed().thenComparing(Item::getField)).collect(Collectors.toList());

IO:
  Java 25+ 新增控制台简化类（隐式声明类则自动导入java.base） IO.println(IO.readln("Enter"));
  使入参符合文件名格式(中英文、数字、._-)："file*name.txt".replaceAll("[^a-zA-Z0-9\\u4e00-\\u9fa5._-]", "_").replaceAll("_+", "_")

线程：
  StructuredTaskScope 比 ExecutorService 更简洁易用，但后者可高度自定义。
  阻塞当前线程数秒： LockSupport.parkNanos(Duration.ofSeconds(3).toNanos()); // 或精确时间点入参 Instant.now().plusSeconds(3).toEpochMilli()
  ThreadPoolExecutor submit(...) 内部封装了其 execute(...) 方法，提供了延迟处理异常的能力 var f = es.submit(...); if (f.isDone()) { f.exceptionNow(); } 或取返回值 f.resultNow() 。

进程：
  无输出执行终端命令： new ProcessBuilder("killall", "Finder").start();
  执行含管道命令：new ProcessBuilder("/bin/sh", "-c", "cat /proc/meminfo | grep MemTotal").start();
  执行终端命令并返回退出码： 
    new ProcessBuilder("gio", "launch", "/etc/xdg/autostart/x.desktop").start()
      .onExit().thenAccept(p -> System.out.println(p.pid() + " | " + p.exitValue())).join();
    System.exit(0); // 不会停止上方 ProcessBuilder 已执行命令。

优雅停机（Graceful Shutdown）：
  首选回调钩子 ShutdownHook，极致控制用信号量 SignalHandler。

异常错误：
  抛异常：
    数据库连接超时应记录后并向上抛出：
      @Override
      protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        try { executeUpdate(sql); } catch (SQLException ex) {
            response.setStatus(HttpServletResponse.SC_OK);
            response.setContentType("text/plain");  //  避免被搜索引擎收录
            response.getWriter().print(ex.getLocalizedMessage());
            return;
        }
      }

      public static void executeUpdate(String sql) throws SQLException {
        try (var conn = DriverManager.getConnection(url, user, password); //
                 var cs = conn.createStatement()) {
            System.out.println(cs.executeUpdate(sql));
        } catch (SQLException ex) {
            ex.printStackTrace(System.err);
            throw ex; // 连接超时等 SQLTimeoutException
        }
      }

  
跨语言

  
  可逆Hex(避免URL编码空格问题) - Java 中 java.util.HexFormat.of().parseHex("E6b58be8af95") 可解码JavaScript编码(Array.from方法入参必须为无符号)：
    https://tsc.openle.com/.well-known/static/scripts/core.js
    非module脚本 - https://tsc.openle.com/.well-known/static/scripts/core-classic.js

  
网络

  
访问 HTTP/2 应换为 HttpClient： URI.create("https://example.com").toURL().openConnection();
Java支持mDNS主机名查对应IP(需20分钟通讯过): InetAddress.getByName("raspberrypi.local").getHostAddress();











其他


Java运行期和编译期异常

网络Socket - 常规功能用 Java NIO API，较复杂可用 Netty。

Java运行WebAssembly - Instance.builder(com.dylibso.chicory.wasm.Parser.parse(new File("./x.wasm"))).build()

知名类库 - 流行工具库 Guava
验证码库 - Java国产工具库 Hutool（疑似投毒?）
序列化库 - Java国产库 阿里巴巴 Fastjson
工具 - TCP/UDP网络调试助手
MQTT Clients - https://github.com/hivemq/hivemq-mqtt-client 或用不怎么更新的 https://eclipse.dev/paho/