Java中只写属性通过私有字段+public setter+无getter实现，适用于密码、审计等敏感场景，需避免空getter、慎用Lombok@Data，并注意框架兼容性。
Java 中设计只写属性，就是让外部能设置值但不能读取值。这种场景虽不常见，但在日志记录、密码接收、审计字段更新等业务中确实存在——比如一个 password 字段，你允许用户设值并加密存储，但绝不允许通过 getter 暴露明文或原始哈希值。
只写属性的核心实现方式
只写属性的本质是：字段私有化 + 提供 public 的 setter 方法 + 不提供对应的 getter 方法。
-
字段必须声明为
private：这是前提，防止外部绕过方法直接访问。 -
只写 setter，不写 getter：例如有
setPassword(String pwd)，但不定义getPassword()。 - setter 内可加入处理逻辑：如加密、脱敏、校验长度、触发事件等，体现“写”的可控性。
典型代码示例
以下是一个含只写密码字段的用户类：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public class User {
private String username;
private String passwordHash; // 存储加密后的密码，不暴露原始值
public void setUsername(String username) {
this.username = username;
}
public void setPassword(String rawPassword) {
if (rawPassword == null || rawPassword.trim().length() < 6) {
throw new IllegalArgumentException("密码至少6位");
}
this.passwordHash = hash(rawPassword); // 实际应调用 BCrypt 等加密工具
}
// 注意：没有 getPassword() 方法！
private String hash(String s) {
return s + "_SHA256"; // 示例，非真实加密
}
}
立即学习“Java免费学习笔记（深入）”；
注意事项与常见误区
-
不要写空 getter 或抛异常的 getter：比如
public String getPassword() { throw new UnsupportedOperationException(); }，这会误导调用方以为“本该可读”，也破坏 API 清晰性。 -
避免使用 Lombok 的
@Data：它会自动生成所有 getter/setter，导致只写意图被覆盖；若要用 Lombok，应单独用@Setter+ 手动控制 getter 缺失。 -
框架兼容性需留意：某些序列化/ORM 框架（如 Jackson、MyBatis）默认依赖 getter 读取字段。若字段只写，框架可能无法自动映射其值——此时应显式配置忽略（如
@JsonIgnore）或改用构造器注入 +@ConstructorProperties。 -
只写不等于“不可查”：业务上需要验证密码时，应通过
boolean matches(String raw)这类语义明确的方法，而不是暴露原始值。
何时考虑只写属性
不是所有字段都适合只写。合理使用场景包括：
- 敏感字段（密码、密钥、令牌）的输入入口
- 触发副作用的操作型字段（如
setAuditTrigger(true)表示要记录操作日志） - 内部状态标记（如
setProcessed(true)，后续由系统异步处理，无需对外反馈） - 配合 Builder 模式做阶段性赋值（如
builder.withConfig(...).build()中的中间 set 方法）
