• 条款18:让接口容易被正确使用,不宜被误用。


    先考虑下面这个接口:

    1 class Data{
    2 ...
    3 public:
    4     Data(int month, int day, int year);
    5 };

    虽然声明是比较合理的,但是有时候人们不一定会这样做,例如做下面这样调用对于客户来说也是完全可能的:

    Data(2, 30, 1995);

    可能只是手误打错了30和20,但是接口额使用者并不能很好的观察的这一点,看看下面对这个接口的重新设计:

    struct Month{
        Month(int mon):val(mon){}
        int val
    };
    struct Day{
        Month(int day):val(day){}
        int val
    };
    struct Year{
        Month(int year):val(year){}
        int val
    };
    接口就会设计成这样:
    Data(Month , Day, Year);
    那么调用的时候可能就需要这样去调用:
    Data(Month(month), Day(day), Year(year));
    虽然看起来可能会比较繁琐,但是用户犯错误的概率也大大降低了。
    (这个地方可以回过头来考虑一下第四条)
     
    还有一个例子就是前面的13条里面的一个函数:
    1 Investment * createInvestment();
    2 //使用原始指针可能会使得用户饭错误的概率大大增加,这里尝试使用一个智能指针来返回更好!
    3 shared_ptr<Investment> createInvestment()
    4 {
    5     ...
    6     return shared_ptr<Investment>(new Investment(tmpIvst));
    7 }
    一般,返回智能指针的话也应该给他取指定一个很好的删除器,
    PS: shared_ptr有一个很好的特性即使i,他可以给每个单独的指针指定特定的删除器。这有助于避免new/delete的一种情况,对于一个指针在一个Dll中被赋值,但是另一个Dll中却被delete掉,而
    对于shared_ptr就不会有这种问题,其删除器是在new的时候就指定好了的删除器,所以不会出现像上述那样的跨越Dll的new/delete情况。
     
    小结:
    1. 好的接口容易被正确使用,不易被误用
    2. 取经正确使用的方法包括有接口的一致性,以及与内置类型的行为兼容
    3. 组织误用的方法包括有: 建立新的类型(例如上面的struct),限制类型上的操作,束缚对象的值,以及消除客户的资源管理责任。
    4. shared_ptr支持自定义删除器,这可以防范DLL问题,条款14就用这个特性来自动解除了互斥锁。
  • 相关阅读:
    织梦删除不需要的文件及文件安全设置
    织梦安全设置
    阿里云一个虚拟主机安装多个织梦系统
    显示织梦模板不存在的解决方法
    织梦安装
    织梦修改数据库密码
    CSS实现兼容性的渐变背景(gradient)效果
    css边框样式、边框配色、边框阴影、边框圆角、图片边框
    织梦后台编辑器添加中文字体
    织梦安装百度编辑器
  • 原文地址:https://www.cnblogs.com/-wang-cheng/p/4857622.html
Copyright © 2020-2023  润新知