보통의 개발자

만약 진행 중인 프로젝트가 프론트엔드와 백엔드 개발자가 분리되어 있거나, 타 회사와 협업 중이라면, API 문서는 원활한 협업을 위한 필수 요소다. 하지만 완벽한 API 문서를 만드는 것은 마치 테스트 코드를 작성하는 것과 같다. 없어서는 안 되지만, 범위가 정해져 있는 것도 아니며, 방법도 다양하다. 특히 귀찮다고 생각하기 십상이라 어떻게 하면 신뢰성 있게 만들되 효율적으로 작성할 수 있을까를 고민하게 된다. 개발자라면 사실 코드가 아닌 문서를 작성하는 일이 달갑지만은 않을 것이다.이런 고민에서 나온 방법이 API 문서 자동화다. 개발 코드에 API 문서 작성을 위한 코드를 자연스럽게 녹여 내서 문서 작업이 아닌 코딩으로 API 문서를 작성할 방법들이 있다.본 포스팅에서는 특히 Spring 환경에서 테..

공약21 v1.0 (2025.05.21)Overview대선 후보자들의 공약은 정책집에 방대하게 나열되어 있어, 일반 유권자가 이를 비교하고 분석하기 쉽지 않습니다. 특히나 평소 대선 공약 등에 관심이 없던 유권자가 갑자기 본인에게 딱 맞는 공약을 찾기란 더더욱 어렵고, 결국 찾기를 포기해 버립니다.또한, 기존의 뉴스 기사나 블로그는 제한된 정보만을 제공하며, 객관성과 신뢰성을 보장하기 어렵습니다.공약21은 이러한 문제를 해결하기 위해 설계된 서비스로, 사용자가 특정 공약에 대해 검색하면 AI 기반 분석을 통해 각 후보자의 공약을 비교하고 요약하여 제공합니다.사용자와 관련된 공약만을 간편한 검색으로 쉽게 찾아볼 수 있습니다.공약의 출처는 각 후보자의 공식 공약 정책집만을 참조하므로, 정보의 신뢰성과 객관성..

클래스에서 객체를 생성한다고 할 때, 아마 가장 먼저 떠올리는 방법이 생성자일 것이다. 생성자는 가장 안전하면서도 일반적인 방법이다. 다만, 전달해야할 파라미터가 많아지면 순서에 제약을 받기도 하고, 어떤 파라미터를 전달해야 하는지 가독성 측면에서도 좋지 않다. 이럴 때 고려해 볼 수 있는 방법 중에는 정적 팩토리 메서드나 빌더 패턴 등이 있는데, 각 방법마다 장단점이 있기 때문에 팀의 컨벤션이나 상황에 따라 유연하게 선택할 수 있어야 한다.정적 팩토리 메서드(Static Factory Method)정적 팩토리 메서드는 쉽게 말해 객체를 생성한 뒤 반환하는 static 메서드를 정의하는 방법이다. 해당 클래스의 객체를 생성자로 생성하는 대신, static 메서드를 호출해 간접적으로 생성된 객체를 반환받게..

DB의 테이블들은 외래키를 사용해 테이블끼리 관계를 맺게 된다. 이를 JPA에서는 @OneToMany, @ManyToOne 등의 애노테이션을 사용해 엔티티 클래스 간의 연관관계로 매핑시키고, 매핑된 엔티티(객체)를 대상으로 쿼리를 날릴 수 있다. 이 때문에 기존의 SQL로 조회하는 것보다 객체 지향적으로 개발할 수 있다.하지만 지연 로딩 설정, N+1 문제, 페치 조인 최적화 등 고려해야 할 부분이 많다. 특히 @__ToOne 관계를 가지는 엔티티를 함께 조회해야 할 때, 생각한 것과 다른 결과가 도출돼 장애가 나거나 성능도 안 나오게 된다.본 포스팅에서는 조회하고 싶은 엔티티(루트 엔티티)가 1:N 관계를 가지는 컬렉션 객체를 필드로 가지고 있을 때 어떤 부분들을 주의해야 하고, 어떻게 최적화할 수 있..