[Effective-Java] Chapter11 #82. 스레드 안정성 수준을 문서화하라
·
Reference/Effective-Java
📌 API 문서 API 문서는 해당 클래스와 Client 사이의 중요한 계약이다. Multi-thread 환경에서 메서드가 어떻게 동작하는지 명시하지 않으면 Client는 나름의 가정을 해야 한다. 가정이 틀리다면 Client 프로그램은 Synchronize를 충분히 하지 못한다. (Item 78) 혹은 동기화를 지나치게 한 상태가 된다. (Item 79) API 문서에 synchronized 한정자가 모이는 메서드는 Thread-safe와 연관이 없다. 메서드 선언에 synchronized 한정자를 선언할지는 구현 이슈일 뿐 API에 속하지 않는다. Thread-safe는 있고, 없고 기준이 아니라, 그 안에서도 안전성의 수준이 나뉜다. 📌 Levels of thread safety 다음은 Thread..