package abstrasy.pcfx;
import abstrasy.Interpreter;
import abstrasy.Node;
import abstrasy.PCoder;
import abstrasy.interpreter.InterpreterException;
import abstrasy.interpreter.SilentException;
import abstrasy.interpreter.StdErrors;
/**
* Abstrasy Interpreter
*
* Copyright : Copyright (c) 2006-2012, Luc Bruninx.
*
* Concédée sous licence EUPL, version 1.1 uniquement (la «Licence»).
*
* Vous ne pouvez utiliser la présente oeuvre que conformément à la Licence.
* Vous pouvez obtenir une copie de la Licence à l’adresse suivante:
*
* http://www.osor.eu/eupl
*
* Sauf obligation légale ou contractuelle écrite, le logiciel distribué sous
* la Licence est distribué "en l’état", SANS GARANTIES OU CONDITIONS QUELLES
* QU’ELLES SOIENT, expresses ou implicites.
*
* Consultez la Licence pour les autorisations et les restrictions
* linguistiques spécifiques relevant de la Licence.
*
*
* @author Luc Bruninx
* @version 1.0
*/
public class PCFx_suspend extends PCFx {
public PCFx_suspend() {
}
/**
* eval
*
* @param startAt Node
* @return Node
* @throws Exception
* @todo Implémenter cette méthode abstrasy.PCFx
*/
public Node eval(Node startAt) throws Exception {
/*
* (suspend) : Suspendre l'activité de l'acteur courant jusqu'à ce qu'il soit réveillé par
* un autre acteur (via l'opérateur (resume)).
*
* (suspend timed ms) : Suspendre l'activité de l'acteur courant jusqu'à ce qu'il soit réveillé par
* un autre ou que le temps imparti soit expiré.
*
* Si aucun signal de réveil n'est reçu avant la fin du délais, une exception
* du type "Time expired" est lancée
*
* Si le délai est égale à zéro, alors cette expression équivant à (suspend).
* Si le délai est plus petit que zéro, alors une exception "out of range" est
* déclenchée.
*
*/
startAt.isGoodArgsCnt(1,3);
Interpreter myself=Interpreter.mySelf();
/**
* Le programmeur devrait pouvoir utiliser tous les systèmes en même temps:
* =======================================================================
* - mutex permet de gérer l'exclusion mutuelle des processus.
* - lock, sync et share permettent de gérer l'exclusion mutuelle d'accès (éventuellement réentrant R/W)
* aux variables partages.
* - sleep, suspend, resume et kill l'activité d'un processus.
* - send, receive et postpone les échanges de messages entre processus.
*
* Chaque système dispose des ses propres caractéristiques. C'est au programmeur des les utiliser correctement
* (c-à-d, d'une façon raisonnable).
*
// dans une section critique ?...
if (myself.actor_ISMUTEX()) {
throw new InterpreterException(StdErrors.Illegal_operation_in_mutex_section);
}
*
*
// dans une section atomic ?
if(myself.actor_ISLOCKEDSECTION()){
throw new InterpreterException(StdErrors.Illegal_operation_in_critical_section);
}
*
*/
// récupération du délai d'attente maximum...
long timed=0;
if(startAt.size()==3){
startAt.requirePCode(1, PCoder.PC_TIMED);
timed=(long)Math.ceil(startAt.getSubNode(2, Node.TYPE_NUMBER).getNumber());
if(timed<0){
throw new InterpreterException(StdErrors.Out_of_range);
}
}
boolean timeout=false;
try {
if(timed>0){
timeout=Interpreter.getSemaphore().suspendAndWaitResume(timed);
}
else{
Interpreter.getSemaphore().suspendAndWaitResume();
}
}
catch (InterruptedException iex) {
Interpreter.Log("Interrupted... SEMAPHORE MSG");
throw new SilentException();
}
/*
* Si timeout, alors exception...
*/
if(timeout){
throw new InterpreterException(StdErrors.Timed_expired_exception);
}
return null;
}
}