FilesExpand file tree

 master

/

ActiveEvent.java

Copy path

BlameMore file actions

BlameMore file actions

Latest commit

 

History

History

History

59 lines (56 loc) · 1.58 KB

 master

/

ActiveEvent.java

Top

File metadata and controls

• Code
• Blame

59 lines (56 loc) · 1.58 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

/*

* Copyright (c) 1997, 2002, Oracle and/or its affiliates. All rights reserved.

* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*/

package java.awt;

/**

* An interface for events that know how to dispatch themselves.

* By implementing this interface an event can be placed upon the event

* queue and its <code>dispatch()</code> method will be called when the event

* is dispatched, using the <code>EventDispatchThread</code>.

* <p>

* This is a very useful mechanism for avoiding deadlocks. If

* a thread is executing in a critical section (i.e., it has entered

* one or more monitors), calling other synchronized code may

* cause deadlocks. To avoid the potential deadlocks, an

* <code>ActiveEvent</code> can be created to run the second section of

* code at later time. If there is contention on the monitor,

* the second thread will simply block until the first thread

* has finished its work and exited its monitors.

* <p>

* For security reasons, it is often desirable to use an <code>ActiveEvent</code>

* to avoid calling untrusted code from a critical thread. For

* instance, peer implementations can use this facility to avoid

* making calls into user code from a system thread. Doing so avoids

* potential deadlocks and denial-of-service attacks.

*

* @author Timothy Prinzing

* @since 1.2

*/

public interface ActiveEvent {

/**

* Dispatch the event to its target, listeners of the events source,

* or do whatever it is this event is supposed to do.

*/

public void dispatch();

}