info.gridworld.actor
Class Critter

java.lang.Object
  info.gridworld.actor.Actor
      info.gridworld.actor.Critter

public class Critter
extends Actor

A Critter is an actor that moves through its world, processing other actors in some way and then picking a new location.
The implementation of this class is testable on the AP CS A and AB exams.

Constructor Summary

Critter()

Method Summary

void	act() A critter acts by getting a list of its neighbors, processing them, getting locations to move to, selecting one of them, and moving to the selected location.
ArrayList<Actor>	getActors() Gets the actors for processing.
ArrayList<Location>	getMoveLocations() Gets the possible locations for the next move.
void	makeMove(Location loc) Moves this critter to the given location.
void	processActors(ArrayList<Actor> actors) Processes the actors.
Location	selectMoveLocation(ArrayList<Location> locs) Selects the location for the next move.

Methods inherited from class info.gridworld.actor.Actor

getColor, getDirection, getGrid, getLocation, moveTo, putSelfInGrid, removeSelfFromGrid, setColor, setDirection, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Critter

public Critter()

Method Detail

act

public void act()

A critter acts by getting a list of its neighbors, processing them, getting locations to move to, selecting one of them, and moving to the selected location.

Overrides:

act in class Actor

getActors

public ArrayList<Actor> getActors()

Gets the actors for processing. The actors must be contained in the same grid as this critter. Implemented to return the actors that occupy neighboring grid locations. Override this method in subclasses to look elsewhere for actors to process.

Returns:

a list of actors that are neighbors of this critter

processActors

public void processActors(ArrayList<Actor> actors)

Processes the actors. Implemented to "eat" (i.e. remove) all actors that are not rocks or critters. Override this method in subclasses to process neighbors in a different way.
Precondition: All objects in actors are contained in the same grid as this critter.

Parameters:

actors - the actors to be processed

getMoveLocations

public ArrayList<Location> getMoveLocations()

Gets the possible locations for the next move. Implemented to return the empty neighboring locations. Override this method in subclasses to look elsewhere for move locations.
Postcondition: The locations must be valid in the grid of this critter.

Returns:

a list of possible locations for the next move

selectMoveLocation

public Location selectMoveLocation(ArrayList<Location> locs)

Selects the location for the next move. Implemented to randomly pick one of the possible locations, or to return the current location if locs has size 0. Override this method in subclasses that have another mechanism for selecting the next move location.
Precondition: All locations in locs are valid in the grid of this critter

Parameters:

locs - the possible locations for the next move

Returns:

the location that was selected for the next move.

makeMove

public void makeMove(Location loc)

Moves this critter to the given location. Implemented to call moveTo. Override this method in subclasses that want to carry out other actions for moving (for example, turning or leaving traces).
Precondition: loc is valid in the grid of this critter

Parameters:

loc - the location to move to (must be valid)