🌳 MethodsCounter 架构

架构方法数按包聚合

MethodsCounter 是 ClassyShark 的方法数统计子系统：把任意归档（.aar/.jar/.dex/.apk）里的每个类的方法数读出来，按包名递归聚合成一棵多叉树，再以树形或扁平两种策略输出。是 -methodcounts 命令与 GUI MethodsCountPanel 的共同后端。

🧩 组件全景

mermaid

flowchart LR
    subgraph 入口
        CLI["CliMode -methodcounts"]
        GUI["MethodsCountPanel"]
    end
    FACADE["SilverGhostFacade.inspectPackages"]
    subgraph methodscounter 包
        RB["RootBuilder<br/>按文件类型分发"]
        CN["ClassNode<br/>按包名递归建树"]
        CI["ClassInfo<br/>值对象"]
    end
    subgraph exporter 包
        INT["MethodCountExporter<br/>策略接口"]
        TREE["TreeMethodCountExporter"]
        FLAT["FlatMethodCountExporter"]
    end
    CLI --> FACADE
    GUI --> RB
    FACADE --> RB
    RB -->|产生 ClassNode| CN
    CN -->|add 每个类| CI
    RB -.->|委托| CI
    FACADE --> INT
    INT -.->|实现| TREE
    INT -.->|实现| FLAT
    TREE & FLAT -->|读 ClassNode 树| CN

入口 SilverGhostFacade.inspectPackages(args) 构造 RootBuilder 与一个 exporter，前者建树、后者遍历输出。

🔀 RootBuilder：按文件类型分发

RootBuilder.fillClassesWithMethods(File) 用文件名后缀分发到四条解析路径，统一产出一棵以文件名为根的 ClassNode：

mermaid

flowchart TD
    IN["fillClassesWithMethods(file)"]
    IN --> D{"file.getName() 后缀"}
    D -->|".aar"| AAR["fillFromAar"]
    D -->|".jar"| JAR["fillFromJar"]
    D -->|".dex"| DEX["fillFromDex"]
    D -->|"其它(含 .apk)"| APK["fillFromApk"]

    AAR --> A1["ZipInputStream 解压找 .jar"]
    A1 --> A2["写出临时 classes*.jar<br/>deleteOnExit"]
    A2 -->|委托| JAR

    JAR --> J1["JarFile 遍历 JarEntry"]
    J1 --> J2["BCEL ClassParser(is, name)"]
    J2 --> J3["JavaClass.getMethods().length"]
    J3 --> CI1["new ClassInfo(类名, 方法数)"]
    J3a["rootNode.add(classInfo)"]
    CI1 --> J3a

    DEX --> DX1["DexlibLoader.loadDexFile"]
    DX1 --> DX2["ClassDef.getMethods() 遍历计数"]
    DX2 --> DX3["getType() 转点分"]
    DX3 --> CI2["new ClassInfo(类名, 方法数)"]
    CI2 --> J3a

    APK --> P1["ZipInputStream 遍历 .dex 条目"]
    P1 --> P2["逐个写出临时 classyshark*.dex"]
    P2 -->|循环| DEX

扩展名	方法	解析库	方法计数来源	委托关系
`.aar`	`fillFromAar`	先解 zip 取内嵌 `.jar`	BCEL	委托给 `fillFromJar`
`.jar`	`fillFromJar`	Apache BCEL `ClassParser`	`JavaClass.getMethods().length`	终点
`.dex`	`fillFromDex`	dexlib2（`DexlibLoader.loadDexFile`）	遍历 `ClassDef.getMethods()` 计数	终点
`.apk`	`fillFromApk`	Zip 流遍历每个 `.dex`	dexlib2	循环委托给 `fillFromDex`

📦 APK 多 dex 处理：fillFromApk 用 ZipInputStream 逐条找 .dex，每个写出临时文件（File.createTempFile("classyshark","dex") + deleteOnExit()）并打印 Parsing <name>，全部喂给 fillFromDex(file, rootNode) 共享同一根。多 dex 的方法数因此汇总到一棵树。
📦 AAR 内嵌 jar 委托：fillFromAar 同样解压取首个 .jar 条目写出临时文件，再 return fillFromJar(tempFile)——AAR 复用 JAR 的 BCEL 路径。
⚠️ 分发只看后缀字符串，else 分支兜底走 fillFromApk，故未识别扩展名会被当 APK 解 zip。

🌲 ClassNode：按包名点分递归建树

ClassNode 是多叉树节点，持有 Map<String,ClassNode> childNodes、String key、int methodCount。建树逻辑核心是 add：

mermaid

flowchart TD
    A["add(ClassInfo)"] --> B["split('.') 切包段<br/>com.bumptech.glide.RequestManager"]
    B --> C["add(0, packages, classInfo)"]
    C --> D{"pos >= packages.length ?"}
    D -->|是| END(["返回"])
    D -->|否| E["methodCount += classInfo.methodCount<br/>（每层祖先都累加）"]
    E --> F{"childNodes 含 packages[pos]?"}
    F -->|否| G["new ClassNode()<br/>key=packages[pos]<br/>put 入 childNodes"]
    F -->|是| H["取出 child"]
    G & H --> I["child.add(pos+1, ...)"]
    I --> D

关键性质：

切段建树：com.bumptech.glide.RequestManager 切成 [com, bumptech, glide, RequestManager]，逐段造子节点。
逐层累加：methodCount = methodCount + classInfo.getMethodCount() 在每一层都执行——因此父包方法数 = 其下所有类方法数之和（同一类的方法数被加到全部祖先）。
末端是类：ClassInfo.packageName 实际存全限定类名（jar 用 jc.getClassName()，dex 用 o.getType() 去斜杠与首尾字符转点分），切段后最后一段即类名。
根节点 key = 文件名，methodCount = 全量方法数。

ClassInfo 值对象

ClassInfo 是不可变值对象，仅两个字段：

java

public ClassInfo(String packageName, int methodCount)
public String getPackageName()   // 实为全限定类名
public int getMethodCount()

📝 它是 RootBuilder 与 ClassNode 之间的数据载体——解析层负责填充，ClassNode 负责消费建树，二者解耦。

📤 MethodCountExporter：输出策略

输出走策略模式，接口 MethodCountExporter 只一个方法 exportMethodCounts(ClassNode rootNode)，两个实现共享同一棵已建好的树：

mermaid

flowchart LR
    INT["MethodCountExporter<br/>exportMethodCounts(root)"]
    INT -.->|默认| T["TreeMethodCountExporter"]
    INT -.->|args 含 -flat| F["FlatMethodCountExporter"]
    T -->|递归 printNode<br/>Unicode box-drawing| OUT1["树形"]
    F -->|递归 printNode<br/>祖先路径拼点| OUT2["扁平全限定名"]

策略	类	遍历方式	行格式	适用
树形	`TreeMethodCountExporter`	DFS + `boolean[] isFinalLevel` 维护分支符号	`╠ key - n` / `╚ key - n`	人读
扁平	`FlatMethodCountExporter`	DFS + `String[] path` 维护祖先路径	`app.apk.com.pkg - n`	管道 `grep`/`sort`

🔧 两者都把 PrintWriter 注入构造函数，SilverGhostFacade 传 new PrintWriter(System.out)，故输出即标准输出。inspectPackages 默认选 Tree；若 args.size() > 2 扫描后续参数遇 -flat 切换 Flat（后写者覆盖）。

🧪 数据流示例

输入 app.apk 含类 com.example.ui.MainActivity（440 方法）、androidx.core.AppCompat（1111 方法）：

RootBuilder.fillFromApk
  → 解出 classes.dex 临时文件
  → fillFromDex: DexlibLoader.loadDexFile
  → 遍历 ClassDef，ClassDef.getMethods() 计数 440 / 1111
  → ClassInfo("com.example.ui.MainActivity", 440) → rootNode.add
  → ClassInfo("androidx.core.AppCompat", 1111)    → rootNode.add
↓
ClassNode 树:
  app.apk(1551)
    com(440)
      example(440)
        ui(440)
          MainActivity(440)
    androidx(1111)
      core(1111)
        AppCompat(1111)
↓
TreeMethodCountExporter → app.apk - 1551 ...
FlatMethodCountExporter → app.apk.com.example.ui.MainActivity - 440 ...

🔗 相关链接

构建与聚合：RootBuilder · ClassNode · ClassInfo
输出策略：MethodCountExporter · TreeMethodCountExporter · FlatMethodCountExporter
入口与调用方：SilverGhostFacade · CliMode · MethodsCountPanel
CLI 命令：-methodcounts

🌳 MethodsCounter 架构 ​

🧩 组件全景 ​

🔀 RootBuilder：按文件类型分发 ​

🌲 ClassNode：按包名点分递归建树 ​

ClassInfo 值对象 ​

📤 MethodCountExporter：输出策略 ​

🧪 数据流示例 ​

🔗 相关链接 ​

🌳 MethodsCounter 架构

🧩 组件全景

🔀 RootBuilder：按文件类型分发

🌲 ClassNode：按包名点分递归建树

ClassInfo 值对象

📤 MethodCountExporter：输出策略

🧪 数据流示例

🔗 相关链接