====== 디지털 자산관리 - 모바일 사진 앨범 ====== ===== 개요 ===== 모바일 사진 앨범은 서버 내 저장된 사진을 쉽게 조회 하도록 목록과 상세사진을 동시에 제공하는 기능을 제공한다. 또한, 관리자가 \\ 서버에 저장된 사진을 쉽게 관리 할 수 있도록 사진 정보 목록조회, 상세조회, 등록, 수정, 삭제 기능을 제공한다. 모바일 사진 앨범은 JQuery Mobile에서 제공하는 Swipeleft, Swiperight, Tab 등의 Touch Events를 사용하여 모바일 단말기에서 사용자가 \\ 화면 터치를 통해 쉽게 사진들을 탐색할 수 있도록 하였다. * 기능흐름 {{:egovframework:mcom:mpa_flow.jpg?800}} 본 컴포넌트의 모바일 화면은 모바일 디바이스에 탑재된 브라우저를 대상으로 개발 및 테스트 검증이 완료되었다. \\ 또한 동일 제조사의 동일한 브랜드라도 PC용 브라우저와 mobile용 브라우저의 HTML5, CSS3 에 대한 지원이 상이함으로 \\ 개발시 유의가 필요함을 밝혀둔다. 검증 대상 디바이스와 브라우저로는 각각 갤럭시S2, 갤럭시S, iPad2, iPhone4, 갤럭시탭1 등의 디바이스와 \\ android용 웹 브라우저, Firefox, Safari, opera mobile 등의 모바일 브라우저를 사용하였다. 검증결과는 아래와 같다. Android \\ android용 웹 브라우저, Firefox(6.xx), opera mobile은 android OS 2.3(gingerbread) 에서 HTML5, CSS3 및 컴포넌트의 \\ 실행이 안정적으로 실행되는 것을 확인 하였다. \\ 반면 android OS 2.3(gingerbread) 하위 브라우저인 android 2.1, 2.2에서는 컴포넌트 실행에 있어 매끄럽지 못한 HTML5, CSS3 지원으로 인하여 \\ 컴포넌트의 UI 구현이 원할하지 못한 모습을 보였다. opera mobile의 경우 UI처리시 색상 및 이벤트 처리에 문제를 야기하였으며 \\ 그로인해 opera mobile은 3종 지원브라우저 대상에서 제외 되었다. \\ 테스트 모바일 디바이스로는 갤럭시, 갤럭시S2, 갤럭시탭1을 채택하였다. iOS \\ iOS는 3종 지원브라우저 대상중 하나로 Safari 4.2, 4.3 버전에서 검증을 하였으며 비교적 원활한 HTML5, CSS3를 지원을 하였다.\\ 테스트 모바일 디바이스로는 iPhone4, iPad2를 채택하였다. ===== 설명 ===== 모바일 사진 앨범은 크게 사진 정보의 관리기능인 **사진 정보 목록조회, 상세조회, 등록, 수정, 삭제**로 구성되어 있으며,\\ 서버에 저장된 사진을 앨범 형태로 조회하는 **모바일 사진 조회** 기능으로 구성되어 있다.(관련기능 부분참조) == 클래스 다이어그램 == {{:egovframework:mcom:mpa_class.jpg?1000}} == 관련소스 == ^유형^대상소스명^비고^ |Controller|egovframework.mbl.com.mpa.web.EgovPhotoController.java|모바일 사진 앨범 Controller Class| |Service|egovframework.mbl.com.mpa.service.EgovPhotoService.java|모바일 사진 앨범 Service Class| |ServiceImpl|egovframework.mbl.com.mpa.service.impl.EgovPhotoServiceImpl.java|모바일 사진 앨범 ServiceImpl Class| |Model|egovframework.mbl.com.mpa.service.Photo.java|모바일 사진 앨범 Model Class| |VO|egovframework.mbl.com.mpa.service.PhotoVO.java|모바일 사진 앨범 VO Class| |DAO|egovframework.mbl.com.mpa.service.impl.PhotoDAO.java|모바일 사진 앨범 Dao Class| |JSP|/WEB-INF/jsp/egovframework/mbl/com/mpa/EgovPhotoList.jsp|사진 정보 목록조회 페이지| |JSP|/WEB-INF/jsp/egovframework/mbl/com/mpa/EgovPhotoRegist.jsp|사진 정보 등록 페이지| |JSP|/WEB-INF/jsp/egovframework/mbl/com/mpa/EgovPhotoUpdt.jsp|사진 정보 수정 페이지| |JSP|/WEB-INF/jsp/egovframework/mbl/com/mpa/EgovPhotoDetail.jsp|사진 정보 상세조회 페이지| |JSP|/WEB-INF/jsp/egovframework/mbl/com/mpa/EgovMobilePhotoList.jsp|모바일 사진 조회 페이지| |QUERY XML|resources/egovframework/sqlmap/mbl/com/mpa/EgovPhoto_SQL_XXX.xml|모바일 사진 앨범 QUERY XML| |Validator Rule XML|resources/egovframework/validator/validator-rules.xml|Validator Rule을 정의한 XML| |Validator XML|resources/egovframework/validator/mbl/com/mpa/EgovPhoto.xml|모바일 사진 앨범 Validator XML| |Message properties|resources/egovframework/message/message-common_ko_KR.properties|모바일 사진 앨범 Message properties| |Idgen XML|resources/egovframework/spring/com/context-idgen.xml|사진 정보 Id생성 Idgen XML| == ID Generation == * ID Generation Service를 활용하기 위해서 Sequence 저장테이블인 COMTECOPSEQ에 MPA_ID (사진 정보 아이디) 항목을 추가해야 한다. == 관련테이블 == ^테이블명^테이블명(영문)^비고^ |사진 정보|COMTNPHOTOALBUM|사진 정보를 관리| == 로그인/회원관리/권한관리 == 모바일 사진 앨범은 **모바일 사진 정보 목록조회, 상세조회, 등록, 수정, 삭제**에서 관리자 인증이 필요하다.\\ 인증을 위해 로그인/회원관리/권한관리 컴포넌트와 연계하여 사용할 수 있다. Spring Security를 통해 인증을 할 경우 다음과 같이 변경하면 된다. == src/main/java/resources/egovframework/spring/com/context-egovuserdetailshelper.xml == == web.xml == springSecurityFilterChain org.springframework.web.filter.DelegatingFilterProxy springSecurityFilterChain /* org.springframework.security.ui.session.HttpSessionEventPublisher EgovSpringSecurityLogoutFilter egovframework.com.sec.security.filter.EgovSpringSecurityLogoutFilter EgovSpringSecurityLogoutFilter /uat/uia/actionLogout.do EgovSpringSecurityLoginFilter egovframework.com.sec.security.filter.EgovSpringSecurityLoginFilter EgovSpringSecurityLoginFilter *.do web.xml에 위 내용과 같은 Spring Security 관련 필터를 추가 하여야 한다. 로그인/회원관리/권한관리에 대한 자세한 내용은 다음을 참조한다. * 로그인 : [[egovframework:일반_로그인#일반로그인]] * 회원관리 : [[egovframework:사용자_관리|사용자관리]] * 권한관리 : [[egovframework:권한관리|권한관리]] 사용자/관리자 권한이 필요한 페이지는 다음과 같다. ^권한 종류^페이지 경로^설명^ |관리자|/mbl/com/mpa/selectPhotoList.mdo|모바일 사진 정보 목록조회 화면| |관리자|/mbl/com/mpa/selectPhoto.mdo|모바일 사진 정보 상세조회 화면| |관리자|/mbl/com/mpa/goPhotoRegist.mdo|모바일 사진 정보 등록 화면| |관리자|/mbl/com/mpa/insertPhoto.mdo|모바일 사진 정보 등록| |관리자|/mbl/com/mpa/goPhotoUpdt.mdo|모바일 사진 정보 수정 화면| |관리자|/mbl/com/mpa/updatePhoto.mdo|모바일 사진 정보 수정| |관리자|/mbl/com/mpa/deletePhoto.mdo|모바일 사진 정보 삭제| == 파일 다운로드/업로드 == 모바일 사진 정보에 필요한 사진 파일을 관리하기 위해 공통요소인 파일관리 컴포넌트를 사용하였다. 파일관리에 대한 자세한 내용은 다음을 참조한다. * 공통컴포넌트 참조 : [[egovframework:파일관리|File Manage 서비스]] ==== 설정 및 주의사항 ==== * 현재 배포된 모바일 공통컴포넌트는 HTML5, CSS3를 적용하고 있다.\\ * 그에 따라, 현재 모바일OK, W3C의 모바일 웹 사이트 유효성 검사의 표준에 맞지 않으며, 정확한 유효성 검사에 대한 문의는 해당 전문기관에 문의가 필요하다.\\ * 현재 배포된 모바일 공통컴포넌트 V 2.0은 소스코드에 대한 보안성 검증이 완료 되었다.\\ ===== 관련기능 ===== 모바일 사진 앨범은 크게 사용자가 사용하는 **모바일 사진 조회** 기능 및 관리자가 사용하는 **사진 정보 목록조회**, **사진 정보 상세조회**,\\ **사진 정보 등록**, **사진 정보 수정**, **사진 정보 삭제** 기능으로 구성되어있다. ==== 모바일 사진 조회 ==== === 비즈니스 규칙 === 모바일 환경에 적합한 HTML5 태그 등의 구조를 활용하여 사진 파일을 사용자가 쉽게 조회를 할 수 있도록 하였다. === 관련코드 === N/A === 관련화면 및 수행매뉴얼 === ^Action^URL^Controller method^QueryID^ |목록조회|/mbl/com/mpa/selectMobilePhotoList.mdo|selectMobilePhotoList|"PhotoDAO.selectPhotoList"| ^모바일 사진 목록조회 화면^모바일 사진 상세조회 화면^ |{{:egovframework:mcom:egovmobilephotolist.jpg}}|{{:egovframework:mcom:egovmobilephotodetail.jpg}}| ==== 사진 정보 목록조회 ==== === 비즈니스 규칙 === 조회조건으로 목록조회를 할 수 있고, 등록버튼을 클릭하여 사진 정보 등록 화면으로 이동하여 사진 정보를 등록 처리 할 수 있다. === 관련코드 === N/A === 관련화면 및 수행매뉴얼 === ^Action^URL^Controller method^QueryID^ |조회|/mbl/com/mpa/selectPhotoList.mdo|selectPhotoList|"PhotoDAO.selectPhotoList"| | |/mbl/com/mpa/selectPhotoList.mdo|selectPhotoListTotCnt|"PhotoDAO.selectPhotoListTotCnt"| |등록|/mbl/com/mpa/goPhotoRegist.mdo|goPhotoRegist| | |목록클릭|/mbl/com/mpa/selectPhoto.mdo|selectPhoto|"PhotoDAO.selectPhoto"| 사진 정보 목록은 페이지 당 10건씩 조회되며 페이징은 10페이지씩 이루어진다. 검색조건은 사진 제목에 대해서 수행된다.\\ 페이지 당 검색 범위를 변경하고자 하는 경우 context-properties.xml 파일의 pageUnit, pageSize를 변경한다.\\ (단 해당 설정은 전체 공통서비스 기능에 영향을 미친다.) {{:egovframework:mcom:egovphotolist.jpg|사진 정보 목록}} 조회: 사진 정보를 조회하기 위해서는 상단의 검색조건을 선택 후 해당하는 검색문자를 입력 후 조회 버튼을 클릭한다. \\ 등록: 사진 정보를 등록하기 위해서는 상단의 등록 버튼을 통해서 **사진 정보 등록** 화면으로 이동한다. \\ 목록클릭: **사진 정보 상세조회** 화면으로 이동한다. ==== 사진 정보 상세조회 ==== === 비즈니스 규칙 === 사진 정보 목록조회에서 목록 클릭 시 이동되는 화면으로 사진 정보에 대한 상세정보를 보여준다. === 관련코드 === N/A === 관련화면 및 수행매뉴얼 === ^Action^URL^Controller method^QueryID^ |수정|/mbl/com/mpa/goPhotoUpdt.mdo|goMultimediaUpdt| | |삭제|/mbl/com/mpa/deletePhoto.mdo"|deletePhoto|"PhotoDAO.deletePhoto"| |목록|/mbl/com/mpa/selectPhotoList.mdo|selectPhotoList|"PhotoDAO.selectPhotoList"| 사진 정보 상세조회 화면은 사진 정보 수정, 사진 정보 삭제, 사진 정보 목록조회를 할 수 있다. {{:egovframework:mcom:egovphotodetail.jpg|사진 정보 상세조회}} 수정: 수정버튼 클릭 시 사진정보를 수정할 수 있는 ** 사진 정보 수정 **화면으로 이동한다. \\ 삭제: 삭제버튼 클릭 시 삭제여부를 확인하는 메세지를 보여주고 삭제처리를 할 수 있다. \\ 목록: **사진 정보 목록조회** 화면으로 이동한다. ==== 사진 정보 등록 ==== === 비즈니스 규칙 === 입력명 우측의 빨간* 표시는 반드시 입력해야할 항목을 표시한다. \\ 저장처리 시 MPA_ID 컬럼은 "egovframework.rte.fdl.idgnr.impl.EgovTableIdGnrService"를 통하여 자동으로 부여된다.\\ Primary Key => MPA_ID : 일련번호로 자동생성 부여된다. === 관련코드 === N/A === 관련화면 및 수행매뉴얼 === ^Action^URL^Controller method^QueryID^ |등록|/mbl/com/mpa/insertPhoto.mdo|insertPhoto|"PhotoDAO.insertPhoto"| |목록|/mbl/com/mpa/selectPhotoList.mdo|selectPhotoList|"PhotoDAO.selectPhotoList"| 사진 정보에 관한 기본정보를 입력 저장처리한다. {{:egovframework:mcom:egovphotoregist.jpg|사진 정보 등록}} 등록: 입력한 사진 정보가 저장 처리된다. \\ 목록: **사진 정보 목록조회** 화면으로 이동한다. ==== 사진 정보 수정 ==== === 비즈니스 규칙 === 입력명 우측의 빨간* 표시는 수정 시 반드시 입력해야 할 항목을 표시한다. \\ === 관련코드 === N/A === 관련화면 및 수행매뉴얼 === ^Action^URL^Controller method^QueryID^ |수정|/mbl/com/mpa/updatePhoto.mdo|updatePhoto|"PhotoDAO.updatePhoto"| |목록|/mbl/com/mpa/selectPhotoList.mdo|selectPhotoList|"PhotoDAO.selectPhotoList"| 입력한 사진 정보를 저장 처리한다. {{:egovframework:mcom:egovphotoupdt.jpg|사진 정보 수정}} 수정: 수정 입력한 사진 정보가 저장 처리된다. \\ 목록: **사진 정보 목록조회** 화면으로 이동한다. ===== 참고자료 ===== * 실행환경 참조 : [[egovframework:rte:fdl:id_generation#Table Id Generation Service|ID Generation Service]] * 배포 및 테스트 관련 : [[egovframework:mcom:모바일 공통컴포넌트란?|모바일 공통컴포넌트란]] 및 [[모바일_배포_패키지_구성안|배포 패키지 구성안]] * 관련 데이터베이스 구조 및 스키마 : [[모바일_관련_데이터베이스_구조_및_스키마|관련 데이터베이스 구조 및 스키마]]