MessageChannel  - AS3

MessageChannel의 내부 메시지 대기열에 송신 워커로부터 받은 메시지가 하나 이상 있는지 여부를 나타납니다.

MessageChannel 객체의 현재 상태(열림, 닫는 중 또는 닫힘)를 나타냅니다. 이 속성의 가능한 값은 MessageChannelState 클래스에 상수로 정의됩니다.

관련 API 요소

리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. 표시 목록의 모든 노드에서 특정 유형의 이벤트, 단계, 우선 순위에 대한 이벤트 리스너를 등록할 수 있습니다.

이벤트 리스너의 등록을 마친 뒤에는 addEventListener()를 추가로 호출하여 그 우선 순위를 변경할 수 없습니다. 리스너의 우선 순위를 변경하려면 먼저 removeListener()를 호출해야 합니다. 그런 다음 해당 리스너를 새로운 우선 순위 레벨로 다시 등록할 수 있습니다.

일단 리스너가 등록된 뒤에 type 또는 useCapture 값을 달리하여 addEventListener()를 이어서 호출하면 별도의 리스너 등록이 생성된다는 것에 유의합니다. 예를 들어 useCapture가 true로 설정된 리스너를 등록하면 이 리스너는 캡처 단계 동안에만 수신합니다. 그러나 useCapture를 false로 설정하고 동일한 리스너 객체를 사용하여 addEventListener()를 다시 호출하면 별도로 두 개의 리스너가 등록되어, 한 리스너는 캡처 단계 동안 수신하고 다른 하나는 대상 및 버블링 단계 동안 수신합니다.

대상 단계 또는 버블링 단계 전용의 이벤트 리스너를 등록할 수는 없습니다. 버블링은 대상 노드의 조상에만 적용되기 때문에 이들 단계는 등록 과정에서 하나로 통합됩니다.

사용하지 않는 이벤트 리스너는 removeEventListener()를 호출하여 제거하도록 합니다. 이렇게 하지 않으면 메모리 문제가 발생할 수 있습니다. useWeakReference 매개 변수가 true로 설정되지 않은 경우 전달하는 객체가 있는 한, 가비지 수집기는 이벤트 리스너를 제거하지 않으므로 리스너는 메모리에서 자동으로 제거되지 않습니다.

EventDispatcher 인스턴스를 복사해도 연결된 이벤트 리스너는 복사되지 않습니다. 새로 만든 노드에 이벤트 리스너가 필요한 경우, 노드를 만든 후 리스너를 연결해야 합니다. 그러나 EventDispatcher 인스턴스를 이동할 때에는 연결된 이벤트 리스너도 함께 이동됩니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 등록하는 경우, 그 이벤트 리스너는 현재 단계 동안에는 트리거되지 않지만 이벤트 흐름에서 이후 단계(예: 버블링 단계) 동안에는 트리거될 수 있습니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 제거하는 경우, 그 리스너는 현재 액션에 의해 트리거됩니다. 일단 제거된 이벤트 리스너는 이후의 처리를 위해 재등록하지 않는 한 다시는 호출되지 않습니다.

매개 변수

function(evt:Event):void

모든 메시지가 수신되면 현재 MessageChannel이 닫히도록 합니다.

이 메서드를 호출한 후에는 더 이상 send() 메서드를 호출하여 대기열에 메시지를 추가할 필요가 없습니다. send() 호출이 실패하고 false가 반환됩니다.

또한 대기열에서 이미 대기 중인 메시지를 호출하려면 receive() 메서드만 호출하면 됩니다. 대기열이 비어 있는 경우 receive()를 호출하면 null이 반환됩니다.

이 메시지 채널을 통해 전송되는 메시지의 대기열에서 단일 메시지 객체를 검색합니다.

송신 워커의 코드가 MessageChannel 객체의 send() 메서드를 호출할 때마다 메시지 채널의 내부 메시지 대기열에 단일 객체가 추가됩니다. 이러한 객체는 receive() 메서드를 호출하는 수신 워커를 호출하여 한 번에 하나씩 제거될 때까지 대기열에서 계속 누적됩니다. 메시지 객체는 전송되는 순서대로 수신됩니다.

대기열에 수신할 메시지 객체가 들어 있는지 확인하려면 messageAvailable 속성을 사용합니다.

일반적인 경우 send()로 전달되는 객체는 AMF3 형식으로 직렬화됩니다. receive()를 호출하여 대기열에서 제거되는 경우에는 수신 워커에서 ActionScript 객체(원본 객체의 복사본)로 직렬화가 해제되고 워커에서는 해당 복사본에 대한 참조를 수신합니다. 특정 유형의 객체가 워커 간에 복사되는 대신 공유됩니다. 이 경우 수신 워커가 가져오는 객체는 객체의 새 복사본이 아닌 공유되는 객체 자체에 대한 참조입니다. 이러한 사례에 대한 자세한 내용은 send() 메서드 설명을 참조하십시오.

메시지 대기열이 비어 있는 상태에서 blockUntilReceived 매개 변수에 대해 true를 전달하면 메서드의 비헤이비어가 변경됩니다. 이 경우 워커는 receive() 호출 시 해당 실행 스레드를 일시 정지하며 코드를 추가로 실행하지 않습니다. 송신 워커가 send()를 호출하는 경우 메시지를 수신함으로써 receive() 호출이 완료됩니다. 그러면 워커는 receive 호출에 이어지는 다음 코드 줄에서 코드 실행을 다시 시작합니다.

매개 변수

관련 API 요소

EventDispatcher 객체에서 리스너를 제거합니다. EventDispatcher 객체와 함께 등록된 리스너 중 일치하는 것이 없다면 이 메서드를 호출해도 아무 영향이 없습니다.

매개 변수

송신 워커에서 객체를 전송하여 수신 워커에 대한 메시지 대기열에 추가합니다.

arg 매개 변수로 전달되는 객체는 거의 모든 객체일 수 있습니다. 아래 설명된 예외를 제외하고 arg 매개 변수로 전달되는 모든 객체는 참조에 의해 전달되지 않습니다. send()가 호출된 후 특정 워커의 객체에서 변경된 사항은 다른 워커로 전달되지 않습니다. 객체는 AMF3 형식으로 직렬화하고 receive()가 호출될 때 수신 워커에서 새 객체로 직렬화를 해제하는 방식으로 복사됩니다. 이 때문에 표시 객체를 비롯해 AMF3 형식으로 직렬화할 수 없는 객체는 arg 매개 변수로 전달할 수 없습니다. 사용자 정의 클래스를 올바르게 전달하려면 flash.net.registerClassAlias() 함수 또는 [RemoteClass] 메타데이터를 사용하여 클래스 정의를 등록해야 합니다. 어느 쪽 방법을 사용하든 클래스의 두 워커 버전 모두에 대해 동일한 별칭을 사용해야 합니다.

객체가 워커 간에 공유되지 않는 규칙의 예외에 해당하는 객체의 유형에는 다섯 가지가 있습니다.

• 작업자가
• MessageChannel
• 공유 가능 ByteArray(해당 shareable 속성이 true로 설정된 ByteArray 객체)
• Mutex
• Condition

이러한 객체의 인스턴스를 arg 매개 변수로 전달하는 경우 각각의 워커는 동일한 기본 객체를 참조합니다. 한 워커에 있는 인스턴스에서 변경된 내용은 다른 워커에서 즉시 사용 가능합니다. 또한 send()를 사용하여 이러한 객체의 동일한 인스턴스를 두 번 이상 전달하는 경우 런타임은 수신 워커에 해당 객체의 새 복사본을 만들지 않습니다. 대신 동일한 참조가 다시 사용되므로 시스템 메모리 사용량이 줄어듭니다.

기본적으로 이 메서드는 객체를 대기열에 추가하고 값을 즉시 반환하여 다음 코드 줄을 계속 실행합니다. 대기열이 특정 크기 이상으로 증가하지 않도록 하려면 queueLimit 매개 변수를 사용하여 대기열에서 허용할 최대 항목 수를 지정하면 됩니다. 대기열의 항목 수가 지정한 제한보다 큰 상태에서 send()를 호출하면 워커는 send() 호출 시 실행 스레드를 일시 정지합니다. 수신 워커가 대기열 크기가 지정된 대기열 제한 아래로 내려갈 만큼 충분한 횟수의 receive()를 호출하는 경우 send() 호출이 완료됩니다. 그러면 워커는 다음 코드 줄에서 실행을 계속 이어갑니다.

매개 변수

관련 API 요소

지정된 객체의 문자열 표현을 반환합니다.

참고: Object 클래스의 메서드는 Object의 프로토타입에 동적으로 만들어집니다. Object의 하위 클래스에서 이 메서드를 다시 정의할 때 override 키워드를 사용하지 마십시오. 예를 들어 Object의 하위 클래스에서는 기본 클래스에 대한 재정의를 사용하는 대신 function toString():String을 구현합니다.

송신 워커가 이 MessageChannel 객체의 send() 메서드를 호출할 때마다 전달되며, MessageChannel 인스턴스의 대기열에서 새 메시지 객체를 사용할 수 있음을 나타냅니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

메시지 채널의 state 속성 값이 변경되는 경우 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.