11. Um novo tipo de dados, cliente de Jogador

Neste capítulo construiremos programas que trabalham com jogos e jogadores de modo a ilustrar a utilização de uma coleção de objetos.

Se quisermos fazer um programa que ponha vários jogadores a jogarem até que um deles alcance uma dada pontuação, por exemplo, podemos sempre criar uma classe com um main que declare e crie um array de objetos do tipo Jogador e que use esses objetos para ir registando pontuações e verificando se o jogo deve acabar.

Podemos adotar outra abordagem mais estruturada e criar um tipo de dados, a que podemos chamar Jogo, que esconde (encapsula) a forma como o conjunto de jogadores é representado e permitisse operações sobre as suas instâncias como, por exemplo, registar jogadores, dar início ao jogo, registar pontuações para os jogadores, verificar se já terminou, determinar o(s) vencedor(es), etc..

Depois de criada essa classe, se bem documentada, poder-se-ia gerar a documentação da sua API (Application Programming Interface). Por exemplo:

A partir do momento em que a classe Jogo estivesse criada e disponível, poderíamos criar uma outra classe que declarasse uma variável do tipo Jogo, construísse um objeto desse tipo e usasse esse objeto para simular a execução de um jogo em que as pontuações para os vários jogadores seriam geradas através de um objeto do tipo Random, como é feito na classe seguinte.

​x
import java.util.Random;
​
public class PossivelClienteDeJogo {
​
    public static void main (String [] args) {
​
       Jogo meuJogo = new Jogo(30); 
       System.out.println("O objetivo eh " + meuJogo.pontuacaoObjetivo()); 
       String[] participantes = {"Maria","Pedro","Rui","Margarida"};
       for (int i = 0 ; i < participantes.length ; i++) {
           meuJogo.juntarJogador(participantes[i]); 
       }
       
       Random gerador = new Random();
       int max = Jogo.MAX_PONTUACAO_JOGADA;
       int min = Jogo.MIN_PONTUACAO_JOGADA;
​
       // O jogo eh jogado em rondas. 
       // Em cada ronda jogam todos os jogadores.
       while(!meuJogo.terminou()) {            
 
            for (int j = 0 ; j < participantes.length ; j++) {
                  // gera um valor no intervalo [min,max]
                  int pontuacao = gerador.nextInt(max - min + 1) + min;
                  // regista a pontuacao do proximo jogador
                  meuJogo.registarPontosJogada(participantes[j], pontuacao);
                  
                  System.out.println(participantes[j] + " ganhou mais " + 
                                     pontuacao + " pontos");
             }                 
       }
       
       System.out.println("===========================================");
       System.out.println(meuJogo.toString());
       System.out.println("Media dos maximos numa soh jogada: " + 
                          meuJogo.mediaMaximosNumaJogada());
       System.out.println("===========================================");
       String[] vencedores = meuJogo.vencedores();
       for (int i = 0 ; i < vencedores.length ; i++) {
               System.out.println(vencedores[i] + " venceu com " + 
                              meuJogo.pontuacao(vencedores[i]) + " pontos");
       }
       System.out.println("===========================================");          
       System.out.println("Parabens aos vencedores!");
   }
}
​

Vamos então construir a classe Jogo nas secções seguintes.

Anterior: 10.9. A classe Jogador completa

Seguinte: 11.1. A classe Jogo