student

Class ObjectdrawTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

student.TestCase

student.GUITestCase

student.ObjectdrawTestCase

All Implemented Interfaces:

junit.framework.Test

public class ObjectdrawTestCase
extends GUITestCase

This class provides enhancements to GUITestCase to support testing of objectdraw graphics programs that use DrawableInterface instances.

Version:

$Revision: 1.4 $, $Date: 2010/06/01 12:29:24 $

Author:

Stephen Edwards, Last changed by $Author: fr3lm0 $

Nested Class Summary

Nested classes/interfaces inherited from class student.GUITestCase

GUITestCase.EventDispatchException

Nested classes/interfaces inherited from class student.TestCase

TestCase.AssertMethodCalledIncorrectly

Field Summary

Fields

Modifier and Type	Field and Description
ObjectdrawFilter.Operator	where This field re-exports the where operator from ObjectdrawFilter so that it is available in test methods without requiring a static import.

Fields inherited from class student.GUITestCase

DISPOSE_CLASSES

Constructor Summary

Constructors

Constructor and Description
ObjectdrawTestCase() Creates a new ObjectdrawTestCase object.
ObjectdrawTestCase(String name) Creates a new ObjectdrawTestCase object.

Method Summary

Modifier and Type	Method and Description
<T extends objectdraw.DrawableInterface> List<T>	getAllDrawablesMatching(Class<T> type) Look up all DrawableInterface objects on the canvas of the WindowController being tested by specifying their class.
<T extends objectdraw.DrawableInterface> List<T>	getAllDrawablesMatching(Class<T> type, ObjectdrawFilter filter) Look up all DrawableInterface objects on the canvas of the WindowController being tested by specifying their class and an ObjectdrawFilter.
List<objectdraw.DrawableInterface>	getAllDrawablesMatching(ObjectdrawFilter filter) Look up all DrawableInterface objects on the canvas of the WindowController being tested by specifying an ObjectdrawFilter.
protected objectdraw.DrawingCanvas	getCanvas() Retrieve the JDrawingCanvas object associated with the WindowController being tested.
<T extends objectdraw.DrawableInterface> T	getDrawable(Class<T> type) Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying its class.
<T extends objectdraw.DrawableInterface> T	getDrawable(Class<T> type, ObjectdrawFilter filter) Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying its class and an ObjectdrawFilter.
objectdraw.DrawableInterface	getDrawable(ObjectdrawFilter filter) Look up a DrawableInterface object on the canvas of the WindowController being tested, using a filter to specify which object you want.
<T extends objectdraw.DrawableInterface> T	getFirstDrawableMatching(Class<T> type) Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying its class.
<T extends objectdraw.DrawableInterface> T	getFirstDrawableMatching(Class<T> type, ObjectdrawFilter filter) Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying its class and an ObjectdrawFilter.
objectdraw.DrawableInterface	getFirstDrawableMatching(ObjectdrawFilter filter) Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying an ObjectdrawFilter.

Methods inherited from class student.GUITestCase

callGUIIOMethod, callGUIIOMethod, callGUIIOMethod, click, click, click, clickDialogButton, createHierarchy, doubleClick, doubleClick, enterText, fixtureSetUp, fixtureTearDown, focus, getAllComponentsMatching, getAllComponentsMatching, getAllComponentsMatching, getComponent, getComponent, getComponent, getComponent, getContents, getContents, getFinder, getFirstComponentMatching, getFirstComponentMatching, getFirstComponentMatching, getHierarchy, getPathFor, getRobot, getWindowTracker, keyPress, keyRelease, keyString, keyStroke, keyStroke, mouseDragFrom, mouseDragFrom, mouseDragOver, mouseDropOn, mouseDropOn, mouseExit, mouseMove, mousePress, mousePress, mouseRelease, not, rightClick, rightClick, runBare, runTestMethod, selectColorInChooser, selectFileInChooser, selectFilesInChooser, selectItem, selectItem, selectMenuItem, setInputDialogText, setModifiers, setSwitchFocus, showInFrame, showInFrame, showWindow, showWindow, sleep, toString, toString, toString

Methods inherited from class student.TestCase

assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertFuzzyEquals, assertFuzzyEquals, assertSame, assertSame, assertTrue, assertTrue, compact, compact, contains, containsRegex, containsRegex, equals, equalsRegex, equalsRegex, fromFile, fromFile, fuzzyContains, fuzzyContainsRegex, fuzzyContainsRegex, fuzzyEquals, fuzzyEqualsRegex, fuzzyEqualsRegex, in, installExitHandler, instrumentIO, multiline, out, prepareIO, resetIO, resetSystemIO, setIn, setIn, setNormalizeLineEndings, setSystemIn, setUp, setUseFuzzyStringComparisons, stringNormalizer, systemErr, systemOut, tearDown, uninstallExitHandler

Methods inherited from class junit.framework.TestCase

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runTest, setName, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

where

public final ObjectdrawFilter.Operator where

This field re-exports the where operator from ObjectdrawFilter so that it is available in test methods without requiring a static import.

Constructor Detail

ObjectdrawTestCase

public ObjectdrawTestCase()

Creates a new ObjectdrawTestCase object.

ObjectdrawTestCase

public ObjectdrawTestCase(String name)

Creates a new ObjectdrawTestCase object.

Parameters:

name - The name of this test case.

Method Detail

getDrawable

public <T extends objectdraw.DrawableInterface> T getDrawable(Class<T> type)

Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying its class. This method expects the given class to identify a unique DrawableInterface object, meaning that there should only be one instance of the given class on the canvas. If no matching object exists, the test case will fail with an appropriate message. If more than one matching object exists, the test case will fail with an appropriate message.

Type Parameters:

T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.

Parameters:

type - The type (class) of the object you wish to retrieve, and also the way you specify the return type of this method.

Returns:

The single instance of the desired type that was found (otherwise, a test case failure results).

See Also:

getFirstDrawableMatching(Class), getAllDrawablesMatching(Class)

getDrawable

public <T extends objectdraw.DrawableInterface> T getDrawable(Class<T> type,
                                                              ObjectdrawFilter filter)

Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying its class and an ObjectdrawFilter. This method expects exactly one DrawableInterface object to match your criteria. If no matching object exists, the test case will fail with an appropriate message. If more than one matching object exists, the test case will fail with an appropriate message.

Type Parameters:

T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.

Parameters:

type - The type (class) of the object you wish to retrieve, and also the way you specify the return type of this method.

filter - The search criteria.

Returns:

The single DrawableInterface object matching the criteria specified (otherwise, a test case failure results).

See Also:

getFirstDrawableMatching(Class, ObjectdrawFilter), getAllDrawablesMatching(Class, ObjectdrawFilter)

getDrawable

public objectdraw.DrawableInterface getDrawable(ObjectdrawFilter filter)

Look up a DrawableInterface object on the canvas of the WindowController being tested, using a filter to specify which object you want. This method is more general than getDrawable(Class, ObjectdrawFilter), since no class needs to be specified, but that also means the return type is less specific (it is always DrawableInterface). This method expects the given filter to identify a unique DrawableInterface object. If no matching object exists, the test case will fail with an appropriate message. If more than one matching object exists, the test case will fail with an appropriate message.

Parameters:

filter - The search criteria.

Returns:

The single DrawableInterface object matching the provided filter (otherwise, a test case failure results).

See Also:

getFirstDrawableMatching(ObjectdrawFilter), getAllDrawablesMatching(ObjectdrawFilter)

getFirstDrawableMatching

public <T extends objectdraw.DrawableInterface> T getFirstDrawableMatching(Class<T> type)

Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying its class. This method expects the given class to identify at least one such DrawableInterface object. If no matching object exists, the test case will fail with an appropriate message. If more than one matching object exists, the first one found will be returned (although client code should not expect a specific search order).

Type Parameters:

T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.

Parameters:

type - The type (class) of the object you wish to retrieve, and also the way you specify the return type of this method.

Returns:

The first object of the desired type that was found (a test case failure results if there are none).

See Also:

getDrawable(Class), getAllDrawablesMatching(Class)

getFirstDrawableMatching

public <T extends objectdraw.DrawableInterface> T getFirstDrawableMatching(Class<T> type,
                                                                           ObjectdrawFilter filter)

Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying its class and an ObjectdrawFilter. This method expects the given criteria to identify at least one such DrawableInterface object. If no matching object exists, the test case will fail with an appropriate message. If more than one matching object exists, the first one found will be returned (although client code should not expect a specific search order).

Type Parameters:

T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.

Parameters:

type - The type (class) of the object you wish to retrieve, and also the way you specify the return type of this method.

filter - The search criteria.

Returns:

The first DrawableInterface object that was found matching the criteria specified (a test case failure results if there are none).

See Also:

getDrawable(Class,ObjectdrawFilter), getAllDrawablesMatching(Class, ObjectdrawFilter)

getFirstDrawableMatching

public objectdraw.DrawableInterface getFirstDrawableMatching(ObjectdrawFilter filter)

Look up a DrawableInterface object on the canvas of the WindowController being tested by specifying an ObjectdrawFilter. This method is more general than getFirstDrawableMatching(Class, ObjectdrawFilter), since no class needs to be specified, but that also means the return type is less specific (it is always DrawableInterface). This method expects the given criteria to identify at least one such DrawableInterface object. If no matching object exists, the test case will fail with an appropriate message. If more than one matching object exists, the first one found will be returned (although client code should not expect a specific search order).

Parameters:

filter - The search criteria.

Returns:

The first object that was found matching the criteria specified (a test case failure results if there are none).

See Also:

getDrawable(ObjectdrawFilter), getAllDrawablesMatching(ObjectdrawFilter)

getAllDrawablesMatching

public <T extends objectdraw.DrawableInterface> List<T> getAllDrawablesMatching(Class<T> type)

Look up all DrawableInterface objects on the canvas of the WindowController being tested by specifying their class. All matching objects are returned in a list.

Type Parameters:

T - This method is a template method, and the type T used as the List element type in the return value is implicitly deduced from the provided argument type.

Parameters:

type - The type (class) of the objects you wish to retrieve, and also the way you specify the type of elements in the list returned by this method.

Returns:

A list of all objects of the desired type that were found. This will be an empty list (not null) if no matching objects are found.

See Also:

getDrawable(Class), getFirstDrawableMatching(Class)

getAllDrawablesMatching

public <T extends objectdraw.DrawableInterface> List<T> getAllDrawablesMatching(Class<T> type,
                                                                                ObjectdrawFilter filter)

Look up all DrawableInterface objects on the canvas of the WindowController being tested by specifying their class and an ObjectdrawFilter. All matching objects are returned in a list.

Type Parameters:

T - This method is a template method, and the type T used as the List element type in the return value is implicitly deduced from the provided argument type.

Parameters:

type - The type (class) of the objects you wish to retrieve, and also the way you specify the type of elements in the list returned by this method.

filter - The search criteria.

Returns:

A list of all objects found matching the criteria specified. This will be an empty list (not null) if no matching objects are found.

See Also:

getDrawable(Class,ObjectdrawFilter), getAllDrawablesMatching(Class,ObjectdrawFilter)

getAllDrawablesMatching

public List<objectdraw.DrawableInterface> getAllDrawablesMatching(ObjectdrawFilter filter)

Look up all DrawableInterface objects on the canvas of the WindowController being tested by specifying an ObjectdrawFilter. All matching objects are returned in a list. This method is more general than getAllDrawablesMatching(Class, ObjectdrawFilter), since no class needs to be specified, but that also means the return type is less specific (it is always DrawableInterface).

Parameters:

filter - The search criteria.

Returns:

A list of all DrawableInterface objects found matching the criteria specified. This will be an empty list (not null) if no matching objects are found.

See Also:

getDrawable(ObjectdrawFilter), getAllDrawablesMatching(ObjectdrawFilter)

getCanvas

protected objectdraw.DrawingCanvas getCanvas()

Retrieve the JDrawingCanvas object associated with the WindowController being tested.

Returns:

The JDrawingCanvas containing all of the WindowController's drawable objects.