¶ 공통코드관리 기능
공통코드관리 기능은 그룹코드와 상세코드를 등록, 조회, 수정, 삭제하기 위해 사용한다. 그룹코드는 공통코드 분류의 기준정보를 관리하며, 상세코드는 각 그룹코드에 속한 실제 코드값을 관리한다.
¶ 관련화면 및 수행메뉴얼
¶ 공통코드 목록조회
| Action URL | Controller method | QueryID |
|---|---|---|
조회 /ias/comCd/groupList.do |
ComCdPageController.groupList |
selectComGroupCdList, selectComGroupCdTotalCnt |
조회 /api/v1/comCd/group/list |
ComCdApiController.getGroupCodes |
selectComGroupCdList, selectComGroupCdTotalCnt |
등록화면 /ias/comCd/groupRegist.do |
ComCdPageController.groupRegist |
N/A |
상세이동 /ias/comCd/groupDetail.do?groupCd={groupCd} |
ComCdPageController.groupDetail |
selectComGroupCdDetail, getComCdByGroupCd |
수정이동 /ias/comCd/groupModify.do?groupCd={groupCd} |
ComCdPageController.groupModify |
selectComGroupCdDetail |
공통코드 목록은 그룹코드, 그룹명, 설명, 사용여부, 코드수를 조회하며 검색조건은 그룹명 또는 그룹코드, 사용여부를 사용한다.
조회 : 상단의 검색조건을 입력한 뒤 조회 버튼을 클릭하여 그룹코드 목록을 조회한다.
초기화 : 검색조건을 초기 상태로 되돌린다.
등록 : 등록 버튼을 클릭하여 그룹코드 등록 화면으로 이동한다.
상세 : 목록의 상세 버튼을 클릭하여 그룹코드 상세 화면으로 이동한다.
수정 : 목록의 수정 버튼을 클릭하여 그룹코드 수정 화면으로 이동한다.
삭제 : 목록의 삭제 버튼을 클릭하여 그룹코드를 삭제한다.
¶ 그룹코드 상세조회
| Action URL | Controller method | QueryID |
|---|---|---|
상세조회 /ias/comCd/groupDetail.do?groupCd={groupCd} |
ComCdPageController.groupDetail |
selectComGroupCdDetail, getComCdByGroupCd |
상세조회 /api/v1/comCd/group/{groupCd} |
ComCdApiController.getGroupCode |
selectComGroupCdDetail |
상세코드목록 /api/v1/comCd/groupCd/{groupCd} |
ComCdApiController.getCodesByGroupCd |
getComCdByGroupCd |
상세코드 등록팝업 /ias/comCd/cdDetailPopup.do?groupCd={groupCd}&mode=create |
ComCdPageController.cdDetailPopup |
N/A |
수정이동 /ias/comCd/groupModify.do?groupCd={groupCd} |
ComCdPageController.groupModify |
selectComGroupCdDetail |
그룹코드 상세조회 화면은 그룹코드 기본정보와 해당 그룹에 속한 상세코드 목록을 함께 제공한다.
상세코드 등록 : 상세코드 정보 영역의 등록 버튼을 클릭하여 상세코드 등록 팝업을 연다.
상세코드 수정 : 상세코드 목록의 수정 버튼을 클릭하여 상세코드 수정 팝업을 연다.
상세코드 삭제 : 상세코드 목록의 삭제 버튼을 클릭하여 상세코드를 삭제한다.
목록 : 그룹코드 목록조회 화면으로 이동한다.
수정 : 그룹코드 수정 화면으로 이동한다.
삭제 : 그룹코드를 삭제한다.
¶ 그룹코드 등록
| Action URL | Controller method | QueryID |
|---|---|---|
등록화면 /ias/comCd/groupRegist.do |
ComCdPageController.groupRegist |
N/A |
저장 /api/v1/comCd/group |
ComCdApiController.createGroupCode |
insertComGroupCd |
그룹코드 등록 화면에서는 그룹코드, 그룹코드명, 상위그룹코드, 사용여부, 설명을 입력해 저장한다.
- 그룹코드명은 필수이며 최대 100자다.
- 사용여부는 필수이며
Y,N만 허용한다. - 그룹코드가 이미 존재하면 등록할 수 없다.
목록 : 그룹코드 목록조회 화면으로 이동한다.
저장 : 입력한 그룹코드 정보를 저장한다.
¶ 그룹코드 수정
| Action URL | Controller method | QueryID |
|---|---|---|
수정화면 /ias/comCd/groupModify.do?groupCd={groupCd} |
ComCdPageController.groupModify |
selectComGroupCdDetail |
수정 /api/v1/comCd/group/{groupCd} |
ComCdApiController.updateGroupCode |
updateComGroupCd |
그룹코드 수정 화면에서는 기존 그룹코드 정보를 조회한 뒤 수정 저장한다. 그룹코드는 읽기 전용으로 표시된다.
- 존재하지 않는 그룹코드는 수정할 수 없다.
- 그룹코드명은 필수다.
목록 : 그룹코드 목록조회 화면으로 이동한다.
저장 : 수정한 그룹코드 정보를 저장한다.
¶ 그룹코드 삭제
| Action URL | Controller method | QueryID |
|---|---|---|
삭제 /api/v1/comCd/group/{groupCd} |
ComCdApiController.deleteGroupCode |
countComCdByGroupCd, deleteComGroupCd |
그룹코드 삭제는 목록조회 화면 또는 상세조회 화면에서 수행할 수 있다. 삭제 전 하위 상세코드 존재 여부를 검사한다.
- 하위 상세코드가 있으면 그룹코드를 삭제할 수 없다.
- 존재하지 않는 그룹코드는 삭제할 수 없다.
선택 : 목록 화면 또는 상세 화면에서 삭제 버튼을 클릭한다.
삭제 : 삭제 확인 후 그룹코드 정보를 삭제한다.
¶ 상세코드 등록 팝업
| Action URL | Controller method | QueryID |
|---|---|---|
등록팝업 /ias/comCd/cdDetailPopup.do?groupCd={groupCd}&mode=create |
ComCdPageController.cdDetailPopup |
N/A |
저장 /api/v1/comCd |
ComCdApiController.createCode |
insertComCd |
상세코드 등록은 그룹코드 상세조회 화면에서 팝업으로 수행한다. 선택한 그룹코드 기준으로 상세코드, 코드명, 설명, 정렬순서, 사용여부를 입력한다.
- 그룹코드는 필수다.
- 상세코드는 필수다.
- 코드명은 필수이며 최대 100자다.
- 그룹코드가 존재하지 않으면 등록할 수 없다.
- 동일한 상세코드가 이미 존재하면 등록할 수 없다.
취소 : 팝업을 닫는다.
저장 : 입력한 상세코드 정보를 저장한다.
¶ 상세코드 수정 팝업
| Action URL | Controller method | QueryID |
|---|---|---|
수정팝업 /ias/comCd/cdDetailPopup.do?groupCd={groupCd}&cd={cd}&mode=edit |
ComCdPageController.cdDetailPopup |
selectComCdDetail |
수정 /api/v1/comCd/{groupCd}/{cd} |
ComCdApiController.updateCode |
updateComCd |
상세코드 수정은 그룹코드 상세조회 화면에서 팝업으로 수행한다. 수정 모드에서는 상세코드 입력값이 읽기 전용이다.
- 존재하지 않는 상세코드는 수정할 수 없다.
- 코드명은 필수다.
취소 : 팝업을 닫는다.
저장 : 수정한 상세코드 정보를 저장한다.
¶ 상세코드 삭제
| Action URL | Controller method | QueryID |
|---|---|---|
삭제 /api/v1/comCd/{groupCd}/{cd} |
ComCdApiController.deleteCode |
deleteComCd |
상세코드 삭제는 그룹코드 상세조회 화면의 상세코드 목록에서 수행한다.
- 존재하지 않는 상세코드는 삭제할 수 없다.
선택 : 상세코드 목록의 삭제 버튼을 클릭한다.
삭제 : 삭제 확인 후 상세코드를 삭제한다.
¶ 관련 리소스
¶ 클래스
| 유형 | 대상소스명 | 비고 |
|---|---|---|
| Controller | src/main/java/allforland/ias/comcd/web/ComCdPageController.java |
공통코드 화면 요청을 처리하는 컨트롤러 클래스 |
| API Controller | src/main/java/allforland/ias/comcd/web/ComCdApiController.java |
공통코드 API 요청을 처리하는 컨트롤러 클래스 |
| Service | src/main/java/allforland/ias/comcd/service/ComCdService.java |
공통코드 서비스 인터페이스 |
| ServiceImpl | src/main/java/allforland/ias/comcd/service/impl/ComCdServiceImpl.java |
공통코드 서비스 구현 클래스 |
| Mapper | src/main/java/allforland/ias/comcd/mapper/ComCdMapper.java |
공통코드 데이터 처리 Mapper 인터페이스 |
| VO | src/main/java/allforland/ias/comcd/vo/ComGroupCdVO.java |
그룹코드 VO 클래스 |
| VO | src/main/java/allforland/ias/comcd/vo/ComCdVO.java |
상세코드 VO 클래스 |
| DTO | src/main/java/allforland/ias/comcd/web/dto/ComGroupCdRequestDTO.java |
그룹코드 등록/수정 요청 DTO 클래스 |
| DTO | src/main/java/allforland/ias/comcd/web/dto/ComCdRequestDTO.java |
상세코드 등록/수정 요청 DTO 클래스 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/comCd/groupList.jsp |
그룹코드 목록조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/comCd/groupDetail.jsp |
그룹코드 상세조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/comCd/groupRegist.jsp |
그룹코드 등록 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/comCd/groupModify.jsp |
그룹코드 수정 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/comCd/cdDetailPopup.jsp |
상세코드 등록/수정 팝업 페이지 |
| Query XML | src/main/resources/mapper/comcd/ComCdMapper.xml |
그룹코드/상세코드 조회 및 저장 Query XML |
| SQL | docker/postgres/init/01-schema.sql |
공통코드 테이블 생성을 위한 스키마 SQL |
| SQL | docker/postgres/init/02-data.sql |
공통코드 기본데이터 적재 SQL |
¶ 클래스 다이어그램
¶ 테이블
| 테이블명 | 테이블명(영문) | 비고 |
|---|---|---|
| 공통 그룹 코드 | afias.com_group_cd |
그룹코드 기준정보를 관리하는 테이블 |
| 공통 상세 코드 | afias.com_cd |
그룹코드 하위 상세코드를 관리하는 테이블 |