var name = device.name;
var cordova= device.cordova;
var platform = device.platform;
var uuid = device.uuid;
var version = device.version;
^변수^설명^비고^
|name|디바이스에 셋팅된 명칭을 반환한다.| |
|cordova|어플리케이션에서 사용된 폰갭 버전을 반환한다.| |
|platform|모바일 디바이스의 플랫폼 정보를 반환한다.| |
|uuid|디바이스 고유의 UUID를 반환한다.| |
|version|디바이스의 플랫폼 버전을 반환한다.| |
== Event[batterycritical] ==
* 배터리 상태가 Critical 레벨에 도달 했을때 호출되는 콜백함수 정의
window.addEventListener("batterycritical", yourCallbackFunction, false);
== Event[batterylow] ==
* 배터리 상태가 Low 레벨에 도달 했을때 호출되는 콜백함수 정의
window.addEventListener("batterylow", yourCallbackFunction, false);
== Event[batterystatus] ==
* 배터리 상태에 변화가 감지되면 호출되는 콜백함수 정의
window.addEventListener("batterystatus", yourCallbackFunction, false);
== StorageInfo Plugin API ==
* 디바이스의 총 메모리 용량 조회 함수
StorageInfo.totalFileSystemSize(successCallback, failCallback, []);
* 디바이스의 가용 메모리 용량 조회 함수
StorageInfo.freeFileSystemSize(successCallback, failCallback, []);
==== Server Application ====
=== 관련 소스 ===
^유형^대상소스명^비고^
|Controller|egovframework.hyb.ios.dvc.web.EgovDeviceiOSAPIController.java|DeviceInfoAPI 가이드 프로그램 Controller Class|
|Service|egovframework.hyb.ios.dvc.service.EgovDeviceiOSAPIService.java|DeviceInfoAPI 가이드 프로그램 Service Class|
|ServiceImpl|egovframework.hyb.ios.dvc.service.impl.EgovDeviceiOSAPIServiceImpl.java|DeviceInfoAPI 가이드 프로그램 ServiceImpl Class|
|VO|egovframework.hyb.ios.dvc.service.DeviceiOSAPIVO.java|DeviceInfoAPI 가이드 프로그램 VO Class|
|DAO|egovframework.hyb.ios.dvc.service.impl.DeviceiOSAPIDAO.java|DeviceInfoAPI 가이드 프로그램 Dao Class|
|QUERY XML|resources/egovframework/sqlmap/hyb/ios/dvc/EgovDeviceiOSAPIGuide_SQL_[DB명].xml|DeviceInfoAPI 가이드 프로그램 QUERY XML|
=== 관련 테이블 ===
^테이블명^테이블명(영문)^비고^
|디바이스|Device|디바이스 정보 관리|
=== 테이블 정의서 ===
* Device
^No^컬럼ID^컬럼명^타입^길이^NULL^
|1|SN|일련번호|NUMERIC|6|NotNull|
|2|UUID|UUID|VARCHAR|50|NotNull|
|3|TELNO|전화번호|VARCHAR|20|Null|
|4|STRGE_INFO|스토리지정보|VARCHAR|40|Null|
|5|LANG|언어|VARCHAR|15|Null|
|6|NTWRK_DEVICE_INFO|네트워크디바이스정보|VARCHAR|20|Null|
|7|PG_VER|폰갭버전|VARCHAR|40|Null|
|8|DEVICE_NM|디바이스명|VARCHAR|200|Null|
|9|USEYN|활성화여부|CHAR|1|Null|
=== ERD ===
{{:egovframework:hyb:guide:ios:erd.jpg|}}
===== 환경설정 =====
DeviceInfo 디바이스API 가이드 프로그램에서 제공하는 모바일 디바이스의 메타 정보 조회 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.
==== Device Application ====
=== Cordova.plist ===
== Plugin ==
== ExternalHosts ==
=== [Project_Name]/eGovModule/EGovComModule.h ===
#define kSERVER_URL @"Server_URL"
==== Server Application ====
=== resource/egovframework/sqlmap/sql-map-config_[DB명].xml ===
===== 관련기능 =====
DeviceInfo 디바이스API 가이드 프로그램은 크게 디바이스 내 메타 정보 조회 기능과 조회된 메타 정보를 서버에 전송하고 조회할수 있는 기능으로 구성되어 있다.
==== 디바이스 정보 조회하기 ====
=== 비즈니스 규칙 ===
* 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
=== 관련 코드 ===
== 디바이스 정보 VO ==
/** 디바이스 정보 VO */
var deviceInfoVO = { sn : "",
uuid : "",
os : "",
telno : "",
strgeInfo : "",
ntwrkDeviceInfo : "",
pgVer : "",
deviceNm : "",
useyn : "" }
== 디바이스 정보 화면 표시 ==
function fn_egov_load_deviceInfo() {
deviceInfoVO.ntwrkDeviceInfo = fn_egov_get_networkInfo();
$('.deviceInfo:eq(0)').html(device.platform + " " + device.version);
$('.deviceInfo:eq(1)').html(device.uuid);
$('.deviceInfo:eq(2)').html(device.cordova);
fn_egov_get_contacts();
$('.deviceInfo:eq(4)').html(deviceInfoVO.ntwrkDeviceInfo);
StorageInfo.totalFileSystemSize(fn_egov_totalSpace_success, fn_egov_fail, []);
}
== 네트워크 정보 조회 ==
function fn_egov_get_networkInfo() {
var networkState = 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 2G connection';
states[Connection.CELL_3G] = 'Cell 3G connection';
states[Connection.CELL_4G] = 'Cell 4G connection';
states[Connection.NONE] = 'No network connection';
return states[networkState];
}
== 연락처 정보 조회 ==
function fn_egov_get_contactsRead(contacts)
{
console.log("[DeviceAPIGuide] fn_egov_get_contactsRead : Success ");
$('.deviceInfo:eq(3)').html("총 " + contacts.length + "개의 연락처");
deviceInfoVO.telno = contacts.length;
}
function fn_egov_get_contacts()
{
var obj = new ContactFindOptions();
obj.filter = "";
obj.multiple = true;
navigator.contacts.find(
[ "displayName", "name" ],
fn_egov_get_contactsRead,
fn_egov_get_contactsFail,
obj);
}
=== 관련 화면 및 수행매뉴얼 ===
^디바이스 정보조회 화면 ^
|{{:egovframework:hyb3.6:guide:ios:deviceinfo:deviceinfo_info.png?280|}}|
OS: 플랫폼 정보 및 버전 \\
UUID : 디바이스의 고유 아이디 \\
PhoneGap Version : DeviceInfo 가이드 프로그램에 적용된 폰갭 버전 \\
Contacts : 디바이스에 저장된 연락처 갯수 \\
Connection Type : 디바이스의 네트워크 상태 정보 \\
Total Memory : 디바이스의 총 메모리 \\
==== 디바이스 정보 서버에 전송하기 ====
=== 비즈니스 규칙 ===
* 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
* 디바이스 정보의 서버 전송은 InterfaceAPI를 이용한다.
=== 관련 코드 ===
== 디바이스 정보 등록==
function fn_egov_regist_deviceInfo() {
if(!fn_egov_network_check(true)){
return false;
}
var params = {uuid : device.uuid, os : device.platform + " " + device.version,
telno : deviceInfoVO.telno, strgeInfo : deviceInfoVO.strgeInfo,
ntwrkDeviceInfo : deviceInfoVO.ntwrkDeviceInfo , pgVer : device.cordova};
EgovInterface.submitAsynchronous([params, "/dvc/addDeviceInfo.do"],
function(){
navigator.notification.alert("입력 완료.", null, 'Info');
console.log("[DeviceAPIGuide] fn_egov_regist_deviceInfo : Completed ");
},
function(error) {
$("#alert_dialog").click( function() {
jAlert('데이터 입력 중 오류가 발생 했습니다.', '입력 오류', 'c');
});
}
);
}
=== 관련 화면 및 수행매뉴얼 ===
^Action^URL^Controller method^QueryID^
|디바이스 정보 등록|/dvc/addDeviceInfo.do|insertDeviceInfo|"deviceiOSAPIDAO.insertDeviceInfo"|
^디바이스 정보업로드 화면 ^
|{{:egovframework:hyb3.6:guide:ios:deviceinfo:deviceinfo_send.png?280|}}|
정보 업로드: 디바이스 정보를 서버로 업로드 한다.
==== 디바이스 정보 목록 조회하기 ====
=== 비즈니스 규칙 ===
* 네트워크를 체크하여 Wi-Fi가 아닐 경우에는 사용자 승인여부에 따라 동작한다.
=== 관련 코드 ===
== 디바이스 정보 목록 조회 ==
function fn_egov_move_deviceInfoList() {
if(!fn_egov_network_check(true)){
return false;
}
var params = {uuid : device.uuid };
EgovInterface.submitAsynchronous([params, "/dvc/deviceInfoList.do"],
fn_egov_dispatch_deviceInfoList,
function(error) {
$("#alert_dialog").click( function() {
jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
});
}
);
}
function fn_egov_dispatch_deviceInfoList(data){
var list_html = "";
var totcnt = data.deviceInfoList.length;
for (var i = 0; i < totcnt; i++) {
result = data.deviceInfoList[i];
list_html += "UUID : " + result.uuid + "
";
list_html += "Network Connection Type : " + result.ntwrkDeviceInfo + "
";
list_html += "OS : " + result.os + "
== 디바이스 정보 상세 조회 ==
function fn_egov_request_deviceInfoDetail(data){
if(!fn_egov_network_check(true)){
return false;
}
var params = {sn : data };
EgovInterface.submitAsynchronous([params, "/dvc/deviceInfo.do"],
fn_egov_move_deviceInfoDetail,
function(error) {
$("#alert_dialog").click( function() {
jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
});
}
);
}
function fn_egov_move_deviceInfoDetail(result){
$('.deviceInfo:eq(6)').html(result.deviceInfo.os);
$('.deviceInfo:eq(7)').html(result.deviceInfo.uuid);
$('.deviceInfo:eq(8)').html(result.deviceInfo.pgVer);
$('.deviceInfo:eq(9)').html("총 " + result.deviceInfo.telno + "개의 연락처");
$('.deviceInfo:eq(10)').html(result.deviceInfo.ntwrkDeviceInfo);
$('.deviceInfo:eq(11)').html(result.deviceInfo.strgeInfo + " MiB");
$("#btnDelDeviceInfo").attr("href","javascript:fn_egov_confirm_delete_deviceInfo(" + result.deviceInfo.sn + ");");
$.mobile.changePage("#deviceInfoDetail", "slide", false, false);
console.log("[DeviceAPIGuide] fn_egov_move_deviceInfoDetail : Completed ");
}
== 디바이스 정보 삭제 ==
function fn_egov_confirm_delete_deviceInfo(sn){
jConfirm('Device 정보를 삭제 하시겠습니까??', '알림', 'c', function(r){
if(r == true){
fn_egov_delete_deviceInfo(sn);
}else{
}
});
}
function fn_egov_delete_deviceInfo(data){
if(!fn_egov_network_check(true)){
return false;
}
console.log("fn_egov_delete_deviceInfo : ");
var params = {sn : data };
EgovInterface.submitAsynchronous([params, "/dvc/deleteDeviceInfo.do"],
function(result){
navigator.notification.alert("삭제 완료.", null, 'Info');
console.log("[DeviceAPIGuide] fn_egov_delete_deviceInfo : Completed ");
fn_egov_move_deviceInfoList();
},
function(error) {
$("#alert_dialog").click( function() {
jAlert('데이터 조회 중 오류가 발생 했습니다.', '조회 오류', 'c');
});
}
);
}
=== 관련 화면 및 수행매뉴얼 ===
^Action^URL^Controller method^QueryID^
|디바이스 정보 목록 조회|/dvc/deviceInfoList.do|selectDeviceList|"deviceiOSAPIDAO.selectDeviceInfoList"|
|디바이스 정보 상세 조회|/dvc/deviceInfo.do|selectDeviceInfo|"deviceiOSAPIDAO.selectDeviceInfo"|
|디바이스 정보 삭제|/dvc/deleteDeviceInfo.do|deleteDeviceInfo|"deviceiOSAPIDAO.deleteDeviceInfo"|
^디바이스 목록조회 ^ 디바이스 상세조회 화면 ^
|{{:egovframework:hyb3.6:guide:ios:deviceinfo:deviceinfo_list.png?280|}}|{{:egovframework:hyb3.6:guide:ios:deviceinfo:deviceinfo_list2.png?280|}}|
디바이스 정보 조회 : 디바이스 정보 조회를 요청한다.\\
목록 : 디바이스 정보 목록 페이지를 호출한다.\\
삭제 : 디바이스 정보를 삭제한다.
===== 컴파일 디버깅 배포 =====
==== 컴파일 ====
=== Device Applicaton 컴파일 방법 ===
* 왼쪽 상단의 삼각형 버튼을 클릭하면 가이드 프로그램이 빌드되어 아이폰 디바이스에 설치 된다.
{{:egovframework:hyb3.6:guide:mbl:ios_app_compile.png?740|}}
* 빌드가 성공하면 아래와 같은 어플리케이션 실행화면을 확인 할 수 있다.
{{:egovframework:hyb3.6:guide:ios:deviceinfo:deviceinfo_run.png?320|}}
=== Server Applicaton 컴파일 방법 ===
* 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.
{{:egovframework:hyb:guide:ios:서버실행.png?640|}}
* 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.
{{:egovframework:hyb:guide:add:서버실행결과_콘솔.png?840|}}
==== 디버깅 ====
디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 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 콘솔 창
{{:egovframework:hyb:guide:ios:cameradebugxcode.png?700|}}\\
DeviceInfo 디바이스 API 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다.
^디버그 코드^디버깅 내용^
|[DeviceAPIGuide] fn_egov_onBatteryStatus : Success | 디바이스의 배터리 정보 변경 시|
|[DeviceAPIGuide] fn_egov_onBatteryLow : Success | 디바이스의 배터리 레벨이 로우 상태 진입 시|
|[DeviceAPIGuide] fn_egov_onBatteryCritical : Success | 디바이스의 배터리 레벨이 크리티컬 상태 진입 시 |
|[DeviceAPIGuide] fn_egov_get_contactsRead : Success | 디바이스 연락처 갯수 조회 성공 시|
|[DeviceAPIGuide] fn_egov_get_contactsFail : Fail | 디바이스 연락처 갯수 조회 실패 시|
|[DeviceAPIGuide] fn_egov_totalSpace_success : Success | 디바이스의 총 메모리 조회 성공 시|
|[DeviceAPIGuide] fn_egov_freeSpace_success : Success | 디바이스의 가용 메모리 조회 성공 시|
|[DeviceAPIGuide] fn_egov_fail : Success | 공통 Fail 콜백 함수 호출 시|
|[DeviceAPIGuide] fn_egov_regist_deviceInfo : Completed | 디바이스 정보 저장의 성공 수행 시|
|[DeviceAPIGuide] fn_egov_dispatch_deviceInfoList : Completed | 디바이스 정보 목록 조회의 성공 수행 시|
|[DeviceAPIGuide] fn_egov_move_deviceInfoDetail : Completed | 디바이스 정보 상세 조회의 성공 수행 시|
|[DeviceAPIGuide] fn_egov_delete_deviceInfo : Completed | 디바이스의 정보 삭제의 성공 수행 시|
==== 배포 ====
DeviceInfo Server Applicaton 다운로드 : [[http://www.egovframe.go.kr/cop/bbs/selectBoardArticle.do?bbsId=BBSMSTR_000000000161&nttId=1258&menu=3&submenu=9|Click]]
===== 참고자료 =====
* Cordova : [[https://cordova.apache.org|Click]] \\
* UX/UI 라이브러리 : jQuery Mobile[[http://jquerymobile.com/demos/1.4.5/|Click]] \\