1 /* |
1 /* |
2 * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
23 * questions. |
23 * questions. |
24 */ |
24 */ |
25 |
25 |
26 package com.sun.jdi.request; |
26 package com.sun.jdi.request; |
27 |
27 |
28 import com.sun.jdi.*; |
28 import com.sun.jdi.ObjectReference; |
|
29 import com.sun.jdi.ReferenceType; |
|
30 import com.sun.jdi.ThreadReference; |
|
31 import com.sun.jdi.VirtualMachine; |
|
32 import com.sun.jdi.event.EventQueue; |
|
33 import com.sun.jdi.event.EventSet; |
|
34 import com.sun.jdi.event.ExceptionEvent; |
29 |
35 |
30 /** |
36 /** |
31 * Request for notification when an exception occurs in the target VM. |
37 * Request for notification when an exception occurs in the target VM. |
32 * When an enabled ExceptionRequest is satisfied, an |
38 * When an enabled ExceptionRequest is satisfied, an |
33 * {@link com.sun.jdi.event.EventSet event set} containing an |
39 * {@link EventSet event set} containing an |
34 * {@link com.sun.jdi.event.ExceptionEvent ExceptionEvent} will be placed |
40 * {@link ExceptionEvent ExceptionEvent} will be placed |
35 * on the {@link com.sun.jdi.event.EventQueue EventQueue}. |
41 * on the {@link EventQueue EventQueue}. |
36 * The collection of existing ExceptionRequests is |
42 * The collection of existing ExceptionRequests is |
37 * managed by the {@link EventRequestManager} |
43 * managed by the {@link EventRequestManager} |
38 * |
44 * |
39 * @see com.sun.jdi.event.ExceptionEvent |
45 * @see ExceptionEvent |
40 * @see com.sun.jdi.event.EventQueue |
46 * @see EventQueue |
41 * @see EventRequestManager |
47 * @see EventRequestManager |
42 * |
48 * |
43 * @author Robert Field |
49 * @author Robert Field |
44 * @since 1.3 |
50 * @since 1.3 |
45 */ |
51 */ |
58 * Returns whether caught exceptions of the requested type |
64 * Returns whether caught exceptions of the requested type |
59 * will generate events when they are thrown. |
65 * will generate events when they are thrown. |
60 * <p> |
66 * <p> |
61 * Note that at the time an exception is thrown, it is not always |
67 * Note that at the time an exception is thrown, it is not always |
62 * possible to determine whether it is truly caught. See |
68 * possible to determine whether it is truly caught. See |
63 * {@link com.sun.jdi.event.ExceptionEvent#catchLocation} for |
69 * {@link ExceptionEvent#catchLocation} for |
64 * details. |
70 * details. |
65 * @return |
71 * @return |
66 * boolean true if caught exceptions will be reported, false |
72 * boolean true if caught exceptions will be reported, false |
67 * otherwise. |
73 * otherwise. |
68 */ |
74 */ |
72 * Returns whether uncaught exceptions of the requested type |
78 * Returns whether uncaught exceptions of the requested type |
73 * will generate events when they are thrown. |
79 * will generate events when they are thrown. |
74 * <p> |
80 * <p> |
75 * Note that at the time an exception is thrown, it is not always |
81 * Note that at the time an exception is thrown, it is not always |
76 * possible to determine whether it is truly uncaught. See |
82 * possible to determine whether it is truly uncaught. See |
77 * {@link com.sun.jdi.event.ExceptionEvent#catchLocation} for |
83 * {@link ExceptionEvent#catchLocation} for |
78 * details. |
84 * details. |
79 * @return |
85 * @return |
80 * boolean true if caught exceptions will be reported, false |
86 * boolean true if caught exceptions will be reported, false |
81 * otherwise. |
87 * otherwise. |
82 */ |
88 */ |