Java简单属性Getter与Setter最佳实践：企业级场景选型咨询

我有C# .NET开发背景，现在基于Java 21重构应用。在C#里，带Getter/Setter的公共属性和「私有字段+公共Getter/Setter」功能完全等价，还能隐式调用，所以我一直用前者，既能保证封装性又没冗余代码。

但到了Java里，如果照搬这个习惯，JPA实体类、Jackson映射的JSON响应类这类简单对象的代码会变得特别冗长。想请教：在实际企业级应用中，对于仅做字段读写、无额外数据操作的简单属性，标准处理方式是用「私有字段+公共Getter/Setter」（如示例1），还是直接用公共字段（如示例2）？

C# 属性示例 #

namespace SpeedRunAppImport.Model.Entity
{
    public class GameEntity
    {
        // 自动属性
        public string Name { get; set; }
        
        // 和上面功能完全等价的手动实现
        private string _Name;
        public string Name
        { 
            get
            {
                return _Name;
            }
            set
            {
                _Name = value;
            } 
        }
    }
}

Java 示例代码 #

JPA实体类示例 #

@Entity
@Table(name = "tbl_game")
public class Game {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)    
    private Integer id;
    private String name;
    private String code;
    private String abbreviation;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getCode() {
         return code;
    }

    public void setCode(String code) {
         this.code = code;
    }

    public String getAbbreviation() {
         return abbreviation;
    }

    public void setAbbreviation(String abbreviation) {
         this.abbreviation = abbreviation;
    }
}

JSON响应类示例 #

public class GameResponse
{
    private String id;
    private String name;
    private String abbreviation;

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getName() {
         return name;
    }

    public void setName(String name) {
         this.name = name;
    }

    public String getAbbreviation() {
         return abbreviation;
    }

    public void setAbbreviation(String abbreviation) {
         this.abbreviation = abbreviation;
    }
}

两种用法的业务代码示例 #

示例1：使用Getter/Setter #

public void SaveGames(List<GameResponse> games)
{
    _logger.info("Started SaveGames: {@count}", games.size());
    
    var existingGamesVWs = _gameRepo.GetGamesByCode(games.stream().map(x -> x.getId()).toList());            

    var gameEntities = games.stream().map(i -> { 
        var game = new Game();
        var existingGame = existingGamesVWs.stream().filter(x -> x.code == i.getId()).findFirst().orElse(null);
        game.setId(existingGame != null ? existingGame.getId() : null);
        game.setName(i.getName());
        game.setCode(i.getId());
        game.setAbbr(i.getAbbreviation());

        return game;
    }).toArray(Game[]::new);


    _logger.info(Integer.toString(existingGamesVWs.size()));
}

示例2：使用公共字段 #

public void SaveGames(List<GameResponse> games)
{
    _logger.info("Started SaveGames: {@count}", games.size());
    
    var existingGamesVWs = _gameRepo.GetGamesByCode(games.stream().map(x -> x.id).toList());             

    var gameEntities = games.stream().map(i -> { 
        var game = new Game();
        var existingGame = existingGamesVWs.stream().filter(x -> x.code == i.id).findFirst().orElse(null);
        game.id = existingGame != null ? existingGame.id : null;
        game.name = i.name;
        game.code = i.id;
        game.abbr = i.abbreviation;

        return game;
    }).toArray(Game[]::new);
}

企业级应用的标准处理方式 #

在Java生态的企业级应用中，优先选择「私有字段+公共Getter/Setter」的方案，但可以通过Lombok工具消除代码冗余，具体原因如下：

1. 框架兼容性更强 #

JPA、Spring、Jackson等主流框架的核心特性（比如JPA的懒加载、Jackson的序列化/反序列化配置）默认依赖Getter/Setter的规范实现。虽然部分框架支持公共字段，但使用Getter/Setter能避免框架适配的潜在问题，适配范围更广。

2. 保留封装的扩展性 #

即使当前属性仅做简单读写，后续如果需要添加数据校验、修改日志、格式转换等逻辑，直接在Getter/Setter中修改即可，无需改动所有调用该属性的业务代码。如果用公共字段，后续扩展必须全量替换调用处，维护成本极高。

3. 符合Java生态的编码规范 #

Oracle官方的Java编码规范、Spring等主流框架的最佳实践，都推荐使用私有字段+访问器的模式，这是Java社区的共识，能提升团队代码的一致性和可读性。

解决代码冗长的方案：Lombok #

既然Java没有C#的自动属性语法，用Lombok的@Data注解可以一键生成所有Getter/Setter、toString、equals等方法，彻底消除冗余代码。比如上述JPA实体类可以简化为：

@Entity
@Table(name = "tbl_game")
@Data
public class Game {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)    
    private Integer id;
    private String name;
    private String code;
    private String abbreviation;
}

Lombok是企业级Java项目的标配工具，完全兼容JPA、Jackson等框架，既保持了封装性，又解决了代码冗长的问题。

公共字段的适用场景 #

只有在极少数临时的、内部使用的简单DTO（比如仅在方法内部传递数据的一次性对象）中，才会偶尔使用公共字段，但绝不推荐在JPA实体、对外的JSON响应类这类核心对象中使用。

内容的提问来源于stack exchange，提问作者mgmedick