3장 - 모든 객체의 공통 메서드

10. equals는 일반 규약을 지켜 재정의하라

• 재정의하지 말아야 할 경우

  1. 각 인스턴스가 고유하다. ex: Thread(값을 표현하는 것이 아니라 동작하는 개체를 표현하는 클래스)
  2. 인스턴스의 '논리적 동치성(logical equality)'을 검사할 일이 없다.
  3. 상위 클래스에서 재정의한 equals가 하위 클래스에도 딱 들어맞는다.
  4. 클래스가 private이거나 package-private이고 equals 메서드를 호출할 일이 없다.

  // 호출 방지법
  @Override public boolean equals(Object o){
  	throw new new AssertionError();
  }
  

• equals 재정의해야 할 경우

  1. 논리적 동치성을 확인해야 할 때 ex: 값 클래스들

• equals 메서드 재정의 일반 규약

  1. 반사성(reflexivity): x.equals(x)는 true
  2. 대칭성(symmetry): x.equals(y)가 true, y.equals(x)도 true
  3. 추이성(transitivity): x.equals(y)가 true and y.equals(z)가 true, x.equals(z) true
  4. 일관성(consistency): x.equals(y)는 항상 true or false를 동일하게 리턴해야한다.
  5. null-아님: x.equals(null)은 무조건 false!!

• 양질의 메서드 구현 방법

  1. == 연산자를 사용해 입력이 자기 자신의 참조인지 확인한다.
  2. instanceof 연산자로 입력이 올바른 타입인지 확인한다.
  3. 입력을 올바른 타입으로 형변환한다.
  4. 입력 객체와 자기 자신의 대응되는 '핵심' 필드들이 모두 일치하는지 하나씩 검사한다.
  5. equals를 재정의할 땐 hashcode도 반드시 재정의하자
  6. 너무 복잡하게 해결하려 들지 말자
  7. Object 외의 타입을 매개변수로 받는 equals 메서드는 선언하지 말자

• Google @AutoValue을 사용하면 편리하다

11. equals를 재정의하려거든 hashcode도 재정의하라

• hashcode에 대한 Object 명세 규약
  1. 객체의 hashCode 메서드는 몇 번을 호출해도 같은 값을 반환
  2. 두 객체가 같다고 하면 두 객체의 hashCode는 똑같은 값을 반환
  3. 두 객체가 다르다고 판단하더라도, 각 개체의 hashCode가 다른 값일 필요는 없다. 하지만 달라야 해시테이블의 성능이 좋아진다.
• hashcode 재정의 유의사항
  1. 논리적으로 같은 객체는 같은 해시코드 반환
  2. 성능 때문에 해시코드 계산 시 핵심 필드 생략 X
  3. hashcode 반환하는 값의 생성 규칙을 API 사용자(클라이언트)에게 자세히 공표 X
• 전형적인 hashcode 메서드

private final short areaCode, prefix, lineNum;

@Override public int hashCode() {
	int result = Short.hashCode(areaCode);

	// 숫자 31: 홀수이면서 소수. 짝수일 시 오버플로우 발생한 경우 정보 손실
	result = 31 * result + Short.hashCode(prefix);
	result = 31 * result + Short.hashCode(lineNum);
	return result;

	// 한 줄짜리 hashCode 메서드
	// 입력 인수를 위한 배열이 필요하고, 기본 타입이 있다면 박싱, 언박싱의 절차가 필요하므로
	// 속도가 느리다.
	@Override public int hashCode() {
		return Objects.hash(lineNum, prefix, areaCode);
	}
}

• Item 10과 마찬가지로 @AutoValue 프레임워크를 사용하면 편리하다.

12. toString을 항상 재정의하라

• toString 재정의 유의사항
  1. 객체가 가진 주요 정보 모두를 반환하는 것이 좋다.
  2. 정의 의도를 명확히 밝혀야 한다.
  3. toString이 반환한 값에 포함된 정보를 얻어올 수 있는 API를 제공하자
• @AutoValue 프레임워크가 이 역시 자동 생성 해주지만, 클래스 '의미' 파악까지는 어려움

13. clone 재정의는 주의해서 진행하라