## API

### API概述-帮助文档的使用

- 什么是API

API (Application Programming Interface) ：`应用程序编程接口`

- java中的API

指的就是 JDK 中提供的各种功能的 Java类，这些类将底层的实现封装了起来，我们不需要关心这些类是如何实现的，只需要学习这些类如何使用即可，我们可以通过帮助文档来学习这些API如何使用。

**如何使用API帮助文档 :**

- 打开帮助文档

- 找到索引选项卡中的输入框

- 在输入框中输入Random

- 看类在哪个包下

- 看类的描述

- 看构造方法

- 看成员方法

### 键盘录入字符串

**Scanner类 :**

`next() `: 遇到了空格, 就不再录入数据了 , 结束标记: 空格, tab键

`nextLine()` : 可以将数据完整的接收过来 , 结束标记: 回车换行符

**代码实现 :**

```java
package com.itheima.api;

import java.util.Scanner;

public class Demo1Scanner {
    /*
        next() : 遇到了空格, 就不再录入数据了

结束标记: 空格, tab键

nextLine() : 可以将数据完整的接收过来

结束标记: 回车换行符
     */
    public static void main(String[] args) {
        // 1. 创建Scanner对象
        Scanner sc = new Scanner(System.in);
        System.out.println("请输入:");
        // 2. 调用nextLine方法接收字符串
        // ctrl + alt + v : 快速生成方法的返回值
        String s = sc.nextLine();

System.out.println(s);
    }
}

```

```java
package com.itheima.api;

import java.util.Scanner;

public class Demo2Scanner {
    /*
        nextInt和nextLine方法配合使用的时候, nextLine方法就没有键盘录入的机会了

建议: 今后键盘录入数据的时候, 如果是字符串和整数一起接受, 建议使用next方法接受字符串.
     */
    public static void main(String[] args) {
        Scanner sc = new Scanner(System.in);
        System.out.println("请输入整数:");
        int num = sc.nextInt(); // 10 + 回车换行
        System.out.println("请输入字符串:");
        String s = sc.nextLine();

System.out.println(num);
        System.out.println(s);
    }
}
```

## String

### String概述

1. String类在java.lang包下，所以使用的时候不需要导包。
2. String 类代表字符串，Java 程序中的所有字符串文字（例如“abc”）都被实现为此类的实例也就是说，Java 程序中所有的双引号字符串，都是 String 类的对象。
3. 字符串一旦被创建，值就不可能发生改变。若是字符串内容发生了改变，那么一定是创建了一个新的字符串的对象。
4. 字符串是由一个个的字符组成的，比如:"abc" --> 'a' 'b' 'c'。
5. 字符串是有索引的，最小的索引是0，最大的索引是字符串的长度-1。

### String类的构造方法

常用的构造方法

| 方法名                         | 说明                                      |
| ------------------------------ | ----------------------------------------- |
| public String()                | 创建一个空白的字符串对象，不含有任何内容  |
| public String(char[] chs)      | 根据字符数组的内容，来创建字符串对象      |
| public String(String original) | 根据传入的字符串内容，来创建字符串对象    |
| String s = "abc"               | 直接赋值的方式创建字符串对象，内容就是abc |

**示例代码**

```java
/**
 * @Author: ✎﹏ Sunflower丶
 */
public class Demo2StringConstructor {
    /*
        String类常见构造方法:

public String() : 创建一个空白字符串对象，不含有任何内容
            public String(char[] chs) : 根据字符数组的内容，来创建字符串对象
            public String(String original) : 根据传入的字符串内容，来创建字符串对象
            String s = “abc”;  直接赋值的方式创建字符串对象，内容就是abc

注意:
                String这个类比较特殊, 打印其对象名的时候, 不会出现内存地址
                而是该对象所记录的真实内容.

面向对象-继承, Object类
     */
    public static void main(String[] args) {
        // public String() : 创建一个空白字符串对象，不含有任何内容
        String s1 = new String();
        System.out.println(s1);

// public String(char[] chs) : 根据字符数组的内容，来创建字符串对象
        char[] chs = {'a','b','c'};
        String s2 = new String(chs);
        System.out.println(s2);

// public String(String original) : 根据传入的字符串内容，来创建字符串对象
        String s3 = new String("123");
        System.out.println(s3);
        
        String s4 = "123";
        String s5 = "123";
    }
}
```

### 创建字符串对象的区别对比

- **通过构造方法创建**

通过 new 创建的字符串对象，每一次 new 都会申请一个内存空间，`虽然内容相同，但是地址值不同`

- **直接赋值方式创建**

以“”方式给出的字符串，只要字符序列相同(顺序和大小写)，`无论在程序代码中出现几次，JVM 都只会建立一个 String 对象，并在字符串池中维护`

### 字符串的特点

* Java程序中所有的双引号字符串，都是String类的对象
* 字符串不可变，它们的值在创建后不能被更改
* 虽然String的值是不可变的，但是他们可以被共享

### 字符串的比较

#### 字符串的比较

- == 比较基本数据类型：`比较的是具体的值`
- == 比较引用数据类型：`比较的是对象地址值`

**String类 :  public boolean equals(String s)     比较两个字符串内容是否相同、区分大小写**

**代码 :**

```java
package com.itheima.stringmethod;

public class Demo1Equals {
    public static void main(String[] args) {
        String s1 = "abc";
        String s2 = "ABC";
        String s3 = "abc";

// equals : 比较字符串内容, 区分大小写
        System.out.println(s1.equals(s2));	//false
        System.out.println(s1.equals(s3));  //true
		
        //比较的地址值，但因为常量池，因此他们会指向同一个地址值。
        System.out.println(s1 == s3);		//true
        
        
        
        // equalsIgnoreCase : 比较字符串内容, 忽略大小写
        System.out.println(s1.equalsIgnoreCase(s2)); 			//true
    }
}

```

* ` 字符串常量池`：当使用双引号创建字符串对象的时间，系统会检查该字符串是否在字符串常量池中存在

不存在：创建

存在：不会重新创建，二十直接复用

### 用户登录案例

**案例需求 :**

已知用户名和密码，请用程序实现模拟用户登录。总共给三次机会，登录之后，给出相应的提示

**实现步骤 : **

1. 已知用户名和密码，定义两个字符串表示即可
2. 键盘录入要登录的用户名和密码，用 Scanner 实现
3. 拿键盘录入的用户名、密码和已知的用户名、密码进行比较，给出相应的提示。
4. 字符串的内容比较，用equals() 方法实现
5. 用循环实现多次机会，这里的次数明确，采用for循环实现，并在登录成功的时候，使用break结束循

**代码实现 :**

```java
/**
 * @Author: ✎﹏ Sunflower丶
 */
import java.util.Scanner;

public class Test1 {
    /*
        需求：已知用户名和密码，请用程序实现模拟用户登录。
              总共给三次机会，登录之后，给出相应的提示

思路：
        1. 已知用户名和密码，定义两个字符串表示即可
        2. 键盘录入要登录的用户名和密码，用 Scanner 实现
        3. 拿键盘录入的用户名、密码和已知的用户名、密码进行比较，给出相应的提示。
            字符串的内容比较，用equals() 方法实现
        4. 用循环实现多次机会，这里的次数明确，采用for循环实现，并在登录成功的时候，使用break结束循环

*/
    public static void main(String[] args) {
        // 1. 已知用户名和密码，定义两个字符串表示即可
        String username = "admin";
        String password = "123456";
        // 2. 键盘录入要登录的用户名和密码，用 Scanner 实现
        Scanner sc = new Scanner(System.in);
        // 4. 用循环实现多次机会，这里的次数明确，采用for循环实现
        for(int i = 1; i <= 3; i++){
            System.out.println("请输入用户名:");
            String scUsername = sc.nextLine();
            System.out.println("请输入密码:");
            String scPassword = sc.nextLine();
            // 3. 拿键盘录入的用户名、密码和已知的用户名、密码进行比较，给出相应的提示。
            if(username.equals(scUsername) && password.equals(scPassword)){
                System.out.println("登录成功");
                break;
            }else{
                if(i == 3){
                    System.out.println("您的登录次数已达到今日上限, 请明天再来");
                }else{
                    System.out.println("登录失败,您还剩余" + (3-i) +"次机会");
                }

}
        }

}
}
```

###  遍历字符串案例

**案例需求 :**

键盘录入一个字符串，使用程序实现在控制台遍历该字符串

**实现步骤 :**

1. 键盘录入一个字符串，用 Scanner 实现
2. 遍历字符串，首先要能够获取到字符串中的每一个字符, `public char charAt(int index)`：返回指定索引处的char值，字符串的索引也是从0开始的
3. 遍历字符串，其次要能够获取到字符串的长度,   `public int length()`：返回此字符串的长度
4. 遍历打印

**代码实现 :**

```java
/**
 * @Author: ✎﹏ Sunflower丶
 */
import java.util.Scanner;

public class Test2 {
    /*
        需求：键盘录入一个字符串，使用程序实现在控制台遍历该字符串

思路：
        1. 键盘录入一个字符串，用 Scanner 实现
        2. 遍历字符串，首先要能够获取到字符串中的每一个字符
            public char charAt(int index)：返回指定索引处的char值，字符串的索引也是从0开始的
        3. 遍历字符串，其次要能够获取到字符串的长度
            public int length()：返回此字符串的长度
        4. 遍历打印
9
     */
    public static void main(String[] args) {
        //  1. 键盘录入一个字符串，用 Scanner 实现
        Scanner sc = new Scanner(System.in);
        System.out.println("请输入:");
        String s = sc.nextLine();
        // 2. 遍历字符串，首先要能够获取到字符串中的每一个字符
        for(int i = 0; i < s.length(); i++){
            // i : 字符串的每一个索引
            char c = s.charAt(i);
            System.out.println(c);
        }
    }
}
```

### 统计字符次数案例

**案例需求 :**

键盘录入一个字符串，使用程序实现在控制台遍历该字符串

**实现步骤 :**

1. 键盘录入一个字符串，用 Scanner 实现
2. 将字符串拆分为字符数组 , `public char[] toCharArray( )`：将当前字符串拆分为字符数组并返回
3. 遍历字符数

**代码实现 :**

```java
/**
 * @Author: ✎﹏ Sunflower丶
 */
import java.util.Scanner;

public class Test3 {
    /*
       需求：键盘录入一个字符串，使用程序实现在控制台遍历该字符串

思路：
       1. 键盘录入一个字符串，用 Scanner 实现
       2. 将字符串拆分为字符数组
                public char[] toCharArray( )：将当前字符串拆分为字符数组并返回
       3. 遍历字符数组

*/
    public static void main(String[] args) {
        //  1. 键盘录入一个字符串，用 Scanner 实现
        Scanner sc = new Scanner(System.in);
        System.out.println("请输入:");
        String s = sc.nextLine();
        // 2. 将字符串拆分为字符数组
        char[] chars = s.toCharArray();
        // 3. 遍历字符数组
        for (int i = 0; i < chars.length; i++) {
            System.out.println(chars[i]);
        }
    }
}
```

### 手机号屏蔽-字符串截取

**案例需求 :**

以字符串的形式从键盘接受一个手机号，将中间四位号码屏蔽
        最终效果为：156****1234

**实现步骤 :**

1. 键盘录入一个字符串，用 Scanner 实现
2. 截取字符串前三位
3. 截取字符串后四位
4. 将截取后的两个字符串，中间加上****进行拼接，输出结果

**代码实现 :**

```java
package com.itheima.test;

import java.util.Scanner;

public class Test5 {
    /*
        需求：以字符串的形式从键盘接受一个手机号，将中间四位号码屏蔽
        最终效果为：156****1234

思路：
        1. 键盘录入一个字符串，用 Scanner 实现
        2. 截取字符串前三位
        3. 截取字符串后四位
        4. 将截取后的两个字符串，中间加上****进行拼接，输出结果

*/
    public static void main(String[] args) {
        // 1. 键盘录入一个字符串，用 Scanner 实现
        Scanner sc = new Scanner(System.in);
        System.out.println("请输入手机号:");
        String telString = sc.nextLine();
        // 2. 截取字符串前三位
        String start = telString.substring(0,3);
        // 3. 截取字符串后四位
        String end = telString.substring(7);
        // 4. 将截取后的两个字符串，中间加上****进行拼接，输出结果
        System.out.println(start + "****" + end);
    }
}
```

### 敏感词替换-字符串替换

**案例需求 :**

键盘录入一个 字符串，如果字符串中包含（TMD），则使用***替换

**实现步骤 :**

1. 键盘录入一个字符串，用 Scanner 实现
2. 替换敏感词
   ` String replace(CharSequence target, CharSequence replacement)`
    将当前字符串中的target内容，使用replacement进行替换，返回新的字符串
3. 输出结果

**代码实现 :**

```java
/**
 * @Author: ✎﹏ Sunflower丶
 */
import java.util.Scanner;

public class Test6 {
    /*
        需求：键盘录入一个 字符串，如果字符串中包含（TMD），则使用***替换

思路：
        1. 键盘录入一个字符串，用 Scanner 实现
        2. 替换敏感词
                String replace(CharSequence target, CharSequence replacement)
                将当前字符串中的target内容，使用replacement进行替换，返回新的字符串
        3. 输出结果

*/
    public static void main(String[] args) {
        // 1. 键盘录入一个字符串，用 Scanner 实现
        Scanner sc = new Scanner(System.in);
        System.out.println("请输入:");
        String s = sc.nextLine();
        // 2. 替换敏感词
        String result = s.replace("TMD","***");
        // 3. 输出结果
        System.out.println(result);
    }
}
```

### 切割字符串

**案例需求 :**

以字符串的形式从键盘录入学生信息，例如：“张三 , 23”

从该字符串中切割出有效数据,封装为Student学生对象

**实现步骤 :**

1. 编写Student类，用于封装数据

2. 键盘录入一个字符串，用 Scanner 实现

3. 根据逗号切割字符串，得到（张三）（23）

`String[] split(String regex) ：根据传入的字符串作为规则进行切割`
   将切割后的内容存入字符串数组中，并将字符串数组返回

4. 从得到的字符串数组中取出元素内容，通过Student类的有参构造方法封装为对象

5. 调用对象getXxx方法，取出数据并打印。

**代码实现 :**

```java
/**
 * @Author: ✎﹏ Sunflower丶
 */
import com.itheima.domain.Student;

import java.util.Scanner;

public class Test7 {
    /*
         需求：以字符串的形式从键盘录入学生信息，例如：“张三 , 23”
                从该字符串中切割出有效数据,封装为Student学生对象
         思路：
            1. 编写Student类，用于封装数据
            2. 键盘录入一个字符串，用 Scanner 实现
            3. 根据逗号切割字符串，得到（张三）（23）
                    String[] split(String regex) ：根据传入的字符串作为规则进行切割
                    将切割后的内容存入字符串数组中，并将字符串数组返回
            4. 从得到的字符串数组中取出元素内容，通过Student类的有参构造方法封装为对象
            5. 调用对象getXxx方法，取出数据并打印。

*/
    public static void main(String[] args) {
        // 2. 键盘录入一个字符串，用 Scanner 实现
        Scanner sc = new Scanner(System.in);
        System.out.println("请输入学生信息:");
        String stuInfo = sc.nextLine();
        // stuInfo = "张三,23";
        // 3. 根据逗号切割字符串，得到（张三）（23）
        String[] sArr = stuInfo.split(",");

//        System.out.println(sArr[0]);
//        System.out.println(sArr[1]);

// 4. 从得到的字符串数组中取出元素内容，通过Student类的有参构造方法封装为对象
        Student stu = new Student(sArr[0],sArr[1]);

// 5. 调用对象getXxx方法，取出数据并打印。
        System.out.println(stu.getName() + "..." + stu.getAge());
    }
}
```

### String方法小结

**String类的常用方法 :**

`public boolean equals(Object anObject)`  比较字符串的内容，严格区分大小写

`public boolean equalsIgnoreCase(String anotherString)`  比较字符串的内容，忽略大小写

`public int length() ` 返回此字符串的长度

`public char charAt(int index)  `返回指定索引处的 char 值

`public char[] toCharArray()` 将字符串拆分为字符数组后返回

`public String substring(int beginIndex, int endIndex) ` 根据开始和结束索引进行截取，得到新的字符串（包含头，不包含尾）

`public String substring(int beginIndex)`  从传入的索引处截取，截取到末尾，得到新的字符串

`public String replace(CharSequence target, CharSequence replacement)`  使用新值，将字符串中的旧值替换，得到新的字符串

`public String[] split(String regex)` 根据传入的规则切割字符串，得到字符串数组

## StringBuilder类

### StringBuilder类概述

**概述 :** StringBuilder 是一个可变的字符串类，我们可以把它看成是一个容器，这里的可变指的是 StringBuilder 对象中的内容是可变的

作用：提高字符串的操作效率。

### StringBuilder类和String类的区别

- **String类：**`内容是不可变的`
- **StringBuilder类：**`内容是可变的`

### StringBuilder类的构造方法

**常用的构造方法**

| 方法名                             | 说明                                       |
| ---------------------------------- | ------------------------------------------ |
| public StringBuilder()             | 创建一个空白可变字符串对象，不含有任何内容 |
| public StringBuilder(String   str) | 根据字符串的内容，来创建可变字符串对象     |

**示例代码**

```java
public class StringBuilderDemo01 {
    public static void main(String[] args) {
        //public StringBuilder()：创建一个空白可变字符串对象，不含有任何内容
        StringBuilder sb = new StringBuilder();
        System.out.println("sb:" + sb);
        System.out.println("sb.length():" + sb.length());

//public StringBuilder(String str)：根据字符串的内容，来创建可变字符串对象
        StringBuilder sb2 = new StringBuilder("hello");
        System.out.println("sb2:" + sb2);
        System.out.println("sb2.length():" + sb2.length());
    }
}
```

### StringBuilder常用的成员方法

- **添加和反转方法**

| 方法名                                  | 说明                     |
  | --------------------------------------- | ------------------------ |
  | public StringBuilder   append(任意类型) | 添加数据，并返回对象本身 |
  | public StringBuilder   reverse()        | 返回相反的字符序列       |

- **示例代码**

```java
public class StringBuilderDemo01 {
    public static void main(String[] args) {
        //创建对象
        StringBuilder sb = new StringBuilder();

//public StringBuilder append(任意类型)：添加数据，并返回对象本身
//        StringBuilder sb2 = sb.append("hello");
//
//        System.out.println("sb:" + sb);
//        System.out.println("sb2:" + sb2);
//        System.out.println(sb == sb2);

//        sb.append("hello");
//        sb.append("world");
//        sb.append("java");
//        sb.append(100);

//链式编程
        sb.append("hello").append("world").append("java").append(100);

System.out.println("sb:" + sb);

//public StringBuilder reverse()：返回相反的字符序列
        sb.reverse();
        System.out.println("sb:" + sb);
    }
}
```

### StringBuilder和String相互转换

- **StringBuilder转换为String**

`public String toString()`：通过 toString() 就可以实现把 StringBuilder 转换为 String

- **String转换为StringBuilder**

`public StringBuilder(String s)`：通过构造方法就可以实现把 String 转换为 StringBuilder

- **示例代码**

```java
public class StringBuilderDemo02 {
    public static void main(String[] args) {
        /*
        //StringBuilder 转换为 String
        StringBuilder sb = new StringBuilder();
        sb.append("hello");

//String s = sb; //这个是错误的做法

//public String toString()：通过 toString() 就可以实现把 StringBuilder 转换为 String
        String s = sb.toString();
        System.out.println(s);
        */

//String 转换为 StringBuilder
        String s = "hello";

//StringBuilder sb = s; //这个是错误的做法

//public StringBuilder(String s)：通过构造方法就可以实现把 String 转换为 StringBuilder
        StringBuilder sb = new StringBuilder(s);

System.out.println(sb);
    }
}
```

### StringBuilder拼接字符串案例

**案例需求 :**

定义一个方法，把 int 数组中的数据按照指定的格式拼接成一个字符串返回，调用该方法，

并在控制台输出结果。例如，数组为int[] arr = {1,2,3}; ，执行方法后的输出结果为：[1, 2, 3]

**实现步骤 :**

1. 定义一个 int 类型的数组，用静态初始化完成数组元素的初始化
2. 定义一个方法，用于把 int 数组中的数据按照指定格式拼接成一个字符串返回。
       返回值类型 String，参数列表 int[] arr
3. 在方法中用 StringBuilder 按照要求进行拼接，并把结果转成 String 返回
4. 调用方法，用一个变量接收结果
5. 输出结果

**代码实现 :**

```java
/**
 * @Author: ✎﹏ Sunflower丶
 */
public class StringBuilderTest01 {
    public static void main(String[] args) {
        //定义一个 int 类型的数组，用静态初始化完成数组元素的初始化
        int[] arr = {1, 2, 3};

//调用方法，用一个变量接收结果
        String s = arrayToString(arr);

//输出结果
        System.out.println("s:" + s);

}

//定义一个方法，用于把 int 数组中的数据按照指定格式拼接成一个字符串返回
    /*
        两个明确：
            返回值类型：String
            参数：int[] arr
     */
    public static String arrayToString(int[] arr) {
        //在方法中用 StringBuilder 按照要求进行拼接，并把结果转成 String 返回
        StringBuilder sb = new StringBuilder();

sb.append("[");

for(int i=0; i<arr.length; i++) {
            if(i == arr.length-1) {
                sb.append(arr[i]);
            } else {
                sb.append(arr[i]).append(", ");
            }
        }

sb.append("]");

String s = sb.toString();

return  s;
    }
}
```

API、String、StringBuilder

目录