====== 우편번호 주소찾기, 우편번호관리 ======

===== 개요 =====

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



===== 설명 =====

==== 패키지 참조 관계 ====

우편번호 패키지는 요소기술의 공통 패키지(cmm)에 대해서만 직접적인 함수적 참조 관계를 가진다. 

  * 패키지 간 참조 관계 : [[egovframework:com:v2:init_pkg_dependency#시스템관리|시스템관리 Package Dependency]]

==== 관련소스 ====

^유형^대상소스명^비고^
|Controller|egovframework.com.sym.ccm.zip.web.EgovCcmZipManageController.java|우편번호 관리를 위한 컨트롤러 클래스|
|Service|egovframework.com.sym.ccm.zip.service.EgovCcmZipManageService.java|우편번호 관리를 위한 서비스 인터페이스|
|Service|egovframework.com.sym.ccm.zip.service.EgovCcmRdnmadZipServiceImpl.java|도로명주소 관리를 위한 서비스 인터페이스|
|ServiceImpl|egovframework.com.sym.ccm.zip.service.impl.EgovCcmZipManageServiceImpl.java|우편번호 관리를 위한 위한 서비스구현 클래스|
|ServiceImpl|egovframework.com.sym.ccm.zip.service.impl.EgovCcmRdnmadZipServiceImpl.java|도로명주소 관리를 위한 위한 서비스구현 클래스|
|ServiceImpl|egovframework.com.sym.ccm.zip.service.impl.EgovCcmExcelZipMapping.java|우편번호 엑셀파일의 일괄 등록 처리를 위한 위한 서비스구현 매핑 클래스|
|ServiceImpl|egovframework.com.sym.ccm.zip.service.impl.EgovCcmExcelRdnmadZipMapping.java|도로명주소 엑셀파일의 일괄 등록 처리를 위한 위한 서비스구현 매핑 클래스|
|Model|egovframework.com.sym.ccm.zip.service.Zip.java|우편번호 정보 Model 클래스|
|VO|egovframework.com.sym.ccm.zip.service.ZipVO.java|우편번호 관리를 위한 VO 클래스|
|DAO|egovframework.com.sym.ccm.zip.service.impl.ZipManageDAO.java|우편번호 정보 관리를 위한 데이터처리 클래스|
|DAO|egovframework.com.sym.ccm.zip.service.impl.RdnmadZipDAO.java|도로명주소 정보 관리를 위한 데이터처리 클래스|
|JSP|/WEB-INF/jsp/egovframework/com/sym/ccm/zip/EgovCcmExcelZipRegist.jsp|우편번호 엑셀파일의 일괄 등록 처리를 위한 JSP 페이지|
|JSP|/WEB-INF/jsp/egovframework/com/sym/ccm/zip/EgovCcmZipDetail.jsp|우편번호 상세보기를 위한 JSP 페이지|
|JSP|/WEB-INF/jsp/egovframework/com/sym/ccm/zip/EgovCcmZipList.jsp|우편번호 목록을 위한 JSP 페이지|
|JSP|/WEB-INF/jsp/egovframework/com/sym/ccm/zip/EgovCcmZipModify.jsp|우편번호 수정을 위한 JSP 페이지|
|JSP|/WEB-INF/jsp/egovframework/com/sym/ccm/zip/EgovCcmZipRegist.jsp|우편번호 등록을 위한 JSP 페이지|
|JSP|/WEB-INF/jsp/egovframework/com/sym/ccm/zip/EgovCcmZipSearchList.jsp|우편번호 찾기 팝업 내용을 위한 JSP 페이지|
|JSP|/WEB-INF/jsp/egovframework/com/sym/ccm/zip/EgovCcmZipSearchPopup.jsp|우편번호 찾기 팝업을 위한 JSP 페이지|
|QUERY XML|resources/egovframework/sqlmap/com/sym/ccm/zip/EgovZipManage_SQL_Mysql.xml|우편번호 MySQL용 QUERY XML|
|QUERY XML|resources/egovframework/sqlmap/com/sym/ccm/zip/EgovRdnmadZip_SQL_Mysql.xml|도로명주소 MySQL용 QUERY XML|
|QUERY XML|resources/egovframework/sqlmap/com/sym/ccm/zip/EgovZipManage_SQL_Oracle.xml|우편번호 Oracle용 QUERY XML|
|QUERY XML|resources/egovframework/sqlmap/com/sym/ccm/zip/EgovRdnmadZip_SQL_Oracle.xml|도로명주소 Oracle용 QUERY XML|
|QUERY XML|resources/egovframework/sqlmap/com/sym/ccm/zip/EgovZipManage_SQL_Tibero.xml|우편번호 Tibero용 QUERY XML|
|QUERY XML|resources/egovframework/sqlmap/com/sym/ccm/zip/EgovRdnmadZip_SQL_Tibero.xml|도로명주소 Tibero용 QUERY XML|
|QUERY XML|resources/egovframework/sqlmap/com/sym/ccm/zip/EgovZipManage_SQL_Altibase.xml|우편번호 Altibase용 QUERY XML|
|QUERY XML|resources/egovframework/sqlmap/com/sym/ccm/zip/EgovRdnmadZip_SQL_Altibase.xml|도로명주소 Altibase용 QUERY XML|
|Validator Rule XML|resources/egovframework/validator/validator-rules.xml|Validator Rule을 정의한 XML|
|Validator XML|resources/egovframework/validator/com/sym/ccm/zip/EgovZipManage.xml|우편번호 Validator XML|

==== 관련테이블 ====

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


==== 환경설정 ====

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

=== context-excel.xml ===

<code xml>
    <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="egov.sqlMapClient" />
    </bean>

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

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

=== context-common.xml ===

<code xml>
<!-- 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" />
</code>

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

===== 관련기능 =====

우편번호 주소찾기, 우편번호관리는 **우편번호 찾기**, **우편번호 목록조회**, **우편번호 등록**, **우편번호 엑셀파일 등록**, **우편번호 수정**, **우평번호 상세조회** 기능으로 구분된다.

==== 우편번호 찾기 ====

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

=== 관련코드  ===
N/A

=== 관련화면 및 수행매뉴얼 ===

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

 <code html>  
<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>
 </code>

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

{{:egovframework:com:v2:sym:도로명주소.jpg|우편번호 찾기 화면}}

조회: 조회하기 위해서는 상단의 검색창에 검색문자를 입력 후 조회 버튼을 클릭한다.

==== 우편번호 목록조회 ====

=== 비즈니스 규칙 ===
우편번호 목록은 페이지 당 10건씩 조회되며 페이징은 10페이지씩 이루어진다.
검색조건은 우편번호, 시도명, 시군구명, 읍면동명, 리건물명에 대해서 수행된다.\\

=== 관련코드  ===
N/A

=== 관련화면 및 수행매뉴얼 ===

^Action^URL^Controller method^QueryID^
|목록조회|/sym/ccm/zip/EgovCcmZipList.do|selectZipList|"ZipManageDAO.selectZipList"|
| | | |"ZipManageDAO.selectZipListTotCnt"|

페이지 당 검색 범위를 변경하고자 하는 경우
context-properties.xml 파일의 pageUnit, pageSize를 변경한다.(단 해당 설정은 전체 공통서비스 기능에 영향을 미친다.)

{{:egovframework:com:sym:zip:ziplist.jpg|우편번호목록 화면}}

조회: 조회하기 위해서는 상단의 검색조건을 선택 후 해당하는 검색문자를 입력 후 조회 버튼을 클릭한다.\\
등록: 등록하기 위해서는 상단의 등록버튼을 통해서 **우편번호 등록** 페이지로 이동한다.\\
엑셀등록: 우편번호 엑셀 파일의 양식을 이용하여 우편번호를 등록할 수 있는 페이지로 이동한다.\\
목록클릭: **우편번호 상세조회** 화면으로 이동한다.\\

==== 우편번호 등록 ====

=== 비즈니스 규칙 ===

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

=== 관련코드  ===
N/A

=== 관련화면 및 수행매뉴얼 ===

^Action^URL^Controller method^QueryID^
|등록|/sym/ccm/zip/EgovCcmZipRegist.do|insertZip|"ZipManageDAO.insertZip"|

{{:egovframework:com:sym:zip:zipregist.jpg|우편번호등록 화면}}

목록: **우편번호 목록** 화면으로 이동한다. \\
저장: 입력한 우편번호 정보들이 저장 처리된다. 

==== 우편번호 엑셀파일 등록 ====

=== 비즈니스 규칙 ===

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

=== 관련코드  ===
N/A

=== 관련화면 및 수행매뉴얼 ===

^Action^URL^Controller method^QueryID^
|등록|/sym/ccm/zip/EgovCcmExcelZipRegist.do|insertExcelZip|"ZipManageDAO.deleteAllZip"|

다음의 우편번호 엑셀 파일의 양식을 이용하여 우편번호를 등록한다.\\
^구분^참고사이트^
|{{:egovframework:com:v2:sym:zipcode.xls|우편번호 엑셀양식}}|http://www.epost.go.kr/search/zipcode/jibunAddressDown.jsp|
|{{:egovframework:com:v2:sym:rdmnzipcode.xls|도로명주소 엑셀양식}}|http://www.juso.go.kr/support/AddressBuild.do |

=== 도로명코드 엑셀양식 참조자료 ===
도로명주소안내 사이트에서 **__대표지번__**으로 다운받으면 txt파일로 내려받게 된다.('|'(파이프) 구분자로 한 텍스트 포멧임)
^법정동^시도^시군구^읍명동^리^산여부^지번^본번^도로명코드^도로명^지하여부^건물번호[본번]^건물번호[지번]^건물명^상세건물명^건물관리번호^읍면동일련번호^행정동코드^행정동명^우편번호^우편번호일련번호^다량배달처명^
|1168010100|서울특별시|강남구|역삼동| |0|642|6|116803121022|논현로|0|507|0|성지하이츠3| |1168010100106420000000000|1|1168064000|역삼1동|135717|3|성지하이츠3차빌딩|

도로명주소 엑셀양식에 맞추어서 넣으면 된다.
^도로명코드^일련번호^시도^시군구^도로명^건물번호[본번]^건물번호[부번]^건물명^상세건물명^우편번호^등록ID^
|116803121022|1|서울특별시|강남구|논현로|507|0|성지하이츠3| |135717|SYSTEM|
※ 일변번호는 중복을 피하기 위한 일련번호로 1번부터 중복없이 순서대로 입력한다.

=== 우편번호 엑셀등록 ===

{{:egovframework:com:sym:zip:zipexcelregist1.jpg|우편번호엑셀등록 화면}}

목록: 우편번호 목록 화면으로 이동한다. \\
저장: 엑셀양식으로 입력한 우편번호 정보들이 저장 처리된다. 




==== 우편번호 수정 ====

=== 비즈니스 규칙 ===

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

=== 관련코드  ===
N/A

=== 관련화면 및 수행매뉴얼 ===

^Action^URL^Controller method^QueryID^
|수정|/sym/ccm/zip/EgovCcmZipModify.do|updateZip|"ZipManageDAO.updateZip"|

{{:egovframework:com:sym:zip:zipmodify2.jpg|우편번호수정 화면}}


저장: 수정된 정보들이 저장 처리된다. \\
목록: **우편번호 목록** 화면으로 이동한다. 



==== 우편번호 상세 조회 ====

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

=== 관련코드  ===
N/A

=== 관련화면 및 수행매뉴얼 ===

^Action^URL^Controller method^QueryID^
|상세조회|/sym/ccm/zip/EgovCcmZipDetail.do|selectZipDetail|"ZipManageDAO.selectZipDetail"|
|삭제|/sym/ccm/zip/EgovCcmZipRemove.do|deleteZip|"ZipManageDAO.deleteZip"|


{{:egovframework:com:sym:zip:zipdetail.jpg|우편번호상세 화면}}

수정: 수정버튼 클릭 시 **우편번호 수정** 화면으로 이동한다. \\
삭제: 삭제버튼 클릭 시 삭제여부를 확인하는 메시지를 보여주고 삭제처리를 할 수 있다.\\
목록: **우편번호 목록** 화면으로 이동한다.


===== 참고자료 =====

  * 실행환경 참조 : [[egovframework:rte:fdl:excel]]