为了使自己写的API发布出去后,别人能够容易使用,应该参考以下这些原则:
1.谨慎选择方法的名字:选择一个与功能相符合,并且相似的名字。比如在java中,对于移除,通常命名为remove,比较少用delete
2.不要过于追求提供便利的方法:不要定义太多冗余的方法
3.避免太长的参数列表:参数列表数,通常最大值被定为3个,如果超过3个,很容易出错。并且,避免定义太多类型相同的参数
4.对于参数的类型,优先使用接口而不是类:尽力使用父类的接口来定义参数类型,这样方便拥有这个父类的所有子类使用这个方法
5.谨慎使用函数对象:过得的使用函数对象,会降低程序的可读行。不过,在策略模式以及其他设计模式中,函数对象经常出现