ihs.apcs.spacebattle

Class BasicSpaceship

java.lang.Object

ihs.apcs.spacebattle.BasicSpaceship

All Implemented Interfaces:

Spaceship<BasicGameInfo>

public abstract class BasicSpaceship
extends java.lang.Object
implements Spaceship<BasicGameInfo>

Basic Spaceship class to abstract Generic for initial introduction. See Spaceship for more info.

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
BasicSpaceship()

Method Summary

Methods

Modifier and Type	Method and Description
abstract ShipCommand	getNextCommand(BasicEnvironment env)
ShipCommand	getNextCommand(Environment<BasicGameInfo> env) Issues a command to be executed by this ship on the server.
abstract RegistrationData	registerShip(int numImages, int worldWidth, int worldHeight) Registers a ship with the server so it can begin issuing commands.
void	shipDestroyed(java.lang.String lastDestroyedBy) Notifies a ship that it has been destroyed and respawned.

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicSpaceship

public BasicSpaceship()

Method Detail

registerShip

public abstract RegistrationData registerShip(int numImages,
                            int worldWidth,
                            int worldHeight)

Description copied from interface: Spaceship

Registers a ship with the server so it can begin issuing commands.

Specified by:

registerShip in interface Spaceship<BasicGameInfo>

Parameters:

numImages - the number of images available for the ship's appearance on the server

worldWidth - the width of the current world in pixels

worldHeight - the height of the current world in pixels

Returns:

the necessary registration information for the server

getNextCommand

public abstract ShipCommand getNextCommand(BasicEnvironment env)

getNextCommand

public ShipCommand getNextCommand(Environment<BasicGameInfo> env)

Description copied from interface: Spaceship

Issues a command to be executed by this ship on the server.

Commands are executed one at a time, except for non-blocking commands. Commands cannot be issued except when requested by the server. The server will process each command, then send the new environment (representing the result of the issued command and any actions taken by other entities in the game world) back to the ship and request a new command.

Specified by:

getNextCommand in interface Spaceship<BasicGameInfo>

Parameters:

env - the current environment provided by the server

Returns:

a command to be executed by the ship

shipDestroyed

public void shipDestroyed(java.lang.String lastDestroyedBy)

Description copied from interface: Spaceship

Notifies a ship that it has been destroyed and respawned. Ships can use this to track their deaths.

Specified by:

shipDestroyed in interface Spaceship<BasicGameInfo>

Parameters:

lastDestroyedBy - string containing the name of the player's ship or the object type name and #ID of the entity which destroyed your ship.