how to write a good api
2012-12-01 23:13
387 查看
个人觉得一套好的API应该在三个方面做到最好,注意是同时满足而不牺牲任何一个:
1. 精确的实现功能,不多不少;
2. 简洁明了,方便用户使用,不让他们迷糊;
3. 具备良好的可扩展性,遵循open-close原则;
当然最近我又学到一点,API应该易于理解和交流,过于深奥的设计是很容易被抛弃的。
1. 精确的实现功能,不多不少;
2. 简洁明了,方便用户使用,不让他们迷糊;
3. 具备良好的可扩展性,遵循open-close原则;
当然最近我又学到一点,API应该易于理解和交流,过于深奥的设计是很容易被抛弃的。
相关文章推荐
- How to use java Properties API -- read and write
- How to write a good SRS
- How to Write a good Email
- How to write a good bug?
- How to write a good build system ?
- prjGetWriteINIFile - How to Read-Write INI file using VB & API - 读取/写入INI文件 - VB6 + API - SourceCode - HackerJLY
- How to write a good bug report
- Talk about how to write good C# code from a bug
- How to write a good user story
- How to write a good paper
- A VS MPF bug, about how to write good virtual fucntion
- How to Design a Good API and Why it Matters
- How to write a good tech blog
- How to write good essay
- Learn how to write a Regular Expression (a very good article)
- how to design a good api and why it matters
- How to write a good design document for peer engineers (如何写一份给工程师看的技术文档)
- How to write a good tech blog
- How to Design a Good API and Why it Matters
- A good blog about how to write an Hadoop MapReduce program in Python