| /* |
| * Copyright (c) 2001, 2018, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| */ |
| |
| package nsk.jdi.EventSet.eventIterator; |
| |
| import nsk.share.*; |
| import nsk.share.jdi.*; |
| |
| import com.sun.jdi.*; |
| import com.sun.jdi.event.*; |
| import com.sun.jdi.request.*; |
| |
| import java.util.*; |
| import java.io.*; |
| |
| /** |
| * The test for the implementation of an object of the type <BR> |
| * EventSet. <BR> |
| * <BR> |
| * The test checks that results of the method <BR> |
| * <code>com.sun.jdi.EventSet.eventIterator()</code> <BR> |
| * complies with its spec. <BR> |
| * <BR> |
| * The test checks that for ThreadStartEvent and <BR> |
| * ThreadDeathEvent sets: <BR> |
| * - the method returns non-null object; <BR> |
| * - object's class is subclass of class Iterator. <BR> |
| * <BR> |
| * The test has three phases and works as follows. <BR> |
| * <BR> |
| * In first phase, <BR> |
| * upon launching debuggee's VM which will be suspended, <BR> |
| * a debugger waits for the VMStartEvent within a predefined <BR> |
| * time interval. If no the VMStartEvent received, the test is FAILED. <BR> |
| * Upon getting the VMStartEvent, it makes the request for debuggee's <BR> |
| * ClassPrepareEvent with SUSPEND_EVENT_THREAD, resumes the VM, <BR> |
| * and waits for the event within the predefined time interval. <BR> |
| * If no the ClassPrepareEvent received, the test is FAILED. <BR> |
| * Upon getting the ClassPrepareEvent, <BR> |
| * the debugger sets up the breakpoint with SUSPEND_EVENT_THREAD <BR> |
| * within debuggee's special methodForCommunication(). <BR> |
| * <BR> |
| * In second phase the debugger and the debuggee perform the following. <BR> |
| * - The debugger creates ThreadStartRequest,resumes the debuggee, and <BR> |
| * waits for corresponding ThreadStartEvent. <BR> |
| * - The debuggee starts new thread, named "thread2", <BR> |
| * whose running creates the needed events. <BR> |
| * - Upon getting the ThreadStartEvent, the debugger checks up on it, <BR> |
| * creates ThreadDeathRequest, resumes the debuggee, and <BR> |
| * waits for corresponding ThreadDeathEvent. <BR> |
| * Upon getting the ThreadDeathEvent, the debugger checks up on it. <BR> |
| * <BR> |
| * In third phase, the debugger and the debuggee end. <BR> |
| * <BR> |
| */ |
| |
| public class eventiterator003 { |
| |
| //----------------------------------------------------- templete section |
| static final int PASSED = 0; |
| |
| static final int FAILED = 2; |
| |
| static final int PASS_BASE = 95; |
| |
| //----------------------------------------------------- templete parameters |
| static final String sHeader1 = "\n==> nsk/jdi/EventSet/eventIterator/eventiterator003 ", |
| sHeader2 = "--> debugger: ", sHeader3 = "##> debugger: "; |
| |
| //----------------------------------------------------- main method |
| |
| public static void main(String argv[]) { |
| |
| int result = run(argv, System.out); |
| |
| System.exit(result + PASS_BASE); |
| } |
| |
| public static int run(String argv[], PrintStream out) { |
| |
| int exitCode = new eventiterator003().runThis(argv, out); |
| |
| if (exitCode != PASSED) { |
| System.out.println("TEST FAILED"); |
| } |
| return testExitCode; |
| } |
| |
| //-------------------------------------------------- log procedures |
| |
| private static Log logHandler; |
| |
| private static void log1(String message) { |
| logHandler.display(sHeader1 + message); |
| } |
| |
| private static void log2(String message) { |
| logHandler.display(sHeader2 + message); |
| } |
| |
| private static void log3(String message) { |
| logHandler.complain(sHeader3 + message); |
| } |
| |
| // ************************************************ test parameters |
| |
| private String debuggeeName = "nsk.jdi.EventSet.eventIterator.eventiterator003a"; |
| |
| private String testedClassName = "nsk.jdi.EventSet.eventIterator.TestClass"; |
| |
| //====================================================== test program |
| //------------------------------------------------------ common section |
| |
| static Debugee debuggee; |
| |
| static ArgumentHandler argsHandler; |
| |
| static int waitTime; |
| |
| static VirtualMachine vm = null; |
| |
| static EventRequestManager eventRManager = null; |
| |
| static EventQueue eventQueue = null; |
| |
| static EventSet eventSet = null; |
| |
| static EventIterator eventIterator = null; |
| |
| static ReferenceType debuggeeClass = null; |
| |
| static int testExitCode = PASSED; |
| |
| class JDITestRuntimeException extends RuntimeException { |
| JDITestRuntimeException(String str) { |
| super("JDITestRuntimeException : " + str); |
| } |
| } |
| |
| //------------------------------------------------------ methods |
| |
| private int runThis(String argv[], PrintStream out) { |
| |
| argsHandler = new ArgumentHandler(argv); |
| logHandler = new Log(out, argsHandler); |
| Binder binder = new Binder(argsHandler, logHandler); |
| |
| waitTime = argsHandler.getWaitTime() * 60000; |
| |
| try { |
| log2("launching a debuggee :"); |
| log2(" " + debuggeeName); |
| if (argsHandler.verbose()) { |
| debuggee = binder.bindToDebugee(debuggeeName + " -vbs"); |
| } else { |
| debuggee = binder.bindToDebugee(debuggeeName); |
| } |
| if (debuggee == null) { |
| log3("ERROR: no debuggee launched"); |
| return FAILED; |
| } |
| log2("debuggee launched"); |
| } catch (Exception e) { |
| log3("ERROR: Exception : " + e); |
| log2(" test cancelled"); |
| return FAILED; |
| } |
| |
| debuggee.redirectOutput(logHandler); |
| |
| vm = debuggee.VM(); |
| |
| eventQueue = vm.eventQueue(); |
| if (eventQueue == null) { |
| log3("ERROR: eventQueue == null : TEST ABORTED"); |
| vm.exit(PASS_BASE); |
| return FAILED; |
| } |
| |
| log2("invocation of the method runTest()"); |
| switch (runTest()) { |
| |
| case 0: |
| log2("test phase has finished normally"); |
| log2(" waiting for the debuggee to finish ..."); |
| debuggee.waitFor(); |
| |
| log2("......getting the debuggee's exit status"); |
| int status = debuggee.getStatus(); |
| if (status != PASS_BASE) { |
| log3("ERROR: debuggee returned UNEXPECTED exit status: " + status + " != PASS_BASE"); |
| testExitCode = FAILED; |
| } else { |
| log2("......debuggee returned expected exit status: " + status + " == PASS_BASE"); |
| } |
| break; |
| |
| default: |
| log3("ERROR: runTest() returned unexpected value"); |
| |
| case 1: |
| log3("test phase has not finished normally: debuggee is still alive"); |
| log2("......forcing: vm.exit();"); |
| testExitCode = FAILED; |
| try { |
| vm.exit(PASS_BASE); |
| } catch (Exception e) { |
| log3("ERROR: Exception : e"); |
| } |
| break; |
| |
| case 2: |
| log3("test cancelled due to VMDisconnectedException"); |
| log2("......trying: vm.process().destroy();"); |
| testExitCode = FAILED; |
| try { |
| Process vmProcess = vm.process(); |
| if (vmProcess != null) { |
| vmProcess.destroy(); |
| } |
| } catch (Exception e) { |
| log3("ERROR: Exception : e"); |
| } |
| break; |
| } |
| |
| return testExitCode; |
| } |
| |
| /* |
| * Return value: 0 - normal end of the test |
| * 1 - ubnormal end of the test |
| * 2 - VMDisconnectedException while test phase |
| */ |
| |
| private int runTest() { |
| |
| try { |
| testRun(); |
| |
| log2("waiting for VMDeathEvent"); |
| getEventSet(); |
| |
| if (!(eventIterator.nextEvent() instanceof VMDeathEvent)) { |
| log3("ERROR: last event is not the VMDeathEvent"); |
| return 1; |
| } |
| |
| log2("waiting for VMDisconnectEvent"); |
| getEventSet(); |
| |
| if (!(eventIterator.nextEvent() instanceof VMDisconnectEvent)) { |
| log3("ERROR: last event is not the VMDisconnectEvent"); |
| return 1; |
| } |
| |
| return 0; |
| |
| } catch (VMDisconnectedException e) { |
| log3("ERROR: VMDisconnectedException : " + e); |
| e.printStackTrace(logHandler.getOutStream()); |
| return 2; |
| } catch (Exception e) { |
| log3("ERROR: Exception : " + e); |
| return 1; |
| } |
| |
| } |
| |
| private void testRun() throws JDITestRuntimeException, Exception { |
| |
| eventRManager = vm.eventRequestManager(); |
| |
| ClassPrepareRequest cpRequest = eventRManager.createClassPrepareRequest(); |
| cpRequest.setSuspendPolicy(EventRequest.SUSPEND_EVENT_THREAD); |
| cpRequest.addClassFilter(debuggeeName); |
| cpRequest.enable(); |
| vm.resume(); |
| getEventSet(); |
| cpRequest.disable(); |
| |
| ClassPrepareEvent event = (ClassPrepareEvent) eventIterator.next(); |
| debuggeeClass = event.referenceType(); |
| |
| if (!debuggeeClass.name().equals(debuggeeName)) |
| throw new JDITestRuntimeException("** Unexpected ClassName for ClassPrepareEvent **"); |
| |
| log2(" received: ClassPrepareEvent for debuggeeClass"); |
| |
| String bPointMethod = "methodForCommunication"; |
| String lineForComm = "lineForComm"; |
| BreakpointRequest bpRequest; |
| |
| ThreadReference mainThread = threadByName("main"); |
| |
| bpRequest = settingBreakpoint(mainThread, debuggeeClass, bPointMethod, lineForComm, "zero"); |
| bpRequest.enable(); |
| |
| //------------------------------------------------------ testing section |
| |
| log1(" TESTING BEGINS"); |
| |
| String thread2Name = "thread2"; |
| |
| EventRequest eRequest = null; |
| |
| label0: { |
| |
| vm.resume(); |
| breakpointForCommunication(); |
| |
| //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ variable part |
| |
| ThreadReference tr = (ThreadReference) debuggeeClass.getValue(debuggeeClass.fieldByName(thread2Name)); |
| |
| log2("......setting up ThreadStartRequest"); |
| eRequest = settingThreadStartRequest(tr, EventRequest.SUSPEND_EVENT_THREAD, "ThreadStartRequest"); |
| eRequest.enable(); |
| vm.resume(); |
| log2("......getting EventSet"); |
| getEventSet(); |
| eRequest.disable(); |
| |
| String str = (String) eventIterator.nextEvent().request().getProperty("number"); |
| if (!str.equals("ThreadStartRequest")) { |
| testExitCode = FAILED; |
| log3("ERROR: new event doesn't corresponds to ThreadStartRequest required"); |
| break label0; |
| } |
| |
| log2("......checking up on EventIterator"); |
| if (eventIterator == null) { |
| testExitCode = FAILED; |
| log3("ERROR: eventIterator == null"); |
| } |
| if (!(eventIterator instanceof Iterator)) { |
| testExitCode = FAILED; |
| log3("ERROR: eventIterator is NOT instanceof Iterator"); |
| } |
| |
| log2("......setting up ThreadDeathRequest"); |
| // suspend policy 'SUSPEND_ALL' should be used for ThreadDeathRequest (see 6609499) |
| eRequest = settingThreadDeathRequest(tr, EventRequest.SUSPEND_ALL, "ThreadDeathRequest"); |
| eRequest.enable(); |
| eventSet.resume(); |
| log2("......getting EventSet"); |
| getEventSet(); |
| eRequest.disable(); |
| |
| str = (String) eventIterator.nextEvent().request().getProperty("number"); |
| if (!str.equals("ThreadDeathRequest")) { |
| testExitCode = FAILED; |
| log3("ERROR: new event doesn't corresponds to ThreadDeathRequest required"); |
| break label0; |
| } |
| |
| log2("......checking up on EventIterator"); |
| if (eventIterator == null) { |
| testExitCode = FAILED; |
| log3("ERROR: eventIterator == null"); |
| } |
| if (!(eventIterator instanceof Iterator)) { |
| testExitCode = FAILED; |
| log3("ERROR: eventIterator is NOT instanceof Iterator"); |
| } |
| |
| eventSet.resume(); |
| //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| } |
| |
| log1(" TESTING ENDS"); |
| return; |
| } |
| |
| private ThreadReference threadByName(String name) throws JDITestRuntimeException { |
| |
| List all = vm.allThreads(); |
| ListIterator li = all.listIterator(); |
| |
| for (; li.hasNext();) { |
| ThreadReference thread = (ThreadReference) li.next(); |
| if (thread.name().equals(name)) |
| return thread; |
| } |
| throw new JDITestRuntimeException("** Thread IS NOT found ** : " + name); |
| } |
| |
| /* |
| * private BreakpointRequest settingBreakpoint(ThreadReference, ReferenceType, |
| * String, String, String) |
| * |
| * It sets up a breakpoint at given line number within a given method in a given class |
| * for a given thread. |
| * |
| * Return value: BreakpointRequest object in case of success |
| * |
| * JDITestRuntimeException in case of an Exception thrown within the method |
| */ |
| |
| private BreakpointRequest settingBreakpoint(ThreadReference thread, ReferenceType testedClass, String methodName, |
| String bpLine, String property) throws JDITestRuntimeException { |
| |
| log2("......setting up a breakpoint:"); |
| log2(" thread: " + thread + "; class: " + testedClass + "; method: " + methodName + "; line: " + bpLine); |
| |
| List alllineLocations = null; |
| Location lineLocation = null; |
| BreakpointRequest breakpRequest = null; |
| |
| try { |
| Method method = (Method) testedClass.methodsByName(methodName).get(0); |
| |
| alllineLocations = method.allLineLocations(); |
| |
| int n = ((IntegerValue) testedClass.getValue(testedClass.fieldByName(bpLine))).value(); |
| if (n > alllineLocations.size()) { |
| log3("ERROR: TEST_ERROR_IN_settingBreakpoint(): number is out of bound of method's lines"); |
| } else { |
| lineLocation = (Location) alllineLocations.get(n); |
| try { |
| breakpRequest = eventRManager.createBreakpointRequest(lineLocation); |
| breakpRequest.putProperty("number", property); |
| breakpRequest.addThreadFilter(thread); |
| breakpRequest.setSuspendPolicy(EventRequest.SUSPEND_EVENT_THREAD); |
| } catch (Exception e1) { |
| log3("ERROR: inner Exception within settingBreakpoint() : " + e1); |
| breakpRequest = null; |
| } |
| } |
| } catch (Exception e2) { |
| log3("ERROR: ATTENTION: outer Exception within settingBreakpoint() : " + e2); |
| breakpRequest = null; |
| } |
| |
| if (breakpRequest == null) { |
| log2(" A BREAKPOINT HAS NOT BEEN SET UP"); |
| throw new JDITestRuntimeException("**FAILURE to set up a breakpoint**"); |
| } |
| |
| log2(" a breakpoint has been set up"); |
| return breakpRequest; |
| } |
| |
| private void getEventSet() throws JDITestRuntimeException { |
| try { |
| eventSet = eventQueue.remove(waitTime); |
| if (eventSet == null) { |
| throw new JDITestRuntimeException("** TIMEOUT while waiting for event **"); |
| } |
| eventIterator = eventSet.eventIterator(); |
| } catch (Exception e) { |
| throw new JDITestRuntimeException("** EXCEPTION while waiting for event ** : " + e); |
| } |
| } |
| |
| private void breakpointForCommunication() throws JDITestRuntimeException { |
| |
| log2("breakpointForCommunication"); |
| getEventSet(); |
| |
| if (eventIterator.nextEvent() instanceof BreakpointEvent) |
| return; |
| |
| throw new JDITestRuntimeException("** event IS NOT a breakpoint **"); |
| } |
| |
| // ============================== test's additional methods |
| |
| private ThreadStartRequest settingThreadStartRequest(ThreadReference thread, int suspendPolicy, String property) |
| throws JDITestRuntimeException { |
| try { |
| ThreadStartRequest tsr = eventRManager.createThreadStartRequest(); |
| tsr.addThreadFilter(thread); |
| tsr.addCountFilter(1); |
| tsr.setSuspendPolicy(suspendPolicy); |
| tsr.putProperty("number", property); |
| return tsr; |
| } catch (Exception e) { |
| log3("ERROR: ATTENTION: Exception within settingThreadStartRequest() : " + e); |
| log3(" ThreadStartRequest HAS NOT BEEN SET UP"); |
| throw new JDITestRuntimeException("** FAILURE to set up ThreadStartRequest **"); |
| } |
| } |
| |
| private ThreadDeathRequest settingThreadDeathRequest(ThreadReference thread, int suspendPolicy, String property) |
| throws JDITestRuntimeException { |
| try { |
| ThreadDeathRequest tdr = eventRManager.createThreadDeathRequest(); |
| tdr.addThreadFilter(thread); |
| tdr.addCountFilter(1); |
| tdr.setSuspendPolicy(suspendPolicy); |
| tdr.putProperty("number", property); |
| return tdr; |
| } catch (Exception e) { |
| log3("ERROR: ATTENTION: Exception within settingThreadDeathRequest() : " + e); |
| log3(" ThreadDeathRequest HAS NOT BEEN SET UP"); |
| throw new JDITestRuntimeException("** FAILURE to set up ThreadDeathRequest **"); |
| } |
| } |
| |
| } |