cz.zcu.kiv.ppr.msloup.kernel
Class Fiber

java.lang.Object
  extended by cz.zcu.kiv.ppr.msloup.kernel.Fiber
Direct Known Subclasses:
FarmerFiber, WorkerFiber

public abstract class Fiber
extends Object

Abtraktni trida definujici Fiber.

Author:
Martin Sloup

Constructor Summary
Fiber()
          Konstruktor fiberu
 
Method Summary
 void doStep(SysCall sysCall)
          Metoda kterou vola CPU pri vykonani dalsi instrukce ve stepu.
protected  HashSet<EventStructure> getEventStructures()
          Vraci Hashset synchronizacnich ojektu, na kterych ceka tento Fiber
protected  int getFiberID()
          Vraci jednoznacny identifikator Fiberu
protected  int getPC()
          Vraci aktualni cislo instrukce ve stepu.
protected  long getSleepTo()
          Vraci cas v milisekundach, do kdy nebude Fiber planovan
 FiberState getState()
          Vraci stav Fiberu.
protected abstract  int getStepCount()
          Abstraktni metoda ktera varci pocet instrukci v case bloku uvnitr metody step.
protected  void goTo(int newPC)
          Jednoduche primitivum ke skoku na zadanou instrukci.
protected  void ifGoTo(boolean condition, int truePC)
          Jednoduche primitivum na generovani skoku pri splneni podminky.
protected  boolean isLastWaitForTimeouted()
          Vraci true, pokud u posledni metody waitForSingleObjekt nebo waitForMultipleObject vytikal nastaveny timer.
protected  boolean isWaitOnAllEvents()
          Vraci true, pokud waitForMultipleObject ceka na aktiavci vsech zadanych eventu
protected  void resetSleep()
          Resetuje cas spanku Fiberu
protected  void setLastWaitForTimeouted(boolean lastWaitForTimeouted)
          Nastavuje stav posledniho waitForXXX.
 void setState(FiberState state)
          Nastavuje stav Fiberu
protected  void setWaitOnAllEvents(boolean waitOnAllEvents)
          Nastavuje, zda se ma cekat na aktivaci vsech eventu u witForMultipleObject.
protected  void sleep(long miliseconds)
          Metoda, ktera zajisti uspani Fiberu na minimalne zadany pocet milisekund.
protected abstract  void step(SysCall sysCall)
          Abtraktni metoda pro jeden krok (instrukci) programu ve Fiberu.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Fiber

public Fiber()
Konstruktor fiberu

Method Detail

step

protected abstract void step(SysCall sysCall)
Abtraktni metoda pro jeden krok (instrukci) programu ve Fiberu. Kazda oddedena trida musi doimplementovat kod teto metody.

Kod teto metody by mohl vypadat napr nasledovne:


 switch(PC) {
        case 0:
                i = 0;
                break;
        case 1:
                ifGoTo(i >= 10, 4);
                break;
        case 2:
                sysCall.getOut().println(i++);
                break;
        case 3:
                goTo(1);
                break;
        case 4:
                break;
 }
 

Pro tento ukazkovy kod musi vracet u getStepCount() jako pocet instrukci cislo 5.

Parameters:
sysCall - objekt pro systemove volani

getStepCount

protected abstract int getStepCount()
Abstraktni metoda ktera varci pocet instrukci v case bloku uvnitr metody step. Pokud se Fiber dostane pri vykonavani na toto cislo, je automaticky oznacen jeho stav jako TERMINATED.

Returns:
celkovy pocet instrukci (pocet case bloku)

doStep

public final void doStep(SysCall sysCall)
Metoda kterou vola CPU pri vykonani dalsi instrukce ve stepu. Stara se o zvysovani program counteru (PC) a osetruje skoky v programu. Take se stara o nastaveni stavu TERMINATED pri prekroceni poctu instrukci vracene v getStepCount().

Parameters:
sysCall - objekt systemovych volani

ifGoTo

protected void ifGoTo(boolean condition,
                      int truePC)
Jednoduche primitivum na generovani skoku pri splneni podminky. Tato metoda by mela byt v case bloku jako posledni.

Parameters:
condition - je-li splnena podminka
truePC - dojde ke skoku na instrukci (na case) s timto cislem

goTo

protected void goTo(int newPC)
Jednoduche primitivum ke skoku na zadanou instrukci. Tato metoda by mela byt v case bloku jako posledni.

Parameters:
newPC - cislo instrukce (cislo v case), ktera bude vykonana jako dalsi

setState

public void setState(FiberState state)
Nastavuje stav Fiberu

Parameters:
state - novy stav Fiberu

getState

public FiberState getState()
Vraci stav Fiberu.

Returns:
stav Fiberu

getEventStructures

protected HashSet<EventStructure> getEventStructures()
Vraci Hashset synchronizacnich ojektu, na kterych ceka tento Fiber

Returns:
Hashset synchronizacnich ojektu, na kterych ceka tento Fiber

sleep

protected void sleep(long miliseconds)
Metoda, ktera zajisti uspani Fiberu na minimalne zadany pocet milisekund. Tato metoda by mela byt jako posledni v case bloku.

Parameters:
miliseconds - pocet milisekund, po kterych bude Fiber uspan

getSleepTo

protected long getSleepTo()
Vraci cas v milisekundach, do kdy nebude Fiber planovan

Returns:
cas v milisekundach

resetSleep

protected void resetSleep()
Resetuje cas spanku Fiberu


isLastWaitForTimeouted

protected boolean isLastWaitForTimeouted()
Vraci true, pokud u posledni metody waitForSingleObjekt nebo waitForMultipleObject vytikal nastaveny timer.

Returns:
stav timeoutu u posledniho waitForXXX

setLastWaitForTimeouted

protected void setLastWaitForTimeouted(boolean lastWaitForTimeouted)
Nastavuje stav posledniho waitForXXX. Toto nastavuje scheduler.

Parameters:
lastWaitForTimeouted - stav timeoutu u posledniho waitForXXX

getFiberID

protected int getFiberID()
Vraci jednoznacny identifikator Fiberu

Returns:
indentifikator Fiberu

isWaitOnAllEvents

protected boolean isWaitOnAllEvents()
Vraci true, pokud waitForMultipleObject ceka na aktiavci vsech zadanych eventu

Returns:
true, pokud ceka na aktivaci vsech eventu, nad kteryma Fiber ceka

setWaitOnAllEvents

protected void setWaitOnAllEvents(boolean waitOnAllEvents)
Nastavuje, zda se ma cekat na aktivaci vsech eventu u witForMultipleObject. Toto je volano pouze ze systemoveho volani.

Parameters:
waitOnAllEvents - ma se cekat na akticvaci vsdech eventu u waitForMultipleObject?

getPC

protected int getPC()
Vraci aktualni cislo instrukce ve stepu.

Returns:
cislo instrukce