AbstractPlayer (SWP6-Javadocs)

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

de.torfu.kabayellow.common
Class AbstractPlayer

java.lang.Object
  |
  +--de.torfu.kabayellow.common.AbstractPlayer

All Implemented Interfaces:: IControllingPlayer, IGameJoinObserver, IGameObserver

public abstract class AbstractPlayer
extends java.lang.Object
implements IGameObserver, IControllingPlayer, IGameJoinObserver

Abstrakte Superklasse für einen lokalen Spieler (GUI oder KI). GUI und KI müssen diese Klasse erweitern.

Wenn das Spiel beginnt, wird ein AbstractPlayer erzeugt. Der AbstractPlayer hat über die getGame()-Methode jederzeit Zugriff auf den aktuellen Spielstand.

Es müssen mindestens die vier abstrakten Methoden yourTurnNormal(), yourTurnMoveKing(), yourTurnSetFirstKnight() und timeout() überschrieben werden. Diese Methoden werden von der Control aufgerufen, wenn der AbstractPlayer am Zug ist, bzw. sein Zug wegen Timeout beendet wurde.

Die anderen Methoden können überschrieben werden, um auf bestimmte Spielereignisse zu reagieren. Sie werden von der Control aufgerufen, wenn bestimmte Ereignisse eingetreten sind.

Aufrufreihenfolge:

Normale Aktionen: Zuerst wird die Aktion ausgeführt, dann werden aufgerufen:

Beim Kartenkauf: Zuerst wird die neue Karte in die getCards()-Liste eingefügt, dann:

Beim Zugende (ActionEndTurn, ActionMoveKing, letztes ActionSetFirstKnight) werden zuerst Runde, Phase, currentPlayer usw. im Game aktualisiert, dann werden aufgerufen:

Constructor Summary

AbstractPlayer()


Method Summary

void actionPerformed(Action action)
          Wird aufgerufen, wenn ein beliebiger Spieler eine Action ausgeführt hat.

void gameOver(Player winner)
          Wird aufgerufen, wenn das Spiel vorbei ist.

void gameStarted()
          Wird einmalig aufgerufen, wenn alle Spieler sich angemeldet haben.

void gameStatusChanged()
          Wird nach jeder Änderung des Spielstatus aufgerufen, z.B. wenn der nächste Spieler dran ist, oder wenn ein beliebiger Spieler eine Aktion ausgeführt hat.

void newPlayer(java.lang.String name, int age)
          Wird aufgerufen, wenn sich ein weiterer Spieler anmeldet.

void nextPhase()
          Wird aufgerufen, nachdem eine Phase zu Ende ist.

void nextPlayer()
          Wird aufgerufen, nachdem ein Spieler seinen Zug beendet hat.

void nextRound()
          Wird aufgerufen, nachdem eine Runde zu Ende ist.

void receiveCard(ActionCard card)
          Wird aufgerufen, nachdem der AbstractPlayer eine ActionBuyCard ausgeführt hat.

void receiveChatMessage(int playerID, java.lang.String message)
          Wird aufgerufen, wenn ein beliebiger Spieler eine Chat-Nachricht verschickt hat.

void startGame(Game game)
          Wird von Communicator aufgerufen, wenn alle Spieler sich angemeldet haben und das Spiel losgehen kann.

abstract void timeout()
          Wird aufgerufen, wenn der AbstractPlayer innerhalb der vorgeschriebenen Bedenkzeit seinen Zug nicht beendet hat.

abstract void yourTurnMoveKing()
          Wird aufgerufen, um dem AbstractPlayer mitzuteilen, dass er den König versetzen soll.

abstract void yourTurnNormal()
          Wird aufgerufen, um dem AbstractPlayer mitzuteilen, dass er mit einem normalen Zug an der Reihe ist.

abstract void yourTurnSetFirstKnight()
          Wird aufgerufen, um dem AbstractPlayer mitzuteilen, dass er einen Ritter einsetzen soll.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractPlayer

public AbstractPlayer()

Method Detail

yourTurnNormal

public abstract void yourTurnNormal()

Description copied from interface: IControllingPlayer

Wird aufgerufen, um dem AbstractPlayer mitzuteilen, dass er mit einem normalen Zug an der Reihe ist. Nachdem die Methode aufgerufen wurde, kann der AbstractPlayer Action-Objekte erzeugen und diese mit execute() ausführen. Wenn er mit seinem Zug fertig ist, muss er ein ActionEndTurn-Objekt erzeugen und ausführen, um seinen Zug zu beenden.

Specified by:: yourTurnNormal in interface IControllingPlayer

yourTurnMoveKing

public abstract void yourTurnMoveKing()

Description copied from interface: IControllingPlayer

Wird aufgerufen, um dem AbstractPlayer mitzuteilen, dass er den König versetzen soll. Nachdem die Methode aufgerufen wurde, muss er ein ActionMoveKing-Objekt erzeugen und dieses mit execute() ausführen. Damit ist sein Zug beendet.

Specified by:: yourTurnMoveKing in interface IControllingPlayer

yourTurnSetFirstKnight

public abstract void yourTurnSetFirstKnight()

Description copied from interface: IControllingPlayer

Wird aufgerufen, um dem AbstractPlayer mitzuteilen, dass er einen Ritter einsetzen soll. Dies geschieht ein mal, vor der ersten Runde. Nachdem die Methode aufgerufen wurde, muss er ein ActionSetFirstKnight-Objekt erzeugen und dieses mit execute() ausführen. Damit ist sein Zug beendet.

Specified by:: yourTurnSetFirstKnight in interface IControllingPlayer

timeout

public abstract void timeout()

Description copied from interface: IControllingPlayer

Wird aufgerufen, wenn der AbstractPlayer innerhalb der vorgeschriebenen Bedenkzeit seinen Zug nicht beendet hat. Damit ist der nächste Spieler dran. Nach dem Aufruf von timeout() werden keine Action-Objekte mehr akzeptiert.

Specified by:: timeout in interface IControllingPlayer

receiveCard

public void receiveCard(ActionCard card)

Description copied from interface: IControllingPlayer

Wird aufgerufen, nachdem der AbstractPlayer eine ActionBuyCard ausgeführt hat. Übergeben wird die Nummer der Karte, die er vom Stapel gezogen hat. Dies ist nur zur Information; die Karte wird auf jeden Fall auch automatisch im Array getGame().getCurrentPlayer().getActionCards() abgelegt.

Specified by:: receiveCard in interface IControllingPlayer

Parameters:: card - die gezogene Karte