您的位置：首页 > 编程技术 > C语言  >  深入C++中API的问题详解

深入C++中API的问题详解

 更新时间：2020年4月25日 17:47  点击：2000
前言：本文书写的格式与其它不相同。本文题目说是关于C++ API的思考，其实也不仅仅是C++，对于其它语言同样适用。

API实际是指Application Programming Interface,应用程序编程接口。对API是一套用来控制Windows的各个部件的外观和行为的一套预先定义的Windows函数。在C++中我认为：一个API就是一堆类以及类中方法和字段的集合。
并不是所有的签名都是API的一部分，未公开的部分(private)内容不是API，它不对外承诺兼容性。API广泛定义：凡是有利于在“无绪”的状态下把一个大的系统以组件集成的方法拼装出来的东西都属于API。

为什么要开发API？
我们希望将大块的构建模块“无绪”地集合成应用程序，一些构建模块包含共享库、框架、预先定义好的程序架构，以及这些内容的组合。

如何检查API的质量？
1、可理解性
2、一致性
3、可见性
4、简单的任务应该有简单的方案
5、保护投资

API设计技巧一:
不要把类中的字段直接对外公布，而应该放置在内部。最好让外部用户只能通过set、Get方法来访问字段，千万不要将字段直接公布出来。

使用方法访问字段要好于直接访问字段。如果你在编写API的时候遵守这一建议，那么可以在这个API的下一个版本中对方法的具体实现进行很多改动，如添加数据的验证和校验、覆盖一个方法等，还可以做一些大的变化。如果直接使用指端就不能做上述改动。

API设计技巧二:
使用工厂方法而不是直接使用构造函数来创建一个对象。

使用工厂方法创建对象的好处：
1、工厂方法的返回值并不一定是声明类型的实例，它可以是它子类的实例。使用工厂方法可以更好的体现面向对象语言中多态的优势，代码也会显得更加简洁。
2、每次返回的对象并不一定都是新创建的对象，完全可以将其缓存。相比之下，每次调用构造函数都会创建一个实例，而一个工厂方法可以缓存以前创建的对象，并重用他们，从而节省了内存。
3、对同步控制，在工厂方法中可以将创建对象前后的相应代码进行统一处理。构造函数对这一种情况就无能为力。

API设计技巧三:
让所有的内容不可改，如果不考虑让其拥有子类，就应该让这个类不能被继承。
强烈推荐：不公开构造函数，转而提供工厂方法
 
API设计技巧四:
避免滥用set方法，在不部分情况下set方法是多余的。
建议：小心API中的每一个不必要的set方法

API设计技巧五:
尽可能通过友元的方式来公开功能。为了让用户更加简单明了地使用好你的API，就不要再你的API中公开太多的方法，不要给用户犯错的机会。

API设计技巧六:
避免暴露深层次继承。一旦发现继承体系超过两层时，一定要打住，并多多思考一下，要弄清楚：“我到底设计API还是在复用代码？”如果答案是后者，那么重新审视，并严格设计这个API，或者做好子类化的准备。
[!--infotagslink--]

相关文章

  • C语言实现放烟花的程序

    这篇文章主要为大家详细介绍了C语言实现放烟花的程序，有音乐播放，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下...2021-02-23

  • C语言中的字符（char）详细讲解

    本篇文章主要介绍C语言中char的知识,并附有代码实例,以便大家在学习的时候更好的理解,有需要的可以看一下...2020-04-25

  • 详解如何将c语言文件打包成exe可执行程序

    这篇文章主要介绍了详解如何将c语言文件打包成exe可执行程序，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2021-02-25

  • 浅谈vue2的$refs在vue3组合式API中的替代方法

    这篇文章主要介绍了浅谈vue2的$refs在vue3组合式API中的替代方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2021-04-18

  • WebStorm无法正确识别Vue3组合式API的解决方案

    这篇文章主要介绍了WebStorm无法正确识别Vue3组合式API的解决方案，帮助大家更好的理解和学习使用vue框架，感兴趣的朋友可以了解下...2021-02-18

  • C语言中free函数的使用详解

    free函数是释放之前某一次malloc函数申请的空间，而且只是释放空间，并不改变指针的值。下面我们就来详细探讨下...2020-04-25

  • C语言中计算正弦的相关函数总结

    这篇文章主要介绍了C语言中计算正弦的相关函数总结,包括正弦和双曲线正弦以及反正弦的函数,需要的朋友可以参考下...2020-04-25

  • 详解C语言中的rename()函数和remove()函数的使用方法

    这篇文章主要介绍了详解C语言中的rename()函数和remove()函数的使用方法,是C语言入门学习中的基础知识,需要的朋友可以参考下...2020-04-25

  • C语言中求和、计算平均值、方差和标准差的实例

    这篇文章主要介绍了C语言中求和、计算平均值、方差和标准差的实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧...2020-12-10

  • C语言的基本语法详解

    本篇文章主要讲解C语言 基本语法,这里提供简单的示例和代码来详细讲解C语言的基本语法，开始学习C语言的朋友可以看一下，希望能够给你带来帮助...2021-09-18

  • 如何使用 JavaScript 操作浏览器历史记录 API

    这篇文章主要介绍了如何使用 JavaScript 操作浏览器历史记录 API，帮助大家更好的理解和使用JavaScript，感兴趣的朋友可以了解下...2020-11-24

  • vue设置全局访问接口API地址操作

    这篇文章主要介绍了vue设置全局访问接口API地址操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧...2020-08-14

  • 理解JavaScript中worker事件api

    这篇文章主要帮助大家理解JavaScript中worker事件api，对worker事件api有一个深刻了解，感兴趣的小伙伴们可以参考一下...2015-12-27

  • C语言中send()函数和sendto()函数的使用方法

    这篇文章主要介绍了C语言中send()函数和sendto()函数的使用方法,是C语言入门学习中的基础知识,需要的朋友可以参考下...2020-04-25

  • 如何设计一个安全的API接口详解

    在日常开发中,总会接触到各种接口,前后端数据传输接口,第三方业务平台接口,下面这篇文章主要给大家介绍了关于如何设计一个安全的API接口的相关资料,需要的朋友可以参考下...2021-08-12

  • Vue常用API、高级API的相关总结

    这篇文章主要介绍了Vue常用API、高级API的相关总结，帮助大家更好的理解和学习使用vue框架，感兴趣的朋友可以了解下...2021-02-04

  • C语言实现从文件读入一个3*3数组,并计算每行的平均值

    今天小编就为大家分享一篇C语言实现从文件读入一个3*3数组,并计算每行的平均值，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧...2020-04-25

  • C# Windows API应用之基于GetDesktopWindow获得桌面所有窗口句柄的方法

    这篇文章主要介绍了C# Windows API应用之基于GetDesktopWindow获得桌面所有窗口句柄的方法,结合实例形式分析了GetDesktopWindow函数用于获取窗口句柄的具体使用方法与相关注意事项,需要的朋友可以参考下...2020-06-25

  • C语言中memcpy 函数的用法详解

    这篇文章主要介绍了C语言中memcpy 函数的用法详解的相关资料,需要的朋友可以参考下...2020-04-25

  • 使用C语言操作文件的基本函数整理

    这篇文章主要介绍了使用C语言操作文件的基本函数整理,包括创建和打开以及关闭文件的操作方法,需要的朋友可以参考下...2020-04-25