cz.gyarab.util.teaser

Interface Hanoi

All Known Implementing Classes:

HanoiAnimator, HanoiRemote, MultiUserHanoi

public interface Hanoi

Rozhraní slouží k implementaci známého hlavolamu Hanojských věží. "Hra" probíhá ve třech krocích:

• setup - nastavení parametrů hry (počet disků) a inicializace hracího plánu (všechny disky jsou vlevo
• move - opakované přesuny disků podle pravidel
• done - poslední kontrola, zda jsou všechny disky vpravo

Pokud je tah neplatný (táhne se neexistujícím diskem nebo by se měl větší disk umístit na menší), bude vyvolána výjimka IllegalStateException.

Since:

1.3.23

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Hanoi.Place Poloha věže.

Field Summary

Fields

Modifier and Type	Field and Description
static Hanoi	EMPTY Prázdná implementace pravidel.

Method Summary

Modifier and Type	Method and Description
void	done() Ověří ukončení hry.
void	move(Hanoi.Place from, Hanoi.Place to) Přesune jeden disk z jedné věže na druhou.
void	setup(int count) Spustí novou hru.

Field Detail

EMPTY

static final Hanoi EMPTY

Prázdná implementace pravidel. Tato implementace nic nekontroluje, nevyvolá žádnou výjimku, lze jí např. použít pro testovací účely.

Since:

1.4

Method Detail

setup

void setup(int count)
    throws java.lang.IllegalArgumentException

Spustí novou hru. Všechny disky se umístí ve správném pořadí na levou věž.

Parameters:

count - počet disků

Throws:

java.lang.IllegalArgumentException - pokud počet disků není kladné číslo

move

void move(Hanoi.Place from,
          Hanoi.Place to)
   throws java.lang.IllegalStateException

Přesune jeden disk z jedné věže na druhou. Pokud by byl tah v rozporu s pravidly, tah se neuskuteční a bude vyvolána výjimka.

Parameters:

from - poloha věže, ze které se má disk přesunout

to - poloha věže, na kterou se má být disk přesunout

Throws:

java.lang.IllegalStateException - pokud je tah v rozporu s pravidly

done

void done()
   throws java.lang.IllegalStateException

Ověří ukončení hry. Hra je ukončena podle pravidel, pokud jsou všechny disky na pravé věží ve správném pořadí.

Throws:

java.lang.IllegalStateException - pokud hra není na konci (jsou disky, které zůstaly na levé nebo střední věži)