让接口容易被正确实用,不易被误会

本文探讨了如何设计易于正确使用且不易被误用的接口。通过引入新的类型和限制,如Month、Day和Year,可以避免用户输入错误的日期信息。良好的接口设计包括一致性、类型限制、值约束和资源管理责任的消除。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

  1. 接口要规避用户可能犯下的错误。
    例如实现一个用来表现日期的class设计构造函数
    class Date{
    public:
    Date(int month,int day,int year);
    }
    但是这样如果用户误输入一些日期信息或者将信息顺序填错将会发生错误。
    这样我们可以导入简单的外覆环境来区别天数,月份和年份,然后于Date构造函数中使用这些类型:
    struct Day {
    explicit Day(int d)
    :val(d) {}
    int val;
    };
    Month和Year也可以这样定义,规避一些错误。
    限制类型之后,还要限制值。例如
    class Month{
    public:
    static Month Jan() {return Month(1);}
    static Month Feb() {return Month(2);}

    static Month Dec() {return Month(12);}

    private
    explicit Month(int m);

    }
    Date d(Month::Mar(),Day(30),Year(1995));
    好的接口很容易被正确使用,不容易被误用。你应该在你的所有接口中努力达成这些性质。
    促成正确使用的办法包括接口的一致性,以及内置类型的行为兼容。
    阻止误用的办法包括建立新类型,限制类型上的操作,束缚对象值,以及消除客户的资源管理责任。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值