reversi

Class Arena

java.lang.Object

reversi.Arena

public class Arena
extends java.lang.Object

Die Klasse Arena führt ein Spiel zwischen zwei vom Benutzer an der Kommandozeile angegebenen Spielern aus. Sie ist die Hauptklasse des Reversi-Frameworks, deren main-Methode ein Spiel beginnt. Aufrufsyntax des Programms Arena:

 java -classpath . reversi.Arena [options] GameName package1.myclass1 package2.myclass2
 

Der obige Aufruf startet ein Spiel zwischen zwei Computerspielern package1.myclass1 und package2.myclass2. Dabei bezeichnet myclassX die Klasse, die das Interface ReversiPlayer implementiert. packageX bezeichnet das Package, in dem die Spielerklasse implementiert ist.

GameName ist ein beliebiger Name für das Spiel. Der Name wird beim Schreiben von Spielinformationen in eine Log-Datei verwendet. Das erlaubt das spätere Wiederfinden von einzelnen Spielen in einer Log-Datei, die mehrere Spiele enthält.

Folgende Optionen können verwendet werden:

 -h            Hilfe anzeigen
 -t timeout    Maximale Zugdauer in Millisekunden (0 für unbeschränkt)
 -d delay      Verzögerung zwischen Zügen; wichtig nur zur Animation
 -e exittime   Verzögerung, bis das Programm nach Spielende stoppt
 -l logfile    Name der Log-Datei für das Protokollieren des Spiels
 -c            keine graphische Oberfläche anzeigen
 -f            keine graphischen Animationen
 -s startPosNr Start Position (0: Standart, 1-6 Alternative Startpositionen, siehe Startpositionen.pdf)

Field Summary

Fields

Modifier and Type	Field and Description
(package private) java.lang.StringBuffer	backlog
protected static int	BOARD_LENGTH
(package private) int[]	direction
(package private) java.lang.String	logFile
(package private) java.util.Vector<java.io.PrintWriter>	logStreams
(package private) java.lang.String	matchId
(package private) java.lang.String	name_green
(package private) java.lang.String	name_red
protected reversi.ProgramParameters	params
protected java.lang.Thread	performerThread
(package private) ReversiPlayer	player_green
(package private) ReversiPlayer	player_red
(package private) reversi.GameState	state
(package private) java.lang.String	statusText
protected static int	TIME_TOLERANCE
(package private) int	timeBeforeExit
(package private) long	timeOut
(package private) boolean	verbose
(package private) reversi.Visualization	visualization

Constructor Summary

Constructors

Constructor and Description
Arena(reversi.ProgramParameters params, reversi.Visualization vis)

Method Summary

Modifier and Type	Method and Description
(package private) void	addLogStream(java.io.PrintWriter pw)
(package private) void	cheatedFinish(int player, int reason, reversi.TextGameBoard board)
(package private) void	computePossibleMoves(reversi.TextGameBoard board, int player, int[][] possibleMoves)
(package private) void	computeTokensToFlip(GameBoard gb, Coordinates pos, int color, int[][] toFlip) This routine computes which positions on the board have to be flipped when a certain move is made.
(package private) java.lang.String	getBacklog()
(package private) reversi.ProgramParameters	getParams()
(package private) static ReversiPlayer	instantiatePlayer(java.lang.String name)
(package private) static ReversiPlayer	instantiatePlayerJar(java.lang.String name, java.lang.String path)
static void	main(java.lang.String[] args) Arena main method.
(package private) Coordinates	makeMove(ReversiPlayer player, GameBoard board) Make a move under supervised conditions.
(package private) boolean	onBoard(int r, int c)
(package private) void	performMatch() Perform a match between two players.
(package private) Coordinates	performMove(int player, reversi.TextGameBoard board)
(package private) void	regularFinish(int redStones, int greenStones)
void	setStartingPosition(int s, reversi.TextGameBoard board)
void	setTimeBeforeExit(int t)
void	startMatch()
(package private) void	writeToLog(java.lang.String s)

Methods inherited from class java.lang.Object

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

Field Detail

backlog

java.lang.StringBuffer backlog

BOARD_LENGTH

protected static final int BOARD_LENGTH

See Also:

Constant Field Values

direction

int[] direction

logFile

java.lang.String logFile

logStreams

java.util.Vector<java.io.PrintWriter> logStreams

matchId

java.lang.String matchId

name_green

java.lang.String name_green

name_red

java.lang.String name_red

params

protected reversi.ProgramParameters params

performerThread

protected java.lang.Thread performerThread

player_green

ReversiPlayer player_green

player_red

ReversiPlayer player_red

state

reversi.GameState state

statusText

java.lang.String statusText

TIME_TOLERANCE

protected static final int TIME_TOLERANCE

See Also:

Constant Field Values

timeBeforeExit

int timeBeforeExit

timeOut

long timeOut

verbose

boolean verbose

visualization

reversi.Visualization visualization

Constructor Detail

Arena

public Arena(reversi.ProgramParameters params,
             reversi.Visualization vis)

Method Detail

addLogStream

void addLogStream(java.io.PrintWriter pw)

cheatedFinish

void cheatedFinish(int player,
                   int reason,
                   reversi.TextGameBoard board)

computePossibleMoves

void computePossibleMoves(reversi.TextGameBoard board,
                          int player,
                          int[][] possibleMoves)

computeTokensToFlip

void computeTokensToFlip(GameBoard gb,
                         Coordinates pos,
                         int color,
                         int[][] toFlip)

This routine computes which positions on the board have to be flipped when a certain move is made. The move is specified by the position pos and the player color color. The array flipped will be filled with the result. A "0" indicates no flip, while a "1" indicates that the stone at this position will be flipped when the corresponding move is made.

getBacklog

java.lang.String getBacklog()

getParams

reversi.ProgramParameters getParams()

instantiatePlayer

static ReversiPlayer instantiatePlayer(java.lang.String name)

instantiatePlayerJar

static ReversiPlayer instantiatePlayerJar(java.lang.String name,
                                          java.lang.String path)
                                   throws java.lang.Exception

Throws:

java.lang.Exception

main

public static void main(java.lang.String[] args)

Arena main method.

makeMove

Coordinates makeMove(ReversiPlayer player,
                     GameBoard board)
              throws java.lang.Throwable

Make a move under supervised conditions.

Throws:

java.lang.Throwable

onBoard

boolean onBoard(int r,
                int c)

performMatch

void performMatch()

Perform a match between two players.

performMove

Coordinates performMove(int player,
                        reversi.TextGameBoard board)
                 throws reversi.IrregularFinishException

Throws:

reversi.IrregularFinishException

regularFinish

void regularFinish(int redStones,
                   int greenStones)

setStartingPosition

public void setStartingPosition(int s,
                                reversi.TextGameBoard board)

setTimeBeforeExit

public void setTimeBeforeExit(int t)

startMatch

public void startMatch()

writeToLog

void writeToLog(java.lang.String s)