0

0

C++建造者模式如何实现流畅接口设计 链式调用与参数校验结合

P粉602998670

P粉602998670

发布时间:2025-07-11 10:14:01

|

671人浏览过

|

来源于php中文网

原创

c++++中,建造者模式通过链式调用和参数校验提升接口的可读性与安全性。1. 链式调用通过返回*this引用实现,使多个设置方法连续调用;2. 参数校验可在设置时立即抛出异常或延迟至build()统一处理;3. 接口设计应提供默认值、支持移动语义并命名清晰,从而兼顾灵活性与健壮性。

C++建造者模式如何实现流畅接口设计 链式调用与参数校验结合

在C++中,建造者模式常用于构建复杂对象,而结合链式调用和参数校验,可以让接口更清晰、易用且安全。关键在于如何设计类结构和方法返回值,使得每一步操作都能自然地串联起来,同时又不忽略必要的检查。

C++建造者模式如何实现流畅接口设计 链式调用与参数校验结合

一、链式调用的核心:返回 *this 的引用

实现链式调用的关键是每个设置方法都返回当前对象的引用(通常是 *this)。这样可以在一个语句中连续调用多个方法。

C++建造者模式如何实现流畅接口设计 链式调用与参数校验结合

例如:

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

class PersonBuilder {
public:
    PersonBuilder& setName(const std::string& name) {
        name_ = name;
        return *this;
    }

    PersonBuilder& setAge(int age) {
        age_ = age;
        return *this;
    }

    // 其他字段设置...

private:
    std::string name_;
    int age_;
};

使用方式如下:

C++建造者模式如何实现流畅接口设计 链式调用与参数校验结合
Person person = PersonBuilder().setName("Tom").setAge(25).build();

这种方式让代码更具可读性,也更容易维护。但要注意的是,所有设置方法必须返回 PersonBuilder& 类型,不能是值或指针,否则链式调用会中断。

二、参数校验如何融入链式流程

直接返回 *this 虽然方便,但如果某些字段需要校验怎么办?比如年龄不能为负数,名字不能为空等。

这时候可以考虑两种策略:

LangChain
LangChain

一个开源框架,用于构建基于大型语言模型(LLM)的应用程序。

下载
  • 立即抛出异常:在校验失败时抛出异常,阻止非法状态继续构建。

    PersonBuilder& setAge(int age) {
        if (age < 0) {
            throw std::invalid_argument("Age cannot be negative");
        }
        age_ = age;
        return *this;
    }
  • 延迟校验,在 build() 中统一处理:适用于部分字段之间有依赖关系的情况。

    Person build() {
        if (name_.empty()) {
            throw std::invalid_argument("Name is required");
        }
        if (age_ < 0) {
            throw std::invalid_argument("Age cannot be negative");
        }
        return Person(name_, age_);
    }

两种方式各有适用场景:

  • 如果字段独立性强,建议尽早校验;
  • 如果字段之间有关联,统一在 build 阶段验证更合理。

三、流畅接口设计的一些细节优化

为了让 API 更加友好,还可以做一些小改进:

  • 默认构造函数提供合理的初始值 这样用户不需要手动设置每一个字段。

  • 支持移动语义(Move Semantics) 如果字段类型较大,可以考虑使用 std::move 提高性能。

  • 命名清晰简洁 方法名尽量动词开头,如 setName, addTag, enableFeature 等。

举个例子,一个带默认值和链式调用的 builder 可能像这样:

class RequestBuilder {
public:
    RequestBuilder() : timeout_(1000), retry_(3) {}

    RequestBuilder& setUrl(const std::string& url) {
        url_ = url;
        return *this;
    }

    RequestBuilder& setTimeout(int ms) {
        if (ms <= 0) throw std::invalid_argument("Timeout must be positive");
        timeout_ = ms;
        return *this;
    }

    RequestBuilder& setMaxRetry(int retry) {
        retry_ = retry;
        return *this;
    }

    Request build() const {
        if (url_.empty()) throw std::invalid_argument("URL is required");
        return Request(url_, timeout_, retry_);
    }

private:
    std::string url_;
    int timeout_;
    int retry_;
};

这种写法兼顾了灵活性与安全性,用户使用起来也更顺手。


基本上就这些。链式调用虽然简单,但配合好参数校验,能让建造者模式的接口既流畅又健壮。

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1018

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

62

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

402

2025.12.29

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

4

2026.01.15

公务员递补名单公布时间 公务员递补要求
公务员递补名单公布时间 公务员递补要求

公务员递补名单公布时间不固定,通常在面试前,由招录单位(如国家知识产权局、海关等)发布,依据是原入围考生放弃资格,会按笔试成绩从高到低递补,递补考生需按公告要求限时确认并提交材料,及时参加面试/体检等后续环节。要求核心是按招录单位公告及时响应、提交材料(确认书、资格复审材料)并准时参加面试。

26

2026.01.15

公务员调剂条件 2026调剂公告时间
公务员调剂条件 2026调剂公告时间

(一)符合拟调剂职位所要求的资格条件。 (二)公共科目笔试成绩同时达到拟调剂职位和原报考职位的合格分数线,且考试类别相同。 拟调剂职位设置了专业科目笔试条件的,专业科目笔试成绩还须同时达到合格分数线,且考试类别相同。 (三)未进入原报考职位面试人员名单。

31

2026.01.15

国考成绩查询入口 国考分数公布时间2026
国考成绩查询入口 国考分数公布时间2026

笔试成绩查询入口已开通,考生可登录国家公务员局中央机关及其直属机构2026年度考试录用公务员专题网站http://bm.scs.gov.cn/pp/gkweb/core/web/ui/business/examResult/written_result.html,查询笔试成绩和合格分数线,点击“笔试成绩查询”按钮,凭借身份证及准考证进行查询。

6

2026.01.15

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

63

2026.01.14

php与html混编教程大全
php与html混编教程大全

本专题整合了php和html混编相关教程,阅读专题下面的文章了解更多详细内容。

34

2026.01.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

【web前端】Node.js快速入门
【web前端】Node.js快速入门

共16课时 | 2万人学习

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

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