mx.messaging.Channel (Flex™ 2 레퍼런스 가이드)

	property	정의
		channelSets : Array [read-only] 채널에 접속된 ChannelSet 에의 액세스를 제공합니다.	Channel
		connected : Boolean [read-only] 이 채널이 리모트 행선지와의 접속을 확립해 있을지 어떨지를 나타냅니다.	Channel
		connectTimeout : int 채널에 대한 접속 타임 아웃 시간 (초단위)에의 액세스를 제공합니다.	Channel
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		endpoint : String [read-only] 이 채널의 엔드 포인트에의 액세스를 제공합니다.	Channel
		failoverURIs : Array 엔드 포인트가 클러스터화 되고 있는 경우에, 이 채널이 페이르오바를 시행할 수 있는 엔드 포인트 URI 세트에의 액세스를 제공합니다.	Channel
		id : String [read-only] 이 채널의 ID 에의 액세스를 제공합니다.	Channel
		protocol : String [read-only] 채널이 사용하는 프로토콜에의 액세스를 제공합니다.	Channel
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object
		reconnecting : Boolean [read-only] 이 채널이 대체 엔드 포인트에의 재접속을 실행중일지 어떨지를 나타냅니다.	Channel
		requestTimeout : int 채널에 대한 디폴트 요구 타임 아웃 (초단위)에의 액세스를 제공합니다.	Channel
		uri : String [read-only] 이 채널에 대한 엔드 포인트 URI 전체를 작성하는데 사용되는 URI 에의 액세스를 제공합니다.	Channel

	Methods	정의
		Channel (id:String , uri:String ) 지정된 엔드 포인트 URI 에 접속하는 범용 채널의 인스턴스를 작성합니다.	Channel
		addEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.	EventDispatcher
		applySettings (settings:XML ):void 개개의 채널에 필요한 설정을 적용하려면 항상, 서브 클래스에서 이 Methods를 재정의(override) 할 필요가 있습니다.	Channel
		connect (channelSet:ChannelSet ):void ChannelSet 를 채널에 접속합니다.	Channel
		disconnect (channelSet:ChannelSet ):void ChannelSet 를 채널로부터 절단 합니다.	Channel
		dispatchEvent (event:Event ):Boolean 이벤트를 event 플로우(flow)에 dispatch합니다.	EventDispatcher
		hasEventListener (type:String ):Boolean EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.	EventDispatcher
		hasOwnProperty (name:String ):Boolean object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.	Object
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		logout (agent:MessageAgent ):void 채널이 접속되고 있으면, CommandMessage 을 서버에 송신해 로그아웃 합니다.	Channel
		propertyIsEnumerable (name:String ):Boolean 지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.	Object
		removeEventListener (type:String , listener:Function , useCapture:Boolean = false):void EventDispatcher object로부터 listener를 삭제합니다.	EventDispatcher
		send (agent:MessageAgent , message:IMessage ):void 지정된 메세지를 타겟의 행선지에 송신합니다.	Channel
		setCredentials (credentials:String , agent:MessageAgent = null):void 자격 정보를 지정의 값으로 설정합니다.	Channel
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		toString ():String 지정된 object의 string 표현을 돌려줍니다.	Object
		valueOf ():Object 지정된 object의 원시적치를 돌려줍니다.	Object
		willTrigger (type:String ):Boolean 지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.	EventDispatcher

	Methods	정의
		connectFailed (event:ChannelFaultEvent ):void 실패한 내부 접속을 처리해, 채널의 `FAULT` 이벤트를 dispatch합니다.	Channel
		connectSuccess ():void 성공한 내부 접속을 처리해, 채널의 `CONNECT` 이벤트를 dispatch합니다.	Channel
		connectTimeoutHandler (event:TimerEvent ):void ChannelFaultEvent 를 dispatch해 접속 타임 아웃을 처리합니다.	Channel
		disconnectFailed (event:ChannelFaultEvent ):void 실패한 내부 절단을 처리해, 채널의 `FAULT` 이벤트를 dispatch합니다.	Channel
		disconnectSuccess (rejected:Boolean = false):void 성공한 내부 절단을 처리해, 채널의 `DISCONNECT` 이벤트를 dispatch합니다.	Channel
		getMessageResponder (agent:MessageAgent , message:IMessage ):MessageResponder 채널의 `send()` Methods에 적절한 MessageResponder 를 돌려줍니다.	Channel
		internalConnect ():void 채널을 엔드 포인트에 접속합니다.	Channel
		internalDisconnect (rejected:Boolean = false):void 채널을 엔드 포인트로부터 절단 합니다.	Channel
		internalSend (messageResponder:MessageResponder ):void 채널을 통해서 메세지를 송신해, 응답을 응답 측에 전송 합니다.	Channel

일람	정의
channelConnect	채널이 엔드 포인트로부터 절단 된 다음에 dispatch됩니다.	Channel
channelDisconnect	채널이 엔드 포인트로부터 절단 된 다음에 dispatch됩니다.	Channel
channelFault	채널에 장해가 발생한 후에 dispatch됩니다.	Channel
message	채널이 엔드 포인트로부터 메세지를 수신했을 때에 dispatch됩니다.	Channel
propertyChange	채널의 property가 변경되었을 때에 dispatch됩니다.	Channel

property의 상세

channelSets

property

channelSets:Array [read-only]

채널에 접속된 ChannelSet 에의 액세스를 제공합니다.

Implements
public function get channelSets():Array

connected

property

connected:Boolean [read-only]

이 채널이 리모트 행선지와의 접속을 확립해 있을지 어떨지를 나타냅니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
public function get connected():Boolean

connectTimeout

property

connectTimeout:int [read-write]

채널에 대한 접속 타임 아웃 시간 (초단위)에의 액세스를 제공합니다. 값이 0 이하의 경우는, 접속의 시행은 클라이언트로 타임 아웃이 되지 않습니다. 페이르오바 하도록(듯이) 설정되어 있는 채널의 경우, 이 값은 접속이 확립될 때까지의 대기 시간의 합계가 됩니다. 이 값은, 채널이 접속을 시행하는 페이르오바 URI 마다 리셋트 되지 않습니다.

Implements
public function get connectTimeout():int
public function set connectTimeout(value:int ):void

endpoint

property

endpoint:String [read-only]

이 채널의 엔드 포인트에의 액세스를 제공합니다. 이 값은,uri property의 값에 근거해 산출됩니다.

Implements
public function get endpoint():String

failoverURIs

property

failoverURIs:Array [read-write]

엔드 포인트가 클러스터화 되고 있는 경우에, 이 채널이 페이르오바를 시행할 수 있는 엔드 포인트 URI 세트에의 액세스를 제공합니다.

Implements
public function get failoverURIs():Array
public function set failoverURIs(value:Array ):void

property

id:String [read-only]

이 채널의 ID 에의 액세스를 제공합니다.

Implements
public function get id():String

protocol

property

protocol:String [read-only]

채널이 사용하는 프로토콜에의 액세스를 제공합니다.

메모: 채널의 서브 클래스에서 이 Methods를 재정의(override) 해, 지원(support)되는 프로토콜을 나타내는 string를 돌려줄 필요가 있습니다. 지원(support)되는 프로토콜의 string의 예로서"rtmp","http","https" 등이 있습니다.

Implements
public function get protocol():String

reconnecting

property

reconnecting:Boolean [read-only]

이 채널이 대체 엔드 포인트에의 재접속을 실행중일지 어떨지를 나타냅니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
public function get reconnecting():Boolean

requestTimeout

property

requestTimeout:int [read-write]

채널에 대한 디폴트 요구 타임 아웃 (초단위)에의 액세스를 제공합니다. 값이 0 이하의 경우는, 송신 요구는 클라이언트상에서 타임 아웃이 되지 않습니다.

요구 타임 아웃은, 리모트 행선지로부터의 응답을 필요로 하는 RPC 스타일의 메시징으로 특히 편리합니다.

Implements
public function get requestTimeout():int
public function set requestTimeout(value:int ):void

uri

property

uri:String [read-only]

이 채널에 대한 엔드 포인트 URI 전체를 작성하는데 사용되는 URI 에의 액세스를 제공합니다. URI 는 부분 패스로 할 수 있어 그 경우는 필요에 따라서 완전한 엔드 포인트 URI 가 계산됩니다.

Implements
public function get uri():String

constructor　　 의 상세

Channel

()

constructor　　

public 함수 Channel(id:String , uri:String )

지정된 엔드 포인트 URI 에 접속하는 범용 채널의 인스턴스를 작성합니다. 메모:채널의 타입은 직접 작성하지 말아 주세요. 대신에, 프로토콜 고유의 서브 클래스 (RTMPChannel 나 AMFChannel 등)의 인스턴스를 작성합니다.

Parameters

	`id:String` — 이 채널의 ID 입니다.

	`uri:String` — 이 채널의 엔드 포인트 URI 입니다.

Methods의 상세

applySettings

()

Methods

public function applySettings(settings:XML ):void

개개의 채널에 필요한 설정을 적용하려면 항상, 서브 클래스에서 이 Methods를 재정의(override) 할 필요가 있습니다. 반드시 super.applySettings() 를 호출해, 채널에 일반적인 설정을 적용해 주세요.

Parameters

settings:XML — 이 채널의 services-config.xml 파일의 XML fragment입니다. 이하의 fragment에는, 모든 설정 내용을 갖춘 <channel> 태그가 있습니다.

<channel id="my-amf" type="mx.messaging.channels.AMFChannel">
<endpoint uri="/dev/messagebroker/amf" type="flex.messaging.endpoints.AmfEndpoint"/>
<property >
<polling-enabled>false</polling-enabled>
</properties>
</channel>

connect

()

Methods

public final function connect(channelSet:ChannelSet ):void

ChannelSet 를 채널에 접속합니다. 채널이 아직 엔드 포인트에 접속되어 있지 않은 경우는, 접속을 시도합니다. 채널의 서브 클래스에서 internalConnect() Methods를 재정의(override) 해, 기본으로 되는 접속이 확립되면 connectSuccess() Methods를 호출할 필요가 있습니다.

Parameters

channelSet:ChannelSet — 채널에 접속하는 ChannelSet 입니다.

connectFailed

()

Methods

protected function connectFailed(event:ChannelFaultEvent ):void

실패한 내부 접속을 처리해, 채널의 FAULT 이벤트를 dispatch합니다. 채널에 failoverURI 값가 있는 경우는, 그 URI 값를 순서에 사용해, 접속이 확립될 때까지 또는 사용 가능한 값이 없어질 때까지, 자동적으로 재접속을 시도합니다.

Parameters

event:ChannelFaultEvent — 실패한 접속의 ChannelFaultEvent 입니다.

connectSuccess

()

Methods

protected function connectSuccess():void

성공한 내부 접속을 처리해, 채널의 CONNECT 이벤트를 dispatch합니다.

connectTimeoutHandler

()

Methods

protected function connectTimeoutHandler(event:TimerEvent ):void

ChannelFaultEvent 를 dispatch해 접속 타임 아웃을 처리합니다. 현재의 접속 시행을 정지하기 위해서, 아류형에 의해 재정의(override) 되는 일이 있습니다만,super.connectTimeoutHandler(event) 를 호출할 필요가 있습니다.

Parameters

event:TimerEvent — 접속 타임 아웃 시간에 이른 것을 나타내는 타이머 이벤트.

disconnect

()

Methods

public final function disconnect(channelSet:ChannelSet ):void

ChannelSet 를 채널로부터 절단 합니다. 채널이 엔드 포인트에 접속되고 있어, 접속되고 있는 ChannelSet 가 그 이상 없는 경우, ChannelSet 는 내부적으로 절단 됩니다.

채널의 서브 클래스에서 internalDisconnect() Methods를 재정의(override) 해, 기가 되는 접속이 종료하고 있는 경우는 disconnectSuccess() Methods를 호출할 필요가 있습니다.

Parameters

channelSet:ChannelSet — 채널로부터 절단 하는 ChannelSet 입니다.

disconnectFailed

()

Methods

protected function disconnectFailed(event:ChannelFaultEvent ):void

실패한 내부 절단을 처리해, 채널의 FAULT 이벤트를 dispatch합니다.

Parameters

event:ChannelFaultEvent — 실패한 절단의 ChannelFaultEvent 입니다.

disconnectSuccess

()

Methods

protected function disconnectSuccess(rejected:Boolean = false):void

성공한 내부 절단을 처리해, 채널의 DISCONNECT 이벤트를 dispatch합니다. 절단의 원인이 네트워크 장해로, 채널에 failoverURI 값가 있는 경우는, 그 URI 값를 순서에 사용해, 접속이 확립될 때까지 또는 사용 가능한 값이 없어질 때까지, 자동적으로 재접속을 시도합니다.

Parameters

rejected:Boolean (default = false) — 스킵 하지 않는 한 시행되는 페이르오바 처리를 절단시에 모두 스킵 할 필요가 있는 경우는, true 입니다. 페이르오바 처리의 실행을 허가할 필요가 있는 경우는, false 입니다.

getMessageResponder

()

Methods

protected function getMessageResponder(agent:MessageAgent , message:IMessage ):MessageResponder

채널의 send() Methods에 적절한 MessageResponder 를 돌려줍니다. 재정의(override) 할 필요가 있습니다.

Parameters

	`agent:MessageAgent` — 메세지를 송신하는 MessageAgent 입니다.

	`message:IMessage` — 송신하는 메세지입니다.

반환값

MessageResponder — 결과 또는 에러를 처리하기 위한 MessageResponder 입니다.

Throws

IllegalOperationError — 채널의 서브 클래스에서 이 Methods를 재정의(override) 하지 않는 경우.

internalConnect

()

Methods

protected function internalConnect():void

채널을 엔드 포인트에 접속합니다. 재정의(override) 할 필요가 있습니다.

internalDisconnect

()

Methods

protected function internalDisconnect(rejected:Boolean = false):void

채널을 엔드 포인트로부터 절단 합니다. 재정의(override) 할 필요가 있습니다.

Parameters

rejected:Boolean (default = false) — 접속 거부 또는 타임 아웃이 원인으로 절단 되어 재접속을 자동적으로 시행할 필요가 없는 경우는 true 로, 그 이외의 경우는 false 입니다.

internalSend

()

Methods

protected function internalSend(messageResponder:MessageResponder ):void

채널을 통해서 메세지를 송신해, 응답을 응답 측에 전송 합니다. 재정의(override) 할 필요가 있습니다.

Parameters

messageResponder:MessageResponder — 응답을 처리하기 위한 MessageResponder 입니다.

logout

()

Methods

public function logout(agent:MessageAgent ):void

채널이 접속되고 있으면, CommandMessage 을 서버에 송신해 로그아웃 합니다. 현재의 증명서는 클리어 됩니다.

Parameters

agent:MessageAgent — 로그아웃하기 위한 MessageAgent 입니다.

send

()

Methods

public final function send(agent:MessageAgent , message:IMessage ):void

지정된 메세지를 타겟의 행선지에 송신합니다. 실제의 송신을 실행하려면 , 서브 클래스에서 internalSend() Methods를 재정의(override) 할 필요가 있습니다.

Parameters

	`agent:MessageAgent` — 메세지를 송신하고 있는 MessageAgent 입니다.

	`message:IMessage` — 송신하는 메세지입니다.

Throws

InvalidDestinationError — MessageAgent 와 메세지의 어느 것에도 행선지가 지정되어 있지 않은 경우.

setCredentials

()

Methods

public function setCredentials(credentials:String , agent:MessageAgent = null):void

자격 정보를 지정의 값으로 설정합니다. 자격 정보가 null 가 아니고, 채널이 접속되고 있는 경우, 이 Methods는 자격 정보를 사용해 로그인하도록(듯이)라는 CommandMessage 도 서버에 송신합니다.

Parameters

	`credentials:String` — 자격 정보는 string입니다.

	`agent:MessageAgent` (default = `null`) — 로그인하기 위한 MessageAgent 입니다. 로그인 결과를 처리합니다.

이벤트의 상세

channelConnect

event

Event object type: mx.messaging.events.ChannelEvent
ChannelEvent.type property = mx.messaging.events.ChannelEvent.CONNECT

채널이 엔드 포인트로부터 절단 된 다음에 dispatch됩니다.

CONNECT 이벤트형. 채널이 엔드 포인트에 접속된 것을 나타냅니다.

이 정수의 값은 "channelConnect" 입니다.

event object의 각 property에는 다음의 값이 설정됩니다.

Property	Value
`bubbles`	false
`cancelable`	false
`channel`	이 이벤트가 방아쇠 된 채널입니다.
`currentTarget`	이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 `myButton.addEventListener()` 를 사용하면,`currentTarget` 의 값은 "myButton" 가 됩니다.
`target`	이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,`currentTarget` property를 사용해 주세요.
`reconnecting`	이 이벤트를 생성한 채널이 재접속중인가 어떤가를 나타냅니다.
`rejected`	이 이벤트를 생성한 채널이 거부되었는지 어떠했는지를 나타냅니다. 액티버티가 없는 것에보다 채널이 절단 되었을 경우는, 이것이 true 가 되어, 페이르오바를 하지 않고, 대체 채널에의 접속도 행해지지 않습니다.

channelDisconnect

event

Event object type: mx.messaging.events.ChannelEvent
ChannelEvent.type property = mx.messaging.events.ChannelEvent.DISCONNECT

채널이 엔드 포인트로부터 절단 된 다음에 dispatch됩니다.

DISCONNECT 이벤트형. 채널이 엔드 포인트로부터 절단 된 것을 나타냅니다.

이 정수의 값은 "channelDisconnect" 입니다.

event object의 각 property에는 다음의 값이 설정됩니다.

Property	Value
`bubbles`	false
`cancelable`	false
`channel`	이 이벤트가 방아쇠 된 채널입니다.
`currentTarget`	이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 `myButton.addEventListener()` 를 사용하면,`currentTarget` 의 값은 "myButton" 가 됩니다.
`target`	이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,`currentTarget` property를 사용해 주세요.
`reconnecting`	이 이벤트를 생성한 채널이 재접속중인가 어떤가를 나타냅니다.
`rejected`	이 이벤트를 생성한 채널이 거부되었는지 어떠했는지를 나타냅니다. 액티버티가 없는 것에보다 채널이 절단 되었을 경우는, 이것이 true 가 되어, 페이르오바를 하지 않고, 대체 채널에의 접속도 행해지지 않습니다.

channelFault

event

Event object type: mx.messaging.events.ChannelFaultEvent
ChannelFaultEvent.type property = mx.messaging.events.ChannelFaultEvent.FAULT

채널에 장해가 발생한 후에 dispatch됩니다.

FAULT 이벤트형. fault가 발생한 채널을 나타냅니다.

이 정수의 값은 "channelFault" 입니다.

event object의 각 property에는 다음의 값이 설정됩니다.

Property	Value
`bubbles`	false
`cancelable`	false
`channel`	이 이벤트를 생성한 채널.
`currentTarget`	이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 `myButton.addEventListener()` 를 사용하면,`currentTarget` 의 값은 "myButton" 가 됩니다.
`faultCode`	실패에 관한 행선지 고유의 상세를 제공합니다.
`faultDetail`	실패의 행선지 고유의 이유에의 액세스를 제공합니다.
`faultString`	채널 자체가 fault를 생성하지 않았던 경우는, fault의 근본적인 이유에의 액세스를 제공합니다.
`reconnecting`	이 이벤트를 생성한 채널이 재접속중인가 어떤가를 나타냅니다.
`rootCause`	채널 자체가 fault를 생성하지 않았던 경우는, fault의 근본적인 이유에의 액세스를 제공합니다.
`target`	이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,`currentTarget` property를 사용해 주세요.

message

event

Event object type: mx.messaging.events.MessageEvent
MessageEvent.type property = mx.messaging.events.MessageEvent.MESSAGE

채널이 엔드 포인트로부터 메세지를 수신했을 때에 dispatch됩니다.

MESSAGE 이벤트형. 메세지의 수신시에 dispatch됩니다.

이 정수의 값은 "message" 입니다.

event object의 각 property에는 다음의 값이 설정됩니다.

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 `myButton.addEventListener()` 를 사용하면,`currentTarget` 의 값은 "myButton" 가 됩니다.
`message`	이 이벤트에 관련지을 수 있었던 메세지입니다.
`target`	이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,`currentTarget` property를 사용해 주세요.

propertyChange

event

Event object type: mx.events.PropertyChangeEvent
PropertyChangeEvent.type property = mx.events.PropertyChangeEvent.PROPERTY_CHANGE

채널의 property가 변경되었을 때에 dispatch됩니다.

PropertyChangeEvent.PROPERTY_CHANGE 정수에 의해,PropertyChange 이벤트의 event object의 type property치가 정의됩니다.

event object의 각 property에는 다음의 값이 설정됩니다.

Property	Value
`bubbles`	constructor　　 에 의해 결정됩니다. 디폴트는 false 입니다.
`cancelable`	constructor　　 에 의해 결정됩니다. 디폴트는 false 입니다.
`kind`	변경의 종류. PropertyChangeEventKind.UPDATE 또는 PropertyChangeEventKind.DELETE 의 머지않아인가입니다.
`oldValue`	원의 property의 값입니다.
`newValue`	새로운 property의 값 (존재하는 경우)입니다.
`property`	변경된 property입니다.
`source`	변경된 property를 포함한 object입니다.
`currentTarget`	이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 `myButton.addEventListener()` 를 사용하면,`currentTarget` 의 값은 "myButton" 가 됩니다.
`target`	이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,`currentTarget` property를 사용해 주세요.

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class Channel	property \| Methods \| event

Package	mx.messaging
Class	public class Channel
Inheritance	Channel EventDispatcher Object
Subclasses	PollingChannel