Java API最佳实践

（给ImportNew加星标，提高Java技能）来自：唐尤华，译自：https://dzone.com/refcardz/java-api-best-practices想要让人们使用你的软件，你必须成为一名 API 开发者。这篇文章中，你将了解如何制作文档完备、具备一致性、可扩展的 API。帮助用户充分利用你的 Java 应用程序。1. 简介身为软件开发工程师，我们每天都编写代码。然而不可思议的是，这些代码会一直“存在于真空中”，与所有其他开发的软件隔离开来。在软件工程领域，“站在巨人的肩膀上”这个比喻从来没有像今天这样合适。GitHub、Stack Overflow、Maven Central 以及所有其他代码仓库、支持库和软件库都唾手可得。软件是由应用程序编程接口（API）构建的——我们每天都在使用 Maven 或 Gradle 等工具引入的 JDK API 和数量众多 ………………………………