SAÉ - Développement IHM

Quelques commentaires sur la façon de remplir les squelettes :

• La classe GameElement contient un attribut int type, qui permet de catégoriser les éléments. Cette catégorisation va permettre de différencier plus facilement les éléments lorsqu'une méthode retourne une liste de GameElement.
• Attribuer un type à un élément se fait automatiquement pour les classes existantes de boardifier-console.
• Pour celles créés par le développeur, le constructeur doit obligatoirement enregistrer un nouveau type dans ElementTypes, grâce à la méthode register().
• Cette méthode prend en paramètre un nom et une valeur entière. Par convention (et pour ne pas écraser celles qui sont déjà définies par boardifier-console), les valeurs doivent être >=50.
• On peut ensuite utiliser ce nom et la méthode ElementTypes.getType() pour fixer le type de l'élément. 
• Quand on crée soit même des sous-classes de GameElement, il faut qu'elles contiennent tous les attributs nécessaires à la gestion de l'état de l'élément.
• Par exemple, aux dames, un pion peut devenir une reine. Il faut donc définir un attribut booléen qui indique si le pion est normal ou bien une reine et des méthodes permettant de manipuler cet attribut.
• Dans le cas de "The Hole", un pion a un numéro, qui doit donc être définit comme attribut.
• Pour certains jeux, un changement des valeurs de ces attributs d'état doit provoquer un changement de rendu visuel de l' élément (= son "look" dans la suite). Par exemple, un pion qui devient reine doit changer d'aspect visuel.
• Dans ce cas, les méthodes qui manipulent les attributs d'état DOIVENT appeler la méthode addChangeFaceEvent() afin de signaler à la partie vue qu'il faudra mettre à jour le look de l'élément. Sans cet appel explicite, on ne constaterait aucun changement visuel à l'écran.

• Quand un stage commence, la "machinerie" de boardifier-console va automatiquement créer une instance du stage (donc de HoleStageModel) grâce à son nom.
• Ensuite, elle appelle la méthode getDefaultFactory() de cette instance. Le rôle de cette fonction est de retourner une instance de la classe qui crée les éléments du stage.
• C'est pourquoi dans le cas présent, le code de getDefaultFactory() retourne une instance de HoleStageFactory.
• Enfin, la machinerie appelle la fonction setup() de cette instance.

• la classe HoleStageFactory contient un attribut stageModel, qui a la même valeur que la paramètre gameStageModel, mais dont on force le type comme étant celui de HoleStageModel.
• Cette manipulation est juste un tour de passe-passe pour éviter plein de transtypages dans la méthode setup(), lorsque l'on voudra accéder aux attributs/méthodes de la classe HoleStageModel.

 Pour la classe Pawn :

• Comme dit plus haut, il suffit d'enregistrer un type pour les pions, par exemple avec la valeur 50, puis d'initialiser les attributs int color et int number.
• A noter qu'il n'y a pas besoin de méthode pour changer la valeurs de ces 2 attributs puisque les pions ne changent jamais d'état. Dans "The Hole", la classe Pawn n'a donc jamais besoin d'appeler addChangeEvent().

    public void setBoard(HoleBoard board) {
        this.board = board;
        addContainer(board);
    }
    public void setBlackPawns(Pawn[] blackPawns) {
        this.blackPawns = blackPawns;
        for(int i=0;i<blackPawns.length;i++) {
            addElement(blackPawns[i]);
        }
    }

    private void setupCallbacks() { 
        onPutInContainer( (element, containerDest, rowDest, colDest) -> {
            if (containerDest != board) return; // if not put in board, do nothing
            Pawn p = (Pawn) element;
            if (p.getColor() == 0) {
                blackPawnsToPlay--;
            }
            else {
                redPawnsToPlay--;
            }
            if ((blackPawnsToPlay == 0) && (redPawnsToPlay == 0)) {
                computePartyResult();
            }
        });
    }

    private void computePartyResult() {
        int idWinner = -1;
        // compute winner
        // ... to fulfill
        
        // set the winner
        model.setIdWinner(idWinner);
        // stop de the stage
        model.stopStage();
    }

    public void setup() {
        // create the text , top-left char is in (0,0)
        TextElement text = new TextElement(stageModel.getCurrentPlayerName(), stageModel);
        text.setLocation(0,0);
        stageModel.setPlayerName(text);
        // create the board, top-left char is in (0,1)
        stageModel.setBoard(new HoleBoard(0, 1, stageModel));
        //create the black pot, top-left char is in (18,0)
        HolePawnPot blackPot = new HolePawnPot(18,0, stageModel);
        stageModel.setBlackPot(blackPot);
        // create the black pawns
        Pawn[] blackPawns = new Pawn[4];
        for(int i=0;i<4;i++) {
            blackPawns[i] = new Pawn(i + 1, Pawn.PAWN_BLACK, stageModel);
        }
        stageModel.setBlackPawns(blackPawns);
        // assign black pawns to their pot
        for (int i=0;i<4;i++) {
            blackPot.addElement(blackPawns[i], i,0);
        }

        // to fulfill for the red pot in (25,0), and red pawns 
        // ...
    }