Java example source code file (SpuriousExitEnter_2.java)

This example Java source code file (SpuriousExitEnter_2.java) is included in the alvinalexander.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" ^TM.

Learn more about this Java project at its project page.

Java - Java tags/keywords

alt\+space, awt, button, enter, entered, event, exited, frame, gui, press, put, runtimeexception, spuriousexitenter_2, stage, string, swing, testdialog, the

The SpuriousExitEnter_2.java Java example source code

/*
 * Copyright (c) 2007, 2008, 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.
 */

/*
  @test
  @bug 6479820
  @summary verify that after Alt+Space resizing/moving the correct event gets generated.
  @author Andrei Dmitriev: area=awt.event
  @run main/manual SpuriousExitEnter_2
*/

/**
 * SpuriousExitEnter_2.java
 * There is a JFrame with a JButton in it (Lightweight) and a Frame with a Button in it (Heavyweight).
 * Testcases diveded into two similar activities: first with JFrame and second with Frame.
 */

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;

public class SpuriousExitEnter_2 {
    static JFrame frame = new JFrame("SpuriousExitEnter_2(LW)");
    static JButton jbutton = new JButton("jbutton");

    static Frame frame1 = new Frame("SpuriousExitEnter_2 (HW)");
    static Button button1 = new Button("button");

    private static void init() {
        String[] instructions =
        {
            "You see a plain JFrame with JButton in it and Frame with Button in it.",
            " Following steps should be accomplished for both of them (for Frame and for JFrame).",
            " If any of the following ",
            " third steps fails, press Fail.",
            " Let A area is the area inside Button.",
            " Let B area is the area inside Frame but not inside Button.",
            " Let C area is the area outside Frame.",
            " Stage 1:",
            " 1) Put the mouse pointer into A area.",
            " 2) Press Alt+Space (or other sequence opening the system menu from the top-left corner) ",
            " and resize the Frame so the pointer remains in A.",
            " 3) Press Enter key. No event should be fired.",
            " Stage 2:",
            " Repeat Stage 1 with area B.",
            " Stage 3:",
            " Repeat Stage 1 with area C.",
            " Stage 4:",
            " 1) Put the mouse pointer into A area.",
            " 2) Press Alt+Space and resize the Frame so the pointer becomes in B.",
            " 3) Press Enter key. Exited event on Button and Entered event on Frame should be fired.",
            " Stage 5:",
            " 1) Put the mouse pointer into A area.",
            " 2) Press Alt+Space and resize the Frame so the pointer becomes in C.",
            " 3) Press Enter key. Exited event on Button should be fired.",
            " Stage 6:",
            " 1) Put the mouse pointer into B area.",
            " 2) Press Alt+Space and resize the Frame so the pointer becomes in A.",
            " 3) Press Enter key. Exited event on Frame and Entered event on Button should be fired.",
            " Stage 7:",
            " 1) Put the mouse pointer into B area.",
            " 2) Press Alt+Space and resize the Frame so the pointer becomes in C.",
            " 3) Press Enter key. Exited event on Frame should be fired.",
            " Stage 8:",
            " 1) Put the mouse pointer into C area.",
            " 2) Press Alt+Space and resize the Frame so the pointer becomes in A.",
            " 3) Press Enter key. Entered event on Button should be fired.",
            " Stage 9:",
            " 1) Put the mouse pointer into C area.",
            " 2) Press Alt+Space and resize the Frame so the pointer becomes in B.",
            " 3) Press Enter key. Entered event on Frame should be fired.",
            " Stage 10:",
            " Repeat Stages from 4 to 9 with using Move command rather then Resize. ",
            " Note, that when the pointer jumps to the titlebar when you select \"Move window\", ",
            " it is OK to fire Exited event. Then, if the pointer returns to component back, ",
            " it should fire Entered event.",
        };

        Sysout.createDialog( );
        Sysout.printInstructions( instructions );
        Sysout.enableNumbering(true);

        MouseAdapter enterExitAdapter = new MouseAdapter() {
                public void mouseEntered(MouseEvent e){
                    Sysout.println("Entered on " + e.getSource().getClass().getName());
                }
                public void mouseExited(MouseEvent e){
                    Sysout.println("Exited on " + e.getSource().getClass().getName());
                }
            };

        frame.addMouseListener(enterExitAdapter);
        jbutton.addMouseListener(enterExitAdapter);
        frame.setSize(600, 200);
        frame.add(jbutton, BorderLayout.NORTH);
        frame.setVisible(true);

        frame1.addMouseListener(enterExitAdapter);
        button1.addMouseListener(enterExitAdapter);
        frame1.setSize(600, 200);
        frame1.add(button1, BorderLayout.NORTH);
        frame1.setVisible(true);
    }//End  init()


    /*****************************************************
     * Standard Test Machinery Section
     * DO NOT modify anything in this section -- it's a
     * standard chunk of code which has all of the
     * synchronisation necessary for the test harness.
     * By keeping it the same in all tests, it is easier
     * to read and understand someone else's test, as
     * well as insuring that all tests behave correctly
     * with the test harness.
     * There is a section following this for test-defined
     * classes
     ******************************************************/
    private static boolean theTestPassed = false;
    private static boolean testGeneratedInterrupt = false;
    private static String failureMessage = "";

    private static Thread mainThread = null;

    private static int sleepTime = 300000;

    public static void main( String args[] ) throws InterruptedException
    {
        mainThread = Thread.currentThread();

        try
        {
            init();
        }
        catch( TestPassedException e )
        {
            //The test passed, so just return from main and harness will
            // interepret this return as a pass
            return;
        }
        //At this point, neither test passed nor test failed has been
        // called -- either would have thrown an exception and ended the
        // test, so we know we have multiple threads.

        //Test involves other threads, so sleep and wait for them to
        // called pass() or fail()
        try
        {
            Thread.sleep( sleepTime );
            //Timed out, so fail the test
            throw new RuntimeException( "Timed out after " + sleepTime/1000 + " seconds" );
        }
        catch (InterruptedException e)
        {
            if( ! testGeneratedInterrupt ) throw e;

            //reset flag in case hit this code more than once for some reason (just safety)
            testGeneratedInterrupt = false;
            if ( theTestPassed == false )
            {
                throw new RuntimeException( failureMessage );
            }
        }

    }//main

    public static synchronized void setTimeoutTo( int seconds )
    {
        sleepTime = seconds * 1000;
    }

    public static synchronized void pass()
    {
        Sysout.println( "The test passed." );
        Sysout.println( "The test is over, hit  Ctl-C to stop Java VM" );
        //first check if this is executing in main thread
        if ( mainThread == Thread.currentThread() )
        {
            //Still in the main thread, so set the flag just for kicks,
            // and throw a test passed exception which will be caught
            // and end the test.
            theTestPassed = true;
            throw new TestPassedException();
        }
        //pass was called from a different thread, so set the flag and interrupt
        // the main thead.
        theTestPassed = true;
        testGeneratedInterrupt = true;
        if (mainThread != null){
            mainThread.interrupt();
        }
    }//pass()

    public static synchronized void fail()
    {
        //test writer didn't specify why test failed, so give generic
        fail( "it just plain failed! :-)" );
    }

    public static synchronized void fail( String whyFailed )
    {
        Sysout.println( "The test failed: " + whyFailed );
        Sysout.println( "The test is over, hit  Ctl-C to stop Java VM" );
        //check if this called from main thread
        if ( mainThread == Thread.currentThread() )
        {
            //If main thread, fail now 'cause not sleeping
            throw new RuntimeException( whyFailed );
        }
        theTestPassed = false;
        testGeneratedInterrupt = true;
        failureMessage = whyFailed;
        mainThread.interrupt();
    }//fail()

}// class SpuriousExitEnter_2

//This exception is used to exit from any level of call nesting
// when it's determined that the test has passed, and immediately
// end the test.

class TestPassedException extends RuntimeException
{
}

//*********** End Standard Test Machinery Section **********


//************ Begin classes defined for the test ****************

// make listeners in a class defined here, and instantiate them in init()

/* Example of a class which may be written as part of a test
class NewClass implements anInterface
 {
   static int newVar = 0;

   public void eventDispatched(AWTEvent e)
    {
      //Counting events to see if we get enough
      eventCount++;

      if( eventCount == 20 )
       {
         //got enough events, so pass

         ManualMainTest.pass();
       }
      else if( tries == 20 )
       {
         //tried too many times without getting enough events so fail

         ManualMainTest.fail();
       }

    }// eventDispatched()

 }// NewClass class

*/


//************** End classes defined for the test *******************




/****************************************************
 Standard Test Machinery
 DO NOT modify anything below -- it's a standard
  chunk of code whose purpose is to make user
  interaction uniform, and thereby make it simpler
  to read and understand someone else's test.
 ****************************************************/

/**
 This is part of the standard test machinery.
 It creates a dialog (with the instructions), and is the interface
  for sending text messages to the user.
 To print the instructions, send an array of strings to Sysout.createDialog
  WithInstructions method.  Put one line of instructions per array entry.
 To display a message for the tester to see, simply call Sysout.println
  with the string to be displayed.
 This mimics System.out.println but works within the test harness as well
  as standalone.
 */

class Sysout
{
    private static TestDialog dialog;
    private static boolean numbering = false;
    private static int messageNumber = 0;

    public static void createDialogWithInstructions( String[] instructions )
    {
        dialog = new TestDialog( new Frame(), "Instructions" );
        dialog.printInstructions( instructions );
        dialog.setVisible(true);
        println( "Any messages for the tester will display here." );
    }

    public static void createDialog( )
    {
        dialog = new TestDialog( new Frame(), "Instructions" );
        String[] defInstr = { "Instructions will appear here. ", "" } ;
        dialog.printInstructions( defInstr );
        dialog.setVisible(true);
        println( "Any messages for the tester will display here." );
    }

    /* Enables message counting for the tester. */
    public static void enableNumbering(boolean enable){
        numbering = enable;
    }

    public static void printInstructions( String[] instructions )
    {
        dialog.printInstructions( instructions );
    }


    public static void println( String messageIn )
    {
        if (numbering) {
            messageIn = "" + messageNumber + " " + messageIn;
            messageNumber++;
        }
        dialog.displayMessage( messageIn );
    }

}// Sysout  class

/**
  This is part of the standard test machinery.  It provides a place for the
   test instructions to be displayed, and a place for interactive messages
   to the user to be displayed.
  To have the test instructions displayed, see Sysout.
  To have a message to the user be displayed, see Sysout.
  Do not call anything in this dialog directly.
  */
class TestDialog extends Dialog implements ActionListener
{

    TextArea instructionsText;
    TextArea messageText;
    int maxStringLength = 80;
    Panel  buttonP = new Panel();
    Button passB = new Button( "pass" );
    Button failB = new Button( "fail" );

    //DO NOT call this directly, go through Sysout
    public TestDialog( Frame frame, String name )
    {
        super( frame, name );
        int scrollBoth = TextArea.SCROLLBARS_BOTH;
        instructionsText = new TextArea( "", 15, maxStringLength, scrollBoth );
        add( "North", instructionsText );

        messageText = new TextArea( "", 5, maxStringLength, scrollBoth );
        add("Center", messageText);

        passB = new Button( "pass" );
        passB.setActionCommand( "pass" );
        passB.addActionListener( this );
        buttonP.add( "East", passB );

        failB = new Button( "fail" );
        failB.setActionCommand( "fail" );
        failB.addActionListener( this );
        buttonP.add( "West", failB );

        add( "South", buttonP );
        pack();

        setVisible(true);
    }// TestDialog()

    //DO NOT call this directly, go through Sysout
    public void printInstructions( String[] instructions )
    {
        //Clear out any current instructions
        instructionsText.setText( "" );

        //Go down array of instruction strings

        String printStr, remainingStr;
        for( int i=0; i < instructions.length; i++ )
        {
            //chop up each into pieces maxSringLength long
            remainingStr = instructions[ i ];
            while( remainingStr.length() > 0 )
            {
                //if longer than max then chop off first max chars to print
                if( remainingStr.length() >= maxStringLength )
                {
                    //Try to chop on a word boundary
                    int posOfSpace = remainingStr.
                        lastIndexOf( ' ', maxStringLength - 1 );

                    if( posOfSpace <= 0 ) posOfSpace = maxStringLength - 1;

                    printStr = remainingStr.substring( 0, posOfSpace + 1 );
                    remainingStr = remainingStr.substring( posOfSpace + 1 );
                }
                //else just print
                else
                {
                    printStr = remainingStr;
                    remainingStr = "";
                }

                instructionsText.append( printStr + "\n" );

            }// while

        }// for

    }//printInstructions()

    //DO NOT call this directly, go through Sysout
    public void displayMessage( String messageIn )
    {
        messageText.append( messageIn + "\n" );
        System.out.println(messageIn);
    }

    //catch presses of the passed and failed buttons.
    //simply call the standard pass() or fail() static methods of
    //ManualMainTest
    public void actionPerformed( ActionEvent e )
    {
        if( e.getActionCommand() == "pass" )
        {
            SpuriousExitEnter_2.pass();
        }
        else
        {
            SpuriousExitEnter_2.fail();
        }
    }

}// TestDialog  class