This page was saved using jaction on 2006-09-04 8:33:31.
Address: http://flexdocs.kr/docs/flex2/langref/mx/messaging/ChannelSet.html
Title: mx.messaging.ChannelSet (Flex™ 2 레퍼런스 가이드)  •  Size: 58999
(Flex Data Services 전용)
Packagemx.messaging
Classpublic class ChannelSet
InheritanceChannelSet Inheritance EventDispatcher Inheritance Object

ChannelSet 는, 타겟 행선지에의 메세지 송신에 사용되는 채널세트입니다. ChannelSet 는, 네트워크 장해나 개개의 채널의 문제가 발생했을 때에, 세트내의 채널을 최대한 활용해 메세지를 송신하는 것으로, 클라이언트의 서비스의 질을 향상시킵니다.



Public property
 property정의
  channelIds : Array
[read-only] ChannelSet 로 사용되는 채널의 ID 입니다.
ChannelSet
  clustered : Boolean
[read-only] ChannelSet 가 클러스터화 된 행선지를 타겟으로 하고 있을지 어떨지를 나타냅니다.
ChannelSet
  configured : Boolean
[read-only] ChannelSet 로 사용하고 있는 채널이 자동 설정된 채널인가, 수동으로 할당할 수 있었던 채널인지를 나타냅니다.
ChannelSet
  connected : Boolean
[read-only] ChannelSet 가 접속되고 있는지 어떤지를 나타냅니다.
ChannelSet
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  messageAgents : Array
[read-only] 이 ChannelSet 를 사용하는 MessageAgents 세트에의 액세스를 제공합니다.
ChannelSet
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
Public Methods
 Methods정의
  ChannelSet (channelIds:Array = null, clustered:Boolean = false)
ChannelSet 를 작성합니다.
ChannelSet
  addChannel (channel:Channel ):void
ChannelSet 에 채널을 추가합니다.
ChannelSet
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
  channelConnectHandler (event:ChannelEvent ):void
CONNECT ChannelEvent 를 처리해 이벤트를 재발송 냅니다.
ChannelSet
  channelDisconnectHandler (event:ChannelEvent ):void
DISCONNECT ChannelEvent 를 처리해 이벤트를 재발송 냅니다.
ChannelSet
  channelFaultHandler (event:ChannelFaultEvent ):void
ChannelFaultEvent 이벤트를 처리해, 그 이벤트를 재발송 냅니다.
ChannelSet
  connect (agent:MessageAgent ):void
MessageAgent 를 ChannelSet 에 접속합니다.
ChannelSet
  disconnect (agent:MessageAgent ):void
MessageAgent 를 ChannelSet 로부터 절단 합니다.
ChannelSet
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  logout (agent:MessageAgent ):void
보존되고 있는 자격 정보를 클리어 해, 세트내의 모든 채널에 대해서 로그아웃을 호출합니다.
ChannelSet
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
  removeChannel (channel:Channel ):void
ChannelSet 로부터 채널을 삭제합니다.
ChannelSet
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
EventDispatcher
  send (agent:MessageAgent , message:IMessage ):void
현재 접속중의 채널을 통해서 MessageAgent 로부터 메세지를 송신합니다.
ChannelSet
  setCredentials (credentials:String , agent:MessageAgent ):void
자격 정보를 보존해, 접속중의 모든 채널에 송신합니다.
ChannelSet
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
  toString ():String
ChannelSet 내의 채널의 ID 를 돌려줍니다.
ChannelSet
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
EventDispatcher
이벤트
 이벤트일람정의
  channelConnect ChannelSet 내의 채널이 엔드 포인트에 접속된 다음에 dispatch됩니다. ChannelSet
  channelDisconnect ChannelSet 내의 채널이 엔드 포인트로부터 절단 된 다음에 dispatch됩니다. ChannelSet
  channelFault ChannelSet 내의 채널로 fault가 발생한 다음에 dispatch됩니다. ChannelSet
  propertyChange 채널 세트의 property가 변경되었을 때에 dispatch됩니다. ChannelSet
property의 상세
channelIdsproperty
channelIds:Array   [read-only]

ChannelSet 로 사용되는 채널의 ID 입니다.

Implements
    public function get channelIds():Array
clusteredproperty 
clustered:Boolean   [read-only]

ChannelSet 가 클러스터화 된 행선지를 타겟으로 하고 있을지 어떨지를 나타냅니다. true 의 경우, 접속이 성공하면 ChannelSet 는 채널의 클러스터화 된 모든 엔드 포인트의 행선지를 조회해, 이러한 페이르오바 URI 를 각각의 채널에 할당합니다.

Implements
    public function get clustered():Boolean
configuredproperty 
configured:Boolean   [read-only]

ChannelSet 로 사용하고 있는 채널이 자동 설정된 채널인가, 수동으로 할당할 수 있었던 채널인지를 나타냅니다.

Implements
    public function get configured():Boolean
connectedproperty 
connected:Boolean   [read-only]

ChannelSet 가 접속되고 있는지 어떤지를 나타냅니다.

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

Implements
    public function get connected():Boolean
messageAgentsproperty 
messageAgents:Array   [read-only]

이 ChannelSet 를 사용하는 MessageAgents 세트에의 액세스를 제공합니다.

Implements
    public function get messageAgents():Array
constructor    의 상세
ChannelSet()constructor   
public 함수 ChannelSet(channelIds:Array = null, clustered:Boolean = false)

ChannelSet 를 작성합니다. channelIds Parameters가 지정되고 있는 경우, ChannelSet 는 ServerConfig.getChannel() 로 취득된 지정의 채널을 사용해 행선지에 접속합니다. 타겟이 설정 끝난 ChannelSet 에 채널을 수동으로 할당할 수 없습니다.

channelIds Parameters가 지정되어 있지 않은 경우, 또는 null 의 경우는, 접속해 메세지를 송신하기 위해서, 채널을 수동으로 작성해 ChannelSet 에 추가할 필요가 있습니다.

ChannelSet 가 클러스터화 되고 있는 경우, ChannelSet 네차이인가의 채널에 처음으로 접속하면, 자동적으로 세트내의 채널 마다 클러스터 전역의 모든 엔드 포인트를 요구해, 이 페이르오바 URI 를 각각의 채널에 할당합니다. 이것에 의해, ChannelSet 내의 채널의 페이르오바가 가능하게 되어, 1 개의 채널의 페이르오바를 다 사용하면, ChannelSet 는 세트내의 다음의 사용 가능한 채널에 진행될 수가 있습니다.

클러스터화와는 관계없이, 채널이 접속을 확립할 수 없는 경우, 또는 접속이 없어졌을 경우는, ChannelSet 는 다음의 사용 가능한 채널을 사용해 재접속을 시도합니다. 이것에 의해, ChannelSet 는 다양한 프로토콜, 포토등을 사용하는 채널중에서, 엔드 포인트에 정상적으로 접속할 수 있는 채널을 취득할 수가 있습니다.

Parameters
channelIds:Array (default = null) — 이 ChannelSet 가 사용하는 설정 끝난 채널의 ID입니다. null 의 경우는, 채널을 수동으로 ChannelSet 에 추가할 필요가 있습니다.
 
clustered:Boolean (default = false) — ChannelSet 내의 채널이 클러스터화 되고 있는 경우는 true 로, 클러스터화되어 있지 않은 경우는 false 입니다.
Methods의 상세
addChannel()Methods
public function addChannel(channel:Channel ):void

ChannelSet 에 채널을 추가합니다.

Parameters
channel:Channel — 추가하는 채널입니다.

Throws
IllegalOperationError — ChannelSet 가 configured 의 경우, 채널의 추가는 지원(support)되지 않습니다.
channelConnectHandler()Methods 
public function channelConnectHandler(event:ChannelEvent ):void

CONNECT ChannelEvent 를 처리해 이벤트를 재발송 냅니다.

Parameters
event:ChannelEvent — ChannelEvent 입니다.
channelDisconnectHandler()Methods 
public function channelDisconnectHandler(event:ChannelEvent ):void

DISCONNECT ChannelEvent 를 처리해 이벤트를 재발송 냅니다.

Parameters
event:ChannelEvent — ChannelEvent 입니다.
channelFaultHandler()Methods 
public function channelFaultHandler(event:ChannelFaultEvent ):void

ChannelFaultEvent 이벤트를 처리해, 그 이벤트를 재발송 냅니다.

Parameters
event:ChannelFaultEvent — ChannelFaultEvent 입니다.
connect()Methods 
public function connect(agent:MessageAgent ):void

MessageAgent 를 ChannelSet 에 접속합니다. ChannelSet 에 접속되면, 에이전트가 ChannelSet 를 사용해 메세지를 송신할 수 있습니다.

Parameters
agent:MessageAgent — 접속하는 MessageAgent 입니다.
disconnect()Methods 
public function disconnect(agent:MessageAgent ):void

MessageAgent 를 ChannelSet 로부터 절단 합니다.

Parameters
agent:MessageAgent — 절단 하는 MessageAgent 입니다.
logout()Methods 
public function logout(agent:MessageAgent ):void

보존되고 있는 자격 정보를 클리어 해, 세트내의 모든 채널에 대해서 로그아웃을 호출합니다.

Parameters
agent:MessageAgent — 로그아웃을 개시하는 MessageAgent 입니다.
removeChannel()Methods 
public function removeChannel(channel:Channel ):void

ChannelSet 로부터 채널을 삭제합니다. 삭제하는 채널이 현재 접속중으로 ChannelSet 가 이것을 사용하고 있는 경우, 채널은 절단 됩니다.

Parameters
channel:Channel — 삭제하는 채널입니다.

Throws
IllegalOperationError — ChannelSet 가 configured 의 경우, 채널의 삭제는 지원(support)되지 않습니다.
send()Methods 
public function send(agent:MessageAgent , message:IMessage ):void

현재 접속중의 채널을 통해서 MessageAgent 로부터 메세지를 송신합니다.

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

Throws
NoChannelAvailableError — ChannelSet 가 사용하는 내부 채널이 없는 경우.
setCredentials()Methods 
public function setCredentials(credentials:String , agent:MessageAgent ):void

자격 정보를 보존해, 접속중의 모든 채널에 송신합니다.

Parameters
credentials:String — MessageAgent 의 증명서입니다.
 
agent:MessageAgent — 증명서를 설정하는 MessageAgent 입니다.
toString()Methods 
public override function toString():String

ChannelSet 내의 채널의 ID 를 돌려줍니다.

반환값
String — ChannelSet 의 string 표현입니다.
이벤트의 상세
channelConnectevent 
Event object type: mx.messaging.events.ChannelEvent
ChannelEvent.type property = mx.messaging.events.ChannelEvent.CONNECT

ChannelSet 내의 채널이 엔드 포인트에 접속된 다음에 dispatch됩니다.

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

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

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

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

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

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

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

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

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

ChannelSet 내의 채널로 fault가 발생한 다음에 dispatch됩니다.

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

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

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

PropertyValue
bubblesfalse
cancelablefalse
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를 사용해 주세요.
propertyChangeevent  
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에는 다음의 값이 설정됩니다.

PropertyValue
bubblesconstructor    에 의해 결정됩니다. 디폴트는 false 입니다.
cancelableconstructor    에 의해 결정됩니다. 디폴트는 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를 사용해 주세요.






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/messaging/ChannelSet.html