zoukankan      html  css  js  c++  java
  • EC笔记:第4部分:18、接口正确使用,不易被误用

    • 好的接口容易被正确使用,不易被误用

    考虑以下函数:

    void func(int year,int month,int day){

        //一些操作

    }

    这个函数看似合理,因为参数的名字已经暴露了它的用途。但是如果只有寒暑签名呢?如下:

    void func(int,int,int);

    就算我告诉你,此处需要日期作为参数,你可能会以月日年、日月年等不同形式作为参数。

    正确的做法是把年月日都各自抽象为一个类(或者说是结构体):

    struct Year {

        int year;

    };

     

    struct Month {

        int month;

    };

     

    struct Day {

        int day;

    };

     

    void func(Year year,Month month,Day day){

        //一些操作

    }

    这样即使你只有函数签名,也不会轻易出错。

    • 用于内置类型的行为兼容

    尽量要在行为上与现有类型兼容,因为一般用户会先与类型作为参考。

    如:int类型不支持:

    int a=5;

    int b=6;

    int c=50;

    a+b=c;//错误

    那么你自己定义的类型,也不应该有类似的语法:

    MyType a;

    MyType b;

    MyType c;

    a+b=c;//尽量不要这样去做,除非你有更好的理由

    • 建立新类型、限制类型上的操作、束缚对象值、消除客户的资源管理责任

    为了防止用户犯错,一般的方式就是为我们的新类型加上各种限制,比如限定月份的值为1到12,日期的值为1到31等。在用户输入非法的值的时候给出明确的提示或警告。

    • 设想各种被应用的场景

    我们要假设用户各种可能犯错的场景,比如,在多线程环境中使用,如果不支持多线程,就应该明确的在文档中输出。或者是,用户的非法输入,非法调用,我们应该尽可能地进行合法性检验。

    尽可能让用户在不改变现有使用习惯的情况下,尽可能的少出错。

  • 相关阅读:
    结对第一次作业-原型设计(文献摘要热词统计)
    第一次作业-准备篇
    Docker 安装 redis
    Docker 安装 MySQL8
    个人作业——软件工程实践总结作业
    团队作业第二次—项目选题报告
    结对第二次—文献摘要热词统计及进阶需求
    结对第一次—原型设计(文献摘要热词统计)
    第一次作业-准备篇
    个人作业——软件工程实践总结
  • 原文地址:https://www.cnblogs.com/SkyFireITDIY/p/6231425.html
Copyright © 2011-2022 走看看