¶ 팝업관리 기능
팝업관리 기능은 시스템별 팝업 공지를 등록, 조회, 수정, 삭제하기 위해 사용한다. 제목, 게시기간, 정렬순서, 연결 URL, 사용여부를 관리하며 게시 기간과 사용여부를 기준으로 활성 팝업 노출에 사용된다.
¶ 관련화면 및 수행메뉴얼
¶ 팝업 목록조회
| Action URL | Controller method | QueryID |
|---|---|---|
조회 /ias/popupNtc/popupNtcList.do |
PopupNtcPageController.list |
selectPopupNtcList, selectPopupNtcListTotCnt |
조회 /api/v1/popup/list |
PopupNtcApiController.getList |
selectPopupNtcList, selectPopupNtcListTotCnt |
등록화면 /ias/popupNtc/popupNtcRegist.do |
PopupNtcPageController.regist |
N/A |
상세이동 /ias/popupNtc/popupNtcDetail.do?popupNtcSn={popupNtcSn} |
PopupNtcPageController.detail |
selectPopupNtcDetail |
수정이동 /ias/popupNtc/popupNtcModify.do?popupNtcSn={popupNtcSn} |
PopupNtcPageController.modify |
selectPopupNtcDetail |
팝업 목록은 시스템코드, 제목, 사용여부, 게시여부 조건으로 조회한다. 게시여부는 현재 날짜가 게시 시작일과 종료일 사이인지 여부로 계산된다.
조회 : 검색조건을 입력한 뒤 조회 버튼을 클릭하여 팝업 목록을 조회한다.
등록 : 등록 버튼을 클릭하여 팝업 등록 화면으로 이동한다.
상세 : 목록의 상세 버튼을 클릭하여 팝업 상세조회 화면으로 이동한다.
수정 : 목록의 수정 버튼을 클릭하여 팝업 수정 화면으로 이동한다.
삭제 : 목록의 삭제 버튼을 클릭하여 팝업 삭제를 수행한다.
¶ 팝업 상세조회
| Action URL | Controller method | QueryID |
|---|---|---|
상세조회 /ias/popupNtc/popupNtcDetail.do?popupNtcSn={popupNtcSn} |
PopupNtcPageController.detail |
selectPopupNtcDetail |
상세조회 /api/v1/popup/{popupNtcSn} |
PopupNtcApiController.getDetail |
selectPopupNtcDetail |
수정화면 /ias/popupNtc/popupNtcModify.do?popupNtcSn={popupNtcSn} |
PopupNtcPageController.modify |
selectPopupNtcDetail |
팝업 상세조회 화면은 제목, 내용, 게시기간, URL, 정렬순서, 사용여부와 등록 및 수정 정보를 함께 보여준다.
목록 : 팝업 목록조회 화면으로 이동한다.
수정 : 수정 버튼을 클릭하여 팝업 수정 화면으로 이동한다.
삭제 : 삭제 버튼을 클릭하여 팝업을 삭제한다.
¶ 팝업 등록
| Action URL | Controller method | QueryID |
|---|---|---|
등록화면 /ias/popupNtc/popupNtcRegist.do |
PopupNtcPageController.regist |
N/A |
저장 /api/v1/popup |
PopupNtcApiController.create |
insertPopupNtc |
팝업 등록 화면에서는 시스템, 제목, 내용, 게시 시작일, 게시 종료일, 연결 URL, 정렬순서, 사용여부를 입력해 저장한다.
- 시스템, 제목, 내용은 필수 입력이다.
- 사용여부는
Y,N값으로 저장한다.
목록 : 팝업 목록조회 화면으로 이동한다.
저장 : 입력한 팝업 정보를 저장한다.
¶ 팝업 수정
| Action URL | Controller method | QueryID |
|---|---|---|
수정화면 /ias/popupNtc/popupNtcModify.do?popupNtcSn={popupNtcSn} |
PopupNtcPageController.modify |
selectPopupNtcDetail |
수정 /api/v1/popup/{popupNtcSn} |
PopupNtcApiController.update |
updatePopupNtc |
팝업 수정 화면에서는 기존 팝업 정보를 조회한 뒤 수정 저장한다.
- 시스템, 제목, 내용은 필수 입력이다.
- 존재하지 않는 팝업 일련번호는 수정할 수 없다.
목록 : 팝업 목록조회 화면으로 이동한다.
저장 : 수정한 팝업 정보를 저장한다.
¶ 팝업 삭제
| Action URL | Controller method | QueryID |
|---|---|---|
삭제 /api/v1/popup/{popupNtcSn} |
PopupNtcApiController.delete |
deletePopupNtc |
팝업 삭제는 목록조회 화면 또는 상세조회 화면에서 수행한다. 삭제 전 팝업 존재 여부를 확인한 뒤 삭제한다.
- 존재하지 않는 팝업 일련번호는 삭제할 수 없다.
선택 : 목록 화면 또는 상세 화면에서 삭제 버튼을 클릭한다.
삭제 : 삭제 확인 후 팝업 정보를 삭제한다.
¶ 관련 리소스
¶ 클래스
| 유형 | 대상소스명 | 비고 |
|---|---|---|
| Controller | src/main/java/allforland/ias/popup/web/PopupNtcPageController.java |
팝업관리 화면 요청을 처리하는 컨트롤러 클래스 |
| API Controller | src/main/java/allforland/ias/popup/web/PopupNtcApiController.java |
팝업관리 API 요청을 처리하는 컨트롤러 클래스 |
| Service | src/main/java/allforland/ias/popup/service/PopupNtcService.java |
팝업관리 서비스 인터페이스 |
| ServiceImpl | src/main/java/allforland/ias/popup/service/impl/PopupNtcServiceImpl.java |
팝업관리 서비스 구현 클래스 |
| Mapper | src/main/java/allforland/ias/popup/mapper/PopupNtcMapper.java |
팝업관리 데이터 처리 Mapper 인터페이스 |
| VO | src/main/java/allforland/ias/popup/vo/PopupNtcVO.java |
팝업 공지 VO 클래스 |
| DTO | src/main/java/allforland/ias/popup/web/dto/PopupNtcRequestDTO.java |
팝업 등록 및 수정 요청 DTO 클래스 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/popupNtc/popupNtcList.jsp |
팝업 목록조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/popupNtc/popupNtcDetail.jsp |
팝업 상세조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/popupNtc/popupNtcRegist.jsp |
팝업 등록 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/popupNtc/popupNtcModify.jsp |
팝업 수정 페이지 |
| Query XML | src/main/resources/mapper/popup/PopupNtcMapper.xml |
팝업 조회 및 저장 Query XML |
| SQL | docker/postgres/init/01-schema.sql |
팝업관리 테이블 생성을 위한 스키마 SQL |
| SQL | docker/postgres/init/02-data.sql |
팝업관리 예시 데이터 적재 SQL |
¶ 클래스 다이어그램
¶ 테이블
| 테이블명 | 테이블명(영문) | 비고 |
|---|---|---|
| 팝업 공지 | afias.popup_ntc |
시스템별 팝업 공지를 관리하는 테이블 |