network

Contents

doPost

BizApp과 Hub 서버와의 데이터 통신 기능을 제공한다.
서버설정 값에 의해 암호화 통신기능도 제공한다. (서버 설정은 op 에서 관리한다.)

options

필드필드설명M/O
context 서버로 데이터 전송에 필요한 정보M
targetName서버이름, op가 미리 정의되어 있어야 한다.M
serviceCategory서비스 카테고리M
serviceName서비스 이름M
message header와 payload로 구성되며 서버로 전송되는 실제 패킷. 개발시에는 서버와 비즈앱간에 합의된 규격서를 기반으로 작성된다.O
header패킷 공통 정보O
payload전송 데이터O
    

successCallback

필드필드필드설명
result  doPost 성공 객체
context 서버로 데이터 전송에 필요한 정보
targetName서버이름, op가 미리 정의되어 있어야 한다.
serviceCategory서비스 카테고리
serviceName서비스 이름
message 응답 패킷의 내용
header패킷의 공통정보
payload개별 패킷 내용
    

errorCallback

필드설명
code에러코드
message에러메세지
   

Example

var options = {
    "context": {
        "targetName": "hub1",
        "serviceCategory": "notice",
        "serviceName": "getNotice"
    },
    "message": {
        "header": {},
        "payload": {
            "pageNumber": 1,
            "rowsPerPage": 10
        }
    }
};

hone.channel.execute('network', 'doPost', [options],
   function(result){
       // success callback
        alert(JSON.stringify(result));
    },
   function(e) {
       // error callback
        alert(JSON.stringify(e));
    }
);

Example 은 단순한 사용 예 이며 실제 동작을 위해서는 Hub 개발이 필요 하다

Result

Network Plugin 은 Hub 와의 통신이 주로 이루어지며 그 중 한 예인 getNotice 의 결과를 예제로 기입 한다. 

{
   "context": {
       "targetName": "hub1",
       "serviceCategory": "notice",
       "serviceName": "getNotice"
    },
   "message": {
       "header": {},
       "payload": {
           "totalNumber": "2",
           "currentPage": "1",
           "rows": [{
               "imageUri": "http://icon.daumcdn.net/w/c/12/11/10192021148946703.png",
               "postedAt": "2013-03-22EDT12:56:35",
               "contents": "첫번째 공지사항입니다.",
               "link": "http://www.daum.net",
               "id": "1",
               "title": "공지사항1"
            }, {
               "imageUri": "http://icon.daumcdn.net/w/c/12/11/10192021148946703.png",
               "postedAt": "2013-03-23EDT12:56:35",
               "contents": "두 번째 공지사항입니다.",
               "link": "http://www.naver.com",
               "id": "2",
               "title": "공지사항2"
            }]
        }
    }
}

doUpload

BizApp과 Hub 서버와의 파일 업로드 기능을 제공한다.

options

필드필드설명M/O
context 서버로 데이터 전송에 필요한 정보M
targetName서버이름, op가 미리 정의되어 있어야 한다.M
serviceCategory서비스 카테고리M
serviceName서비스 이름M
message header와 payload로 구성되며 서버로 전송되는 실제 패킷. 개발시에는 서버와 비즈앱간에 합의된 규격서를 기반으로 작성된다.M
header패킷 공통 정보O
payload전송 데이터M
    

successCallback

필드필드필드설명
result  doUpload 성공 객체
context 서버로 데이터 전송에 필요한 정보
targetName서버이름, op가 미리 정의되어 있어야 한다.
serviceCategory서비스 카테고리
serviceName서비스 이름
message 응답 패킷의 내용
header패킷의 공통정보
payload개별 패킷 내용
    

errorCallback

필드설명
code에러코드
message에러메세지
   

Example

var options = {
   "context": {
       "targetName": "hub1",
       "serviceCategory": "util",
       "serviceName": "fileUpload"
    },
   "message": {
       "header": {},
       "payload": {
           "userId": "user",
           "key2": "value",
           "files": [ "/test.png", "/test1.png" ]
        }
    }
};

hone.channel.execute('network', 'doUpload', [options],
   function(result){
       // success callback
        alert(JSON.stringify(result));
    },
   function(e) {
       // error callback
        alert(JSON.stringify(e));
    }
);

Example 은 단순한 사용 예 이며, 업로드를 위해서는 Hub 개발이 필요 하다.

Result

{
  "context":{
     "targetName":"hub1",
     "serviceCategory":"util",
     "serviceName":"fileUpload"
   },
  "message":{
     "header":{
      },
     "payload":{
        "requestPayload":{
           "userId":"user",
           "key2":"value",
           "files":[
              "/storage/emulated/0/Android/data/com.hanwha.testhonemobile/files/www/com.hanwha.hspsample/test.png",
              "/storage/emulated/0/Android/data/com.hanwha.testhonemobile/files/www/com.hanwha.hspsample/test1.png"
            ]
         },
        "file2":"icon.png",
        "file1":"config.xml"
      }
   }
}

doDownload

BizApp과 Hub 서버와의 파일 다운로드 기능을 제공한다.

options

필드필드설명M/O
context 서버로 데이터 전송에 필요한 정보M
targetName서버이름, op가 미리 정의되어 있어야 한다.M
serviceCategory서비스 카테고리M
serviceName서비스 이름M
message header와 payload로 구성되며 서버로 전송되는 실제 패킷. 개발시에는 서버와 비즈앱간에 합의된 규격서를 기반으로 작성된다.M
header패킷 공통 정보O
payload전송 데이터M
    

successCallback

필드필드필드설명
result  doDownload 성공 객체
context 서버로 데이터 전송에 필요한 정보
targetName서버이름, op가 미리 정의되어 있어야 한다.
serviceCategory서비스 카테고리
serviceName서비스 이름
message 응답 패킷의 내용
header패킷의 공통정보
payload개별 패킷 내용
    

errorCallback

필드설명
code에러코드
message에러메세지
  

Example

var options = {
   "context": {
       "targetName": "hub1",
       "serviceCategory": "util",
       "serviceName": "fileDownload"
    },
   "message": {
       "header": {},
       "payload": {
           "userId": "user",
           "key2": "value",
           "files": ["/test.png"]
        }
    }
};

hone.channel.execute('network', 'doDownload', [options],
   function(result){
       // success callback
        alert(JSON.stringify(result));
    },
   function(e) {
       // error callback
        alert(JSON.stringify(e));
    }
);

Example 은 단순한 사용 예 이며, 다운로드를 위해서는 Hub 개발이 필요 하다.

Result

{
  "context":{
     "targetName":"hub1",
     "serviceCategory":"util",
     "serviceName":"fileDownload"
   },
  "message":{
     "header":{
        
      },
     "payload":{
        "path":"/storage/emulated/0/Android/data/com.hanwha.testhonemobile/files/downloads/test.png"
      }
   }
}

doUploadWithProgress

BizApp과 Hub 서버와의 파일 업로드 기능을 제공하며 업로드 진행률을 사용자에게 표시하는 기능을 추가로 제공한다.

options

필드필드설명M/O
context 서버로 데이터 전송에 필요한 정보M
targetName서버이름, op가 미리 정의되어 있어야 한다.M
serviceCategory서비스 카테고리M
serviceName서비스 이름M
message header와 payload로 구성되며 서버로 전송되는 실제 패킷. 개발시에는 서버와 비즈앱간에 합의된 규격서를 기반으로 작성된다.M
header패킷 공통 정보O
payload전송 데이터M
    

successCallback

필드필드필드설명
result  doUploadWithProgress 성공 객체
context 서버로 데이터 전송에 필요한 정보
targetName서버이름, op가 미리 정의되어 있어야 한다.
serviceCategory서비스 카테고리
serviceName서비스 이름
message 응답 패킷의 내용
header패킷의 공통정보
payload개별 패킷 내용
    

errorCallback

필드설명
code에러코드
message에러메세지
  

Example 

var options = {
   "context": {
       "targetName": "hub1",
       "serviceCategory": "util",
       "serviceName": "fileUpload"
    },
   "message": {
       "header": {},
       "payload": {
           "userId": "user",
           "key2": "value",
           "files": [ "/test.png", "/test1.png" ]
        }
    }
};

hone.channel.execute('network', 'doUploadWithProgress', [options],
   function(result){
       // success callback
        alert(JSON.stringify(result));
    },
   function(e) {
       // error callback
        alert(JSON.stringify(e));
    },
   function(progress) {
        console.log(JSON.stringify(progress));
    }
);

Example 은 단순한 사용 예 이며, 업로드를 위해서는 Hub 개발이 필요하다.
아래는 progress 정보이다.

Progress

{
  "progress":{
     "totalByte":397,
     "sentByte":397
   }
}

Result

{
  "context":{
     "targetName":"hub1",
     "serviceCategory":"util",
     "serviceName":"fileUpload"
   },
  "message":{
     "header":{
      },
     "payload":{
        "requestPayload":{
           "userId":"user",
           "key2":"value",
           "files":[
              "/storage/emulated/0/Android/data/com.hanwha.testhonemobile/files/www/com.hanwha.hspsample/test.png",
              "/storage/emulated/0/Android/data/com.hanwha.testhonemobile/files/www/com.hanwha.hspsample/test1.png"
            ]
         },
        "file2":"icon.png",
        "file1":"config.xml"
      }
   }
}

doDownloadWithProgress

BizApp과 Hub 서버와의 파일 다운로드 기능을 제공하며 다운로드 진행률을 사용자에게 표시하는 기능을 추가로 제공한다.

options

필드필드설명M/O
context 서버로 데이터 전송에 필요한 정보M
targetName서버이름, op가 미리 정의되어 있어야 한다.M
serviceCategory서비스 카테고리M
serviceName서비스 이름M
message header와 payload로 구성되며 서버로 전송되는 실제 패킷. 개발시에는 서버와 비즈앱간에 합의된 규격서를 기반으로 작성된다.M
header패킷 공통 정보O
payload전송 데이터M
    

successCallback

필드필드필드설명
result  doDownloadWithProgress 성공 객체
context 서버로 데이터 전송에 필요한 정보
targetName서버이름, op가 미리 정의되어 있어야 한다.
serviceCategory서비스 카테고리
serviceName서비스 이름
message 응답 패킷의 내용
header패킷의 공통정보
payload개별 패킷 내용
    

errorCallback

필드설명
code에러코드
message에러메세지
  

Example

var options = {
   "context": {
       "targetName": "hub1",
       "serviceCategory": "util",
       "serviceName": "fileDownload"
    },
   "message": {
       "header": {},
       "payload": {
           "userId": "user",
           "key2": "value",
           "files": ["/test.png"]
        }
    }
};

hone.channel.execute('network', 'doDownloadWithProgress', [options],
   function(result){
       // success callback
        alert(JSON.stringify(result));
    },
   function(e) {
       // error callback
        alert(JSON.stringify(e));
    },
   function(progress) {
        console.log(JSON.stringify(progress));
    }
);

Example 은 단순한 사용 예 이며, 다운로드를 위해서는 Hub 개발이 필요하다.

Progress

{
  "progress":{
     "totalByte":397,
     "receivedByte":397
   }
}

Result

{
  "context":{
     "targetName":"hub1",
     "serviceCategory":"util",
     "serviceName":"fileDownload"
   },
  "message":{
     "header":{
      },
     "payload":{
        "path":"/storage/emulated/0/Android/data/com.hanwha.testhonemobile/files/downloads/test.png"
      }
   }
}

Error Code

CodeCauseComment
E10600파라메터 값이 잘못되어 있을 경우 
E10601전달된 액션 값이 알 수 없는 액션일 경우 
E10602서버로 데이터 전송에 필요한 정보가 잘못되어 있을 경우 
E10603서버로 전송되는 실제 패킷 정보가 잘못되어 있을 경우 
E10604서버 이름이 잘못되어 있을 경우 
E10605서비스 카테고리가 잘못되어 있을 경우 
E10606서비스 이름이 잘못되어 있을 경우 
E10607전송 데이터가 잘못되어 있을 경우 
E10608업로드할 파일 정보가 잘못되어 있을 경우 
E10650실행 중 오류가 발생 되었을 경우 
E10651실행 중 업로드할 파일이 존재하지 않을 경우  
E10652서버로 부터 전달받은 응답 메시지가 없는 경우 
E10653서버로 부터 전달받은 응답 메시지가 잘못되어 있는 경우 
E10699알 수 없는 오류가 발생 되었을 경우