Multicaster

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.wegra.util.multicast
Class Multicaster

java.lang.Object
  org.wegra.util.multicast.Multicaster

All Implemented Interfaces:: Subscriber

public class Multicaster
extends java.lang.Object
implements Subscriber

Multicaster 클래스를 ( AWTEventMulticaster 의 방법을 도입해) "구독자"의 리스트를 비교적 짧게 관리하는 효율적인 방법을 제공해준다.

각 Multicaster 객체는 두 개의 "Subscriber" 객체를 참조할 수 있으며 이 중 하나 혹은 둘 다 또 다른 Multicaster가 될 수 있다.
"출간" 메시지는 가장 최상위의 Multicaster에게 건네지며 최상위 멀티 캐스터로부터 자신이 참조하는 구독자에게 재귀적으로 "출간"메시지가 전해지게 된다.

Multicaster는 불변객체이므로 그 값을 수정할 수 없다.
예를 들어, "add()" 메소드를 호출할 때 두 개의 Multicaster를 넘기면 원래의 두 멀티 캐스터를 첩조하는 새로운 구독자가 반환된다.
이런 이유로 인하여 add()가 실행될 때 진행 중이었던 통지는 add()의 영향을 받지 않는다.
따라서, 어떤 스레드가 통지를 진행 중인 때에도 다른 스레드에서는 자유롭게 멀티캐스터에 원소를 집어넣거나 빼낼 수 있다.
구독자들에게 통지가 가는 순서는 정해져 있지 않다.

Version:: 1.0 (2001-08-03)
Author:: wegra (Bok-Youn Lee)
See Also:: AWTEventMulticaster, Subscriber

Nested Class Summary
`static class`	`Multicaster.Test` 테스트용 클래스

Method Summary
`static Subscriber`	`add(Subscriber a, Subscriber b)` 새로운 구독자를 리스트에 추가한다.
`void`	`execute(java.lang.Object publication)` 멀티 캐스터에게 구독자들이 publication을 받을 수 있도록 요청한다.
`static Subscriber`	`remove(Subscriber list, Subscriber target)` 리스트로부터 지정된 구독자를 제거한다.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

add

public static Subscriber add(Subscriber a,
                             Subscriber b)

새로운 구독자를 리스트에 추가한다. 이 메소드의 활용 방식에 따라 구독자로의 통지 순서가 달라진다(execute(Object) 참고). 이 메소드를 호출하는 측에서는 적절하게 동기화를 해주어야 하는데 이는 add() 가 반환한 값이 리스트의 헤드 참조자로 할당되기 전에 다른 스레드가 제어권을 가져갈 수 있기 때문이다.

Parameters:: a - 일반적으로 리스트의 머리를 가리키는 찾조자가 된다.; b - 일반적으로 리스트에 새로 추가한 구독자가 된다.

execute

public void execute(java.lang.Object publication)

멀티 캐스터에게 구독자들이 publication을 받을 수 있도록 요청한다. 즉, 출간을 요청한다. 구독자들이 통지를 받는 순서는 정해져 있지 않다. 하지만 만약 순서대로 통지하기를 원한다면 모든 경우에 다음과 같이 노드를 추가해주면 된다. subscriberList = Multicater.add( SubscriptionList, newNode); ( subscriberList 는 리스트의 헤드에 대한 참조자이며 newNode 는 추가한 노드에 대한 참조자이다) 이렇게 하면 추가된 순서대로 통지가 가게 된다. 노드를 제거한다고 해도 통지의 순서는 바뀌지 않는다. subscriptionList = Multicaster.add( newNode, subscriptionList ); 이렇게 하면 통지의 순서도 바뀌게 된다.

Specified by:: execute in interface Subscriber

remove

public static Subscriber remove(Subscriber list,
                                Subscriber target)

리스트로부터 지정된 구독자를 제거한다. 추가할 때와 마찬가지로 remove()가 반환한 값이 이스트의 헤드 참조자로 할당되기 전에 다른 스레드가 제어권을 가져가지 않도록 하기 위해서 이 메소드를 적절하게 동기화해서 사용해야 한다.