API文档使用方法
Java API文档阅读方法
API是什么?有很多初学java的程序员,对这个概念并不是很清楚。
下面我简单解释一下:
API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,
目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。
从概念上看,还是有点信息的,但是很多人还是不怎么理解,API是什么,怎么用,
举个简单的例子:Scanner这个类是获取键盘输入的,大部分人都有接触过,但是怎么用呢?为什么要这样用?
用法:Scanner mScanner=new Scanner(System.in);
int num=mScammer.nextInt();这个我们应该不陌生
但是它为什么这样用?System.in是什么?
其实我们不需要理解,因为是API规定,我们需要记住它
这里有必要说一下:API和API文档的区别:
API就是我们设计程序用的接口和方法,API文档就是API接口的使用说明;接口是一种特殊的类。
随着越来越深入的学习,我们会接触越来越深奥的API。
我们正常用的包里面所有类、方法怎么用,里面传什么东西,返回什么东西,API都有规定,我们想用这个类或方法,我们就要理解相关的API文档。
所有网上很多API的解释说明,就是针对某个类某个方法的说明,这不就是相当于一个说明书吗?
API 文档仅仅是查询类、方法的功能、参数的(前提是对这些类有初步的认识),并不能教你怎样去使用 Java做东西的。
API 文档的作用主要在于你的某些类有了些初步的了解之后,再想更深入一步的情况下使用的.或者有出新的API,而网上有没有相关的知识解答。这时候就需要我们自己查找API文档去解决我们的问题!
前提是你必须先去网上下载API文档,才能查看,本文末尾提供了链接地址。
API文档使用方法,这里举个例子,比如如要看Math类里面的方法
前三步:选择目录,选择AllClasses ,在All Classes列表做选择
第四步:在AllClasses里面查找Math类,这里类排列的顺序是按照A-Z的顺序排列的
第五步,点击要查看的类名,就会进入详情页面,查看详细的文档
第六步:向下翻动就会有所有方法的列表
第七步:找到你想要的方法,页面上有大概的介绍和使用方法
第八步:如果还想了解详细点,可以点击方法,进入里面查看方法的详细使用方法,每个参数的意义。
在这里我只是简单教大家怎样学看API的方法,
这里举的例子是教大家从AllClasses里面查找某一个类
大家也可以从某一个包里面查找某一个类:点击两下All Profiles,会出现包的选择
因为文档是英文的所以阅读上会有一点障碍,最好下一个翻译软件,比如我下的是金山词霸2016,划词会自动翻译。
这里提供一个AP文档I下载的网址(我的博客资源):http://download.csdn.net/detail/wenzhi20102321/9619913
(资源文件名写错成jdk了,也不知道怎么改的!)
还有,一般的API解释网上都有比较成熟的使用方法和应用解释,都能查得到,但是学会自己看API文档也是以备后患吧,万一没有呢!是吧。