31 lines
1.8 KiB
Markdown
31 lines
1.8 KiB
Markdown
# 代码审查报告
|
|
|
|
**文件:** `data\demo-pmd\src\com\demo\api\ApiService.java`
|
|
**语言:** java
|
|
**耗时:** 74.4s
|
|
**分析工具:** pmd
|
|
|
|
---
|
|
|
|
总计: 4 | 错误: 1 | 警告: 2 | 建议: 1
|
|
|
|
静态分析 · 2 个问题
|
|
|
|
- 🔴 `pmd:SystemPrintln` L11
|
|
使用了 System.out/err 进行输出
|
|
建议: 改用日志框架输出，例如：private static final java.util.logging.Logger LOGGER = java.util.logging.Logger.getLogger(ApiService.class.getName()); 然后调用 LOGGER.info("api service");。这样支持日志级别、格式化与可配置化输出。
|
|
- 🟡 `pmd:AtLeastOneConstructor` L9
|
|
每个类应至少声明一个构造函数
|
|
建议: 为 ApiService 类添加一个显式构造函数，例如：public ApiService() { }。这样可以显式控制实例化过程，并为后续可能的依赖注入留出扩展点。
|
|
|
|
AI 审查 · 2 条建议
|
|
|
|
- 🟡 [AI] [design] `static-method` L10
|
|
**doWork 方法不访问实例状态，应声明为 static**
|
|
doWork() 方法只执行输出操作，未使用任何实例字段或实例方法，因此没有理由要求调用方创建 ApiService 实例。声明为 static 后，可通过 ApiService.doWork() 直接调用，避免不必要的对象分配，也更清晰地表达其工具方法语义。
|
|
建议: 将方法签名改为 public static void doWork()，并更新调用方为 ApiService.doWork()。
|
|
- 🔵 [AI] [style] `magic-string` L11
|
|
**魔法字符串 "api service" 应提取为常量**
|
|
字符串字面量 "api service" 直接出现在代码中，若消息内容在别处也需要使用，重复字面量容易导致不一致。建议提取为静态常量或使用资源文件，提升可维护性与可测试性。
|
|
建议: 在类中定义 private static final String MESSAGE = "api service";，并将输出语句改为 System.out.println(MESSAGE);。
|