04.常用 API 第一部分

一、API

概述
- Java API 是一本程序员的字典，是 JDK 中提供给我们使用的类的说明文档。这些类将底层的代码实现封装了起来，我们不需要关心这些类是如何实现的，只需要学习这些类如何使用即可。所以我们可以通过查询 API 的方式，来学习 Java 提供的类，并得知如何使用它们。
使用步骤
- 打开帮助文档。
- 点击显示，找到索引，看到输入框。
- 你要找谁？在输入框里输入，然后回车。
- 看包。java.lang 下的类不需要导包，其他需要。
- 看类的解释和说明。
- 学习构造方法
- 使用成员方法。

二、Scanner 类

一个可以解析基本类型和字符串的简单文本扫描器。
构造方法
- new Scanner(System.in) ;
成员方法
- nextInt()
  - 返回值： int
  - 将输入信息的下一个标记扫描为一个 int。
- next()
  - 返回值：String
  - 查找并返回来自此扫描器的下一个完整标记。

三、Random 类

用来生成随机数字。
构造方法
- Random()
成员方法
- int nextInt()
  - 返回值：int
  - 获取一个随机的 int 类型数字（范围是 int 所有范围，有正负两种）。
- int nextInt(int n)

四、ArrayList<E> 类

大小可变的数组的实现，存储在内的数据称为元素。此类提供一些方法来操作内部存储的元素。 ArrayList 中可不断添加元素，其大小也自动增长。
尖括号 <E> 代表泛型。
- 泛型：也就是装在集合当中的所有元素，全都是统一的什么类型。
- 泛型只能是引用类型，不能是基本类型。
  - 如果希望向集合 ArrayList 当中存储基本类型数据，必须使用基本类型对应的 "包装类"。
注意事项
- 对于 ArrayList 集合来说，直接打印得到的不是地址值，而是内容。
- 如果内容是空，得到的是空的中括号：[]
构造方法
- ArrayList()
  - 构造一个初始容量为 10 的空列表。
成员方法
- boolean add(E e)
  - 将指定的元素添加到此列表的尾部。
  - 参数：类型和泛型一致
  - 返回值：布尔类型，表示是否添加成功。
    - 对于 ArrayList 集合来说，add 添加动作一定是成功的，所以返回值可用可不用。
    - 对于其他集合（今后学习）来说，add 添加动作不一定成功。
- E get(int index)
  - 返回此列表中指定位置上的元素。
    - 参数：索引值
    - 返回值：指定索引值位的元素。
- E remove(int index)
  - 移除此列表中指定位置上的元素。
    - 参数：索引值
    - 返回值：被删除掉的元素。
- int size()
  - 返回此列表中的元素数。
    - 返回值
      - 集合中包含的元素个数。
遍历
- for 循环

五、String 类

代表字符串，Java 程序中的所有字符串字面值（如 "abc" ）都作为此类的实例实现。
- 其实就是说，程序当中所有的双引号字符串，都是 String 类的对象。（就算没有 new，也照样是。）
特点
- 字符串的内容永不可变。【重点】
- 正是因为字符串不可改变，所以字符串是可以共享使用的。
- 字符串效果上相当于是 char [] 字符数组，但是底层原理是 byte [] 字节数组。
构造方法
- String ()
  - 创建一个空白字符串，不包含任何内容。
- String (char [] chars)
  - 根据字符数组的内容，来创建对应的字符串。
- String ( byte [] bytes)
  - 根据字节数组的内容，来创建对应的字符串。
一种直接创建的方式
- String str = "Hello";
  - 注意：直接写上双引号，就是字符串对象。
字符串常量值池
- 程序当中直接写上的双引号字符串，就在字符串常量池中。
  - 对于基本类型来说，== 是进行数值的比较。
  - 对于引用类型来说，== 是进行【地址值】的比较。
成员方法
boolean equals (Object obj )
- 字符串与指定的对象比较，用来比较字符串的内容
  - 任何对象都能用 Object 进行接收。
  - equals 方法具有对称性，也就是 a.equals(b) 和 b.equals(a) 效果一样。
  - 严格区分大小写。
  - 如果比较双方一个常量一个变量，推荐把常量字符串写在前面。
    - 这样可以防止空指针异常 NullPointerException
boolean equalsIgnoreCase ( String anotherString )
- 将此 String 与另一个 String 比较，不考虑大小写。
int length ()
- 返回字符串的长度。
String concat (String srt )
- 定字符串连接到此字符串的结尾。
- 返回值
  - 拼接后的字符串。
char charAt ( int index )
- 返回指定索引处的 char 值。
int indexOf (String srt )
- 查找参数字符串在本字符串当中首次出现的索引位置.
  - 如果没有返回 -1 值。
String substring ( int index )
- 截取从参数位置一直到字符串末尾，返回新字符串。
String substring ( int begin , int end )
- 截取从 begin 开始，一直到 end 结束，中间的字符串。
  - [begin,end)，包含左边，不包含右边。
char [] toCharArray ()
- 将当前字符串拆分成为字符数组作为返回值。
byte [] getBytes ()
- 获得当前字符串底层的字节数组。
String replace ( CharSequence oldString , CharSequence newString)
- 所有出现的老字符串替换成为新的字符串，返回替换之后的结果新字符串。
  - CharSequence意思就是说可以接受字符串类型。
String [] split ( String regex)
- 按照参数的规则，将字符串切分成为若干部分。
  - split 方法的参数其实是一个“正则表达式”，今后学习。
  - 如果按照英文句点 "." 进行切分，必须写 "\."（两个反斜杠）

六、Arrays 类

是一个与数组相关的工具类，里面提供了大量静态方法，用来实现数组常见的操作。
static String toString (数组)
- 将参数数组变成字符串（按照默认格式：[元素1, 元素2, 元素3...]）
static void sort (数组)
- 按照默认升序（从小到大）对数组的元素进行排序。
  - 如果是数值，sort 默认按照升序从小到大。
  - 如果是字符串，sort 默认按照字母升序。
  - 如果是自定义的类型，那么这个自定义的类需要有 Comparable 或者 Comparator 接口的支持。（今后学习）

七、Math 类

是数学相关的工具类，里面提供了大量的静态方法，完成与数学运算相关的操作。
static double abs ( double num )
- 获取绝对值。有多种重载。
static double ceil ( double num )
- 向上取整。
static double floor ( double num )
- 向下取整。
static long round ( double num )
- 四舍五入。
Math.PI 代表近似的圆周率常量（double）。

八、常用 API 第一部分完结