student.testingsupport

Class ObjectdrawFilter.Operator

java.lang.Object

student.testingsupport.ObjectdrawFilter.Operator

Direct Known Subclasses:

ObjectdrawFilter.BinaryOperator

Enclosing class:

ObjectdrawFilter

public abstract static class ObjectdrawFilter.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 DrawableInterface 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 ObjectdrawFilter	applySelfTo(ObjectdrawFilter otherFilter) Concrete subclasses must override this to implement an operation on the filter being passed in to transform it into another filter.
ObjectdrawFilter	colorIs(Color color) Create a filter that checks a shape's color.
ObjectdrawFilter	heightIs(int value) Create a filter that checks a shape's height.
ObjectdrawFilter	hiddenIs(boolean hidden) Create a filter that checks whether a shape is hidden.
ObjectdrawFilter	isContainedWithin(Rectangle region) Create a filter that checks whether a shape's bounding box lies within a specific rectangle--that is, whether the entire shape's area rather than just its top left corner, lies within the specified region.
ObjectdrawFilter	isLocatedWithin(Rectangle region) Create a filter that checks whether a shape's location (its top left corner) lies within a specific rectangle.
ObjectdrawFilter	lineEndLocationIs(int x, int y) Create a filter that checks whether a line ends at a given coordinate.
ObjectdrawFilter	lineEndLocationIs(objectdraw.Location location) Create a filter that checks whether a line starts at a given location.
ObjectdrawFilter	lineStartLocationIs(int x, int y) Create a filter that checks whether a line starts at a given coordinate.
ObjectdrawFilter	lineStartLocationIs(objectdraw.Location location) Create a filter that checks whether a line starts at a given location.
ObjectdrawFilter	locationIs(int x, int y) Create a filter that checks a shape's location.
ObjectdrawFilter	sizeIs(int width, int height) Create a filter that checks a shape's size.
ObjectdrawFilter	sizeIsWithin(int maxWidth, int maxHeight) Create a filter that checks a shape's size.
ObjectdrawFilter	textIs(String text) Create a filter that checks the text of a shape by calling the shape's getText() method, if it has one.
ObjectdrawFilter	typeIs(Class<? extends objectdraw.DrawableInterface> aClass) Create a filter that checks the class of a shape.
ObjectdrawFilter	widthIs(int value) Create a filter that checks a shape's width.
ObjectdrawFilter	xLocationIs(int x) Create a filter that checks a shape's x-coordinate.
ObjectdrawFilter	yLocationIs(int y) Create a filter that checks a shape'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

textIs

public ObjectdrawFilter textIs(String text)

Create a filter that checks the text of a shape by calling the shape's getText() method, if it has one.

Parameters:

text - The text to look for

Returns:

A new filter that succeeds only on shape where getText() is a valid method and returns the specified text.

typeIs

public ObjectdrawFilter typeIs(Class<? extends objectdraw.DrawableInterface> aClass)

Create a filter that checks the class of a shape.

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 ObjectdrawFilter widthIs(int value)

Create a filter that checks a shape's width.

Parameters:

value - The width to look for.

Returns:

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

heightIs

public ObjectdrawFilter heightIs(int value)

Create a filter that checks a shape's height.

Parameters:

value - The height to look for.

Returns:

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

sizeIs

public ObjectdrawFilter sizeIs(int width,
                               int height)

Create a filter that checks a shape's size.

Parameters:

width - The required width.

height - The required height.

Returns:

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

sizeIsWithin

public ObjectdrawFilter sizeIsWithin(int maxWidth,
                                     int maxHeight)

Create a filter that checks a shape's size.

Parameters:

maxWidth - The required width.

maxHeight - The required height.

Returns:

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

xLocationIs

public ObjectdrawFilter xLocationIs(int x)

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

Parameters:

x - The required x-coordinate

Returns:

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

yLocationIs

public ObjectdrawFilter yLocationIs(int y)

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

Parameters:

y - The required y-coordinate

Returns:

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

locationIs

public ObjectdrawFilter locationIs(int x,
                                   int y)

Create a filter that checks a shape's location.

Parameters:

x - The required x-coordinate.

y - The required y-coordinate.

Returns:

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

isLocatedWithin

public ObjectdrawFilter isLocatedWithin(Rectangle region)

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

Parameters:

region - A rectangle defining a region.

Returns:

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

isContainedWithin

public ObjectdrawFilter isContainedWithin(Rectangle region)

Create a filter that checks whether a shape's bounding box lies within a specific rectangle--that is, whether the entire shape's area rather than just its top left corner, lies within the specified region.

Parameters:

region - A rectangle defining a region.

Returns:

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

colorIs

public ObjectdrawFilter colorIs(Color color)

Create a filter that checks a shape's color.

Parameters:

color - the color to check for.

Returns:

A new filter that succeeds only on shapes that have the specified color.

hiddenIs

public ObjectdrawFilter hiddenIs(boolean hidden)

Create a filter that checks whether a shape is hidden.

Parameters:

hidden - a boolean indicating the hidden state to check for.

Returns:

A new filter that succeeds only if the shape's hidden value matches hidden.

lineStartLocationIs

public ObjectdrawFilter lineStartLocationIs(int x,
                                            int y)

Create a filter that checks whether a line starts at a given coordinate.

Parameters:

x - the required x-coordinate.

y - the required y-coordinate.

Returns:

A new filter that succeeds only for lines that start at (x, y).

lineStartLocationIs

public ObjectdrawFilter lineStartLocationIs(objectdraw.Location location)

Create a filter that checks whether a line starts at a given location.

Parameters:

location - the required Location.

Returns:

A new filter that succeeds only for lines that start at the specified location.

lineEndLocationIs

public ObjectdrawFilter lineEndLocationIs(int x,
                                          int y)

Create a filter that checks whether a line ends at a given coordinate.

Parameters:

x - the required x-coordinate.

y - the required y-coordinate.

Returns:

A new filter that succeeds only for lines that end at (x, y).

lineEndLocationIs

public ObjectdrawFilter lineEndLocationIs(objectdraw.Location location)

Create a filter that checks whether a line starts at a given location.

Parameters:

location - the required Location

Returns:

A new filter that succeeds only lines that end at location.

applySelfTo

protected abstract ObjectdrawFilter applySelfTo(ObjectdrawFilter 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.