목차

시스템/서비스 연계 - MMS 서비스연계 v2.0

개요

MMS 서비스연계는 행정기관이 이동통신서비스를 이용하여 기관의 필요에 따라 각종 행정업무에 활용할 수 있도록
행정안전부 정부통합전산센터 M-Gov(http://www.mgov.go.kr)에서 구축/제공하는 이동통신 기반의 MMS 서비스를 인터페이싱한 컴포넌트이다.

실제 메시지는 정부통합전산센터 M-Gov(http://www.mgov.go.kr)에서 제공하는 API가 전송 처리, 결과값 반환처리를 하고,
본 컴포넌트는 사용자 입력값을 넘겨주고, 반환받은 결과값을 처리하는 역할을 한다.
장문 메시지, 이미지, 동영상, 벨소리 등을 전송할 수 있도록 기반환경을 지원한다.

본 컴포넌트는 사용자가 MMS를 전송하며, 관리자가 MMS 첨부파일 및 전송결과를 관리하는 기능을 제공한다.

※ 본 컴포넌트는 v1.0에서 v2.0으로 버전업되면서 컴포넌트 사용 시 사전환경설정이 간소화 되었기에 v2.0 사용을 권장한다.
※ 본 가이드에서는 v1.0에서 v2.0으로 버전업되면서 변경된 사항만을 가이드하오니 공통적인 부분은 mms서비스연계 v1.0 가이드를 참조한다.

전제조건

mms서비스연계 v1.0 가이드를 참조한다.

설명

모바일MMS서비스는 크게 MMS 첨부파일의 관리기능인 MMS첨부파일 목록조회, 상세조회, 등록, 수정, 삭제와 MMS 전송결과 관리기능인 MMS전송결과 목록조회로 구성되어 있으며,
MMS 전송 기능으로 구성되어 있다.(관련기능 부분참조)

클래스 다이어그램

관련소스
유형대상소스명비고
Controlleregovframework.mbl.com.mms.web.EgovMmsController.javaMMS Controller Class
Serviceegovframework.mbl.com.mms.service.EgovMmsService.javaMMS Service Class
ServiceImplegovframework.mbl.com.mms.service.impl.EgovMmsServiceImpl.javaMMS ServiceImpl Class
Modelegovframework.mbl.com.mms.service.MmsTransInfo.javaMMS 전송정보 Model Class
Modelegovframework.mbl.com.mms.service.AttachFile.java첨부파일 Model Class
VOegovframework.mbl.com.mms.service.MmsTransInfoVO.javaMMS 전송정보 VO Class
VOegovframework.mbl.com.mms.service.AttachFileVO.java첨부파일 VO Class
DAOegovframework.mbl.com.mms.service.impl.MmsDAO.javaMMS Dao Class
JSP/WEB-INF/jsp/egovframework/mbl/com/mms/EgovMmsAttachFileList.jsp첨부파일 목록조회 페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/mms/EgovMmsAttachFileRegist.jsp첨부파일 등록 페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/mms/EgovMmsAttachFileUpdt.jsp첨부파일 수정 페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/mms/EgovMmsAttachFileDetail.jsp첨부파일 상세조회 페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/mms/EgovMmsTransResultList.jspMMS전송결과 목록조회 페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/mms/EgovMobileMmsRegist.jsp모바일 MMS 전송 페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/mms/EgovMobileAttachFileList.jsp모바일 첨부파일 조회 페이지
QUERY XMLresources/egovframework/sqlmap/mbl/com/mms/EgovMms_SQL_XXX.xmlMMS QUERY XML
Validator Rule XMLresources/egovframework/validator/validator-rules.xmlValidator Rule을 정의한 XML
Validator XMLresources/egovframework/validator/mbl/com/mms/EgovMms.xmlMMS Validator XML
Message propertiesresources/egovframework/message/message-common_ko_KR.propertiesMMS Message properties
Idgen XMLresources/egovframework/spring/com/context-idgen.xmlMMS 전송결과 Id, 첨부파일 Id생성 Idgen XML
ID Generation

mms서비스연계 v1.0 가이드를 참조한다.

관련테이블

mms서비스연계 v1.0 가이드를 참조한다.

로그인/회원관리/권한관리

mms서비스연계 v1.0 가이드를 참조한다.

설정 및 주의사항

* 현재 배포된 모바일 공통컴포넌트는 HTML5, CSS3를 적용하고 있다.
* 그에 따라, 현재 모바일OK, W3C의 모바일 웹 사이트 유효성 검사의 표준에 맞지 않으며, 정확한 유효성 검사에 대한 문의는 해당 전문기관에 문의가 필요하다.
* 현재 배포된 모바일 공통컴포넌트 V 2.0은 소스코드에 대한 보안성 검증이 완료 되었다.

환경설정

MMS 서비스연계 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다. 

#-----------------------------------------------------------------------
#
#   mms.properties : MMS 연계 관련 정보를 나타내는 Config 파일
#   
#-----------------------------------------------------------------------
#   1.  key = value 구조
#   2.  key값은 공백문자를 포함불가, value값은 공백문자를 가능
#   3.  key값으로 한글을 사용불가,   value값은 한글사용이 가능
#   4.  줄을 바꿀 필요가 있으면 '\'를 라인의 끝에 추가(만약  '\'문자를 사용해야 하는 경우는 '\\'를 사용)
#   5.  Windows에서의 디렉토리 표시 : '\\' or '/'  ('\' 사용하면 안됨)
#   6.  Unix에서의 디렉토리 표시 : '/'
#   7.  주석문 처리는  #사용
#   8.  value값 뒤에 스페이스가 존재하는 경우 서블릿에서 참조할때는 에러발생할 수 있으므로 trim()하거나 마지막 공백없이 properties 값을 설정할것
#-----------------------------------------------------------------------
 
# MMS 연계 정보
mmsPort = 13000(또는 14000)
mmsHost = M-Gov G/W IP
mmsId = 인증 ID
mmsPassword = 인증 패스워드

위의 정보에서 mmsHost는 정부통합전산센터 M-Gov에서 제공하는 가이드를 참조해서 입력하고, mmsId, mmsPassword 항목에는 각각 발급받은 인증정보를 입력한다.
mmsPort의 경우 개발테스트 시에는 14000번 포트를 이용하고, 실제 서비스시 13000번 포트를 이용한다.
(14000번 포트 사용시 사용자에게 실제로 메시지가 전송되는 것이 아니라 M-Gov Gateway Server에서 임의 결과값을 전송 요청자에게 되돌려 준다는 사실을 참고한다.)

본 컴포넌트를 이용하기 위해서는 다음의 라이브러리들이 필요하며 이 라이브러리를 classpath로 추가한다.

activation.jar
commons-codec-1.3.jar
commons-httpclient-3.1-alpha1.jar
commons-logging-1.0.4.jar
dom.jar
log4j-1.2.9.jar
mail.jar
mose-api-1.5.1.jar
saaj-api.jar
saaj-impl.jar
soap.jar
xalan.jar
xercesImpl.jar

위의 라이브러리는 정부통합전산센터(http://www.mgov.go.kr)에서 다운로드 받을 수 있다.
(정부통합전산센터홈 > 서비스 소개 > FAQ > QUESTION 6번에서 다운로드)

관련기능

mms서비스연계 v1.0 가이드를 참조한다.

참고자료