接口与API设计

  • 用前缀避免命名空间冲突

  1. 选择与你的公司,应用程序或两者皆有关联之名称作为类名的前缀,并在所有代码中均使用这一前缀
  2. 若自己所开发的程序库中用到了第三方库,则应为其中的名称加上前缀
  • 提供“全能初始化方法”

  1. 在类中提供一个全能初始化方法。其他初始化方法均应调用此方法。
  2. 若全能初始化方法与超类不同,则需覆写超类中对应的方法
  3. 如果超类的初始化方法不适应于子类,那么应该覆写这个超类方法实现 description 方法
  • 实现 description 方法

  1. 实现 description 方法返回一个有意义的字符串,用以描述该实例
  2. 若想在调试时打印出更详尽的对象描述信息。则应实现 debugDescription 方法
  • 尽量使用不可变对象

  1. 尽量创建不可变对象
  2. 若某属性尽可用于对象内部修改,则在 “class-continuation分类” 中将其由readonly属性扩展为readwrite属性
  3. 不要把可变对象的collection作为属性公开,而应提供相关方法,以此修改对象中的可变 collection
  • 使用清晰而协调的命名方式

  1. 起名时应遵从标准的 Objective-C命名规范,这样创建出来的接口更容易为开发者所理解
  2. 方法名要言简意赅,从左至右读起来要像个日常用语的句子才好
  3. 方法名里不要使用缩略后的类型名称
  • 2
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
(不错的教程,欢迎下载) API是应用编程接口的缩写。API开发在现代软件开发中随处可见,其目的是为某个组件的功能提供一个逻辑接口,同时隐藏该模块内部的实现细节。有些API用起来很顺手,而有些则用起来让人摸不着头脑,更有些让人直接弃用。编写优质的API非常困难。大多数人的经验都源于不断犯错或借鉴别人的经验,而本书试图打破这种局面,提炼出耐用且不会过时的API设计策略。API有哪些品质要求,有哪些关键要素,有哪些通用的技巧,设计时要遵循哪些原则……这些问题都能在本书中找到答案。 本书主要内容。 第1章:API简介。阐释API的概念及其独特之处,概览全书内容。 第2章:特征。解答优秀API应具备的特点。 第3章:模式。着眼于一些特定的API设计模式和惯用法,包括Pimpl惯用法、单例(singleton)、工厂方法(factory method)、代理(proxy)、适配器(adapter)、外观(facade)模式以及观察者(observer)模式。 第4章:设计。讨论功能需求的收集和使用用例建模推动简洁有用的接口设计,以及一些面向对象分析和设计的技术。这一章也将讨论大型软件项目所面临的诸多问题。 第5章:风格。叙述各种风格的C和C++ API,如纯C API、面向对象API、基于模板的API以及数据驱动的API。 第6章:C++的用法。讨论各种能够影响良好API设计的C++语言特性,如良好构造函数和操作符风格、命名空间、指针和引用参数的比较、友元的使用以及如何在动态库中导出符号。 第7章:性能。分析API的性能问题并说明如何使用C++构建高性能的API。 第8章:版本控制。主要讨论API版本控制以及如何保持向。。。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值