day01_Java语言概述/23-尚硅谷-Java语言基础-API文档的说明

好，下一个问题呢，叫Java API文档，咱不是Java API了啊，是API文档，API的话呢，这个词其实咱们稍微提过了，咱们上午的话呢，讲这个，诶这个JDK这个八的时候呢，这不就说到这是我们Java提供的一些类库，哎J个类库呢，其实就可以叫做API了，这个API呢，也是几个单词的缩写，叫application programming interface。啊，叫应用程序编程接口啊，那用通俗的话来说，就是Java给我们提供的一系列的这个这个类库，哎，我们把这个类库呢，就统称为叫API。啊，那API文档是不是就关于这个API怎么使用的一个说明啊，就这个意思啊，呃，就像呢，这个这个。就像什么呀，比如说你买了一个玩具，这个玩具呢，应该怎么玩是吧，哪个键应该是怎么操作的，它有一个说明书，那个说明书呢，就相当于是你这个玩具的一个文档啊，那关于Java API啊，里边有很多了，很丰富，那怎么去使用这些API，这些类库呢？它给我们提供了一个文档，那就这个意思啊，那这个文档的话呢，大家可以通过这个，呃，网址呢，直接你输入进行一个下载，或者呢，你也可以参照呃，给大家发的这个PDF，这下边呢，也有这个说明啊。

哎，这不是关于这个API文档，诶这块呢，你去进行一个下载就可以了啊，那大家呢，就用不着再去下载了，因为已经给大家都下载好了，诶找到我们发的这个课件，这有一个软件，呃，不是软件了文档资料API，诶这呢我就放到这儿了，诶为什么放了好几个啊嗯，首先的话呢，这个咱们讲课呢是用的是八，所以呢，我先放了一个八这个版本的一个API文档，打开以后长这个样子，嗯嗯，来有同学来了一个，我去都是英文的是吧？啊这个你肯定刚开始学的时候呢，会有一定的困难，我上课讲的时候呢，都是拿英文来讲啊，这个也是带着你一起去学一学英文是吧？哎，你得要能够看得懂这里边的一些基本的词汇啊，这是其一，然后呢，你要是自己看的话，看不太明白，你可。

可以参照我这儿给你提供了一个八的一个中文版。啊，这就是八的一个中文版啊，这里面具体你点开啊，这具体的这些结构再点开，这都是中文的了。哎，方便呢，你去呃，通过这个文档呢，查看你必要的一些结构，但是呢啊有个但是哈，但是这个八呢，翻译的其实不是特别好，我在网上找呢，其实也没找到一个特别好的版本。啊，没有一个特别好的版本啊，然后现在市面上流通当中，这个翻译的比较好的一个版本呢，是API6对，也就是这个六里边儿这个中文呢，翻译的是比较不错的。

啊，那咱们开发当中，其实基本上用的呢，还都是这个六啊五啊，这里边定义的这些API8里边那些呢，毕竟用的还是少数啊，所以呢，大家呢，要平时学习的时候呢，如果你想看看中文啊，你就看六知道了啊，上课呢，我会讲的时候用八的英文版讲，你下来看的话，你也可以看六。啊，你可以对照着去去学习，举个例子哈，比如说呢，在这个八里边，你想找其中的一个结构的使用，就像咱们写的这个代码，这其中有一个，你看这个呢，叫这个吧，叫string，叫string，这其实是一个类了啊，但是你现在还不知道，没关系，诶这个string的话呢，大家你就可以在我们这个吧里边，你看这有一个索引啊，在这你就输入这个叫string，输入以后呢，你看这下边有个叫string的一个class哈，双击。哎，这时候就打开这个string了，下面呢，就是关于它的描述，说这个string呢，这个class啊，它是代表了字符的一个序列，呃，所有的这个字符串的话呢，呃，在我们这个Java程序当中，像ABC啊，呃，它会继承都会继承，嗯都是。

啊，相邻ABC啊，它都是相当于是我们这个类的一个实现啊的一个实例啊，就这个意思啊，就这里边的这一句话是对这个string的一个描述，你现在看呢，看不太懂，那你呢，可以打开这个六。六呢，在这有个显示，那在这呢索引这仍然呢，可以去搜这个string啊，你双击，诶这个呢，你点上面这个也行哈，哎，这就过来了，基本上的话，六跟八这些都能对得上啊，那这就是它说4G呢代表一个字符串，哎，这二乘以中所有的这个字符串的字面值，如它都是作为此类的实例实现，哎这句话呢，这不就是对应的这句话吗。

就这样子的，而且呢，你会发现呢，就是我们这个Java的这个说明文档里边，它不会有那种大长句子的啊，不会说这一段话就是一句话，通常没有都是特别都是一些短句哈，一般都是那种的啊，所以呢，看起来其实比那个你看那个英文考试的那个阅读理解其实是要简单一些的啊哎，大家学习的时候呢，建议呢，就是两个对照着看啊，学习学习啊。啊，这是就是我们说的说的这个文档啊，然后呢，大家你也会发现哈，就是你看这个，这是咱们打开的这个GT8的这样一个API的文档，你看这个色调也好啊，整体上好像跟咱们刚才打开的这个是不是有点像。你看是吧，你看这边有一些目录结构，只不过咱这就一个哈，他这的话呢，就多一些呗。呃，他不是在这儿了，在咱们刚才这个看的这个，呃，这个它是在这个位置呈现了啊，他这块具体的就多一些，实际上这个文档。

啊，这个文档呢，也是用Java道解析出来的。啊，他解析完以后呢，就把所有的这些类呢，就都呈现出来了，这就是这就是用文档注释写的这个说明呗。啊，就是这个意思啊，咱们这个呢，是写了一个比较简单的啊，哎，这不就是也是关于他的一个说明，哎，这都是用文档注式来做的。啊行啊，这呢就说明一下叫API文档啊，你就把它呢想象成咱们学习中文的时候的字典一样就可以了，不会的就去找字典啊，不会的就查API文档。啊就可以啊，呃，具体这个API文档呢，这块，呃，我这又分成了几个部分，回头咱们这个应用起来就熟悉了啊这块呢叫做包列表区域类列表区和详细说明啊对应的呢就是嗯。比如我这块我点我这我这一点就就进去了，就啊，它这个是跟不同的版本有时候也有关系，隐藏一下啊，这个出不来了。

它这有时候这个看看不着这个那么详细的了啊，就是你知道啊，这这块这不是有了，就是我们这块能看到啊，这呢就是叫包列表区啊，就是我们把这个具体的这个Java中的各种各样的类库呢，给他分了分就是先有一个包的概念啊，就跟大家的每一个人一样啊呃，这个先有一个年级的概念，年级里边有具体的班，班里边有具体的人啊，一层一层的啊，我们这儿呢，就是先有包，哎，每一个包下呢，诶有具体的好多的类，然后点具体的某一个类呢，诶这块就出来他的详细说明。哎，就这样子的啊，哎，不用着急，后边咱们用的时候呢，来看就可以了啊。