"한빛미디어 서평단 <나는 리뷰어다> 활동을 위해 책을 협찬 받아 작성된 서평입니다."

한빛미디어의 서평단으로 두 번째 책을 받게 되었습니다. 개인적으로 자바 실무를 하며 코드 품질과 관련된 책을 늘 탐색해왔는데, 이번에 받은 책은 바로 『자바 개발자가 반드시 피해가야 할 100가지 실수』입니다. 두 권 중 랜덤으로 선정된다고 해서 긴장했지만, 기대했던 이 책이 당첨되어 정말 기뻤습니다!

이 책은 단순히 자바 문법을 설명하거나 기능을 나열하는 책이 아닙니다. 자바로 개발을 하다 보면, 분명히 컴파일도 잘 되고 테스트도 통과했는데, 시간이 지나면 이상한 버그가 터지는 경우가 많습니다. 동료가 짠 코드를 리뷰하다 보면 "어? 이거 왜 이렇게 짰지?" 싶은 코드가 나오기도 하고, 내 코드도 누군가에게 그런 반응을 불러일으킨 적이 있을지도 모릅니다.

자바는 강력한 언어이지만, 그만큼 방대한 API와 다양한 기능들 속에서 놓치기 쉬운 디테일이 숨어 있습니다. equals(), hashCode() 구현 실수, Stream API 체인 사용 시의 부수 효과, Optional 남용, 멀티스레드 환경에서의 동기화 누락 등은 모두 '지나고 나면 아차 싶은' 실수들입니다. 그리고 그 실수들은 단순한 실수로 끝나지 않고, 종종 심각한 퍼포먼스 저하나 협업의 문제로까지 번지게 됩니다.

이 책은 그런 실수를 ‘예방하는 법’뿐만 아니라, ‘실수를 통해 배우는 법’을 알려주는 실전형 책입니다. 단순히 하지 말라는 식이 아니라, 왜 그 실수가 생기는지, 어떤 상황에서 자주 나타나는지, 그리고 어떻게 고쳐야 하는지를 차근차근 설명해줍니다. 그래서 실무에서 ‘어제 나도 했던 실수’와 직결되기 때문에, 읽는 내내 공감하면서 정리해갈 수 있습니다.

이 책의 가장 큰 강점 중 하나는 100가지 실수를 주제별로 정리했다는 점입니다. 각 장은 실수를 카테고리별로 묶어 설명하는데, 예를 들어 ‘표현식’, ‘숫자’, ‘예외’, ‘문자열’, ‘컬렉션’, ‘객체 비교’, ‘유닛 테스트’ 등 우리가 실무에서 자주 다루는 주제들로 구성되어 있어요. 단순히 이론적인 설명만 나열하는 것이 아니라, 각 실수마다 코드 예제와 잘못된 예 vs 개선된 예를 비교해주기 때문에 훨씬 이해하기 쉽고 기억에도 잘 남습니다.

각 장에서 특히 인상 깊었던 부분을 몇 가지 소개하자면,

첫째, 코드를 읽는 사람을 배려한 설명 방식이 인상적이었습니다. "맞추어 코드를 수정하라"는 조언이나 "의미 있는 값은 두 번 계산하지 말고 변수로 빼라"는 팁은 단순한 코드 품질의 문제를 넘어, 함께 일하는 동료를 배려하는 마음가짐까지 담겨 있었습니다. 이 책은 '좋은 코드'란 단순히 동작하는 코드가 아니라, '다른 사람이 쉽게 읽고 이해할 수 있는 코드'라고 말합니다.

둘째, 테스트 커버리지, 정적 분석 도구 등 실무에서 꼭 필요한 툴을 함께 소개합니다. 단순히 "null 체크를 하세요" 같은 이야기에 그치지 않고, JaCoCo나 SpotBugs 같은 도구를 통해 어떻게 커버리지를 확인하고, 정적 분석을 통해 어떤 실수를 미리 잡아낼 수 있는지를 알려줍니다. 또한 이러한 도구들이 왜 100% 커버리지를 보장하지 못하는지도 현실적으로 설명해 주며, 도구에 대한 맹신보다 정확한 이해를 중요시합니다.

셋째, 실제 오픈소스에서 발생했던 버그 사례들을 활용해 설명하고 있다는 점도 매우 실용적이었습니다. Apache Avro에서 발생했던 해시 충돌 문제를 예시로 들어, 연산자 우선순위에 대한 오해가 얼마나 심각한 문제를 초래할 수 있는지를 보여줍니다. 컴파일러는 오류를 내지 않지만, 실행 결과는 의도한 바와 전혀 다르게 나올 수 있고, 이런 문제를 방치하면 성능 이슈로 이어질 수 있음을 경고합니다.

넷째, **디버깅 팁과 예외 처리, 유닛 테스트에서의 실수까지 꼼꼼하게 다룬다는 점**도 좋았습니다. assert 문이 갖는 부수 효과, 테스트 메서드가 중간에 조기 종료될 수 있는 구조, 예외 테스트에서 자주 발생하는 실수 등은 유닛 테스트 경험이 있는 사람이라면 누구나 고개를 끄덕일 수밖에 없는 내용이었습니다.

다섯째, 각 장마다 간단한 정리와 요약이 들어 있어 학습 흐름을 이어가기 좋습니다. 단번에 100가지 실수를 모두 기억하긴 어렵지만, 정리 파트를 통해 핵심 포인트만 체크하면 복습도 수월하고 실전에 바로 응용할 수 있겠다는 생각이 들었습니다.

책을 읽으며 느낀 점을 한 문장으로 요약하자면,

“이 책은 실수를 피하는 법을 넘어서, 좋은 코드란 무엇인지에 대한 기준을 심어주는 책이다.”

이 책은 특히 팀 프로젝트를 하거나 코드 리뷰를 주고받는 환경에 있는 개발자에게 매우 유익할 것입니다. 단순히 혼자 코드를 짤 때보다, 팀원과 함께 유지보수 가능한 코드를 만들어가는 상황에서 '좋은 코드'에 대한 합의는 굉장히 중요하니까요. 이 책은 그러한 기준점을 함께 세워주는 역할을 할 수 있습니다.

총평하자면, 『자바 개발자가 반드시 피해가야 할 100가지 실수』는 자바 개발자라면 꼭 한 번은 정독해봐야 할 필독서라고 생각합니다. 실무 감각을 키우고 싶은 주니어 개발자부터, 후배에게 실수를 줄여주고 싶은 리드 개발자까지 모두에게 도움이 될 책입니다. 

처음부터 끝까지 깊은 공감과 배움을 주는 책이었고, 저도 앞으로 계속 책상에 꽂아두고 참고하게 될 것 같습니다.
 

책에서 굉장히 여러 상황에 대해 발생하는 문제점들의 예시를 상세하게 설명하며 풀어나가고 있습니다. 또한 실수 상황과 함께 |실수 방지 가이드|도 상세하게 표시되어 있어 평소에 놓칠만한 부분도 다시 확인하고 넘어갈 수 있는 부분이 많이 존재합니다.

다만, 책에 서술되어 있는 모든 예시들이 일반적으로는 겪기 힘들만한 상황의 실수 예제들도 몇몇 있어서 필요한 부분만 보는 것을 저자분도 추천하고 있습니다.

- 한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬 받아 작성된 서평입니다

이 책은 자바 개발자가 흔히 저지르는 실수 100가지를 분석하고, 구체적인 사례와 함께 해결 방법을 제시한다는 점에서 인상깊었습니다. 

챕터1에서는 코드 품질을 높이고 실수를 방지하기 위해 개발 문화와 도구를 어떻게 활용해야 하는지 설명합니다. 코드를 작성하는 것은 결국 사람이기 때문에 모든 실수를 사전에 방지하는 것은 현실적으로 불가능합니다. 하지만 코드 리뷰, 페어 프로그래밍, 코드 스타일, 정적 분석 도구, 테스트 자동화 등을 활용하면 실수를 줄이고 코드 품질을 유지하는데 도움이 된다고 설명합니다.

개인적으로 책을 읽으며 뮤테이션 커버리지, 동적 분석 등 접해보지 않았던 새로운 도구를 알게 된 점이 유익했습니다. 또한, 도구라는게 모든 문제를 해결해주지 않기 때문에 이를 간과해서는 안된다는 점을 저자는 강조합니다. 이를 통해 기술과 도구는 비즈니스 문제 해결을 위한 수단이어야 하며, 그 자체가 목적이 되어서는 안 된다는 점을 다시 생각해 볼 수 있었습니다.

챕터2. 표현식부터 각 주제별로 "실수 설명 → 해결 방법 → 사례 → 정리" 구조로 설명합니다. 이때 연산자 우선순위, 음수, 언더플로, 오버플로, 비트연산, 유니코드 등과 관련된 실수를 다룹니다. 경험이 부족한 개발자라면 이해하기 어려울 수도 있지만, 컴퓨터 공학 지식과 함께 실수를 찾아낼 수 있는 능력을 갖춘다면 개발자로서의 경쟁력을 강화할 수 있을 거라는 배움을 얻을 수 있었습니다. 챕터3. 프로그램 구조는 가벼운 Java 문법적인 내용이 많았는데 코딩 테스트 연습을 할 때 한번씩 했던 실수라서 쉽게 공감할 수 있었습니다.

챕터5. 일반적인 예외 ~ 챕터 10. 유닛 테스트에서는 구현 경험이 있다면 한번씩 접해 볼 수 있는 실수라 공감하기 쉬웠고 새로운 내용도 알 수 있어 유익했습니다. 쉽게 접할 수 있는 NullPointException을 줄이기 위한 주요 원칙으로 ① null 자체를 사용하지 않거나, ② Optional 사용, ③ 어노테이션 명시, ④ 정적 도구 분석 도구 활용 등 실무에서 적용할 수 있는 유용한 가이드를 제시했습니다. 또한 잠재적으로 ClassCastException 야기할 수 있는 메서드에 대해 리팩터링 하기 위해 자바 9부터 추가된 @Deprecated(forRemoval = true) 활용해 클라이언트 코드가 마이그레이션 할 수 있도록 유도하는 예시가 인상 깊었습니다.

“자바 코드의 품질을 높이는 100가지 방법”을 읽으면서 모르는 내용도 많았지만 앞으로 개발자로서 나아가야 할 방향을 또하나 찾을 수 있었던 거 같습니다. OOP, 테스트 자동화, 자료구조와 알고리즘을 모르는 초보자에게 부담되는 내용일지도 모르지만, 자바 언어를 사용하는 이에게 실수 방지 가이드로 충분히 추천할 만한 도서였습니다.

한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬 받아 작성된 서평입니다.

Java는 명실상부 OOP를 대표하는 프로그래밍 언어다. 특히 이 언어를 사용하여 만들어진 Spring framework 는 대규모 백엔드 어플리케이션을 이야기 할 때 빠짐없이 등장한다. 타이트한 규칙의 프레임워크의 도움을 받아 프레임워크를 알고있으면 모두가 이해할수있는 아키텍처를 구성한다. 그런데 문제는 구현이다.

비즈니스 로직은 여전히 Java 를 사용하여 구현해야 한다. 문자열, 컬렉션, 숫자, 비트와 같은 자료구조와 더불어 이제는 빼놓을 수 없는 ‘대용량 처리’ 유행에 동시성 프로그래밍까지. Java 를 사용한다면 날이 갈수록 Java 언어에 대해 더 깊은 이해를 요구한다.

21세기 2025년. 이제는 notepad 나 vi 에디터를 열고 프로젝트 단위의 개발을 하지는 않는다. 우리는 IDE 를 사용하여 개발한다. 이에 따라오는 정적 분석기를 통해 컴파일 오류를 컴파일 하지 않고도 알아낸다. 나아가 자동완성, 타입추론, 참조검사 등 더이상 정적 분석기의 도움 없이는 지금과 같은 속도로 개발할 수 없는 시대가 되었다.

책의 저자는 Java IDE로 유명한 JetBrains의 IntelliJ 정적 분석기를 개발했다. 우리는 정적 분석기의 도움을 여전히 받고 있지만, 정적 분석기가 만능은 아니다. 그래서 정적 분석기가 잡아내지 못하지만 발생하면 적지 않은 파급효과를 일으키는 코드 실수에 대해 분석-원리-해결 순으로 상세하게 알려준다.

NPE를 다룰때 조심해야 하는 부분의 실제에 대해 알려준다. Nullable 하다면 가능한 Optional 을 사용하고, 그마저 어렵다면 @Nullable 어노테이션이라도 활용하라고 한다. Java 10부터 제공되는 Collection.copyOf() 을 사용해 immutable 한 복사본을 사용하면 nullable 을 허용하지 않는다는 것도 알려준다. 그래도 Null을 꼭 다뤄야 한다면 차라리 열거형을 사용하라고 한다. 특히 박스타입인 Boolean 의 경우 null 을 허용하기 때문에 차라리 참, 거짓, null 을 표현하는 열거형을 만들어서 사용하라고 한다.

Stream API 는 중간 연산을 가지고 있다. 그러나 Stream 은 최종 연산이 호출되기 전에는 아무일도 일어나지 않는다. 만약 중간 연산이 인자를 동반하는 함수의 입력이 발생한다면 부수효과를 일으키게 된다. 이 상황은 parallelStream() 을 사용할때도 예외가 발생할 수 있기 때문에 부수효과를 발생시켜야 한다면partitioningBy()와 같은 컬렉션 함수로 분리하여 멱등성을 유지할 필요가 있다고 한다.

여러 스레드 사이에서 공유 데이터를 다룰때에 대한 팁도 알려준다. Queue에서 작업을 꺼내 수행하기 위해 isEmpty()로 검사하고 remove()를 호출한다면 두번의 호출이 이뤄지기 때문에 원자적인 상호작용이 아니라고 한다. 이같은 작업에서 원자성을 유지하기 위해서 poll()로 대상을 꺼내오면 된다고 한다. 만약 큐가 비었다면 poll()은 null을 반환 하기 때문에 스레드에서 영향을 받지 않는 로컬 변수로 null 검사가 가능해지는 것이다. 요는 동시성 컬렉션 메서드를 연쇄 호출했을때 원자적 처리에 대해서 보장하지 않기 때문에 고민을 하고 연산 선택을 하라는 것이다. Atomic 레퍼런스 역시 set()같은 메서드는 스레드 세이프 하지 않기 때문에 updateAndGet() 메서드를 사용해 구현하라고 알려준다.

이 외에도 유닛 테스트, 객체간 비교, 문자열, 비트 연산 등에서 실수 할 수 있는 문제들에 대해 앞서 소개한 내용처럼 심도있는 고찰을 밀도있게 전달하고 있다. 아마도 이펙티브 자바와 많이 비교가 될 것 같은데, 그 책은 OOP나 리팩토링에 중점을 둔 내용이라면 이번에 소개한 ‘자바 코드의 품질을 높이는 100가지 방법’은 실무에서 자바를 사용했을때 발생할 수 있는 오류의 파훼와 언어 스팩에 포함되어있는 내부 구현에 대해서 많은 인사이트를 얻을 수 있었다.

어떤 언어로 개발하든 개발자라면 다양한 실수를 하게 된다. 의도하든 의도하지 않든 그 실수를 제때 수정하지 않는다면 나중에 비싼 비용을 치뤄야하는 것은 널리 알려진 사실이다. 그렇다면 반복되는 실수를 어떻게 사전에 알 수 있을까? 경험이 많은 개발자라면 다양한 케이스에 대한 노하우가 있기 때문에 적당한 수준으로 실수를 보완해 가겠지만 경력이 얼마되지 않는 개발자라면 명백한 실수도 잘 알아채지 못하는 경우가 종종 있는 것 같다. 특히 컴파일러나 런타임시에 에러가 나온다면 다행이지만 그렇지 않은 경우도 상당히 많다는 것이 문제이다. 테스트 케이스를 통해 문제가 있는 코드가 커버되지 않는다거나 특정한 경우에만 문제가 발생한다거나 또는 시간이 지나야 문제가 나타나는 등 바로 알아채릴 수 없는 다양한 경우가 존재한다.

이 책은 Java 개발에서 반복적으로 발생하는 100가지 실수를 모아 더 나은 코드를 작성할 수 있도록 돕는 실전가이드이다. 다양한 예제를 통해 예외 처리, 변수 처리, 유닛 테스트에서 발생할 수 있는 다양한 문제의 원인과 해결책을 알려준다. 1장에서는 코드 품질 관리를 위한 기본적인 개념에 대한 소개를 통해 기본 개념을 익힐 수 있도록 한다. 이후 표현식에 관련된 부분, 프로그램 구조, 숫자, 예외처리, 문자열, 라이브러리, 유닛테스트 등 Java 개발에 대한 전반적인 영역을 다룬다. 특히 무심코 넘길 수 있는 숫자의 정밀도 손실이나 오버플로우 등 신경써야 할 부분에 대해 잘 설명을 해주며, 문자열에서는 replaceAll 함수의 오용 및 문자열의 대소문자 비교 등 사소한 실수에 대해 점검할 수 있는 요령을 잘 보여준다.

이미 알고 있다고 생각하지만 다시 되집어 볼 수 있는 유용한 정보를 제공하고 있다고 생각이 들었다. 특히 Java 개발을 시작한지 얼마되지 않는 개발자라면 옆에 두고 천천히 읽어보면서 자신의 것으로 소화시키면 매우 유용하겠다는 생각이 들었다. 개발을 빨리하는 것도 중요할 수 있지만 그에 못지않게 코드의 품질을 높이는 것은 더 중요하다고 볼 수 있다. 개발을 진행하면서 꼼꼼히 살펴보고 품질을 높이려는 노력을 기울이는 것이 필요하다고 생각된다.

"한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬 받아 작성된 서평입니다."

개발을 하다보면 내가 어떤 오류를 맞닥뜨릴지도 모르고 내가 실수를 저지르고 있다 한들 그게 잘못된 것인지 조차 인지하지 못하는 경우가 많다.

이럴 때마다 학창시절처럼 개발에도 오답노트나 족보가 있었으면 좋겠다는 생각을 막연히 하곤 했다.

이 책은 나와 같은 생각을 한번이라도 해본 자바 개발자들에게 추천하고 싶다.

탄탄한 개념서나 바이블처럼 꼭 읽어봐야하는 자바 필수 도서 는 아니더라도 언제나 나도 모르게 저지를 수 있는 실수들에 대해 경각심을 일으켜준다.

또한 나의 실수에 대해 분노를 느끼는게 아닌 프로덕션으로 내보내기 전 빨리 발견하다니, 완전 럭키비키잖아?!