如何使用带可选参数的类构建器？解决APIResponse泛型推断报错

问题原因 #

你的APIResponse<T>类中data字段定义为Optional<T>，但实例化时直接传入了非Optional类型的对象（如字符串、CustomDTO），导致构造器参数类型不匹配，编译器无法正确推断泛型参数T。

• 第一个传null的例子不报错，是因为null可匹配任意引用类型，编译器能通过左边声明的APIResponse<String>推断出T=String，null可赋值给Optional<String>。

快速解决方法 #

1. 手动包装为Optional对象 #

直接将传入的数据用Optional.of()或Optional.ofNullable()包装，匹配构造器的参数类型：

// 正确传参：用Optional包装字符串
APIResponse<String> responseWithData = new APIResponse<>("Success", HttpStatus.OK, Optional.of("HEY"));

// 正确传参：用Optional包装自定义DTO
APIResponse<CustomDTO> apiResponse = new APIResponse<>("Success", HttpStatus.OK, Optional.of(this.customDTO));

// 空数据推荐用Optional.empty()替代null（更符合Optional设计初衷）
APIResponse<String> responseWithNullData = new APIResponse<>("Success", HttpStatus.OK, Optional.empty());

注意：第三个例子中APIResponse<Optional<String>>的data字段类型是Optional<Optional<String>>，若没必要嵌套Optional，建议将泛型参数设为实际数据类型（如APIResponse<String>）。

2. 添加重载构造器简化传参 #

新增接受T类型参数的构造器，内部自动将数据包装为Optional<T>，避免手动包装：

import org.springframework.http.HttpStatus;
import java.util.Optional;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class APIResponse<T> {

    private String message;
    private HttpStatus httpStatus;
    private Optional<T> data;

    // 新增重载构造器：自动将T类型数据包装为Optional
    public APIResponse(String message, HttpStatus httpStatus, T data) {
        this.message = message;
        this.httpStatus = httpStatus;
        this.data = Optional.ofNullable(data); // 兼容null，自动转为Optional.empty()
    }
}

之后即可直接传入任意类型数据或null，无需手动包装：

APIResponse<String> responseWithData = new APIResponse<>("Success", HttpStatus.OK, "HEY");
APIResponse<CustomDTO> apiResponse = new APIResponse<>("Success", HttpStatus.OK, this.customDTO);
APIResponse<String> responseWithNullData = new APIResponse<>("Success", HttpStatus.OK, null);

更优实现方案 #

1. 结合Builder模式优化 #

通过重载Builder方法，支持直接传入T类型数据，进一步提升使用便利性：

import org.springframework.http.HttpStatus;
import java.util.Optional;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@AllArgsConstructor
public class APIResponse<T> {

    private String message;
    private HttpStatus httpStatus;
    private Optional<T> data;

    // 自定义Builder，支持两种data传参方式
    @Builder
    public APIResponse(String message, HttpStatus httpStatus, Optional<T> data) {
        this.message = message;
        this.httpStatus = httpStatus;
        this.data = data;
    }

    public static <T> APIResponseBuilder<T> builder() {
        return new APIResponseBuilder<T>() {
            // 重载data方法：接受T类型，自动包装为Optional
            public APIResponseBuilder<T> data(T data) {
                super.data(Optional.ofNullable(data));
                return this;
            }
        };
    }
}

使用示例：

APIResponse<String> response = APIResponse.<String>builder()
        .message("Success")
        .httpStatus(HttpStatus.OK)
        .data("HEY") // 直接传字符串，无需手动包装
        .build();

2. 新增静态工厂方法 #

封装常用的响应场景（成功、错误、空数据），进一步简化代码：

// 静态工厂方法：带数据的成功响应
public static <T> APIResponse<T> success(String message, T data) {
    return new APIResponse<>(message, HttpStatus.OK, Optional.ofNullable(data));
}

// 静态工厂方法：无数据的成功响应
public static <T> APIResponse<T> success(String message) {
    return new APIResponse<>(message, HttpStatus.OK, Optional.empty());
}

// 静态工厂方法：错误响应
public static <T> APIResponse<T> error(String message, HttpStatus status) {
    return new APIResponse<>(message, status, Optional.empty());
}

使用示例：

APIResponse<String> successResp = APIResponse.success("操作成功", "HEY");
APIResponse<CustomDTO> dtoResp = APIResponse.success("查询成功", customDTO);
APIResponse<Void> emptyResp = APIResponse.success("删除成功");
APIResponse<Void> errorResp = APIResponse.error("参数错误", HttpStatus.BAD_REQUEST);

内容的提问来源于stack exchange，提问作者Mr. Kenneth