一点想法:如何写好一个接口
软件物语
一点想法:如何写好一个接口
forxy
2010-12-15, 20:01 下午
由于经常写一些接口,下面是本人的一些想法,欢迎同志们补充(这里主要指C语言):
1)接口必须好看
一个接口无论从调用者、实现者还是维护者的角度来看,他都应当“漂亮”。
好的动态库,应当有版本,windows下可以附加版本,linux下可以通过const static char再源码中标记,并可以通过ident命令查看一些信息。
好的动态库,应该有一个“好看的名称”,名字要贴切,我建议使用如下名字:com.jn.security.XXX.dll
头文件必须好看,不管你内部如何实现,头文件一般都需要提供给调用者,头文件仿佛是一个人的衣服,至少得做到“金玉其外”;
函数名称必须好看,能让人“望文生义”;
接口实现源码必须好看,应有适当的注释;
http://forxy.download.csdn.net/