exception001.java

/*
 * 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.ExceptionEvent.exception;

import com.sun.jdi.*;
import com.sun.jdi.event.*;
import com.sun.jdi.request.*;

import java.io.*;
import java.util.Iterator;
import java.util.List;

import nsk.share.*;
import nsk.share.jpda.*;
import nsk.share.jdi.*;


// This class is the debugger in the test

public class exception001 {
    static final int PASSED = 0;
    static final int FAILED = 2;
    static final int JCK_STATUS_BASE = 95;

    // time interval to wait for events
    static final int TIMEOUT_DELTA = 1000; // milliseconds

    // synchronization commands
    static final String COMMAND_READY = "ready";
    static final String COMMAND_QUIT  = "quit";
    static final String COMMAND_GO    = "go";
    static final String COMMAND_DONE  = "done";
    static final String COMMAND_ERROR = "error";

    // checked classes names
    static final String DEBUGGEE_NAME = "nsk.jdi.ExceptionEvent.exception.exception001a";

    static final String USER_EXCEPTION = DEBUGGEE_NAME + "Exception";
    static final String USER_ERROR     = DEBUGGEE_NAME + "Error";
    static final String USER_THROWABLE = DEBUGGEE_NAME + "Throwable";
    static final String JAVA_EXCEPTION = "java.lang.NumberFormatException";
    static final String JAVA_ERROR     = "java.lang.StackOverflowError";

    // scaffold objects
    static private Debugee debuggee;
    static private VirtualMachine vm;
    static private IOPipe pipe;
    static private Log log;
    static private ArgumentHandler argHandler;
    static private EventSet eventSet;

    // timeout for waiting events
    static private long eventTimeout;

    // mirrors for checked classes and threads in debuggee
    static private ExceptionRequest  checkedRequest;
    static private ReferenceType     checkedClass;
    static private ThreadReference   checkedThread;

    static private ReferenceType userException;
    static private ReferenceType userError;
    static private ReferenceType userThrowable;


    // results of receiving particular events
    static private boolean userExceptionReceived;
    static private boolean userErrorReceived;
    static private boolean userThrowableReceived;
    static private boolean javaExceptionReceived;
    static private boolean javaErrorReceived;

    // results of test execution
    static private boolean eventsReceived;
    static private boolean testFailed;

    // flag for EventHandler thread
    static private volatile boolean exceptionsThrown;

    // execute test from command line
    public static void main (String args[]) {
        System.exit(run(args, System.out) + JCK_STATUS_BASE);
    }

    // execute test from JCK-compatible harness
    public static int run(final String args[], final PrintStream out) {

        testFailed = false;
        userExceptionReceived = false;
        userErrorReceived = false;
        userThrowableReceived = false;
        javaExceptionReceived = false;
        javaErrorReceived = false;
        eventsReceived = false;

        argHandler = new ArgumentHandler(args);
        log = new Log(out, argHandler);
        eventTimeout = argHandler.getWaitTime() * 60 * 1000; // milliseconds

        // launch debuggee
        Binder binder = new Binder(argHandler, log);
        log.display("Connecting to debuggee");
        debuggee = binder.bindToDebugee(DEBUGGEE_NAME);
        debuggee.redirectStderr(log, "exception001a >");

        // create synchronization channel with debuggee
        pipe = debuggee.createIOPipe();
        vm = debuggee.VM();
        EventRequestManager erManager = vm.eventRequestManager();

        // resume debuggee
        log.display("Resuming debuggee");
        debuggee.resume();

        // catch exceptions while testing and finally quit debuggee
        try {

            // wait for debuggee started
            log.display("Waiting for command: " + COMMAND_READY);
            String command = pipe.readln();
            if (!command.equals(COMMAND_READY)) {
                throw new Failure("TEST BUG: unexpected debuggee's command: " + command);
            }

            // get mirrors of checked classes in debuggee
            log.display("Getting loaded classes in debuggee");
            if ((checkedClass = debuggee.classByName(DEBUGGEE_NAME)) == null) {
                throw new Failure("TEST BUG: cannot find " + DEBUGGEE_NAME);
            }

            if ((userException = debuggee.classByName(USER_EXCEPTION)) == null) {
                throw new Failure("TEST BUG: cannot find " + USER_EXCEPTION);
            }

            if ((userError = debuggee.classByName(USER_ERROR)) == null) {
                throw new Failure("TEST BUG: cannot find " + USER_ERROR);
            }

            if ((userThrowable = debuggee.classByName(USER_THROWABLE)) == null) {
                throw new Failure("TEST BUG: cannot find " + USER_THROWABLE);
            }

            // get mirror of main thread in debuggee
            log.display("Getting reference to main thread");
            Iterator threadIterator = vm.allThreads().iterator();
            while (threadIterator.hasNext()) {
                ThreadReference curThread = (ThreadReference) threadIterator.next();
                if (curThread.name().equals("main")) {
                     checkedThread = curThread;
                }
            }
            if (checkedThread == null) {
                throw new Failure("TEST BUG: unable to find reference to main thread");
            }

            // create ExceptionRequest for all throwable classes (initially disabled)
            log.display("Creating ExceptionRequest");
            boolean notifyCaught = true;
            boolean notifyUncaught = true;
            if ((checkedRequest = erManager.createExceptionRequest(null, notifyCaught, notifyUncaught)) == null) {
                throw new Failure("TEST BUG: unable to create ExceptionRequest");
            }

            // define separate thread for handling received events
            class EventHandler extends Thread {
                public void run() {
                    // handle events until all exceptions thrown and
                    // all expected events received
                    while (!(exceptionsThrown && eventsReceived)) {
                        eventSet = null;
                        try {
                            eventSet = vm.eventQueue().remove(TIMEOUT_DELTA);
                        } catch (InterruptedException e) {
                            log.complain("Unexpected InterruptedException while receiving event: " + e);
                            break;
                        }

                        if (eventSet == null) {
                            continue;
                        }

                        // handle each event from event set
                        EventIterator eventIterator = eventSet.eventIterator();
                        while (eventIterator.hasNext()) {

                            Event event = eventIterator.nextEvent();
                            log.display("\nEvent received:\n  " + event);

                            if (EventFilters.filtered(event))
                                continue;

                            // handle ExceptionEvent
                            if (event instanceof ExceptionEvent) {

                                ExceptionEvent castedEvent = (ExceptionEvent)event;

                                ObjectReference eventThrowable = castedEvent.exception();
                                if (eventThrowable == null) {
                                    log.complain("FAILURE 1: ExceptionEvent.exception() returns null");
                                    testFailed = true;
                                } else {
                                    ReferenceType eventRefType = castedEvent.exception().referenceType();
                                    if (eventRefType.equals(userException)) {
                                        log.display("ExceptionEvent for " + USER_EXCEPTION + " is received");
                                        userExceptionReceived = true;

                                        Location eventLocation  = castedEvent.location();
                                        if (!(eventLocation.declaringType().name().equals(DEBUGGEE_NAME))) {
                                            log.complain("FAILURE 2: eventLocation.declaringType() does not equal to debuggee class");
                                            testFailed = true;
                                        }

                                    } else if (eventRefType.equals(userError)) {
                                        log.display("ExceptionEvent for " + USER_ERROR + " is received");
                                        userErrorReceived = true;

                                        Location eventLocation  = castedEvent.location();
                                        if (!(eventLocation.declaringType().name().equals(DEBUGGEE_NAME))) {
                                            log.complain("FAILURE 2: eventLocation.declaringType() does not equal to debuggee class");
                                            testFailed = true;
                                        }

                                    } else if (eventRefType.equals(userThrowable)) {
                                        log.display("ExceptionEvent for " + USER_THROWABLE + " is received");
                                        userThrowableReceived = true;

                                        Location eventLocation  = castedEvent.location();
                                        if (!(eventLocation.declaringType().name().equals(DEBUGGEE_NAME))) {
                                            log.complain("FAILURE 2: eventLocation.declaringType() does not equal to debuggee class");
                                            testFailed = true;
                                        }

                                    } else {
                                        String eventTypeName = eventRefType.name();
                                        if (eventTypeName.equals(JAVA_EXCEPTION)) {
                                            log.display("ExceptionEvent for " + JAVA_EXCEPTION + " is received");
                                            javaExceptionReceived = true;
                                        } else if (eventTypeName.equals(JAVA_ERROR)) {
                                            log.display("ExceptionEvent for " + JAVA_ERROR + " is received");
                                            javaErrorReceived = true;
                                        }
                                    }
                                }

                                EventRequest eventRequest = castedEvent.request();
                                if (!(checkedRequest.equals(eventRequest))) {
                                    log.complain("FAILURE 4: eventRequest does not equal to checked request");
                                    testFailed = true;
                                }
                                ThreadReference eventThread = castedEvent.thread();
                                if (!(checkedThread.equals(eventThread))) {
                                    log.complain("FAILURE 5: eventThread does not equal to checked thread");
                                    testFailed = true;
                                }
                                VirtualMachine eventMachine = castedEvent.virtualMachine();
                                if (!(vm.equals(eventMachine))) {
                                    log.complain("FAILURE 6: eventVirtualMachine does not equal to checked vm");
                                    testFailed = true;
                                }
                            }

                            // ignore each other events

                        } // end of event handling loop

                        log.display("Resuming event set");
                        eventSet.resume();

                        // check if all expected events received
                        eventsReceived = userExceptionReceived && userErrorReceived
                                        && userThrowableReceived && javaExceptionReceived
                                        && javaErrorReceived;

                    } // end of event set handling loop

                    log.display("eventHandler completed");

                } // end of run()

            } // end of EventHandler

            // start EventHandler thread
            EventHandler eventHandler = new EventHandler();
            log.display("Starting eventHandler");
            eventHandler.start();

            // enable event request
            log.display("Enabling ExceptionRequest");
            checkedRequest.enable();

            // force debuggee to throw exceptions and generate events
            log.display("Sending command: " + COMMAND_GO);
            pipe.println(COMMAND_GO);

            log.display("");

            // wait for debuggee completed test case
            log.display("Waiting for command: " + COMMAND_DONE);
            command = pipe.readln();
            if (command.equals(COMMAND_ERROR)) {
                throw new Failure("TEST BUG: Unable to thrown all exceptions in debuggee");
            }
            if (!command.equals(COMMAND_DONE)) {
                throw new Failure("TEST BUG: unknown debuggee's command: " + command);
            }

            // notify EventHandler that all checked exceptions thrown in debuggee
            exceptionsThrown = true;

            log.display("");

            // wait for all expected events received or timeout exceeds
            log.display("Waiting for all expected events received");
            try {
                eventHandler.join(eventTimeout);
                if (eventHandler.isAlive()) {
                    log.complain("FAILURE 20: Timeout for waiting event was exceeded");
                    eventHandler.interrupt();
                    testFailed = true;
                }
            } catch (InterruptedException e) {
                log.complain("TEST INCOMPLETE: InterruptedException caught while waiting for eventHandler's death");
                testFailed = true;
            }

            // complain if not all expected events received
            if (!userExceptionReceived) {
                log.complain("FAILURE 9: " + USER_EXCEPTION + " was not received received");
                testFailed= true;
            }
            if (!userErrorReceived) {
                log.complain("FAILURE 10: " + USER_ERROR + " was not received received");
                testFailed= true;
            }
            if (!userThrowableReceived) {
                log.complain("FAILURE 11: " + USER_THROWABLE + " was not received received");
                testFailed= true;
            }
            if (!javaExceptionReceived) {
                log.complain("FAILURE 12: " + JAVA_EXCEPTION + " was not received received");
                testFailed= true;
            }
            if (!javaErrorReceived) {
                log.complain("FAILURE 13: " + JAVA_ERROR + " was not received received");
                testFailed= true;
            }

            // end testing

        } catch (Failure e) {
            log.complain("TEST FAILURE: " + e.getMessage());
            testFailed = true;
        } catch (Exception e) {
            log.complain("Unexpected exception: " + e);
            e.printStackTrace(out);
            testFailed = true;
        } finally {

            log.display("");

            // disable event request to prevent appearance of further events
            if (checkedRequest != null && checkedRequest.isEnabled()) {
                log.display("Disabling event request");
                checkedRequest.disable();
            }

            // force debugee to exit
            log.display("Sending command: " + COMMAND_QUIT);
            pipe.println(COMMAND_QUIT);

            // wait for debuggee exits and analize its exit code
            log.display("Waiting for debuggee terminating");
            int debuggeeStatus = debuggee.endDebugee();
            if (debuggeeStatus == PASSED + JCK_STATUS_BASE) {
                log.display("Debuggee PASSED with exit code: " + debuggeeStatus);
            } else {
                log.complain("Debuggee FAILED with exit code: " + debuggeeStatus);
                testFailed = true;
            }
        }

        // check test results
        if (testFailed) {
            log.complain("TEST FAILED");
            return FAILED;
        }

        log.display("TEST PASSED");
        return PASSED;
    }
}


/*
// This class is the debugger in the test

public class exception001 {
    static final int PASSED = 0;
    static final int FAILED = 2;
    static final int JCK_STATUS_BASE = 95;
    static final String COMMAND_READY = "ready";
    static final String COMMAND_QUIT = "quit";
    static final String COMMAND_GO = "go";
    static final String DEBUGGEE_NAME = "nsk.jdi.ExceptionEvent.exception.exception001a";
    static final String USER_EXCEPTION = DEBUGGEE_NAME + "Exception";
    static final String USER_ERROR     = DEBUGGEE_NAME + "Error";
    static final String USER_THROWABLE = DEBUGGEE_NAME + "Throwable";
    static final String JAVA_EXCEPTION = "java.lang.NumberFormatException";
    static final String JAVA_ERROR     = "java.lang.StackOverflowError";

    static private Debugee debuggee;
    static private VirtualMachine vm;
    static private IOPipe pipe;
    static private Log log;
    static private ArgumentHandler argHandler;
    static private EventSet eventSet;

    static private ExceptionRequest  checkedRequest;
    static private ReferenceType     checkedClass;
    static private ThreadReference   checkedThread;

    static private ReferenceType userException;
    static private ReferenceType userError;
    static private ReferenceType userThrowable;
    static private boolean userExceptionReceived;
    static private boolean userErrorReceived;
    static private boolean userThrowableReceived;
    static private boolean javaExceptionReceived;
    static private boolean javaErrorReceived;

    static private boolean testFailed;

    public static void main (String args[]) {
          System.exit(run(args, System.out) + JCK_STATUS_BASE);
    }

    public static int run(final String args[], final PrintStream out) {

        testFailed = false;
        userExceptionReceived = false;
        userErrorReceived = false;
        userThrowableReceived = false;
        javaExceptionReceived = false;
        javaErrorReceived = false;

        argHandler = new ArgumentHandler(args);
        log = new Log(out, argHandler);

        Binder binder = new Binder(argHandler, log);
        log.display("Connecting to debuggee");
        debuggee = binder.bindToDebugee(DEBUGGEE_NAME);
        debuggee.redirectStderr(log, "exception001a >");

        pipe = debuggee.createIOPipe();
        vm = debuggee.VM();
        EventRequestManager erManager = debuggee.VM().eventRequestManager();

        log.display("Resuming debuggee");
        debuggee.resume();

        log.display("Waiting for command: " + COMMAND_READY);
        String command = pipe.readln();

        while (true) {

            if (!command.equals(COMMAND_READY)) {
                log.complain("TEST BUG: unexpected debuggee's command: " + command);
                testFailed = true;
                break;
            }

            log.display("Getting loaded classes in debuggee");
            if ((checkedClass = debuggee.classByName(DEBUGGEE_NAME)) == null) {
                log.complain("TEST BUG: cannot find " + DEBUGGEE_NAME);
                testFailed = true;
                break;
            }

            if ((userException = debuggee.classByName(USER_EXCEPTION)) == null) {
                log.complain("TEST BUG: cannot find " + USER_EXCEPTION);
                testFailed = true;
                break;
            }

            if ((userError = debuggee.classByName(USER_ERROR)) == null) {
                log.complain("TEST BUG: cannot find " + USER_ERROR);
                testFailed = true;
                break;
            }

            if ((userThrowable = debuggee.classByName(USER_THROWABLE)) == null) {
                log.complain("TEST BUG: cannot find " + USER_THROWABLE);
                testFailed = true;
                break;
            }

            log.display("Getting reference to main thread");
            Iterator threadIterator = vm.allThreads().iterator();
            while (threadIterator.hasNext()) {
                ThreadReference curThread = (ThreadReference) threadIterator.next();
                if (curThread.name().equals("main")) {
                     checkedThread = curThread;
                }
            }
            if (checkedThread == null) {
                log.complain("TEST BUG: unable to find reference to main thread");
                testFailed = true;
                break;
            }

            log.display("Creating ExceptionRequest");
            boolean notifyCaught = true;
            boolean notifyUncaught = true;
            if ((checkedRequest = erManager.createExceptionRequest(null, notifyCaught, notifyUncaught)) == null) {
                log.complain("TEST BUG: unable to create ExceptionRequest");
                testFailed = true;
                break;
            }

            //checkedRequest.addClassFilter(checkedClass);
            checkedRequest.setSuspendPolicy(EventRequest.SUSPEND_ALL);
            checkedRequest.enable();
            log.display("ExceptionRequest is created");

            break;
        }
        if (testFailed) {
            log.display("Sending command: " + COMMAND_QUIT);
            pipe.println(COMMAND_QUIT);
            log.display("Waiting for debuggee terminating");
            debuggee.waitFor();
            return FAILED;
        }

        class EventHandler extends Thread {
             public void run() {
                 eventSet = null;
                 try {
                     isConnected:
                     while (true) {
                         eventSet = vm.eventQueue().remove();

                         EventIterator eventIterator = eventSet.eventIterator();
                         while (eventIterator.hasNext()) {

                             Event event = eventIterator.nextEvent();

                             if (event instanceof VMDisconnectEvent) {
                                 break isConnected;
                             }

                             if (event instanceof ExceptionEvent) {

                                 ExceptionEvent castedEvent = (ExceptionEvent)event;

                                 ObjectReference eventThrowable = castedEvent.exception();
                                 if (eventThrowable == null) {
                                     log.complain("FAILURE 1: ExceptionEvent.exception() returns null");
                                     testFailed = true;
                                 } else {
                                     ReferenceType eventRefType = castedEvent.exception().referenceType();
                                     if (eventRefType.equals(userException)) {
                                         log.display("ExceptionEvent for " + USER_EXCEPTION + " is received");
                                         userExceptionReceived = true;

                                         Location eventLocation  = castedEvent.location();
                                         if (!(eventLocation.declaringType().name().equals(DEBUGGEE_NAME))) {
                                             log.complain("FAILURE 2: eventLocation.declaringType() does not equal to debuggee class");
                                             testFailed = true;
                                         }

                                     } else if (eventRefType.equals(userError)) {
                                         log.display("ExceptionEvent for " + USER_ERROR + " is received");
                                         userErrorReceived = true;

                                         Location eventLocation  = castedEvent.location();
                                         if (!(eventLocation.declaringType().name().equals(DEBUGGEE_NAME))) {
                                             log.complain("FAILURE 2: eventLocation.declaringType() does not equal to debuggee class");
                                             testFailed = true;
                                         }

                                     } else if (eventRefType.equals(userThrowable)) {
                                         log.display("ExceptionEvent for " + USER_THROWABLE + " is received");
                                         userThrowableReceived = true;

                                         Location eventLocation  = castedEvent.location();
                                         if (!(eventLocation.declaringType().name().equals(DEBUGGEE_NAME))) {
                                             log.complain("FAILURE 2: eventLocation.declaringType() does not equal to debuggee class");
                                             testFailed = true;
                                         }

                                     } else {
                                         String eventTypeName = eventRefType.name();
                                         if (eventTypeName.equals(JAVA_EXCEPTION)) {
                                             log.display("ExceptionEvent for " + JAVA_EXCEPTION + " is received");
                                             javaExceptionReceived = true;
                                         } else if (eventTypeName.equals(JAVA_ERROR)) {
                                             log.display("ExceptionEvent for " + JAVA_ERROR + " is received");
                                             javaErrorReceived = true;
                                         }
                                     }
                                 }

                                 EventRequest eventRequest = castedEvent.request();
                                 if (!(checkedRequest.equals(eventRequest))) {
                                     log.complain("FAILURE 4: eventRequest does not equal to checked request");
                                     testFailed = true;
                                 }
                                 ThreadReference eventThread = castedEvent.thread();
                                 if (!(checkedThread.equals(eventThread))) {
                                     log.complain("FAILURE 5: eventThread does not equal to checked thread");
                                     testFailed = true;
                                 }
                                 VirtualMachine eventMachine = castedEvent.virtualMachine();
                                 if (!(vm.equals(eventMachine))) {
                                     log.complain("FAILURE 6: eventVirtualMachine does not equal to checked vm");
                                     testFailed = true;
                                 }
                             }
                         }
                         eventSet.resume();
                     }
                 } catch (InterruptedException e) {
                 } catch (VMDisconnectedException e) {
                     log.complain("TEST INCOMPLETE: caught VMDisconnectedException while waiting for event");
                     testFailed = true;
                 }
                 log.display("eventHandler completed");
             }
        }

        EventHandler eventHandler = new EventHandler();
        log.display("Starting eventHandler");
        eventHandler.start();

        log.display("Sending command: " + COMMAND_GO);
        pipe.println(COMMAND_GO);

        try {
            eventHandler.join(argHandler.getWaitTime()*60000);
            if (eventHandler.isAlive()) {
                log.complain("FAILURE 20: Timeout for waiting of event was exceeded");
                eventHandler.interrupt();
                testFailed = true;
            }
        } catch (InterruptedException e) {
            log.complain("TEST INCOMPLETE: InterruptedException caught while waiting for eventHandler's death");
            testFailed = true;
        }

        log.display("Waiting for debuggee terminating");
        debuggee.waitFor();

        if (!userExceptionReceived) {
            log.complain("FAILURE 7: " + USER_EXCEPTION + " was not received received");
            testFailed= true;
        }
        if (!userErrorReceived) {
            log.complain("FAILURE 8: " + USER_ERROR + " was not received received");
            testFailed= true;
        }
        if (!userThrowableReceived) {
            log.complain("FAILURE 9: " + USER_THROWABLE + " was not received received");
            testFailed= true;
        }
        if (!javaExceptionReceived) {
            log.complain("FAILURE 10: " + JAVA_EXCEPTION + " was not received received");
            testFailed= true;
        }
        if (!javaErrorReceived) {
            log.complain("FAILURE 11: " + JAVA_ERROR + " was not received received");
            testFailed= true;
        }

        if (testFailed) return FAILED;
        return PASSED;
    }

}

*/