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 객체를 작성합니다 (이 생성자를 직접 호출하는 것이 아니라 create 메서드를 사용하는 것이 일반적).

메서드 개요

static <T> T	create (Class <T> listenerInterface, Object target, String action) 리스너 인터페이스내의 모든 메서드가 핸들러의 action을 target에 적용하기 위한 listenerInterface 구현을 작성합니다.
static <T> T	create (Class <T> listenerInterface, Object target, String action, String eventPropertyName) 모든 메서드로부터, 이벤트식 eventPropertyName값을 문중의 마지막 메서드인 action (target에 적용된다)에 건네주기 위한 listenerInterface 구현을 작성합니다.
static <T> T	create (Class <T> 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 객체를 작성합니다 (이 생성자를 직접 호출하는 것이 아니라 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 <T> T create(Class <T> 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 <T> T create(Class <T> 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 <T> T create(Class <T> 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