java.beans
클래스 EventHandler

java.lang.Object 
  |
  +--java.beans.EventHandler

모든 구현 인터페이스:

InvocationHandler

public class EventHandler

extends Object

implements InvocationHandler

EventHandler 클래스는 수신 이벤트 오브젝트와 타겟 오브젝트를 포함한 단순한 문장을 실행하는 메소드를 가지는 이벤트 청취자의 동적 생성을 서포트합니다.

EventHandler 클래스는 개발자가 Bean 간의 접속을 확립하기 위해서 사용하는 아프리케이션비르다와 같은 대화형 툴로 사용됩니다. 통상, 접속은 유저 인터페이스 Bean (이벤트 소스)로부터 어플리케이션 논리 Bean (타겟)를 향해 확립됩니다. 그 중에서도, 유저 인터페이스로부터 어플리케이션 논리를 격리하는 것 같은 접속은 특히 효과적입니다. 예를 들어,JCheckBox 와 불리언 값을 받아들이는 메소드를 접속하는 EventHandler 는 체크 박스 상태를 추출해, 이것을 직접 메소드에 건네주는 것에 의해, 메소드를 유저 인터페이스층으로부터 격리할 수가 있습니다.

유저 인터페이스를 사용한 이벤트의 처리 방법으로서 보다 일반적인 것은 내부 클래스를 사용하는 방법입니다. EventHandler 클래스에서 처리할 수 있는 것은 내부 클래스에서 처리할 수 있는 이벤트의 부분집합에 지나지 않습니다. 그러나, 장기 지속 schema에서는 내부 클래스보다 EventHandler 쪽이 우수합니다. 또, 같은 인터페이스를 구현하고 있는 대규모 어플리케이션으로 EventHandler 를 반복해 이용하면, 디스크나 어플리케이션의 메모리 발자국을 삭감할 수 있습니다.

EventHandler 로 작성된 청취자의 발자국이 작은 것은 이 클래스의 의존처의 Proxy 클래스가 같은 인터페이스의 구현을 공유하고 있기 때문입니다. 예를 들어,EventHandler create 메소드를 사용해 어플리케이션내의 모든 ActionListener 를 작성하는 경우, 모든 액션 청취자는 단일의 클래스 (Proxy 클래스에 의해 생성된 클래스)의 인스턴스가 됩니다. 통상,Proxy 클래스의 청취자를 사용하는 경우는 「청취자 타입」(인터페이스) 마다 청취자 클래스를 1 개씩 작성할 필요가 있습니다. 그러나, 내부 클래스를 사용하는 방법에서는 청취자 (인터페이스를 구현하는 오브젝트) 마다 클래스를 1 개씩 작성하는 것만으로 끝납니다.

통상,EventHandler 의 인스턴스를 직접 취급할 것은 없습니다. 그 대신에,EventHandler 의 create 메소드를 사용해, 지정된 청취자 인터페이스를 구현하는 오브젝트를 작성합니다. 이 청취자 오브젝트는 내부에서 EventHandler 오브젝트를 사용해, 이벤트에 관한 정보, 이벤트 발생시에 메세지가 송신되는 오브젝트, 송신되는 메세지 (메소드), 메소드의 인수를 캡슐화합니다. 이하에서는 예를 사용해,create 메소드에 의한 청취자 오브젝트의 작성 방법에 대해 설명합니다.

이벤트 핸들러의 사용예

타겟 오브젝트상의 메소드를 인수없이 호출하는 청취자를 인스톨 한다는 것이, 가장 단순한 EventHandler 의 이용 방법입니다. 다음의 예에서는 javax.swing.JFrame 의 인스턴스상의 toFront 메소드를 호출하는 ActionListener 를 작성합니다.

myButton.addActionListener(
    (ActionListener) EventHandler.create(ActionListener.class, frame, "toFront"));

myButton 를 누르면(자),frame.toFront() 문이 실행됩니다. 컴파일시의 형태 프로텍션을 추가해도, 같은 결과를 얻을 수 있습니다. 이 때문에는 ActionListener 인터페이스의 새로운 구현을 정의해, 그 인스턴스를 버튼에 추가합니다.

 //Equivalent code using an inner class instead of EventHandler.
myButton.addActionListener(new ActionListener {
    public void actionPerformed(ActionEvent e) {
        frame.toFront();
    }
});

다음에 단순한 이용 방법으로서 청취자 인터페이스 (통상은 이벤트 오브젝트) 내의 메소드의 최초의 인수로부터 프로퍼티치를 추출해, 이것을 사용해 타겟 오브젝트내의 프로퍼티치를 설정하는 예를 소개합니다. 이 예에서는 타겟 오브젝트의 nextFocusableComponent 프로퍼티를 이벤트의 소스 프로퍼티의 값으로 설정하는 ActionListener 를 작성합니다.

EventHandler.create(ActionListener.class, target, "nextFocusableComponent", "source")

이것은 다음의 내부 클래스 구현에 대응하고 있습니다.

 //Equivalent code using an inner class instead of EventHandler.
new ActionListener {
    public void actionPerformed(ActionEvent e) {
        button.setNextFocusableComponent((Component) e.getSource()); 
    }
}

이벤트 오브젝트의 소스로부터 프로퍼티치를 추출해, 이 값을 타겟 오브젝트의 프로퍼티치로서 설정한다는 것이, 아마 가장 일반적인 EventHandler 의 이용 방법이지요. 다음의 예에서는 타겟 오브젝트의 label 프로퍼티를, 이벤트의 소스의 text 프로퍼티의 값 (source 프로퍼티의 값)으로 설정하는 ActionListener 를 작성합니다.

EventHandler.create(ActionListener.class, button, "label", "source.text")

이것은 다음의 내부 클래스 구현에 대응하고 있습니다.

 //Equivalent code using an inner class instead of EventHandler.
new ActionListener {
    public void actionPerformed(ActionEvent e) {
        button.setLabel(((JTextField) e.getSource()). getText()); 
    }
}

이벤트 프로퍼티는 피리어드 (. )(으)로 단락지어진 임의의 수의 프로퍼티 접두사에 의해 수식됩니다. 피리어드의 전에 표시되는 완전 지정명은 이벤트 오브젝트에 적용되는 프로퍼티 (왼쪽으로부터 순서에 적용)의 이름으로서 다루어집니다.

예를 들어, 다음과 같은 액션 청취자가 있습니다.

EventHandler.create(ActionListener.class, target, "a", "b.c.d")

이 액션 청취자는 다음의 내부 클래스로서 기입해집니다 (모든 프로퍼티가 정규의 get 메소드를 가져, 적절한 형태를 돌려주는 것과 상정).

 //Equivalent code using an inner class instead of EventHandler.
new ActionListener {
    public void actionPerformed(ActionEvent e) {
        target.setA(e.getB(). getC(). isD()); 
    }
}

도입된 버젼:

1.4

관련 항목:

Proxy , EventObject

생성자의 개요

EventHandler (Object target, String action, String eventPropertyName, String listenerMethodName)
새로운 EventHandler 오브젝트를 작성합니다 (이 constructor를 직접 호출하는 것이 아니라 create 메소드를 사용하는 것이 일반적).

메소드의 개요

static Object	create (Class listenerInterface, Object target, String action) 청취자 인터페이스내의 모든 메소드가 핸들러의 action 를 target 에 적용하기 위한 listenerInterface 구현을 작성합니다.
static Object	create (Class listenerInterface, Object target, String action, String eventPropertyName) 모든 메소드로부터, 이벤트식 eventPropertyName 의 값을 문중의 마지막 메소드인 action (target 에 적용된다)에 건네주기 위한 listenerInterface 구현을 작성합니다.
static Object	create (Class listenerInterface, Object target, String action, String eventPropertyName, String listenerMethodName) listenerMethodName 라는 이름의 메소드로부터, 이벤트식의 값 eventPropertyName 를 문중의 마지막 메소드 action (target 에 적용된다)에 건네주기 위한 listenerInterface 구현을 작성합니다.
String	getAction () 이 이벤트 핸들러에 의해 설정되는 타겟의 기입해 가능한 프로퍼티, 또는 이 이벤트가 타겟상에서 호출하는 메소드의 이름을 돌려줍니다.
String	getEventPropertyName () 타겟으로 적용되는 액션으로 사용되는 이벤트의 프로퍼티를 돌려줍니다.
String	getListenerMethodName () 액션을 방아쇠 하는 메소드의 이름을 돌려줍니다.
Object	getTarget () 이 이벤트 핸들러가 메세지의 송신지로 하는 오브젝트를 돌려줍니다.
Object	invoke (Object proxy, Method method, Object [] arguments) 이벤트로부터 적절한 프로퍼티치를 추출해, 이 EventHandler 에 관련지을 수 있고 있는 액션에 건네줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

EventHandler

public EventHandler(Object  target,
                    String  action,
                    String  eventPropertyName,
                    String  listenerMethodName)

새로운 EventHandler 오브젝트를 작성합니다 (이 constructor를 직접 호출하는 것이 아니라 create 메소드를 사용하는 것이 일반적).

파라미터:

target - 액션을 실행하는 오브젝트

action - 타겟상의 기입해 가능한 프로퍼티 또는 메소드의 (완전 지정의) 이름

eventPropertyName - 수신 이벤트의 읽어내 가능한 프로퍼티의 (완전 지정의) 이름

listenerMethodName - 액션을 방아쇠 하는 청취자 인터페이스내의 메소드의 이름

관련 항목:

EventHandler , create(Class, Object, String, String, String) , getTarget() , getAction() , getEventPropertyName() , getListenerMethodName()

메소드의 상세

getTarget

public Object  getTarget()

이 이벤트 핸들러가 메세지의 송신지로 하는 오브젝트를 돌려줍니다.

반환값:

이 이벤트 핸들러의 타겟

관련 항목:

EventHandler(Object, String, String, String)

getAction

public String  getAction()

이 이벤트 핸들러에 의해 설정되는 타겟의 기입해 가능한 프로퍼티, 또는 이 이벤트가 타겟상에서 호출하는 메소드의 이름을 돌려줍니다.

반환값:

이 이벤트 핸들러의 액션

관련 항목:

EventHandler(Object, String, String, String)

getEventPropertyName

public String  getEventPropertyName()

타겟으로 적용되는 액션으로 사용되는 이벤트의 프로퍼티를 돌려줍니다.

반환값:

이벤트의 프로퍼티

관련 항목:

EventHandler(Object, String, String, String)

getListenerMethodName

public String  getListenerMethodName()

액션을 방아쇠 하는 메소드의 이름을 돌려줍니다. 반환값 null 는 청취자 인터페이스내의 모든 메소드가 액션을 방아쇠 하는 것을 나타냅니다.

반환값:

액션을 방아쇠 하는 메소드의 이름

관련 항목:

EventHandler(Object, String, String, String)

invoke

public Object  invoke(Object  proxy,
                     Method  method,
                     Object [] arguments)

이벤트로부터 적절한 프로퍼티치를 추출해, 이 EventHandler 에 관련지을 수 있고 있는 액션에 건네줍니다.

정의:

인터페이스 InvocationHandler 내의 invoke

파라미터:

proxy - 프록시 오브젝트

method - 청취자 인터페이스내의 메소드

arguments - 프록시 인스턴스에서의 메소드 호출시에게 건네지는 인수치를 저장하는 오브젝트 배열. 인터페이스 메소드가 인수를 취하지 않는 경우, null 가 된다. 원시적형 인수는 java.lang.Integer 또는 java.lang.Boolean 와 같이 적절한 원시적형 래퍼 클래스의 인스턴스에 랩 된다

반환값:

타겟으로 액션을 적용한 결과

관련 항목:

EventHandler

create

public static Object  create(Class  listenerInterface,
                            Object  target,
                            String  action)

청취자 인터페이스내의 모든 메소드가 핸들러의 action 를 target 에 적용하기 위한 listenerInterface 구현을 작성합니다. 이 메소드는 그 외의 것보다 일반적인 create 메소드의 구현과 null 값을 받는 eventPropertyName 및 listenerMethodName 를 호출하는 것에 의해 구현됩니다.

이하는 dialog.show() 를 사용해,JDialog 를 표시하는 ActionListener 를 작성하는 예입니다.

EventHandler.create(ActionListener.class, dialog, "show")

파라미터:

listenerInterface - 작성된 프록시를 이용하는 청취자 인터페이스

target - 액션을 실행하는 오브젝트

action - 타겟상의 기입해 가능한 프로퍼티 또는 메소드의 이름

반환값:

listenerInterface 를 구현하는 오브젝트

관련 항목:

create(Class, Object, String, String)

create

public static Object  create(Class  listenerInterface,
                            Object  target,
                            String  action,
                            String  eventPropertyName)

모든 메소드로부터, 이벤트식 eventPropertyName 의 값을 문중의 마지막 메소드인 action (target 에 적용된다)에 건네주기 위한 listenerInterface 구현을 작성합니다. 이 메소드는 보다 일반적인 create 메소드의 구현과 null 값을 받는 listenerMethodName 를 호출하는 것에 의해 구현됩니다.

다음의 코드를 사용해,JLabel 의 텍스트를 수신 이벤트의 JTextField 소스의 텍스트치로 설정하는 것 같은 ActionListener 를 작성할 수 있습니다.

EventHandler.create(ActionListener.class, label, "text", "source.text");

이것은 다음의 코드와 등가입니다.

 //Equivalent code using an inner class instead of EventHandler.
label.setText((JTextField(event.getSource())). getText()) 

파라미터:

listenerInterface - 작성된 프록시를 이용하는 청취자 인터페이스

target - 액션을 실행하는 오브젝트

action - 타겟상의 기입해 가능한 프로퍼티 또는 메소드의 이름

eventPropertyName - 수신 이벤트의 읽어내 가능한 프로퍼티의 (완전 지정의) 이름

반환값:

listenerInterface 를 구현하는 오브젝트

관련 항목:

create(Class, Object, String, String, String)

create

public static Object  create(Class  listenerInterface,
                            Object  target,
                            String  action,
                            String  eventPropertyName,
                            String  listenerMethodName)

listenerMethodName 라는 이름의 메소드로부터, 이벤트식의 값 eventPropertyName 를 문중의 마지막 메소드 action (target 에 적용된다)에 건네주기 위한 listenerInterface 구현을 작성합니다.

eventPropertyName 가 null 의 경우, 구현은 action 로 지정된 이름의 메소드를 호출합니다. EventObject 를 받아들이는 메소드가 정의되어 있지 않은 경우, 이 액션은 EventObject 또는 같은 이름의 인수 없음의 메소드를 취합니다.

listenerMethodName 가 null 의 경우는 인터페이스내의 모든 메소드가,target 상에서 실행되는 action 를 방아쇠 합니다.

예를 들어, mouse button를 누를 때마다 타겟 오브젝트의 origin 프로퍼티를 수신하는 MouseEvent 의 장소 (mouseEvent.getPoint() 의 값)로 설정하는 MouseListener 를 작성하고 싶은 경우는 다음과 같이 기술합니다.

EventHandler.create(MouseListener.class, "mousePressed", target, "origin", "point");

이것은 mousePressed 를 제외하는 모든 메소드가 조작 불능인 MouseListener 의 기술과 같습니다.

 //Equivalent code using an inner class instead of EventHandler.
new MouseAdapter() {
    public void mousePressed(MouseEvent e) {
        target.setOrigin(e.getPoint());
    }
}
 

파라미터:

listenerInterface - 작성된 프록시를 이용하는 청취자 인터페이스

target - 액션을 실행하는 오브젝트

action - 타겟상의 기입해 가능한 프로퍼티 또는 메소드의 이름

eventPropertyName - 수신 이벤트의 읽어내 가능한 프로퍼티의 (완전 지정의) 이름

listenerMethodName - 액션을 방아쇠 하는 청취자 인터페이스내의 메소드의 이름

반환값:

listenerInterface 를 구현하는 오브젝트

관련 항목:

EventHandler