1️⃣▶常用API

1 Object类

1.1 基本概述

• java.lang.Object
• Java语言中的根类，即所有类的父类。它中描述的所有方法子类都可以使用。在对象实例 化的时候，最终找的父类就是Object。

1.2 方法2/11

1.2.1 public String toString()

• 作用：返回该对象的字符串表示，其实该字符串内容就是对象的类型+@+内存地址值？？。由于toString方法返回的结果是内存地址，而在开发中，经常需要按照对象的属性得到相应的字符串表现形式，因此也需要重写它。
• 重写方法：可以点击 Code 菜单中的 Generate… ，也可以使用快捷键 alt+insert ，点击 toString() 选项。选择需要包含的成员变量并确定。

public class Person {
	private String name;
	private int age;
	@Override
	public String toString() {
		return "Person{" + "name='" + name + '\'' + ", age=" + age + '}';
	}
	// 省略构造器与Getter Setter
}

1.2.2 public boolean equals(Object obj)

• 作用：调用成员方法equals并指定参数为另一个对象，则可以判断这两个对象是否相同的。这里的“相同”有默认和自定义两种方式。
• 默认地址比较：如果没有覆盖重写equals方法，那么Object类中默认进行 == 运算符的对象地址比较，只要不是同一个对象（同一引用），结果必然为false。
• 自定义（对象内容比较）：进行对象的内容比较，即所有或指定的部分成员变量相同就判定两个对象相同，则可以覆盖重写equals方法。以使用 Code 菜单中的 Generate… 选项，也可以使用快捷键 alt+insert ，并选择 equals() and hashCode() 进行自动代码生成。
• Objects 类：重写equals代码中，使用到 java.util.Objects 类。Object的equals方法容易抛出空指针异常，而Objects类中的equals方法就优化了这个问题。它由一些静态的实用方法组成，这些方法是null-save（空指针安全的）或null-tolerant（容忍空指针的），用于计算对象的hashcode、返回对象的字符串表示形式、比较两个对象。

import java.util.Objects;
public class Person {
	private String name;
	private int age;
	@Override
	public boolean equals(Object o) {
		// 如果对象地址一样，则认为相同
		if (this == o)
			return true;
		// 如果参数为空，或者类型信息不一样，则认为不同
		if (o == null || getClass() != o.getClass())
			return false;
		// 转换为当前类型
		Person person = (Person) o;
		// 要求基本类型相等，并且将引用类型交给java.util.Objects类的equals静态方法取用结果
		return age == person.age && Objects.equals(name, person.name);
	}
}

为什么要写hashcode？

根据一个类的equals方法（改写后），两个截然不同的实例有可能在逻辑上是相等的，但是，根据Object.hashCode方法，它们仅仅是两个对象。因此，违反了“相等的对象必须具有相等的散列码”

原则用hashmap的底层来记忆

• 1 、如果两个对象equals，Java运行时环境会认为他们的hashcode一定相等。
• 2、如果两个对象不equals，他们的hashcode有可能相等。
• 3、如果两个对象hashcode相等，他们不一定equals。
• 4、如果两个对象hashcode不相等，他们一定不equals。

实现
17和31散列码的想法

public class User {
    private String name;
    private int age;
    private String passport;
    //getters and setters, constructor
    @Override
    public boolean equals(Object o) {
        if (o == this) return true;
        if (!(o instanceof User)) {
            return false;
        }
        User user = (User) o;
        return user.name.equals(name) &&
                user.age == age &&
                user.passport.equals(passport);
    }
    //Idea from effective Java : Item 9
    @Override
    public int hashCode() {
        int result = 17;
        result = 31 * result + name.hashCode();
        result = 31 * result + age;
        result = 31 * result + passport.hashCode();
        return result;
    }
}

对于JDK7及更新版本，你可以是使用java.util.Objects 来重写 equals 和 hashCode 方法，代码如下：

import java.util.Objects;

public class User {
    private String name;
    private int age;
    private String passport;

    //getters and setters, constructor

    @Override
    public boolean equals(Object o) {
        if (o == this) return true;
        if (!(o instanceof User)) {
            return false;
        }
        User user = (User) o;
        return age == user.age &&
                Objects.equals(name, user.name) &&
                Objects.equals(passport, user.passport);
    }

    @Override
    public int hashCode() {
        return Objects.hash(name, age, passport);
    }

}

2 日期类1——Date类

2.1 基本概述

• java.util.Date
• 从基准时间开始的毫秒数。 基准时间：于我们处于东八区，所以我们的基准时间为1970年1月1日8时0分0秒。

2.2 构造方法

• public Date() ：分配Date对象并初始化此对象，以表示分配它的时间（精确到毫秒）。
• public Date(long date) ：分配Date对象并初始化此对象，以表示自从标准基准时间以来的指定毫秒数。

可直接打印Date对象！！！！在使用println方法时，会自动调用Date类中已覆盖重写的toString方法。

import java.util.Date;
public class Demo01Date {
	public static void main(String[] args) {
		// 创建日期对象，把当前的时间
		System.out.println(new Date()); // Tue Jan 16 14:37:35 CST 2018
		// 创建日期对象，把当前的毫秒值转成日期对象
		System.out.println(new Date(0L)); // Thu Jan 01 08:00:00 CST 1970
	}
}

2.3 常用方法

• public long getTime() ：把日期对象转换成对应的时间毫秒值。

Date类中的多数方法已经过时

3 日期类2——DateFormat类

3.1 基本概述

• java.text.DateFormat
• 由于DateFormat为抽象类，需要常用的子类java.text.SimpleDateFormat来实现。
• 是日期/时间格式化子类的抽象类，在Date对象与String对象之间进行来回转换。
• 格式化：从Date对象转换为String对象。 解析：从String对象转换为Date对象。

3.2 构造方法

• 子类 java.text.SimpleDateFormat的方法。
• public SimpleDateFormat(String pattern) ：用给定的模式和默认语言环境的日期格式符号构造SimpleDateFormat。参数pattern字符串，自定义格式。
• 格式规则： “yyyy‐MM‐dd HH:mm:ss”，对应的日期格式如：2018‐01‐16 15:06:38 区分大小写。

3.3 常用方法

• 子类 java.text.SimpleDateFormat的方法。

3.3.1 public String format(Date date)

将Date对象格式化为字符串。

public static void main(String[] args) {
	Date date = new Date();
	// 创建日期格式化对象,在获取格式化对象时可以指定风格
	DateFormat df = new SimpleDateFormat("yyyy年MM月dd日");
	String str = df.format(date);
	System.out.println(str); // 2008年1月23日
}

3.3.2 public Date parse(String source)

将字符串解析为Date对象。

public static void main(String[] args) throws ParseException {
	DateFormat df = new SimpleDateFormat("yyyy年MM月dd日");
	String str = "2018年12月11日";
	Date date = df.parse(str);
	System.out.println(date); // Tue Dec 11 00:00:00 CST 2018
}

4 日期类3——Calendar类

4.1 基本概述

• java.util.Calendar
• 日历类，替换掉了许多Date的方法。该类将所有可能用到的时间信息封装为静态成员变量。方便获取各个时间属性。
• Calendar为抽象类，语言敏感性，在创建对象时非直接创建，通过静态方法创建，返回子类对象。public static Calendar getInstance() 默认时区和语言环境获得一个日历。

4.2 成员变量

字段值	含义
YEAR	年
MONTH	月（从0开始，可以+1使用）
DAY_OF_MONTH	月中的天（几号）
HOUR	（12小时制）
HOUR_OF_DAY	（24小时制）
MINUTE	分
SECOND	秒
DAY_OF_WEEK	周中的天（周几，周日为1，可以-1使用）

get/set直接可以通过Calendar类获取。

4.3 常用方法

4.3.1 get/set方法

• get方法用来获取指定字段的值
• set方法用来设置指定字段的值

Calendar cal = Calendar.getInstance();
//获取年
int year = cal.get(Calendar.YEAR);
// 获取月
int month = cal.get(Calendar.MONTH) + 1;
// 获取日
int dayOfMonth = cal.get(Calendar.DAY_OF_MONTH);
//设置年
cal.set(Calendar.YEAR, 2020);

4.3.2 add方法

• add方法可以对指定日历字段的值进行加减操作

Calendar cal = Calendar.getInstance();
System.out.print(year + "年" + month + "月" + dayOfMonth + "日"); // 2018年1月17日
// 使用add方法
cal.add(Calendar.DAY_OF_MONTH, 2); // 加2天
cal.add(Calendar.YEAR, ‐3); // 减3年

4.3.3 getTime方法

不是获取毫秒时刻，而是拿到对应的Date对象

Calendar cal = Calendar.getInstance();
Date date = cal.getTime();

5 System类

5.1 基本概述

• java.lang.System
• 类中提供了大量的静态方法，可以获取与系统相关的信息或系统级操作。

5.2 常用方法

5.2.1 currentTimeMillis方法

获取当前系统时间与1970年01月01日00:00点之间的毫秒差值

//获取当前时间毫秒值
System.out.println(System.currentTimeMillis());

5.2.2 arraycopy方法

• public static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length)；
• 数组的拷贝动作是系统级的，性能很高
• 参数含义（源数组，源数组索引起始位置，目标数组，目标数组索引起始位置，复制元素个数）

int[] src = new int[]{1,2,3,4,5};
int[] dest = new int[]{6,7,8,9,10};
System.arraycopy( src, 0, dest, 0, 3);
/*代码运行后：两个数组中的元素发生了变化
src数组元素[1,2,3,4,5]
dest数组元素[1,2,3,9,10]
*/

6 StringBuilder类

6.1 基本概述

• java.lang.StringBuilder
• 字符串是常量，它们的值在创建后不能被更改。如果对字符串进行拼接操作（+），每次拼接，都会构建新的String对象，耗时费空间。该类解决这一问题。
• StringBuilder可变字符序列，String 的字符串缓冲区，通过某些方法？？？调用可以改变该序列的长度和内容。
  它的内部有一个数组来存放内容，字符串拼接时，直接在数组中加入。StringBuilder会自动维护数组的扩容(默认16字符空间，超过自动扩充？)。
• 可直接输出！！已经覆盖重写了Object当中的toString方法

6.2 构造方法

6.2.1 public StringBuilder()

构造一个空的StringBuilder容器。

StringBuilder sb1 = new StringBuilder();
System.out.println(sb1); // (空白)

6.2.2 public StringBuilder(String str)

构造一个StringBuilder容器，并将字符串添加进去。

// 使用带参构造
StringBuilder sb2 = new StringBuilder("itcast");
System.out.println(sb2); // itcast

6.3 常用方法

6.3.1 public StringBuilder append(…)

添加任意类型数据的字符串形式，并返回当前对象自身。

StringBuilder builder = new StringBuilder();
builder.append("hello").append("world").append(true).append(100);
System.out.println("builder:"+builder);

6.3.2 public String toString()

将当前StringBuilder对象转换为不可变String对象。

StringBuilder sb = new StringBuilder("Hello").append("World").append("Java");
// 调用方法
String str = sb.toString();
System.out.println(str); // HelloWorldJava

6.4 延伸对比

String、StringBuilder、StringBuffer的区别

• 可变：StringBuilder、StringBuffer 不可变：String
• 效率高低：StringBuilder > StringBuffer
• 线程安全：StringBuilder < StringBuffer

7 包装类

7.1 基本类型和包装类型

基本类型在于效率，然而很多情况，会创建对象使用，因为对象可以做更多的功能。

基本类型	对应的包装类（位于java.lang包中）
byte	Byte
short	Short
int	Integer
long	Long
float	Float
double	Double
char	Character
boolean	Boolean

7.2装箱与拆箱

• 基本类型与对应的包装类对象之间，来回转换的过程称为”装箱“与”拆箱“

7.2.1 基本数值---->包装对象

Integer i = new Integer(4);//使用构造函数函数
Integer iii = Integer.valueOf(4);//使用包装类中的valueOf方法

7.2.2 包装对象---->基本数值

int num = i.intValue();

7.3 自动装箱与自动拆箱

• 从Java 5（JDK 1.5）开始，基本类型与包装类的装箱、拆箱动作 可以自动完成

Integer i = 4;//自动装箱。相当于Integer i = Integer.valueOf(4);
i = i + 5;//等号右边：将i对象转成基本数值(自动拆箱) i.intValue() + 5;
//加法运算完成后，再次装箱，把基本数值转成对象。

7.4 基本类型和字符串之间的转换

7.4.1 基本类型->String

有三种方式，最简单一种：

//基本类型直接与””相连接即可；如：
String a = 34+"dd";

7.4.2 String->基本类型

• 除了Character类之外（String获取单字符可以调用charAt方法），其他所有包装类都具有parseXxx静态方法可以将字符串参数转换为对应的基本类型。
• public static byte parseByte(String s) ：将字符串参数转换为对应的byte基本类型。
• public static short parseShort(String s) ：将字符串参数转换为对应的short基本类型。
• public static int parseInt(String s) ：将字符串参数转换为对应的int基本类型。
• public static long parseLong(String s) ：将字符串参数转换为对应的long基本类型。
• public static float parseFloat(String s) ：将字符串参数转换为对应的float基本类型。
• public static double parseDouble(String s) ：将字符串参数转换为对应的double基本类型。
• public static boolean parseBoolean(String s) ：将字符串参数转换为对应的boolean基本类型。

public class Demo18WrapperParse {
	public static void main(String[] args) {
		int num = Integer.parseInt("100");
	}
}

• 转换失败抛出异常：java.lang.NumberFormatException 异常。