目录
- 一、API
- 二、API 帮助文档
- 三、LibRec API
- 四、如何看懂 LibRec API？
- 1、Overview 页面
- 2、Package 页面
- 3、Class | Interface 页面
- 4、Use 页面
- 5、Tree 页面
- 6、Deprecated 页面
- 7、Index 页面
- 8、Help 页面
- 五、如何在 API 帮助文档中找到自己想要的查找的方法？
- 六、一个在线的常用 API 索引文档集合
一、API
首先解释第一个问题：什么是 API? 百度百科是这样说的：
API（Application Programming Interface，应用程序接口）是一些预先定义的函数，或指软件系统不同组成部分衔接的约定。目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问原码，或理解内部工作机制的细节。
对于这段话，我比较粗暴的理解是对方把所有的类以及方法都写好了，也就是造好了所谓的"轮子"，我们可以直接的把它放进我们的项目中，就能实现对应的功能。
二、API 帮助文档
再来解释第二个问题：什么是API帮助文档？
API 帮助文档就是对 API 中的这些函数写的文档，它可以帮助开发人员了解函数的使用方法和功能，可以极大的便利想要使用该 API 的 开发人员。
在 JAVA 中，API 帮助文档体现形式为 Javadoc 文档，该文档针对整个方法或者整个类做一个简要的概述，使得别人不通过看具体的方法代码就知道某个方法或者某个类的作用和功能。
你可能会问，那 Javadoc 又是什么呢？Javadoc 是 Sun 公司提供的一个技术，它从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的 API帮助文档，所以这也是为啥很多大的开源项目，代码注释比代码多的原因了！正是为了让使用它的人能够方便的看懂！正所谓助人也助己！
这里所谓的代码的注释是什么呢？实际上在我们使用 Java 语言进行开发的时候，当我们的鼠标悬停在某个类或者某个方法上一般就会有提示信息，而这个提示信息就是源代码上写的注释。我这里截了2张 LibRec 的源代码给大家看下：
则在经过源代码导出的 Javadoc 文档，也就是我们的 LibRec API 文档上我们就可以看到以上的源代码的注释已然写在 API 帮助文档上。
所以在自己写代码的时候，注意写 Javadoc 是多么重要啊，至于怎么写好这个注释，我这里不详细介绍了，有兴趣可以参考Javadoc 使用详解。
三、LibRec API
看到这里，是不是会觉得想要知道库 | 框架 | 项目的某个类或者方法如何使用，查看和源代码配套的API帮助文档是最直接有效的方法了吧！
LibRec 官方公布的 API 帮助文档链接在此，有一点要说明的是该 API 帮助文档是librec-core 2.0 版本的 API 帮助文档，而我使用的是 librec-core 3.0版本的代码，那这份代码参考上面那个API可能会有点错误，我们当然是想要使用目前最新的版本！
那如何得到最新版本的 LibRec API 呢？（如果并不在意这一点的，可以直接看下一个大标题。）读者是否记得上面描述的 :
javadoc 是 Sun 公司提供的一个技术，它从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。
所以其实我们只有要 librec-core 3.0 版本的源代码我们就可以直接生成最新版本的LibRec API 帮助文档了！
我前面的几篇学习笔记中有提及到目前已经有 librec-core 3.0版本的 jar 包了，那是否我们可用 jar 包生成 Javadoc 文档呢？答案是不可以的！Javadoc 只能用 java 源代码生成！所以大家可以直接去 GitHub上下载最新版本的源代码，下载之后，里面的第二个文件夹就有 librec-core 3.0 的源代码。
至于自己怎么从源代码中生成最新版本的 LibRec API 帮助文档供自己使用，大家可以参考这篇链接的做法：如何使用eclipse生成javadoc帮助文档？，我这里就不重复造轮子了！
其中第5步的设置参数是：-encoding UTF-8 -charset UTF-8
四、如何看懂 LibRec API？
1、Overview 页面
如上图是我们刚进 LibRec API 帮助文档显示的界面，左上角显示了该库里的所有包（package），左下角显示了该库里的所有类（class），中间这部分显示的也是库里的所有包（package）。
2、Package 页面
当我们想要查看某个包的情况的时候，比如点击 net.librec.data 包，则会出现以下页面：
这种页面我们称之为包（package）的页面，而每一个包（package）会有单独的一页显示里面包（package）包含的所有
- 类（Classes）
- 接口（Interface）
- 枚举变量（Enums）
- 异常（Exceptions）
- 错误（Errors）
- 注释类型（Annotation Types）
的列表，以及每一个的简单介绍，所以如果想要了解这个包（package）里的任何一个内容，都可以点击进去，会有另外单独的页面显示。
3、Class | Interface 页面
比如当我们想要查看 net.librec.data 包下面的 DataContext 类，单击之后会出现以下页面
当我们想要查看 net.librec.data 包下面的 DataSplitter 接口，单击之后会出现以下页面
以上页面我们称之为类（CLASS）和接口（Interface）的页面，每个类, 接口, 嵌套类和嵌套接口都有各自的页面。其中每个页面都由三部分 (类/接口说明，概要表，以及详细的成员说明) 组成：
- 类继承图 （Class inheritance diagram）
- 直接子类 （Direct Subclasses）
- 所有已知子接口 （All Known Subinterfaces）
- 所有已知实现类 （All Known Implementing Classes）
- 类/接口声明 （Class/interface declaration）
- 类/接口说明（Class/interface description）
- 嵌套类概要 （Nested Class Summary）
- 字段概要 （Field Summary）
- 构造器概要 （Constructor Summary）
- 方法概要 （Method Summary）
- 字段详细资料（Field Detail）
- 构造器详细资料（Constructor Detail）
- 方法详细资料（Method Detail）
4、Use 页面
当我们想要知道特定包 | 类 | 接口 被其他哪些包、类、方法中给使用的时候，可以转至包、类或接口页面，然后单击导航栏中的 USE按钮，最后显示页面基本如下所示：
对于给定的类或接口 A，其 USE 页面 包含 A 的子类, 声明为 A 的字段, 返回 A 的方法, 以及带有类型为 A 的参数的方法和构造器（图中显示的只有一部分）。
5、Tree 页面
当我们想要知道特定包 | 类 | 接口里面的树（Tree）结构的时候，可以转至包、类或接口页面，然后单击导航栏中的 TREE 按钮，最后显示页面基本如下所示：
查看所有包的分层结构，可以直接转到 Overview 页面，然后单击 Tree 页面，即可显示所有程序包的分层结构。
6、Deprecated 页面
已过时的 API 页面列出了所有已过时的 API。一般由于进行了改进并且通常提供了替代的 API，所以建议不要使用已过时的 API，在将来的实现过程中, 可能会删除已过时的 API。
7、Index 页面
包含按字母顺序排列的所有类、接口、 构造器、方法和字段的列表。
这个页面是我比较常用的页面，有时候查找某个具体的包、类、接口里面有什么字段、方法的时候，直接在这个页面上进行查找，能够很快找到！
8、Help 页面
Help页面里的内容是帮助你如何理解各个页面的用途的，展示的是这个 API 帮助文档是如何组织的，也就是我上面讲的 1-7 点！只不过我加了图示让大家看的更明白些。
五、如何在 API 帮助文档中找到自己想要的查找的方法？
如果看完以上各个页面的结构的话，不难发现如果我们想要查找某个类 | 接口里面的方法的话，有以下三种途径：
- 从侧边栏出发，先找到包，再找类 | 接口，进而可以看到里面的所有方法；
- 从 Overview 页面出发，也是先找到包，再找类 | 接口，进而可以看到里面的所有方法；
- 直接从 Index 页面出发，直接找想要找的方法名（如果你知道方法名的话），这个是最快的方法！
六、一个在线的常用 API 索引文档集合
由于 javadoc 的注释是遵循一定语法规则的，所以不管是任何项目的 API 其实都是一个结构（模样），所以说如果你会看这里的 LibRec API 帮助文档了，你就顺带也会看其他库 | 框架 | 项目的 API 帮助文档了！
下面这个是常用的API索引文档在线集合，有需要的可以去看看。
既然会看 API 帮助文档了，那从现在开始自觉养成多看 API 帮助文档的习惯吧！ヾ(◍°∇°◍)ﾉﾞ
