线程分组与导出

基本信息

采样器采集到的是「一堆线程各自的时间」，需要两步加工才有意义：ThreadDumper 决定采哪些线程，ThreadGrouper 决定采到的线程怎么合并成报告里的几行。

ThreadGrouper（线程归并）

ThreadGrouper.parseConfigSetting(String setting)（ThreadGrouper.java:67-76）:

switch (setting) {
    case "as-one":   return AS_ONE;
    case "by-name":  return BY_NAME;
    default:         return BY_POOL;
}

注意 switch 的 default 落到 BY_POOL —— 任何拼错的配置值都会静默变成 by-pool，不报错。

在多线程服务器上这直接决定报告可读性：默认 by-pool 会把 Acceptor #0/Worker #0 这类 Netty/pool 线程合并成几行，而不是几十行独立条目；改成 by-name 则每个线程单列。

ThreadDumper（线程筛选）

ThreadDumper.parseConfigSetting(String setting)（ThreadDumper.java:71-81）:

switch (setting) {
    case "default":  return null;
    case "all":      return ALL;
    default:
        Set<String> threadNames = Arrays.stream(setting.split(",")).collect(Collectors.toSet());
        return new ThreadDumper.Specific(threadNames);
}

default 返回 null 是有意设计：调用方 BackgroundSamplerManager.startSampler() 判空后回退到 platform.getPlugin().getDefaultThreadDumper()，由平台决定「默认线程」是什么。

逗号分隔的多线程名是本配置的主要用法 —— 例如 "Server thread,Netty Server IO#0"。注意解析不 trim 空白，且分隔符固定为英文逗号。

1.7.10 的平台默认线程

SparkPlugin.getDefaultThreadDumper() 的接口默认实现返回 ThreadDumper.ALL（SparkPlugin.java:105-107），但 1.7.10 两个插件都覆写了它：

即 1.7.10 上默认只采主线程（服务端）或 Minecraft 客户端线程，与其他平台默认导出全部线程的行为不同。要在服务端采全部线程需显式设 backgroundProfilerThreadDumper: "all"。

服务端之所以要在构造时捕获当前线程：插件在 FMLServerStartingEvent 中注册，此时 Thread.currentThread() 即服务端主线程。

客户端主线程的访问变换器

客户端访问 minecraft.mcThread 需要 FMLAT。spark-forge1710/src/main/resources/META-INF/spark_at.cfg 内容仅一行：

public net.minecraft.client.Minecraft field_152352_aC # mcThread

由 spark-forge1710/build.gradle 的 jar { manifest { attributes 'FMLAT': 'spark_at.cfg' } } 挂载。详见 访问变换器。

数值

相关条目

• 后台采样器 - 这两个配置项的使用方
• 访问变换器 - 客户端线程访问所需的 FMLAT
• 报告输出与查看器 - 归并后的数据如何呈现