0

0

Java设计模式之建造者模式的实际应用案例

爱谁谁

爱谁谁

发布时间:2025-07-13 20:32:02

|

697人浏览过

|

来源于php中文网

原创

建造者模式通过独立建造者对象解决复杂对象构建的痛点。①它分离构建过程与表示,避免构造器参数爆炸和对象状态不一致;②提供链式调用设置属性,提升代码可读性和健壮性;③在build()方法中统一校验参数,确保对象有效性;④被广泛应用于spring框架(如webclient.builder)、mybatis(sqlsessionfactorybuilder)及lombok(@builder注解)等主流库中;⑤设计时需权衡是否增加类复杂度及维护成本。

Java设计模式之建造者模式的实际应用案例

建造者模式在Java中,其实就是一种让你能优雅地“组装”复杂对象的方式,特别适合那些构造器参数爆炸或者有多种构建步骤的场景。它把构建过程和最终产品的表示分离开来,让代码更清晰,更易维护。

Java设计模式之建造者模式的实际应用案例

我会从一个实际的场景入手,比如我们经常需要构建一个配置项非常多的对象。想象一下,你有一个Notification类,它可能包含发送者、接收者、消息内容、消息类型(邮件、短信、站内信)、优先级、附件列表等等。如果用传统的构造函数,你很快就会陷入“构造器地狱”——一个构造函数参数巨长,或者需要写一堆重载构造函数,维护起来简直是噩梦。

建造者模式的妙处就在于,它提供了一个独立的“建造者”对象。这个建造者知道如何一步步地构建最终的Notification实例。你只需要链式调用建造者的方法,设置你关心的属性,最后调用build()方法,就能得到一个完整的、状态一致的Notification对象。这不仅让代码读起来更像自然语言,而且避免了在对象构造过程中出现半成品的状态。

立即学习Java免费学习笔记(深入)”;

Java设计模式之建造者模式的实际应用案例

建造者模式如何解决复杂对象构建的痛点?

在Java开发中,我们经常会遇到需要构建一个拥有众多属性,且其中大部分属性都是可选的对象。传统的做法,要么是定义一个参数列表极长的构造函数(俗称“伸缩构造器”反模式),这不仅可读性极差,而且一旦参数顺序错乱,编译通过但运行时可能就出问题了;要么就是先创建一个空对象,再通过一堆setter方法去设置属性。后者的缺点在于,对象在完成所有setter调用之前,其内部状态可能是不完整的或不一致的,这在多线程环境下尤其危险。

建造者模式正是为了解决这些痛点而生。它将对象的构建过程从其表示中分离出来。一个典型的建造者模式实现,会有一个内部静态类作为Builder,它拥有与目标对象相同的属性,并提供链式调用的方法来设置这些属性。最后,通过一个build()方法来返回最终构建好的对象。

Java设计模式之建造者模式的实际应用案例

举个例子,假设我们要构建一个HttpRequest对象,它可能有URL、方法、头部信息、请求体、超时时间等。

import java.util.HashMap;
import java.util.Map;

public class HttpRequest {
    private String url;
    private String method;
    private Map<String, String> headers;
    private String body;
    private int timeout;

    // 私有构造函数,只能通过Builder构建
    private HttpRequest(Builder builder) {
        this.url = builder.url;
        this.method = builder.method;
        this.headers = builder.headers;
        this.body = builder.body;
        this.timeout = builder.timeout;
    }

    // Getter方法 (为简洁省略)
    public String getUrl() { return url; }
    public String getMethod() { return method; }
    public Map<String, String> getHeaders() { return headers; }
    public String getBody() { return body; }
    public int getTimeout() { return timeout; }

    public static class Builder {
        private String url;
        private String method = "GET"; // 默认值
        private Map<String, String> headers = new HashMap<>();
        private String body;
        private int timeout = 5000; // 默认超时5秒

        public Builder(String url) {
            this.url = url;
        }

        public Builder method(String method) {
            this.method = method;
            return this;
        }

        public Builder addHeader(String key, String value) {
            this.headers.put(key, value);
            return this;
        }

        public Builder body(String body) {
            this.body = body;
            return this;
        }

        public Builder timeout(int timeout) {
            this.timeout = timeout;
            return this;
        }

        public HttpRequest build() {
            // 可以在这里进行参数校验
            if (url == null || url.isEmpty()) {
                throw new IllegalArgumentException("URL cannot be null or empty");
            }
            return new HttpRequest(this);
        }
    }
}

使用时:

Nanonets
Nanonets

基于AI的自学习OCR文档处理,自动捕获文档数据

下载
// 假设在某个main方法或服务中
// import com.example.HttpRequest; // 假设HttpRequest在com.example包下

HttpRequest request = new HttpRequest.Builder("https://api.example.com/data")
                                     .method("POST")
                                     .addHeader("Content-Type", "application/json")
                                     .body("{ \"key\": \"value\" }")
                                     .timeout(10000)
                                     .build();
// System.out.println(request.getUrl());
// System.out.println(request.getMethod());

这种方式极大地提升了代码的可读性和健壮性。你一眼就能看出这个HttpRequest对象是如何被构建出来的,而且在build()方法中,我们还可以统一进行参数校验,确保构建出的对象是有效的。

建造者模式在哪些Java框架和库中被广泛应用?

建造者模式并非只存在于理论之中,它在许多流行的Java框架和库中都有着广泛而巧妙的应用。它的存在让这些框架的API设计更加优雅和易用。

例如,在Spring框架中,你可能会在构建RestTemplateWebClient(Spring 5+)或者各种Builder类(如UriComponentsBuilder)时看到它的身影。WebClient的构建就是典型的建造者模式,你可以通过链式调用设置baseURL、过滤器、编码器等,最终调用build()方法得到一个可用的客户端实例。

import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.web.reactive.function.client.WebClient;

// WebClient的建造者模式应用
WebClient webClient = WebClient.builder()
                               .baseUrl("http://localhost:8080")
                               .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
                               .filter((request, next) -> {
                                   // 可以在这里添加一些请求日志或认证逻辑
                                   System.out.println("Request URL: " + request.url());
                                   return next.exchange(request);
                               })
                               .build();

另一个经典案例是MyBatis的SqlSessionFactoryBuilder。虽然它不是直接构建一个数据对象,但其核心思想是根据配置文件(或Java代码)一步步构建出SqlSessionFactory这个重量级对象。Configuration对象内部也常常采用建造者模式的思想来配置各种映射器和插件。

再比如,Lombok库通过@Builder注解,可以非常方便地为你的POJO类自动生成建造者模式的代码,极大地减少了样板代码。这本身就是对建造者模式实用性的一个侧面印证。

import lombok.Builder;
import lombok.Data;

@Data
@Builder // Lombok会自动生成Builder类和相关方法
public class Product {
    private Long id;
    private String name;
    private String description;
    private double price;
    private int stock;
    private String category;
}

// 使用Lombok生成的Builder
// import com.example.Product; // 假设Product在com.example包下

Product product = Product.builder()
                         .id(123L)
                         .name("Java编程思想")
                         .price(99.50)
                         .stock(100)
                         .category("Books")
                         .build();
// System.out.println(product.getName());

甚至在JDK内部,一些类的设计也暗含了建造者模式的思想,比如StringBuilderStringBuffer,它们通过链式调用append方法来逐步构建字符串,虽然严格意义上它们是可变对象,但其构建流程与建造者模式有异曲同工之妙。

这些应用无一不体现了建造者模式在处理复杂对象构建时的强大能力和带来的代码整洁度。它让API的使用者无需关心对象内部复杂的构造细节,只需关注需要设置哪些属性即可。

应用建造者模式时,有哪些值得深思的设计考量和潜在挑战?

尽管建造者模式好处多多,但在实际应用中,我们

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

160

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

88

2026.01.26

mybatis一级缓存和二级缓存
mybatis一级缓存和二级缓存

在MyBatis中,一级缓存和二级缓存是两种不同级别的缓存机制,它们都可以用来提高性能。本专题提供mybatis一级缓存和二级缓存相关文章,大家可以免费阅读。

304

2023.08.21

ibatis和mybatis有什么区别
ibatis和mybatis有什么区别

ibatis和mybatis的区别:1、基本信息不同;2、开发时间不同;3、功能与易用性;4、配置文件;5、入参类型与出参类型;6、返回结果集接受方式;7、语法差异;8、数据库方言支持;9、插件支持;10、社区活跃度;11、全球化支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

94

2024.02.23

mybatis如何配置数据库连接
mybatis如何配置数据库连接

mybatis配置数据库连接的方法:1、指定数据源;2、配置事务管理器;3、配置类型处理器和映射器;4、使用环境元素;5、配置别名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

106

2024.02.23

mybatis工作原理及流程是什么
mybatis工作原理及流程是什么

mybatis工作原理及流程:1、配置文件;2、接口与映射;3、sql解析与生成;4、执行计划;5、结果处理;6、动态sql;7、缓存机制;8、插件;9、事务管理;10、日志与监控;11、扩展性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

161

2024.02.23

hibernate和mybatis有哪些区别
hibernate和mybatis有哪些区别

hibernate和mybatis的区别:1、实现方式;2、性能;3、对象管理的对比;4、缓存机制。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

158

2024.02.23

Java MyBatis框架
Java MyBatis框架

本专题专注于Java主流ORM框架MyBatis的应用,系统讲解SQL映射、动态SQL、结果映射、分页查询、缓存机制与多表关联等核心内容,并结合企业管理系统、电商平台和后台管理项目实战,帮助学员全面掌握高效的数据库持久层开发技能。

136

2025.08.26

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

25

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
10分钟--Midjourney创作自己的漫画
10分钟--Midjourney创作自己的漫画

共1课时 | 0.1万人学习

Midjourney 关键词系列整合
Midjourney 关键词系列整合

共13课时 | 0.9万人学习

AI绘画教程
AI绘画教程

共2课时 | 0.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号