refactor(sample)!: CRUD 반환 계약과 페이징 처리 및 MyBatis 매핑 개선

[LeeBaekHaeng]

수정 사유 Reason for modification

• 버그수정 Bug fixes
• 기능개선 Enhancements
• 기능추가 Adding features
• 기타 Others

샘플 CRUD 처리 건수를 호출부에 전달하고 목록 조회 결과 타입을
SampleVO로 통일한다. 요청한 페이징 값을 유지하며 중복 SQL을 정리한다.

수정된 소스 내용 Modified source

• 서비스·매퍼의 등록·수정·삭제 반환 타입을 void에서 int로 변경하고,
  컨트롤러에서 처리 건수를 디버그 로그로 기록한다.
• 목록 조회를 List로 통일하고 관련 테스트의 EgovMap 접근을
  SampleVO getter 호출로 변경한다.
• MyBatis의 mapUnderscoreToCamelCase를 활성화하고 명시적 resultMap을
  SampleVO resultType으로 전환한다.
• pageUnit과 pageSize를 nullable Integer로 변경한다.
  기존에는 요청값을 설정값으로 덮어썼으나, 이제 null일 때만 기본값을 적용한다.
• 목록·건수 조회의 FROM 및 검색 조건을 sampleFromWhere SQL 조각으로 공통화한다.
• UPDATE의 불필요한 ID 자기 대입을 제거하고 SQL 파라미터 타입을 명시한다.
• SQL 기본 제한 시간을 3초로 설정하고 목록 조회에는 30초를 적용한다.
• 컨트롤러의 ModelMap을 Model로 통일하고 서비스의 ID 생성·로그 코드를 정리한다.
• @service의 명시적 빈 이름을 제거한다.

호환성 영향

• CRUD 반환 타입 변경에 따라 기존 구현체와 목 객체를 수정해야 한다.
• 목록 요소를 EgovMap으로 캐스팅하거나 Map 방식으로 접근하는 호출부는
  SampleVO 기반으로 변경해야 한다.
• pageUnit과 pageSize를 직접 사용하는 호출부는 null 가능성을 고려해야 한다.
• sampleService 이름으로 빈을 조회하거나 주입하는 코드는
  egovSampleServiceImpl로 변경하거나 타입 기반 주입을 사용해야 한다.

JUnit 테스트 JUnit tests

• JUnit 테스트 JUnit tests
• 수동 테스트 Manual testing

JDK 17.0.17+10, Maven 3.9.9에서 다음 관련 테스트 5개 클래스를 실행했다.

• SampleDefaultVOTest
• EgovSampleServiceImplTest
• EgovSampleControllerTestAddTest
• EgovSampleControllerTestDeleteTest
• EgovSampleControllerTestUpdateTest

결과: 14개 테스트 통과, 실패 0, 오류 0, 건너뜀 0 / BUILD SUCCESS

실행 명령:
mvn -B -Dtest=SampleDefaultVOTest,EgovSampleServiceImplTest,EgovSampleControllerTestAddTest,EgovSampleControllerTestDeleteTest,EgovSampleControllerTestUpdateTest test

전체 테스트는 실행하지 않았다.
페이징 요청값 유지와 CRUD 반환 건수에 대한 직접 검증은 추가 보강이 필요하다.

테스트 브라우저 Test Browser

• Chrome
• Firefox
• Edge
• Safari
• Opera
• Internet Explorer
• 기타 Others

http://localhost:8080/?pageUnit=20

테스트 스크린샷 또는 캡처 영상 Test screenshots or captured video

테스트 후