student.testingsupport

Class GObjectFilter.Operator

java.lang.Object

student.testingsupport.GObjectFilter.Operator

Direct Known Subclasses:

GObjectFilter.BinaryOperator

Enclosing class:

GObjectFilter

public abstract static class GObjectFilter.Operator
extends Object

This base class represents an operator used to create a query. As the base class for all operators, it defines the primitive query operations supported for all GObject objects, each of which can be combined using any operator.

Constructor Summary

Constructors

Constructor and Description
Operator()

Method Summary

Modifier and Type	Method and Description
protected abstract GObjectFilter	applySelfTo(GObjectFilter otherFilter) Concrete subclasses must override this to implement an operation on the filter being passed in to transform it into another filter.
GObjectFilter	cointainsPoint(double x, double y) Create a filter that checks that a GObject contains the given point.
GObjectFilter	cointainsPoint(acm.graphics.GPoint point) Create a filter that checks that a GObject contains the given point.
GObjectFilter	colorIs(Color color) Create a filter that checks a GObject's color.
GObjectFilter	fillColorIs(Color color) Create a filter that checks a GObject's fill color.
GObjectFilter	filledIs(boolean filled) Create a filter that checks whether a GObject is filled.
GObjectFilter	heightIs(double value) Create a filter that checks a GObject's height.
GObjectFilter	isContainedWithin(Rectangle region) Create a filter that checks whether a GObject's bounding box (as returned by GObject.getBounds()) lies within a specific rectangle--that is, whether the entire GObject's area, rather than just its top left corner, lies within the specified region.
GObjectFilter	isLocatedWithin(Rectangle region) Create a filter that checks whether a GObject's location (its top left corner) lies within a specific rectangle.
GObjectFilter	isNear(double x, double y) Create a filter that checks that a GObject is within 50 pixels of the given point.
GObjectFilter	isNear(double x, double y, double distance) Create a filter that checks that a GObject is within distance pixels of the given point.
GObjectFilter	isNear(acm.graphics.GPoint point) Create a filter that checks that a GObject is within 50 pixels of the given point.
GObjectFilter	isNear(acm.graphics.GPoint point, double distance) Create a filter that checks that a GObject is within distance pixels of the given point.
GObjectFilter	lineEndPointIs(double x, double y) Create a filter that checks that a GPoint is a line that ends at the point (x, y).
GObjectFilter	lineEndPointIs(acm.graphics.GPoint point) Create a filter that checks that a GOBject is a line that ends at point.
GObjectFilter	lineStartPointIs(double x, double y) Create a filter that checks that a GPoint is a line that starts at the point (x, y).
GObjectFilter	lineStartPointIs(acm.graphics.GPoint point) Create a filter that checks that a GOBject is a line that starts at point.
GObjectFilter	locationIs(double x, double y) Create a filter that checks a GObject's location relative to its parent.
GObjectFilter	locationIs(acm.graphics.GPoint point) Create a filter that checks a GObject's location relative to its parent.
GObjectFilter	sizeIs(double width, double height) Create a filter that checks a GObject's size.
GObjectFilter	sizeIsWithin(double maxWidth, double maxHeight) Create a filter that checks a GObject's size.
GObjectFilter	textIs(String text) Create a filter that checks the text of a GObject by calling the GObject's getText() method.
GObjectFilter	typeIs(Class<? extends acm.graphics.GObject> aClass) Create a filter that checks the class of a GObject.
GObjectFilter	visibilityIs(boolean visibility) Create a filter that checks a GObject's visibilty.
GObjectFilter	widthIs(double value) Create a filter that checks a GObject's width.
GObjectFilter	xLocationIs(double x) Create a filter that checks a GObject's x-coordinate.
GObjectFilter	yLocationIs(double y) Create a filter that checks a GObject's y-coordinate.

Methods inherited from class java.lang.Object

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

Constructor Detail

Operator

public Operator()

Method Detail

cointainsPoint

public GObjectFilter cointainsPoint(acm.graphics.GPoint point)

Create a filter that checks that a GObject contains the given point.

Parameters:

point - the required point

Returns:

A new filter that succeeds only on GObjects that contain the point.

cointainsPoint

public GObjectFilter cointainsPoint(double x,
                                    double y)

Create a filter that checks that a GObject contains the given point.

Parameters:

x - The required x coordinate, relative to the GObject's parent.

y - The required y coordinate, relative to the GObject's parent.

Returns:

A new filter that succeeds only on GObjects that contain the point (x, y).

isNear

public GObjectFilter isNear(acm.graphics.GPoint point)

Create a filter that checks that a GObject is within 50 pixels of the given point.

Parameters:

point - The required point.

Returns:

A new filter that succeeds only on GObjects that are located with 50 pixels of point.

isNear

public GObjectFilter isNear(double x,
                            double y)

Create a filter that checks that a GObject is within 50 pixels of the given point.

Parameters:

x - The required x coordinate, relative to the GObject's parent.

y - The required y coordinate, relative to the GObject's parent.

Returns:

A new filter that succeeds only on GObjects that are located within 50 pixels of the point (x, y).

isNear

public GObjectFilter isNear(acm.graphics.GPoint point,
                            double distance)

Create a filter that checks that a GObject is within distance pixels of the given point.

Parameters:

point - The required point.

distance - The distance used to judge whether the GObject is near the given point

Returns:

A new filter that succeeds only on GObjects that are within distance pixels of the given point.

isNear

public GObjectFilter isNear(double x,
                            double y,
                            double distance)

Create a filter that checks that a GObject is within distance pixels of the given point.

Parameters:

x - The required x coordinate, relative to the GObject's parent.

y - The required y coordinate, relative to the GObject's parent

distance - The distance used to judge whether the GObject is near the given point

Returns:

A new filter that succeeds only on GObjects that are within distance pixels of the point (x, y).

lineStartPointIs

public GObjectFilter lineStartPointIs(acm.graphics.GPoint point)

Create a filter that checks that a GOBject is a line that starts at point.

Parameters:

point - The required point.

Returns:

A new filter that succeeds only on GObjects that are lines starting at point.

lineStartPointIs

public GObjectFilter lineStartPointIs(double x,
                                      double y)

Create a filter that checks that a GPoint is a line that starts at the point (x, y).

Parameters:

x - The required x coordinate, relative to the GObject's parent.

y - The required y coordinate, relative to the GObject's parent

Returns:

A new filter that succeeds only on GObjects that are lines starting at the point (x, y).

lineEndPointIs

public GObjectFilter lineEndPointIs(acm.graphics.GPoint point)

Create a filter that checks that a GOBject is a line that ends at point.

Parameters:

point - The required point.

Returns:

A new filter that succeeds only on GObjects that are lines ending at point.

lineEndPointIs

public GObjectFilter lineEndPointIs(double x,
                                    double y)

Create a filter that checks that a GPoint is a line that ends at the point (x, y).

Parameters:

x - The required x coordinate, relative to the GObject's parent.

y - The required y coordinate, relative to the GObject's parent

Returns:

A new filter that succeeds only on GObjects that are lines endin at the point (x, y).

sizeIs

public GObjectFilter sizeIs(double width,
                            double height)

Create a filter that checks a GObject's size.

Parameters:

width - The required width.

height - The required height.

Returns:

A new filter that succeeds only on GObjects that have the given size.

sizeIsWithin

public GObjectFilter sizeIsWithin(double maxWidth,
                                  double maxHeight)

Create a filter that checks a GObject's size.

Parameters:

maxWidth - The required width.

maxHeight - The required height.

Returns:

A new filter that succeeds only on GObjects that are eqal to or smaller than the given size.

locationIs

public GObjectFilter locationIs(double x,
                                double y)

Create a filter that checks a GObject's location relative to its parent.

Parameters:

x - The required x-coordinate, relative to the GObject's parent.

y - The required y-coordinate, relative to the GObject's parent.

Returns:

A new filter that succeeds only on GObjects that have the given location.

locationIs

public GObjectFilter locationIs(acm.graphics.GPoint point)

Create a filter that checks a GObject's location relative to its parent.

Parameters:

point - The required point, relative to the GObject's parent.

Returns:

A new filter that succeeds only on GObjects that have the given location.

isLocatedWithin

public GObjectFilter isLocatedWithin(Rectangle region)

Create a filter that checks whether a GObject's location (its top left corner) lies within a specific rectangle.

Parameters:

region - A rectangle defining a region in the GObject's parent.

Returns:

A new filter that succeeds only on GObjects that have a location within the given region.

isContainedWithin

public GObjectFilter isContainedWithin(Rectangle region)

Create a filter that checks whether a GObject's bounding box (as returned by GObject.getBounds()) lies within a specific rectangle--that is, whether the entire GObject's area, rather than just its top left corner, lies within the specified region.

Parameters:

region - A rectangle defining a region in the GObject's parent.

Returns:

A new filter that succeeds only on GObjects that lie entirely within the given region, as determined by Rectangle.contains(Rectangle).

xLocationIs

public GObjectFilter xLocationIs(double x)

Create a filter that checks a GObject's x-coordinate.

Parameters:

x - The required x-coordinate, relative to the GObject's parent.

Returns:

A new filter that succeeds only on GObjects that have the given x-coordinate.

yLocationIs

public GObjectFilter yLocationIs(double y)

Create a filter that checks a GObject's y-coordinate.

Parameters:

y - The required y-coordinate, relative to the GObject's parent.

Returns:

A new filter that succeeds only on GObjects that have the given y-coordinate.

textIs

public GObjectFilter textIs(String text)

Create a filter that checks the text of a GObject by calling the GObject's getText() method.

Parameters:

text - The text to look for

Returns:

A new filter that succeeds only on GObjects where getText() returns the specified text.

typeIs

public GObjectFilter typeIs(Class<? extends acm.graphics.GObject> aClass)

Create a filter that checks the class of a GObject.

Parameters:

aClass - The required class to check for (any subclass will also match).

Returns:

A new filter that only succeeds on instances of the given class.

widthIs

public GObjectFilter widthIs(double value)

Create a filter that checks a GObject's width.

Parameters:

value - The width to look for.

Returns:

A new filter that succeeds only on GObjects that have the given width.

heightIs

public GObjectFilter heightIs(double value)

Create a filter that checks a GObject's height.

Parameters:

value - The height to look for.

Returns:

A new filter that succeeds only on GObjects that have the given height.

colorIs

public GObjectFilter colorIs(Color color)

Create a filter that checks a GObject's color.

Parameters:

color - The required Color.

Returns:

A new filter that succeeds only on GObjects that are Color color.

fillColorIs

public GObjectFilter fillColorIs(Color color)

Create a filter that checks a GObject's fill color.

Parameters:

color - The required Color.

Returns:

A new filter that succeeds only on GObjects that are filled with Color color.

filledIs

public GObjectFilter filledIs(boolean filled)

Create a filter that checks whether a GObject is filled.

Parameters:

filled - The required boolean value.

Returns:

A new filter that succeeds only on GObjects whose filled value is equal to filled.

visibilityIs

public GObjectFilter visibilityIs(boolean visibility)

Create a filter that checks a GObject's visibilty.

Parameters:

visibility - The required boolean value.

Returns:

A new filter that succeeds only on GObjects whos visibility value is equal to visibility.

applySelfTo

protected abstract GObjectFilter applySelfTo(GObjectFilter otherFilter)

Concrete subclasses must override this to implement an operation on the filter being passed in to transform it into another filter.

Parameters:

otherFilter - The argument to transform (second argument, for binary operators)

Returns:

A new compound filter that includes the given argument as one subfilter, after applying this operator to it.