이번 장에서는 X-PUSH 메시지를 수신할 클라이언트(넥사크로플랫폼17.1 애플리케이션)를 개발하는 방법을 설명합니다. X-PUSH 클라이언트는 넥사크로 애플리케이션으로 구성할 수 있습니다. 그러므로 X-PUSH 클라이언트를 개발하기 위해서는 넥사크로 애플리케이션 개발에 대한 지식이 필요합니다.

이 문서에서는 넥사크로 애플리케이션 개발에 대해 설명은 하지 않으며 X-PUSH 서버와 관련된 특이 사항만 설명합니다. 애플리케이션 개발과 관련된 상세한 내용은 넥사크로플랫폼 매뉴얼을 참조하십시오.

nexacro17.1 클라이언트 개발

X-PUSH 클라이언트는 넥사크로 애플리케이션으로 개발할 수 있습니다. 기본적으로 X-PUSH 서버를 통해 메시지를 수신하려면 X-PUSH 프로토콜 어댑터가 추가되어야 하며, 오브젝트를 통해 구성할 수 있습니다.

X-PUSH 프로토콜 어댑터

넥사크로플랫폼에는 X-PUSH 프로토콜 어댑터가 기본 패키지에 포함되어 있습니다.

넥사크로 프로젝트에 X-PUSH 오브젝트 추가

프로젝트에 X-Push 오브젝트를 추가하려면 아래 순서를 따라갑니다.

1. 프로젝트 익스플로러(Project explorer) 원도우에서 "TypeDefinition"-"Objects" 선택 후 마우스 오른쪽 버튼을 클릭하여 "Edit" 를 선택합니다.

2. + 버튼을 눌러 Push.json 파일을 선택 후 열기를 클릭합니다.

3. Objects에 + 버튼을 선택하고 nexacro.XPush를 선택한 뒤 OK버튼을 클릭합니다.

4. 추가한 X-PUSH 오브젝트가 정상적으로 등록되었는지 확인합니다.

프로토콜 어댑터 속성

다음 속성값을 변경할 수 있습니다.

프로토콜 어댑터 이벤트 속성

xpush 어댑터로부터 발생된 이벤트를 정의할 수 있습니다.

예제

기능 예제 애플리케이션

위치: %XPUSH_HOME%/sample/nexacro_client

예제 애플리케이션의 프로젝트 파일은 %XPUSH_HOME%\sample\nexacro_client\xpushSample.xadl 입니다. 이 파일을 넥사크로 스튜디오에서 오픈합니다.

1. 넥사크로 스튜디오 메뉴에서 [File > Open > Project] 항목을 클릭합니다.

2. 예제 프로젝트인xpushSample.xprj 파일을 선택합니다.

3. Project Explorer 창에서 Base 밑에 sample01_functional을 더블클릭합니다.

아래에서는 예제에서 사용한 기능 및 코드에 대해 설명합니다.

set_projectid, set_protocolversion

project_id 정보를 설정합니다.

this.XPush00.set_projectid("PRO#1");

x-push와 통신할 프로토콜 버전을 설정합니다.

this.XPush00.set_protocolversion('3');

connection

X-PUSH 서버와 접속을 합니다.

{
	var value = this.IpPort.value;
	this.XPush00.set_iplist(value);

	this.XPush00.connect("user00","pw");
}

subscribe

X-PUSH 서버에 Topic Type 및 Topic Id 등록합니다.

{
var ret = this.XPush00.subscribe(this.topicTYPE.value, this.topicID.value, this, this.dsMessage, "append", "fn_PushCallback_Test_Data");
}

/*
 * 콜백 함수( 메시지 수신 )
 */
this.fn_PushCallback_Test_Data = function (Row, ChangeColumn, AllColumns, Type, ActionType, MessageId) 
{
	trace("fn_PushCallback - NOTI\n" +
		" - ActionType : " + ActionType + "\n" +
		" - Row : " + Row + "\n" +
		" - MessageId : " + MessageId + "\n" );

	trace(this.dsMessage.saveXML() );

	/*
	 * 일반 메시지 수신
	 */
	if (ActionType == "PUSH") {
		trace(this.dsMessage.getColumn(0, "NOTI_00"));
		trace(this.dsMessage.getColumn(0, "NOTI_01"));
		trace(this.dsMessage.getColumn(Row, "NOTI_02"));
		trace(this.dsMessage.getColumn(Row, "NOTI_03"));
	}
	
	/*
	 * 신뢰성 메시지 수신
	 */
	if (ActionType == "RELI") {
		trace(this.dsMessage.getColumn(0, "NOTI_00"));
		trace(this.dsMessage.getColumn(0, "NOTI_01"));
		trace(this.dsMessage.getColumn(0, "NOTI_22"));
	}
}

미수신 메시지 개수 조회

X-PUSH 서버에 미수신 메시지 개수를 요청합니다.

this.btnReqd_onclick = function(obj:Button,  e:nexacro.ClickEventInfo)
{
	this.XPush00.requestMessageCount("NOTI", "ALL");
}

미수신 메시지 요청

X-PUSH 서버에 미수신 메시지를 요청합니다.

this.btnReqd_onclick = function(obj:Button,  e:nexacro.ClickEventInfo)
{
	this.XPush00.requestMessage("NOTI", "ALL");
}

수신 확인 메시지 전송

X-PUSH 서버로부터 신뢰성 메시지를 받으면 수신확인 메시지를 X-PUSH 에 전송합니다.

this.fn_PushCallback_Test_Data = function(Row, ChangeColumn, AllColumn, Type, ActionType, MessageId)
{
	AddLog("get push data. reliable message = " + "[ActionType:" + ActionType + "] " + this.dsMessage.getColumn(0, "Title"));
	
	if (ActionType == "RELI") {
		alert(this.dsMessage.getColumn(0, "Title"));
		this.XPush00.sendResponse(MessageId);
	}
}

유저 등록

데이터베이스에 유저정보(T_TOPIC Table)를 추가한다. 인증(AUTH)을 한 다음에 유저 등록(ADUI)를 해야합니다.

this.XPush00.registerTopic("NOTI", "ALL");

유저 삭제

데이터베이스에 유저정보(T_TOPIC Table)를 삭제합니다.

this.XPush00.unregisterTopic("NOTI", "ALL");

성공/실패 이벤트 처리

onerror

this.XPush00_onerror = function(obj:XPush,  e:XPushErrorEventInfo)

{
	this.fn_setMsg("XPush00_onerror Event\n" + 
		" - eventid: " + e.eventid + "\n" +
		" - action: " + e.action + "\n" + 
		" - statuscode: " + e.statuscode + "\n" +
		" - errormsg: " + e.errormsg + "\n" +
		" - serverip: " + e.serverip + "\n" +
		" - serverport: " + e.serverport + "\n" +
		" - e.message: " + e.message + "\n" +
		" - e.command : " + e.command );

	if (e.command != null)
	{
		this.fn_setMsg("e.command != null\n" +
			" - e.command.check : " + e.command.check + "\n" +
			" - e.command.row : " + e.command.row + "\n" +
			" - e.command.type : " + e.command.type + "\n" +
		   " - e.command.useactiveformcallback : " + e.command.useactiveformcallback + "\n" +
			" - e.command.actiontype : " + e.command.actiontype + "\n" +
			" - e.command.callback : " + e.command.callback + "\n" +
			" - e.command.messagekey : " + e.command.messagekey + "\n" +
			" - e.command.messagetype : " + e.command.messagetype + "\n" +
			" - e.command.objdataset : " + e.command.objdataset + "\n" +
			" - e.command.objform : " + e.command.objform);	

	}
		
	if (e.message != null)
	{
		this.fn_setMsg("e.message != null\n" +
			" - e.message.messagetype: " + e.message.messagetype + "\n" +
			" - e.message.messagekey: " + e.message.messagekey + "\n" +
			" - e.message.messageid: " + e.message.messageid + "\n" +
			" - e.message.devicetoken: " + e.message.devicetoken);
	}
	
	this.fn_setMsg("e.returnvalue : " + e.returnvalue);
}

onsuccess

this.XPush00_onsuccess = function(obj:XPush,  e:XPushEventInfo)
{
alert("XPush00_onsuccess Event\n" + 
		" - eventid: " + e.eventid + "\n" +
		" - statuscode: " + e.statuscode + "\n" +
		" - errormsg: " + e.errormsg + "\n" +
		" - reason: " + e.reason + "\n" +
		" - action: " + e.action + "\n" +
		" - serverip: " + e.serverip + "\n" +
		" - serverport: " + e.serverport + "\n" +
		" - e.message: " + e.message + "\n" +
		" - e.command : " + e.command + "\n" +
		" - e.returnvalue : " + e.returnvalue);
	if (e.command != null)
	{
		alert("e.command != null\n" +
			" - e.command.check : " + e.command.check + "\n" +
			" - e.command.row : " + e.command.row + "\n" +
			" - e.command.type : " + e.command.type + "\n" +
			" - e.command.useactiveformcallback : " + e.command.useactiveformcallback + "\n" +
			" - e.command.actiontype : " + e.command.actiontype + "\n" +
			" - e.command.callback : " + e.command.callback + "\n" +
			" - e.command.messagekey : " + e.command.messagekey + "\n" +
			" - e.command.messagetype : " + e.command.messagetype + "\n" +
			" - e.command.objdataset : " + e.command.objdataset + "\n" +
			" - e.command.objform : " + e.command.objform);	

	}
		
	if (e.message != null)
	{
		alert("e.message != null\n" +
			" - e.message.messagetype: " + e.message.messagetype + "\n" +
			" - e.message.messagekey: " + e.message.messagekey + "\n" +
			" - e.message.messageid: " + e.message.messageid + "\n" +
			" - e.message.returnvalue: " + e.message.returnvalue + "\n" +
			" - e.message.devicetoken: " + e.message.devicetoken);
			
		if(e.message.returnvalue != undefined || e.message.returnvalue != null) {
			var returnvalue = e.message.returnvalue;
			
			for(var i = 0; i < returnvalue.length; i++) {
				alert("index:" + i + " : " + returnvalue[i].topictype + " : " + returnvalue[i].topicid + " : " + returnvalue[i].count);
			}
		}
	}
}