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)
  • 参数：代表了范围，左闭右开
  • 返回值：int
  • 获取一个随机的 int 类型的范围是 [0，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 第一部分完结