목차

Interface 디바이스 API 가이드 프로그램

개요

모바일 Interface 디바이스 API 가이드 프로그램은 모바일 디바이스 API 실행환경을 활용하여 하이브리드 앱을 개발하시는 분들이 구현 시 전자정부 표준프레임워크 기반으로 구축된 웹서버와의 데이터 송수신을 쉽고 편하게 RESTful방식으로 구현할 수 있도록 참고 및 활용될 수 있는 가이드 앱 이다.

특징

본 가이드 프로그램에서는 Interface 기능을 가이드 할 수 있도록 정보데이터 서버로 송신하기, 정보데이터 기기로 수신하기, 서버의 데이터 삭제 요청하기 를 제공하고 있다.

기능 흐름도

기능시퀀스

전제 조건

구분 내용
Local 디바이스 개발 환경 Xcode 6.3.2, PhoneGap 4.3.0
서버 사이드 개발 환경 전자정부표준프레임워크 개발환경 3.5
Mash up Open API 연계N/A
테스트 디바이스 iPhone4, iPhone6
테스트 플랫폼 iOS 7.1.2, iOS 8.3
추가 라이브러리 적용EGovComModuleAPI.js, EgovComModule.h, libEgovComModule.a, EgovInterface.h, EgovInterface.m, EgovStorageInfo.h, EgovStorageInfo.m

제약 사항

지원 디바이스 및 플랫폼

iPhone 의 경우 장치의 연산속도에 따른 문제가 발생할 수 있다.
    document.addEventListener('DOMContentLoaded', function () { setTimeout(loaded, 200); }, false);
setTimeout(function()
           {
               myScroll = new iScroll(thisPage, 
                                      { 
                                          checkDOMChanges: true,
                                          onBeforeScrollStart:function(e)
                                          {
                                          }
                                      });
           },
           500);
CallBack 함수에서 alert() 를 포함하면 문제가 발생할수 있다 (phoneGap)

설명

관련 클래스다이어그램

Device Application

관련 소스

유형대상소스비고
CSSwww/css/egovframwork/mbl/hyb/InterfaceAPI.css InterfaceAPI 가이드 프로그램 주요 Cascading Style Sheets
IMAGE www/images/egovframwork/mbl/hyb/ InterfaceAPI 가이드 프로그램 주요 Image 폴더
JS www/js/egovframwork/mbl/hyb/InterfaceAPI.js InterfaceAPI 가이드 프로그램 주요 JavaScript
JS www/js/egovframwork/mbl/hyb/messages_ko.js Validate 메세지 처리 JavaScript
HTMLwww/InterfaceAPI.htmlInterfaceAPI 메인 페이지
HTMLwww/license.htmlInterfaceAPI 라이센스 페이지
HTMLwww/overview.htmlInterfaceAPI 기능설명 페이지

활용 API

window.plugins.EgovInterface.get
window.plugins.EgovInterface.get(URI, acceptType, params, successCallback);
var param = {pid:'egovmobile'};
window.plugins.EgovInterface.get("/mylist.do", "xml", params, function(xmldata){
    alert(xmldata);
});
Option설명비고
URI요청 할 URI서버 URL 설정은 환경설정 참조
acceptTypeHTTP Header 의 Accept-Type 설정json,xml
params입력 파라미터Json Object 타입으로 입력
successCallbackGET Method에 대한 성공시 리턴되는 함수acceptType에 따라 Json 또는 xml 데이터 처리
window.plugins.EgovInterface.post
window.plugins.EgovInterface.post(URI, acceptType, params, successCallback);
var param = {pid:'egovmobile'};
window.plugins.EgovInterface.post("/mylist.do", "xml", params, function(xmldata){
    alert(xmldata);
});
Option설명비고
URI요청 할 URI서버 URL 설정은 환경설정 참조
acceptTypeHTTP Header 의 Accept-Type 설정json,xml
params입력 파라미터Json Object 타입으로 입력
successCallbackGET Method에 대한 성공시 리턴되는 함수acceptType에 따라 Json 또는 xml 데이터 처리
window.plugins.EgovInterface.geturl
window.plugins.EgovInterface.geturl(successCallback);
window.plugins.EgovInterface.geturl(function(url){
    alert(url);
});
Option설명비고
successCallback성공시 리턴되는 함수String 타입

Server Application

관련 소스

유형대상소스비고
Controlleregovframework.hyb.ios.itf.web.EgovInterfaceiOSAPIController.java회원 정보 관리를 위한 클래스
Serviceegovframework.hyb.ios.itf.service.EgovInterfaceiOSAPIService.java회원 정보 관리를 위한 서비스 인터페이스
VOegovframework.hyb.ios.itf.service.InterfaceiOSAPIDefaultVO.java회원 관리를 위한 VO 클래스
VOegovframework.hyb.ios.itf.service.InterfaceiOSAPIVO.java회원 관리를 위한 VO 클래스
DAOegovframework.hyb.ios.itf.service.impl.InterfaceiOSAPIDAO.java회원 관리를 위한 데이터처리 클래스
DAOegovframework.hyb.ios.itf.service.impl.EgovInterfaceiOSAPIServiceImpl.java요청 서비스 처리를 위한 클래스
Query XMLresources/egovframework/sqlmap/hyb/ios/itf/EgovInterfaceiOSAPIGuide_SQL_mysql.xml회원 정보 관리를 위한 Query 파일

관련 테이블

테이블명테이블명(영문)비고
Interface(eGov)INTERFACE_EGOVInterface(eGov) 정보 관리

테이블 정의서

No컬럼ID컬럼명타입길이Null
1SN일련번호NUMERIC6NotNull
2UUIDUUIDVARCHAR50NotNull
3EMAILS이메일VARCHAR50Null
4USER_ID아이디VARCHAR20Null
5USER_PW패스워드VARCHAR200Null

ERD

환경설정

Interface 디바이스 API 가이드 프로그램에서 제공하는 모바일 디바이스의 Interface 관련 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.

config.xml

    <feature name="InterfaceAPI">
        <param name="ios-package" value="EgovInterface"/>
    </feature>

</code>

[Project_Name]/eGovModule/EGovComModule.h

<!--전자정부 Interface 디바이스 API에서 사용하기 위한 서버경로 설정-->
#define kSERVER_URL     @"Server_URL"

Server Application

resource/egovframework/sqlmap/sql-map-config_[DB명].xml

<sqlMap resource="egovframework/sqlmap/hyb/ios/itf/EgovInterfaceiOSAPIGuide_SQL_[DB명].xml"/>

관련 기능

Interface 디바이스API 가이드 프로그램은 크게 정보데이터 서버로 송신하기, 정보데이터 기기로 수신하기, 서버의 데이터 삭제 요청하기 기능으로 구성되어 있다.

정보데이터 서버로 송신하기

비즈니스 규칙

회원 가입 정보를 서버에 전송하여 응답 결과를 확인 할 수 있다.

관련코드

function fn_signUp() {
	
    var params = {  uuid :  device.uuid,
                    userId : $("#signUpId").val(), 
                    userPw : $("#signUpPasswd").val(),
                    emails : $("#signUpEmail").val()};	
	
    $.mobile.showPageLoadingMsg('a');
    EgovInterface.submitAsynchronous(
                                     [params, "/itf/addInterfaceiOSInfo.do"],
                                     function(result) {
                                         console.log("InterfaceAPIGuide fn_signUp Completed");
                                         var s = JSON.stringify(result);
                                         var str = '{resultState:'+result.resultState+',resultMessage:'+result.resultMessage+'}';
                                         alert('응답방식:RESTful\n응답Type:json, post\nParam:\n' + str);
                                         $.mobile.hidePageLoadingMsg('a');
                                         window.history.back();
                                     },
                                     function(error) {
                                         console.log("InterfaceAPIGuide fn_signUp Failed");
                                         var str = "";
                                         for (myKey in result){
                                             str += myKey + ' : ' + result[myKey] + '\n';
                                         }
                                         alert('응답방식:RESTful\n응답Type:json, post\nParam:\n' + str);
                                         $.mobile.hidePageLoadingMsg('a');
                                     }
                                     );
}

관련화면 및 수행매뉴얼

기능URLControllermethod화면(HTML)
정보데이터 서버로 송신하기/itf/addInterfaceInfo.doEgovInterfaceiOSAPIControlleraddInterfaceInfoInterfaceAPI.html#signUp

입력 데이터는 ID, PASSWD, E-Mail을 사용한다.

정보데이터를 서버로 송신하기 위해서는 회원가입 버튼을 클릭하면 된다.
단, 모든 입력데이터에 대해서 기본적인 validation을 확인하고, 조건이 불충분 할 경우 오류 메시지가 출력된다.

회원가입 : 정보데이터를 서버로 송신하기 위해서는 ID, PASSWD, E-Mail을 입력 후 회원가입 버튼을 클릭한다.
Back 버튼 : Interface 디바이스 API 가이드 프로그램 메뉴 화면으로 이동한다.

정보데이터 기기로 수신하기

비즈니스 규칙

로그인 정보를 서버에 전송하여 로그인 성공 여부를 조회 할 수 있다.

관련코드

function fn_login() {
    $.mobile.showPageLoadingMsg('a');
    alert('전송방식:RESTful\n전송Type:json, get\nURL:\n' + "/itf/logIniOS.do?userId=" + $("#loginId").val() + "&userPw=" + $("#loginPasswd").val());
    EgovInterface.submitAsynchronous(
                                    ["/itf/logIniOS.do?userId=" + $("#loginId").val() + "&userPw=" + $("#loginPasswd").val()],
                                    function(result) {
                                        console.log("InterfaceAPIGuide fn_login Completed");
                                        var str = '{resultState:'+result.resultState+',resultMessage:'+result.resultMessage+'}';
                                        alert('응답방식:RESTful\n응답Type:json, post\nParam:\n' + str);
                                        $.mobile.hidePageLoadingMsg('a');
                                        window.history.back();
                                    },
                                    function(error) {
                                        console.log("InterfaceAPIGuide fn_login Failed");
                                        var str = "";
                                        for (myKey in result){
                                            str += myKey + ' : ' + result[myKey] + '\n';
                                        }
                                        alert('응답방식:RESTful\n전송Type:json, post\nParam:\n' + str);
                                        $.mobile.hidePageLoadingMsg('a');
                                    }
                                    );
}

관련화면 및 수행매뉴얼

기능URLControllermethod화면(HTML)
정보데이터 기기로 수신하기/itf/logIn.doEgovInterfaceiOSAPIControllerlogInInterfaceAPI.html#login

정보데이터를 기기로 수신하기 위해서는 로그인 버튼을 클릭하면 된다.
단, 모든 입력데이터에 대해서 기본적인 validation을 확인하고, 조건이 불충분 할 경우 오류 메시지가 출력된다.

로그인 : 정보데이터를 기기로 수신하기 위해서는 ID, PASSWD를 입력 후 로그인 버튼을 클릭한다.
Back 버튼 : Interface 디바이스 API 가이드 프로그램 메뉴 화면으로 이동한다.

서버의 데이터 삭제 요청하기

비즈니스 규칙

ID, PASSWD 정보를 서버에 전송하여 회원탈퇴 성공 여부를 조회 할 수 있다.

관련코드

function fn_withdrawal() {

    var params = {  userId : $("#signDownId").val(),
                    userPw : $("#signDownPasswd").val() };
    $.mobile.showPageLoadingMsg('a');
    EgovInterface.submitAsynchronous(
                                     [params, "/itf/withdrawaliOS.do"],
                                     function(result) {
                                         console.log("InterfaceAPIGuide fn_withdrawal Completed");
                                         var str = '{resultState:'+result.resultState+',resultMessage:'+result.resultMessage+'}';
                                         alert('응답방식:RESTful\n응답Type:json, post\nParam:\n' + str);
                                         $.mobile.hidePageLoadingMsg('a');
                                         window.history.back();
                                     },
                                     function(error) {
                                         console.log("InterfaceAPIGuide fn_withdrawal Failed");
                                         var str = "";
                                         for (myKey in result){
                                             str += myKey + ' : ' + result[myKey] + '\n';
                                         }
                                         alert('응답방식:RESTful\n응답Type:json, post\nParam:\n' + str);
                                         $.mobile.hidePageLoadingMsg('a');
                                     }
                                     );
}

관련화면 및 수행매뉴얼

기능URLControllermethod화면(HTML)
서버의 데이터 삭제 요청하기/itf/logIn.doEgovInterfaceiOSAPIControllerwithdrawalInterfaceAPI.html#secessionMember

서버의 데이터를 삭제 요청하기 위해서는 회원탈퇴 버튼을 클릭하면 된다.
단, 모든 입력데이터에 대해서 기본적인 validation을 확인하고, 조건이 불충분 할 경우 오류 메시지가 출력된다.

회원탈퇴 : 서버의 데이터를 삭제 요청하기 위해서는 ID, PASSWD를 입력 후 회원탈퇴 버튼을 클릭한다.
Back 버튼 : Interface 디바이스 API 가이드 프로그램 메뉴 화면으로 이동한다.

컴파일 디버깅 배포

컴파일

Interface Device Applicaton 컴파일 방법

1. 디바이스 또는 시뮬레이터에서 실행하고자 할 경우 빨간 테두리 영역을 클릭한다.

2. 디바이스 또는 시뮬레이터를 선택한다.

3. 실행 버튼을 클릭한다.

4. 인트로 화면과 메인 화면을 확인한다.

InterfaceAPI Server Applicaton 컴파일 방법

디버깅

디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 console.log를 이용할 수 있다. console.log 함수는 자바스크립트 구문에서 사용할 수 있는 디버그 코드로 이클립스 및 Xcode에서 확인 할 수 있다.

function fn_egov_network_check(doCheck)
{
    console.log('DeviceAPIGuide fn_egov_network_check');
    var networkState = navigator.network.connection.type;
    ...
}



InterfaceAPI 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다.

디버그 코드디버깅 내용
InterfaceAPIGuide fn_login request Completed정보데이터 기기로 수신하기가 성공적으로 처리 된 경우.
InterfaceAPIGuide fn_login request Failed정보데이터 기기로 수신하기가 실패한 경우.
InterfaceAPIGuide fn_signUp request Completed정보데이터 서버로 송신하기가 성공적으로 처리 된 경우.
InterfaceAPIGuide fn_signUp request Failed정보데이터 서버로 송신하기가 실패한 경우.
InterfaceAPIGuide fn_withdrawal request Completed서버의 데이터 삭제 요청하기가 성공적으로 처리 된 경우.
InterfaceAPIGuide fn_withdrawal request Failed서버의 데이터 삭제 요청하기가 실패한 경우.

배포

Interface 디바이스 API 가이드 다운로드 : Click

참고 자료