시스템관리 - 공통코드관리 - 우편번호관리

우편번호와 주소를 관리하고 우편번호 찾기 기능을 팝업창으로 제공하여 우편번호 및 주소 등록 시 할용 할 수 있도록 하고 팝업화면을 호출할 수 있는 활용 예시를 제공한다.

우편번호의 관리는 우편번호를 목록조회, 상세조회, 등록, 수정, 삭제 처리 할 수 있도록 구성되어있고, 등록시 엑셀파일로 등록 처리가 될 수 있도록 처리되어 우편번호의 일괄 등록을 할 수 있으며 우편번호와 주소를 등록 시 사용 할 수 있도록 우편번호 찾기 팝업을 호출 가능하다.

우편번호 찾기 팝업 호출 기능은 EgovZipPopup.js 에 구현되어 있으며 화면에서 구현하는 방법은 사용방법에 의거하여 적용 구현한다.

유형	대상소스명	비고
Controller	egovframework.com.sym.ccm.zip.web.EgovCcmZipManageController.java	우편번호 관리를 위한 컨트롤러 클래스
Model	egovframework.com.sym.ccm.zip.service.Zip.java	우편번호 정보 Model 클래스
VO	egovframework.com.sym.ccm.zip.service.ZipVO.java	우편번호 관리를 위한 VO 클래스
Service	egovframework.com.sym.ccm.zip.service.EgovCcmZipManageService.java	우편번호 관리를 위한 서비스 인터페이스
ServiceImpl	egovframework.com.sym.ccm.zip.service.impl.EgovCcmZipManageServiceImpl.java	우편번호 관리를 위한 위한 서비스구현 클래스
ServiceImpl	egovframework.com.sym.ccm.zip.service.impl.EgovCcmExcelZipMapping.java	우편번호 엑셀파일의 일괄 등록 처리를 위한 위한 서비스구현 매핑 클래스
DAO	egovframework.com.sym.ccm.zip.service.impl.ZipManageDAO.java	우편번호 정보 관리를 위한 데이터처리 클래스
JS	/webapp/js/egovframework/cmm/sym/zip/EgovZipPopup.js	우편번호 찾기 팝업 호출을 위한 JavaScript
JSP	/WEB-INF/jsp/egovframework/cmm/sym/zip/EgovCcmExcelZipRegist.jsp	우편번호 엑셀파일의 일괄 등록 처리를 위한 JSP 페이지
JSP	/WEB-INF/jsp/egovframework/cmm/sym/zip/EgovCcmZipDetail.jsp	우편번호 상세보기를 위한 JSP 페이지
JSP	/WEB-INF/jsp/egovframework/cmm/sym/zip/EgovCcmZipList.jsp	우편번호 목록을 위한 JSP 페이지
JSP	/WEB-INF/jsp/egovframework/cmm/sym/zip/EgovCcmZipModify.jsp	우편번호 수정을 위한 JSP 페이지
JSP	/WEB-INF/jsp/egovframework/cmm/sym/zip/EgovCcmZipRegist.jsp	우편번호 등록을 위한 JSP 페이지
JSP	/WEB-INF/jsp/egovframework/cmm/sym/zip/EgovCcmZipSearchList.jsp	우편번호 찾기 팝업 내용을 위한 JSP 페이지
JSP	/WEB-INF/jsp/egovframework/cmm/sym/zip/EgovCcmZipSearchPopup.jsp	우편번호 찾기 팝업을 위한 JSP 페이지

테이블명	테이블명(영문)	비고
우편번호	COMTCZIP	우편번호 정보를 관리

우편번호 엑셀파일 등록 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.

<bean id="excelZipService"	class="egovframework.rte.fdl.excel.impl.EgovExcelServiceImpl">
	<property name="propertyPath" value="excelInfo.xml" />
	<property name="mapClass" value="egovframework.com.sym.ccm.zip.service.impl.EgovCcmExcelZipMapping" />
	<property name="sqlMapClient" ref="sqlMapClient" />
</bean>

우편번호 엑셀 파일을 등록하기 위하여 실행환경의 엑셀서비스 구현 클래스를 등록하여 사용한다.
우편번호 등록을 위한 맵핑 클래스를 등록한다.

<!-- custom multi file resolver -->    
<bean id="local.MultiCommonsMultipartResolver"
  class="egovframework.com.cmm.web.EgovMultipartResolver">
    <property name="maxUploadSize" value="100000000" />
    <property name="maxInMemorySize" value="100000000" />
</bean>
 
<!-- choose one from above and alias it to the name Spring expects -->
<alias name="local.MultiCommonsMultipartResolver" alias="multipartResolver" />

우편번호 엑셀 파일을 등록하기 위하여 파일 등록 처리를 사용한다.

설명

---

우편번호 찾기 팝업 호출을 위하여 상기 환경설정까지 완료한 후 다음사항을 적용한다.

<script type="text/javascript" src="<c:url value='/js/egovframework/cmm/sym/zip/EgovZipPopup.js' />" ></script>
 

우편번호 찾기 팝업 호출을 위하여 EgovZipPopup.js 를 해당 페이지에 등록한다.

<form name="Form" action ="<c:url value='/sym/cmm/EgovCcmZipSearchPopup.do'/>" method="post">
	<input type="hidden" name="sZip" value="" size="6" readonly onClick="javascript:fn_egov_ZipSearch(document.Form, document.Form.sZip, document.Form.vZip, document.Form.sAddr);" />
	<input type="text" name="vZip" value="" size="7" readonly onClick="javascript:fn_egov_ZipSearch(document.Form, document.Form.sZip, document.Form.vZip, document.Form.sAddr);" />
	<img src="<c:url value='/images/egovframework/cmm/sym/zip/icon_zip_search.gif' />" onClick="javascript:fn_egov_ZipSearch(document.Form, document.Form.sZip, document.Form.vZip, document.Form.sAddr);">
	<input type="text" name="sAddr" value="" size="30" readonly onClick="javascript:fn_egov_ZipSearch(document.Form, document.Form.sZip, document.Form.vZip, document.Form.sAddr);" />
</form>
 

우편번호와 주소를 사용할 폼에 받기위해 위 샘플 소스처럼 호출 하여 사용한다.
sZip 은 우편번호 6자리를 받고, vZip 은 '-'를 포함하여 받는다.
sAddr 은 해당 우편번호의 주소를 받는다.

우편번호 목록 조회를 할 수 있는 목록조회 화면으로 URL은 다음과 같다.

/sym/cmm/EgovCcmZipList.do

기능	URL	Controller	method	화면(URL)
목록조회	/sym/ccm/zip/EgovCcmZipList.do	EgovCcmZipManageController	selectZipList	/cmm/sym/zip/EgovCcmZipList

우편번호 목록은 페이지 당 10건씩 조회되며 페이징은 10페이지씩 이루어진다.
검색조건은 우편번호, 시도명, 시군구명, 읍면동명, 리건물명에 대해서 수행된다.
페이지 당 검색 범위를 변경하고자 하는 경우 context-properties.xml 파일의 pageUnit, pageSize를 변경한다.(단 해당 설정은 전체 공통서비스 기능에 영향을 미친다.)

---

우편번호 등록 할 수 있는 등록 화면으로 URL은 다음과 같다.

/sym/ccm/zip/EgovCcmZipRegist.do

기능	URL	Controller	method	화면(URL)
등록	/sym/ccm/zip/EgovCcmZipRegist.do	EgovCcmZipManageController	insertZip	/cmm/sym/zip/EgovCcmZipRegist

우편번호에 대한 상세내용을 등록한다.
등록이 성공하면 우편번호 목록 화면으로 이동한다.

---

우편번호 엑셀파일을 등록 할 수 있는 등록 화면으로 URL은 다음과 같다.

/sym/ccm/zip/EgovCcmExcelZipRegist.do

기능	URL	Controller	method	화면(URL)
등록	/sym/ccm/zip/EgovCcmExcelZipRegist.do	EgovCcmZipManageController	insertExcelZip	/cmm/sym/zip/EgovCcmExcelZipRegist

다음의 우편번호 엑셀 파일의 양식을 이용하여 우편번호를 등록한다.

우편번호 엑셀양식

우편번호 엑셀양식 다운로드

등록이 성공하면 우편번호 목록 화면으로 이동한다.

---

우편번호 수정 할 수 있는 수정 화면으로 URL은 다음과 같다.

/sym/ccm/zip/EgovCcmZipModify.do

기능	URL	Controller	method	화면(URL)
수정	/sym/ccm/zip/EgovCcmZipModify.do	EgovCcmZipManageController	updateZip	/cmm/sym/zip/EgovCcmZipModify

수정이 성공하면 우편번호 목록 화면으로 이동한다.

---

우편번호 상세 조회 할 수 있는 상세 조회 화면으로 URL은 다음과 같다.

/sym/ccm/zip/EgovCcmZipDetail.do

기능	URL	Controller	method	화면(URL)
상세조회	/sym/ccm/zip/EgovCcmZipDetail.do	EgovCcmZipManageController	selectZipDetail	/cmm/sym/zip/EgovCcmZipDetail
삭제	/sym/ccm/zip/EgovCcmZipRemove.do	EgovCcmZipManageController	deleteZip	/cmm/sym/zip/EgovCcmZipDetail

상세조회에는 삭제 처리가 포함되어 있고 삭제가 성공하면 우편번호 목록 화면으로 이동한다.

---

• 실행환경 참조 : excel