test/hotspot/jtreg/vmTestbase/nsk/jdi/EventRequestManager/classPrepareRequests/clsprepreq002.java
changeset 50018 3ba0d8631f24
child 50551 367763702685
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/test/hotspot/jtreg/vmTestbase/nsk/jdi/EventRequestManager/classPrepareRequests/clsprepreq002.java	Sat May 05 09:24:29 2018 -0700
@@ -0,0 +1,543 @@
+/*
+ * 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.EventRequestManager.classPrepareRequests;
+
+import nsk.share.*;
+import nsk.share.jpda.*;
+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>
+ * EventRequestManager.                                         <BR>
+ *                                                              <BR>
+ * The test checks that results of the method                   <BR>
+ * <code>com.sun.jdi.EventRequestManager.classPrepareRequests()</code> <BR>
+ * complies with its spec.                                      <BR>
+ * <BR>
+ * The test checks up on the following assertion:                       <BR>
+ * - The list is unmodifiable.                                          <BR>
+ * - The list of the enabled and disabled class prepare requests.       <BR>
+ * - This list is changes as requests are added and deleted.            <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 to check the assertion,                              <BR>
+ * the debugger and the debuggee perform the following.                 <BR>
+ * - The debugger resumes the debuggee and waits for the BreakpointEvent.<BR>
+ * - The debuggee prepares the check case and invokes                   <BR>
+ *   the methodForCommunication to be suspended and                     <BR>
+ *   to inform the debugger with the event.                             <BR>
+ * - Upon getting the BreakpointEvent,                                  <BR>
+ *   the debugger checking up on assertions.                            <BR>
+ * <BR>
+ * In third phase, at the end of the test, the debuggee changes         <BR>
+ * the value of the "instruction" which the debugger and debuggee       <BR>
+ * use to inform each other of needed actions,  and both end.           <BR>
+ * <BR>
+ */
+
+public class clsprepreq002 {
+
+    //----------------------------------------------------- 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/EventRequestManager/classPrepareRequests/clsprepreq002 ",
+    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 clsprepreq002().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.EventRequestManager.classPrepareRequests.clsprepreq002a";
+
+    //====================================================== 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)
+                return 0;
+
+            log3("ERROR: last event is not the VMDeathEvent");
+            return 1;
+        } catch ( VMDisconnectedException e ) {
+            log3("ERROR: VMDisconnectedException : " + e);
+            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";
+
+        ThreadReference   mainThread = threadByName("main");
+
+        BreakpointRequest bpRequest = settingBreakpoint(mainThread,
+                                             debuggeeClass,
+                                            bPointMethod, lineForComm, "zero");
+        bpRequest.enable();
+
+    //------------------------------------------------------  testing section
+
+        List         requests = null;
+        ListIterator li       = null;
+
+        ClassPrepareRequest request = null;
+        ClassPrepareRequest cpRequests[] = { null, null, null, null, null,
+                                             null, null, null, null, null };
+        int listSize;
+        int flag;
+
+
+        log1("     TESTING BEGINS");
+
+        for (int i = 0; ; i++) {
+
+            vm.resume();
+            breakpointForCommunication();
+
+            int instruction = ((IntegerValue)
+                               (debuggeeClass.getValue(debuggeeClass.fieldByName("instruction")))).value();
+
+            if (instruction == 0) {
+                vm.resume();
+                break;
+            }
+
+            log1(":::::: case: # " + i);
+
+            //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ variable part
+
+            cpRequest.putProperty("number", "zero");
+            cpRequest.enable();
+
+            log2("......creating ClassPrepareRequests");
+            for (int i1 = 0; i1 < cpRequests.length; i1++) {
+                cpRequests[i1] = eventRManager.createClassPrepareRequest();
+                cpRequests[i1].putProperty("number", String.valueOf(i1));
+
+                log2("......checking up on returned List after creating new ClassPrepareRequest");
+                requests = eventRManager.classPrepareRequests();
+                listSize = requests.size();
+                if ( listSize != (i1 + 2) ) {
+                    testExitCode = FAILED;
+                    log3("ERROR: size of returned List is not equal to expected : " + listSize + " != " +  (i1 + 2));
+                }
+                flag = 0;
+                li = requests.listIterator();
+                while (li.hasNext()) {
+                    request = (ClassPrepareRequest) li.next();
+                    if ( request.getProperty("number").equals("zero") )
+                        continue;
+                    if ( !request.isEnabled() ) {
+                        flag++;
+                        if (flag > 1) {
+                            testExitCode = FAILED;
+                            log3("ERROR: # of disabled requests > 1 : " + flag);
+                        }
+                        if ( !request.getProperty("number").equals(String.valueOf(i1)) ) {
+                            testExitCode = FAILED;
+                            log3("ERROR: in the List, disabled is request expected to be enabled : # == " + i1);
+                        }
+                    } else {
+                        if ( request.getProperty("number").equals(String.valueOf(i1)) ) {
+                            testExitCode = FAILED;
+                            log3("ERROR: in the List, enabled is newly created disabled request : # == " + i1);
+                        }
+                    }
+                }
+
+                log2("      enabling created ClassPrepareRequest");
+                cpRequests[i1].enable();
+                requests = eventRManager.classPrepareRequests();
+                listSize = requests.size();
+                if ( listSize != (i1 + 2) ) {
+                    testExitCode = FAILED;
+                    log3("ERROR: size of returned List is not equal to expected : " + listSize + " != " +  (i1 + 2));
+                }
+
+                li = requests.listIterator();
+                while (li.hasNext()) {
+                    request = (ClassPrepareRequest) li.next();
+                    if ( !request.isEnabled() ) {
+                        testExitCode = FAILED;
+                        log3("ERROR: returned List contains disabled request : " + request);
+                    }
+                }
+
+                log2("      removing item from the List; UnsupportedOperationException is expected");
+                try {
+                    requests.remove(i1);
+                    testExitCode = FAILED;
+                    log3("ERROR: NO exception");
+                } catch ( UnsupportedOperationException e ) {
+                    log2("        UnsupportedOperationException ");
+                }
+            }
+
+            log2("......deleting ClassPrepareRequests");
+            for (int i2 = cpRequests.length -1; i2 >= 0; i2--) {
+                eventRManager.deleteEventRequest(cpRequests[i2]);
+                requests = eventRManager.classPrepareRequests();
+                listSize = requests.size();
+                if ( listSize != (i2 + 1) ) {
+                    testExitCode = FAILED;
+                    log3("ERROR: size of returned List is not equal to expected : " + listSize + " != " + (i2 + 1));
+                }
+                log2("      removing item from the List; UnsupportedOperationException is expected");
+                try {
+                    requests.remove(i2);
+                    testExitCode = FAILED;
+                    log3("ERROR: NO exception");
+                } catch ( UnsupportedOperationException e ) {
+                    log2("        UnsupportedOperationException ");
+                }
+            }
+
+            //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+        }
+        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 {
+//            log2("       eventSet = eventQueue.remove(waitTime);");
+            eventSet = eventQueue.remove(waitTime);
+            if (eventSet == null) {
+                throw new JDITestRuntimeException("** TIMEOUT while waiting for event **");
+            }
+//            log2("       eventIterator = eventSet.eventIterator;");
+            eventIterator = eventSet.eventIterator();
+        } catch ( Exception e ) {
+            throw new JDITestRuntimeException("** EXCEPTION while waiting for event ** : " + e);
+        }
+    }
+
+
+    private void breakpointForCommunication()
+                 throws JDITestRuntimeException {
+        log2("breakpointForCommunication");
+
+        do {
+            getEventSet();
+
+            Event event = eventIterator.nextEvent();
+            if (event instanceof BreakpointEvent)
+                return;
+
+            log2("      received: " + event);
+
+            if (EventFilters.filtered(event)) {
+                eventSet.resume();
+            }
+            else {
+                break;
+            }
+        } while (true);
+
+        throw new JDITestRuntimeException("** event IS NOT a breakpoint **");
+    }
+}