java 不支持指针或引用传递，也无法直接修改原始参数值；但可通过封装返回值的泛型结果类，统一处理错误码与任意数量的输出数据，避免为每个函数创建独立 dto 类。
java 不支持指针或引用传递，也无法直接修改原始参数值；但可通过封装返回值的泛型结果类，统一处理错误码与任意数量的输出数据，避免为每个函数创建独立 dto 类。
在从 C++ 迁移大量含 input/output 和 output-only 参数的函数（如 int evaluateFunc(const T1&, T2&, T3&)）到 Java 时，核心挑战有两个：
- 无法原地修改基本类型或不可变对象参数（Java 所有参数均按值传递，包括对象引用的副本）；
- 需同时返回整型错误码（50+ 种）与动态结构的业务数据，而 Java 方法仅允许单个返回值。
✅ 推荐方案：泛型 Result<T> 封装类（兼顾类型安全与复用性）
定义一个轻量、不可变、泛型化的结果容器，统一承载错误码与主业务数据：
public final class Result<T> {
public final int errorCode; // 0 表示成功，非0为标准错误码（如 -1: INVALID_INPUT, -2: TIMEOUT）
public final T data; // 任意类型的输出数据（可为 null）
private Result(int errorCode, T data) {
this.errorCode = errorCode;
this.data = data;
}
public static <T> Result<T> success(T data) {
return new Result<>(0, data);
}
public static <T> Result<T> error(int errorCode) {
return new Result<>(errorCode, null);
}
public static <T> Result<T> error(int errorCode, T data) {
return new Result<>(errorCode, data);
}
public boolean isSuccess() {
return errorCode == 0;
}
}? 使用示例：迁移 C++ evaluateFunc
假设原 C++ 函数签名：
int evaluateFunc(const std::string& input, std::string& ioBuffer, int& outputCount);
对应 Java 实现可设计为：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
// 定义输出数据结构（仅此处需一次定义，非每个函数一个类）
public static class EvaluateOutput {
public final String ioBuffer; // 原 para2（input/output）
public final int outputCount; // 原 para3（output only）
public EvaluateOutput(String ioBuffer, int outputCount) {
this.ioBuffer = ioBuffer;
this.outputCount = outputCount;
}
}
// Java 等效方法：输入仅传参，所有“输出”收归 Result<EvaluateOutput>
public static Result<EvaluateOutput> evaluateFunc(String input) {
try {
String ioBuffer = input.toUpperCase().trim(); // 模拟处理
int outputCount = ioBuffer.length();
// 检查业务逻辑错误（映射 C++ error code）
if (input == null) return Result.error(-1); // ERR_NULL_INPUT
if (input.isEmpty()) return Result.error(-2); // ERR_EMPTY_INPUT
return Result.success(new EvaluateOutput(ioBuffer, outputCount));
} catch (Exception e) {
return Result.error(-99); // ERR_UNKNOWN
}
}调用方代码清晰、安全：
Result<EvaluateOutput> result = evaluateFunc(" hello ");
if (result.isSuccess()) {
String updatedBuffer = result.data.ioBuffer; // "HELLO"
int count = result.data.outputCount; // 5
System.out.printf("Success: buffer='%s', count=%d%n", updatedBuffer, count);
} else {
switch (result.errorCode) {
case -1 -> System.err.println("Input is null");
case -2 -> System.err.println("Input is empty");
default -> System.err.println("Unknown error: " + result.errorCode);
}
}⚠️ 关键注意事项
- 勿滥用可变对象模拟“引用传递”：例如向方法传入 StringBuilder 并修改其内容，虽技术可行，但违背封装原则、易引发副作用，且无法表达“该参数本意是 output-only”的契约。
- Result<T> 应为不可变类：确保线程安全与行为可预测；所有字段 final，构造仅通过静态工厂方法。
- 错误码语义必须全局一致：建议定义 ErrorCode 枚举或常量类（如 ErrorCode.OK, ErrorCode.INVALID_ARG），并在 Result.error(...) 中统一使用，便于日志与监控。
- 对多输出场景的扩展：若某函数需返回 3+ 个异构值，可组合为嵌套对象（如 EvaluateOutput），而非强行塞入 Map<String, Object> —— 后者牺牲类型安全与可读性。
✅ 总结
无需为 100 个函数创建 100 个返回类。一个泛型 Result<T> + 若干精简的领域输出类（如 EvaluateOutput, ParseResult, ValidateReport），即可优雅覆盖全部场景：
✅ 统一错误处理流程
✅ 保持强类型与编译期检查
✅ 零反射、零运行时开销
✅ 完全符合 Java 编码规范与函数式风格
这是工业级 Java 项目中处理“多值返回 + 错误码”问题的标准实践。
