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

개요

Network 가이드 프로그램은 모바일 디바이스 API 실행환경을 활용하여 하이브리드 앱을 개발 시 참고 및 활용될 수 있도록 구현된 전자정부 디바이스 API에 대한 가이드 앱으로써, 모바일 스마트 디바이스의 Network 관련 기능을 JavaScript 기반으로 구성 된 Network DeviceAPI 를 통하여 조회 할 수 있도록 지원한다. 또한, 전자정부 표준프레임워크 기반의 웹 서버 어플리케이션과 연계하여 디바이스 내 Network 정보를 체크하여 미디어를 플레이하는 기능과 네트워크 정보를 서버에 전송하고 조회할 수 있는 기능으로 구성되어 있다.

특징

본 가이드 프로그램 에서는 Network 기능을 가이드 할 수 있도록 네트워크 상태를 체크하여 미디어 플레이 하기, 네트워크 정보를 서버에 전송하기,
네트워크 정보 목록을 서버로부터 수신하기 를 제공하고 있다.

기능 흐름도

기능 시퀀스

전제 조건

구분 내용
Local 디바이스 개발 환경 Xcode 8.0 (8A218a), Cordova 6.4.0
서버 사이드 개발 환경 전자정부표준프레임워크 개발환경3.6
Mash up Open API 연계 N/A
테스트 디바이스 iPhone 6 , iPad Air
테스트 플랫폼 iOS 9.3, iOS 10.0
추가 라이브러리 적용N/A

제약 사항

지원 디바이스 및 플랫폼

iPhone 의 경우 장치의 연산속도에 따른 문제가 발생할 수 있다.
  • 문제 : 폰갭 오류시.
  • 해결방안 : setTimeout() 함수로 phonegap 로딩 순서를 지연시킨다.
    document.addEventListener('DOMContentLoaded', function () { setTimeout(loaded, 200); }, false);
  • 문제 : iScroll5 컨텐츠 내용 높이 계산 오류.
  • 해결방안 : setTimeout() 함수로 컨텐츠에 css 적용이 완료되고 iscroll 생성이 되도록 한다.
setTimeout(function()
           {
               myScroll = new iScroll(thisPage, 
                                      { 
                                          checkDOMChanges: true,
                                          onBeforeScrollStart:function(e)
                                          {
                                          }
                                      });
           },
           500);

크로스 도메인 사용

폰갭에서 특정 외부 도메인이나 외부 도메인의 하위 도메인을 사용해야할 경우,
[Project_Name]/Supporting Files/config.xml에서 <access origin=“ExternalHosts”/> 항목에 외부 도메인 주소를 추가 설정해야 외부 도메인에 접속할 수 있다.

라이선스

N/A

설명

Network 디바이스API 가이드 프로그램은 크게 네트워크 상태를 체크하여 미디어 플레이하기, 네트워크 정보를 서버에 전송하기,
네트워크 정보 목록을 서버로부터 수신하기 기능으로 구성되어 있다.(관련기능 부분참조)

관련 클래스다이어그램

Device Application

관련소스

유형대상소스비고
CSSassets/www/css/egovframwork/mbl/hyb/NetworkAPI.css NetworkAPI 가이드 프로그램 주요 Cascading Style Sheets
IMAGE assets/www/images/egovframwork/mbl/hyb/ NetworkAPI 가이드 프로그램 주요 Image 폴더
JS assets/www/js/egovframwork/mbl/hyb/NetworkAPI.js NetworkAPI 가이드 프로그램 주요 JavaScript
HTMLassets/www/NetworkAPI.htmlNetworkAPI 메인 페이지
HTMLassets/www/license.htmlNetworkAPI 라이센스 페이지
HTMLassets/www/overview.htmlNetworkAPI 기능설명 페이지
HTMLassets/www/intro.htmlNetworkAPI Intro 페이지
RES [Project_Name]/Resources/ NetworkAPI 가이드 프로그램 주요 Resource 폴더
PLIST [Project_Name]/Resources/[Project_Name]-Info.plist iOS 어플리케이션 설정 파일

활용 API

navigator.network.connection.type
  • 현재 디바이스의 네트워크 상태 정보
var states = {};
states[Connection.UNKNOWN]  = 'Unknown connection';
states[Connection.ETHERNET] = 'Ethernet connection';
states[Connection.WIFI]     = 'WiFi connection';
states[Connection.CELL_2G]  = 'Cell 3G connection';
states[Connection.CELL_3G]  = 'Cell 3G connection';
states[Connection.CELL_4G]  = 'Cell 4G connection';
states[Connection.NONE]     = 'No network connection';

var NowNetwork = states[navigator.network.connection.type];
Return State(code)NetworkInfo(string)
Connection.UNKNOWNUnknown connection
Connection.ETHERNETEthernet connection
Connection.WIFIWiFi connection
Connection.CELL_2GCell 2G connection
Connection.CELL_3GCell 3G connection
Connection.CELL_4GCell 4G connection
Connection.NONENo network connection
media.play
  • 오디오 파일을 재생 시작 또는 다시 시작합니다.
function playAudio(file) {
    var my_media = new Media(file,
        function() {
            console.log("playAudio():Audio Success");
        },
        function(err) {
            console.log("playAudio():Audio Error: "+err);
    });
    my_media.play();
}
play Option
Option설명비고
numberOfLoops재생하려는 횟수를 지정
playAudioWhenScreenIsLocked디바이스 화면이 잠긴 상태일때 재생여부 선택
mediaError
Error codesError Value비고
MEDIA_ERR_ABORTED사용자에 의해 중단된 비디오 재생
MEDIA_ERR_NETWORK네트워크 에러
MEDIA_ERR_DECODE디코딩 에러(코덱문제)
MEDIA_ERR_SRC_NOT_SUPPORTED지원하지 않는 형식의 오디오
my_media.stop
  • 이 함수는 오디오 파일을 재생 중지 하는 기능입니다.
function playAudio(file) {
    var my_media = new Media(file,
        function() {
            console.log("playAudio():Audio Success");
        },
        function(err) {
            console.log("playAudio():Audio Error: "+err);
    });
    my_media.play();
    setTimeout(function() {
        my_media.stop();
    }, 10000);        
}

Server Application

관련소스

유형대상소스비고
Controlleregovframework.hyb.ios.nwk.web.EgovNetworkiOSAPIController.java네트워크 정보 관리를 위한 클래스
Serviceegovframework.hyb.ios.nwk.service.EgovNetworkiOSAPIService.java네트워크 정보 관리를 위한 서비스 인터페이스
VOegovframework.hyb.ios.nwk.service.NetworkiOSAPIDefaultVO.java네트워크 정보 관리를 위한 VO 클래스
VOegovframework.hyb.ios.nwk.service.NetworkiOSAPIVO.java네트워크 정보 관리를 위한 VO 클래스
DAOegovframework.hyb.ios.nwk.service.impl.NetworkiOSAPIDAO.java네트워크 정보 관리를 위한 데이터처리 클래스
DAOegovframework.hyb.ios.nwk.service.impl.EgovNetworkiOSAPIServiceImpl.java요청 서비스 처리를 위한 클래스
Query XMLresources/egovframework/sqlmap/hyb/ios/nwk/EgovNetworkiOSAPOGuide_SQL_mysql.xml네트워크 정보 관리를 Query 파일

관련 테이블

테이블명

테이블명테이블명(영문)비고
네트워크Network네트워크 정보 관리

테이블 명세서

네트워크
No.컬럼컬럼명타입길이NullKEY
1SN일련번호NUMERIC6NotNullpk
2UUIDUUIDVARCHAR50NotNullpk
3NTWRK_TYPE네트워크typeVARCHAR20Null
4USEYN활성화여부CHAR1Nullpk

ERD

환경 설정

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

Device Application

config.xml

ExternalHosts
    <access origin="ExternalHosts"/>
Plugins
    <feature name="NetworkStatus">
        <param name="ios-package" value="CDVConnection"/>
    </feature>

Server Aplication

context-properties.xml

<entry key="serverContext" value="서버의 경로"/>

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

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

관련 기능

Network 디바이스API 가이드 프로그램은 크게 네트워크 상태를 체크하여 미디어 플레이 하기, 네트워크 정보를 서버에 전송하기,
네트워크 정보 목록을 서버로부터 수신하기 기능으로 구성되어 있다.

네트워크 상태를 체크하여 미디어 플레이 하기

비즈니스 규칙

1. 최초 앱 실행시 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
2. 미디어 스트리밍시 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 항상 사용자 승인여부를 체크한다.

관련 코드

네트워크 상태를 체크한다
var  isNetworkCheck = false;
function fn_egov_network_check(doCheck)
{
    console.log('DeviceAPIGuide fn_egov_network_check');
    var networkState = navigator.network.connection.type;
    
    if (networkState == Connection.UNKNOWN || networkState == Connection.NONE)
    {
        jAlert("네트워크가 연결되어 있지 않습니다.", "알림", "b");
        return false;
    }
    if(networkState != Connection.WIFI)
    {
        if(!doCheck) 
        {
            if(isNetworkCheck)
            {
                return true;
            }
        }
		
	if(confirm('Wi Fi 망이 아닐경우 추가적인 비용이 발생 할 수 있습니다. \n계속 하시겠습니까?')) 
        {		
	    isNetworkCheck = true;
            return true;
        } 
        else 
        {		
            isNetworkCheck = false;
            return false;
        }		
    }
    else
    {		
        return true;
    }
}
미디어를 재생한다
function fn_egov_click_mediaBtn()
{
    if(context === null)
    {
        fn_egov_init_context();
        return;
    }
    
    if(audioCheck)      // 이미 재생중이라면 음악만 정지
    {
        fn_egov_stop_audio();
        audioCheck = false;
    }
    else
    {
        // 오디오, 동영상 스트리밍의 경우 매번 네트워크 체크를 하여 사용자 승인 물어보기
        if(fn_egov_network_check(true))
        {
            $.mobile.showPageLoadingMsg('a');
            // 디바이스의 성능에 따라 PrograssDialog Show 가 완전이 로딩이 된후 다음 코드를 수행하도록 setTimeout 을 사용하여 지연시킨다.
            setTimeout(function()
                       {
                           fn_egov_play_audio();
                       
                           var params = {
                               uuid :  device.uuid,
                               networktype : states[navigator.network.connection.type],
                               useYn : "Y"
                           };
                       
                           fn_egov_sendto_server("/nwk/addNetworkiOSInfo.do",params);
                       }, 
                       500);
        }
    }
}
네트워크 정보를 서버로 전송
var params = {
    uuid :  device.uuid,
    networktype : states[navigator.network.connection.type],
    useYn : "Y"
};

fn_egov_sendto_server("/nwk/addNetworkiOSInfo.do",params);

관련 화면 및 수행매뉴얼

기능URLControllermethod화면(HTML)
미디어 재생/nwk/getMp3FileiOS.doEgovNetworkiOSAPIControllergetMp3FileNetworkAPI.html#vbrMain
네트워크 정보 업로드/nwk/addNetworkiOSInfo.doEgovNetworkiOSAPIControllerinsertNetworkInfoNetworkAPI.html#vbrMain
네트워크 재생 화면

Media Play: 네트워크 상태를 체크하여 Wi-Fi 가 아닐 경우에는 사용자 승인에 따라 서버의 미디어를 재생하고 디바이스의 네트워크 정보를 업로드한다.

네트워크 정보 목록을 서버로부터 수신하기

비즈니스 규칙

1. 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.

관련 코드

네트워크 정보 목록 요청
function fn_egov_open_networkList()
{
    if(context === null)    // 최초 앱 실행시 3G 사용자 승인 여부 판단
    {
        fn_egov_init_context();
        return;
    }
    
    if(fn_egov_network_check(false))     // 통신 이벤트 발생시 3G 사용자 승인여부 판단
    {
        var params = {};
        
        $.mobile.showPageLoadingMsg('a');
        // 디바이스의 성능에 따라 PrograssDialog Show 가 완전이 로딩이 된후 다음 코드를 수행하도록 setTimeout 을 사용하여 지연시킨다.
        setTimeout(function()
                   {
                       fn_egov_sendto_server("/nwk/networkiOSInfoList.do",params);
                   }, 
                   500);
    }        
}
네트워크 정보 상세 요청
function fn_egov_open_networkDetailInfo(selectedId)
{   
    if(fn_egov_network_check(false))        // 통신 이벤트 발생시 3G 사용자 승인여부 판단
    {
        var params = { sn : selectedId };
        
        $.mobile.showPageLoadingMsg('a');
        // 디바이스의 성능에 따라 PrograssDialog Show 가 완전이 로딩이 된후 다음 코드를 수행하도록 setTimeout 을 사용하여 지연시킨다.
        setTimeout(function()
                   {
                       fn_egov_sendto_server("/nwk/networkiOSInfo.do",params);
                   }, 
                   500);
    }
}
네트워크 정보 삭제 요청
function fn_egov_click_deleteBtn()
{
    if(fn_egov_network_check(false))        // 통신 이벤트 발생시 3G 사용자 승인여부 판단
    {
        var params = {
            sn : pageNumber
        };
        
        $.mobile.showPageLoadingMsg('a');
        // 디바이스의 성능에 따라 PrograssDialog Show 가 완전이 로딩이 된후 다음 코드를 수행하도록 setTimeout 을 사용하여 지연시킨다.
        setTimeout(function()
                   {
                       fn_egov_sendto_server("/nwk/deleteNetworkiOSInfo.do",params);
                   }, 
                   500);
    }
}

관련 화면 및 수행매뉴얼

기능URLControllermethod화면(HTML)
네트워크 정보 목록 요청/nwk/networkiOSInfoList.doEgovNetworkiOSAPIControllerselectNetworkInfoListNetworkAPI.html#apiListView
네트워크 정보 상세 요청/nwk/networkiOSInfo.doEgovNetworkiOSAPIControllerselectNetworkInfoNetworkAPI.html#networkInfoDetail
네트워크 정보 삭제 요청/nwk/deleteNetworkiOSInfo.doEgovNetworkiOSAPIControllerdeleteNetworkInfoNetworkAPI.html#networkInfoDetail
네트워크 목록 화면 네트워크 상세 화면

뒤로:메인 페이지를 호출한다.
리스트:선택한 리스트의 네트워크 상세 정보를 표시한다.
목록:네트워크 정보 목록 페이지를 호출한다.
삭제:선택한 네트워크 정보를 삭제한다.

컴파일 디버깅 배포

컴파일

Device Applicaton 컴파일 방법

  • 왼쪽 상단의 삼각형 버튼을 클릭하면 가이드 프로그램이 빌드되어 아이폰 디바이스에 설치 된다.

  • 빌드가 성공하면 아래와 같은 어플리케이션 실행화면을 확인 할 수 있다.

Server Applicaton 컴파일 방법

  • 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.

  • 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.

디버깅

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

  • 실제 콘솔 로그 예
function fn_egov_network_check(doCheck)
{
    console.log('DeviceAPIGuide fn_egov_network_check');
    var networkState = navigator.network.connection.type;
    ...
}
  • xCode 콘솔 창


로그 메시지비고
DeviceAPIGuide fn_egov_network_check네트워크 상태 체크
DeviceAPIGuide fn_egov_sendto_server Response Completed서버에 요청한 내용이 성공적으로 처리 된 경우
DeviceAPIGuide fn_egov_sendto_server Response Failed서버 내부 처리 오류
DeviceAPIGuide fn_egov_sendto_server Request Failed통신 오류
DeviceAPIGuide fn_egov_play_audio Success미디어 재생 성공
DeviceAPIGuide fn_egov_play_audio Error미디어 재생 실패

배포

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

참고 자료

  • Cordova : Click
  • UX/UI 라이브러리 : jQuery MobileClick
 
egovframework/hyb3.6/guide/ios/network.txt · 마지막 수정: 2023/12/21 05:21 (외부 편집기)
 
이 위키의 내용은 다음의 라이센스에 따릅니다 :CC Attribution-Noncommercial-Share Alike 3.0 Unported
전자정부 표준프레임워크 라이센스(바로가기)

전자정부 표준프레임워크 활용의 안정성 보장을 위해 위험성을 지속적으로 모니터링하고 있으나, 오픈소스의 특성상 문제가 발생할 수 있습니다.
전자정부 표준프레임워크는 Apache 2.0 라이선스를 따르고 있는 오픈소스 프로그램입니다. Apache 2.0 라이선스에 따라 표준프레임워크를 활용하여 발생된 업무중단, 컴퓨터 고장 또는 오동작으로 인한 손해 등에 대해서 책임이 없습니다.
Recent changes RSS feed CC Attribution-Noncommercial-Share Alike 3.0 Unported Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki