Java 개발자 포트폴리오에서 프레임워크 이름을 많이 적는 것만으로 구현 역량이 드러나지 않습니다. 요청을 받아 데이터를 처리하고 오류를 알리는 작은 API를 완성한 뒤 코드와 테스트를 함께 보여 주세요.
기능 하나를 끝까지 구현
예를 들어 할 일 항목을 생성·조회하는 API를 만들고 입력값이 비어 있을 때의 응답을 정합니다. Spring의 REST 서비스 시작 가이드는 작은 HTTP 응답을 만드는 과정을 보여 줍니다. 가이드의 예제를 그대로 제출하지 말고 본인이 추가한 데이터 구조·검증·오류 처리를 구분해 적으세요.
설계 선택 기록
엔터티와 요청·응답 구조를 왜 나눴는지, 저장 방식의 제약은 무엇인지 설명합니다. 기능 규모에 비해 복잡한 구조를 만들었다면 이유를 적고, 단순한 예제로 남겼다면 확장할 때 바꿀 부분을 밝힙니다.
테스트와 재현성
정상 요청뿐 아니라 누락된 값, 중복 입력, 없는 항목 조회를 어떻게 처리하는지 테스트합니다. Java 공식 학습 자료는 디버깅과 작은 단위 테스트의 역할을 설명합니다. 자동 테스트가 없다면 수동 확인 절차를 문서에 적습니다.
README와 보안 점검
JDK 버전, 빌드·실행 명령, 환경 변수 예시, API 요청 예제, 제약을 README에 적습니다. 비밀 키와 실제 사용자 데이터는 공개하지 마세요. GitHub README 안내를 참고해 저장소 첫 화면을 정리합니다. 다른 직무 프로젝트와 함께 배치할 때는 직무별 포트폴리오 구성법을 참고하세요.