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.event.AccessWatchpointEvent; |
|
29 import com.sun.jdi.event.EventQueue; |
|
30 import com.sun.jdi.event.EventSet; |
29 |
31 |
30 /** |
32 /** |
31 * Request for notification when the contents of a field are accessed |
33 * Request for notification when the contents of a field are accessed |
32 * in the target VM. |
34 * in the target VM. |
33 * This event will be triggered when the specified field is accessed |
35 * This event will be triggered when the specified field is accessed |
34 * by Java™ programming language code or by a |
36 * by Java™ programming language code or by a |
35 * Java Native Interface (JNI) get function (<code>Get<Type>Field, |
37 * Java Native Interface (JNI) get function (<code>Get<Type>Field, |
36 * GetStatic<Type>Field</code>). |
38 * GetStatic<Type>Field</code>). |
37 * Access by JDI does not trigger this event. |
39 * Access by JDI does not trigger this event. |
38 * When an enabled AccessWatchpointRequest is satisfied, an |
40 * When an enabled AccessWatchpointRequest is satisfied, an |
39 * {@link com.sun.jdi.event.EventSet event set} containing an |
41 * {@link EventSet event set} containing an |
40 * {@link com.sun.jdi.event.AccessWatchpointEvent AccessWatchpointEvent} will be placed |
42 * {@link AccessWatchpointEvent AccessWatchpointEvent} will be placed |
41 * on the {@link com.sun.jdi.event.EventQueue EventQueue}. |
43 * on the {@link EventQueue EventQueue}. |
42 * The collection of existing ExceptionRequests is |
44 * The collection of existing ExceptionRequests is |
43 * managed by the {@link EventRequestManager} |
45 * managed by the {@link EventRequestManager} |
44 * The collection of existing |
46 * The collection of existing watchpoints is |
45 * watchpoints is |
|
46 * managed by the {@link EventRequestManager}. |
47 * managed by the {@link EventRequestManager}. |
47 * <p> |
48 * <p> |
48 * Note that the modification |
49 * Note that the modification |
49 * of a Field is not considered an access. |
50 * of a Field is not considered an access. |
50 * |
51 * |
51 * @see ModificationWatchpointRequest |
52 * @see ModificationWatchpointRequest |
52 * @see com.sun.jdi.event.EventQueue |
53 * @see EventQueue |
53 * @see EventRequestManager |
54 * @see EventRequestManager |
54 * |
55 * |
55 * @author Robert Field |
56 * @author Robert Field |
56 * @since 1.3 |
57 * @since 1.3 |
57 */ |
58 */ |