Ampliació del projecte de personatges

Abans d’afegir funcionalitats, cal entendre bé què us proporciona ja el projecte anterior i què hi falta encara.

El projecte inclou classes com Personatge, les seves subclasses i la lògica necessària per treballar amb equips. Ara heu de dissenyar i implementar una nova classe anomenada Academia, que actuarà com a repositori general de personatges.

• Ja implementat: models principals, subclasses i projecte base anterior.
• Pendent d’implementar: la classe Academia i les funcionalitats de repositori sobre la col·lecció de personatges.

Tasques d’anàlisi

1. Quines classes formen part del projecte i quina funció té cadascuna?
2. Quina diferència hi ha entre un Equip i una Academia dins del sistema?
3. Quines funcionalitats ja estan resoltes al projecte anterior i quines encara no?
4. Per què té sentit que l’Academia sigui el repositori de tots els personatges disponibles?

En aquesta fase heu d’incorporar la nova peça principal de l’activitat: la classe Academia.

L’Academia representarà el repositori general de personatges disponibles per preparar equips o fer consultes globals sobre tots els aventurers registrats.

• Atributs suggerits: nom i ArrayList<Personatge> personatges.
• Mètodes mínims: constructor, afegirPersonatge(...) i mostrarPersonatges().
• Objectiu: disposar d’una estructura central sobre la qual implementareu la resta de funcionalitats.

Ara començareu a ampliar l’Academia amb funcionalitats útils sobre la col·lecció de personatges.

Fase 3: Cerques

Implementeu mètodes que permetin localitzar personatges dins del sistema.

• Propostes: buscarPerNom(String nom), existeixPersonatge(String nom)
• Objectiu: retornar un personatge concret o indicar si el sistema el conté.

Fase 4: Filtres

Implementeu mètodes que retornin subconjunts de la col·lecció segons una condició.

• Propostes: obtenirPersonatgesVius(), filtrarPerNivellMinim(int nivell), filtrarPerTipus(String tipus)
• Objectiu: practicar recorreguts, condicions i creació de noves llistes.

Aquesta fase se centra a obtenir informació global a partir del conjunt de personatges disponibles a l’Academia.

• Propostes: calcularVidaMitjana(), obtenirPersonatgeMesNivell(), comptarPerTipus()
• Objectiu: acumular valors, comparar elements i resumir la informació de la col·lecció.

Ara fareu que l’Academia pugui mostrar els personatges en diferents ordres segons el criteri que interessi.

• Propostes: ordenar per nom, per nivell o per vida.
• Consell: si voleu flexibilitat, podeu utilitzar Comparator per definir criteris d’ordenació diferents.
• Exemple: personatges.sort(Comparator.comparing(Personatge::getNom));

Un cop funcionin les operacions de consulta, podeu incorporar accions que modifiquin l’estat del sistema dins de l’Academia.

Implementeu una o més funcionalitats d’aquest tipus:

1. entrenarPersonatge(String nom) per augmentar-li el nivell.
2. curarTotsElsPersonatges(int quantitat) per recuperar punts de vida.
3. eliminarPersonatge(String nom) per treure’l del repositori.

Exemple de sortida esperada

Personatge trobat: Lira (Arquer) - nivell 6
Personatges vius: 5
Vida mitjana del grup: 84.2

S'ha entrenat Thorin. Nou nivell: 8
Llistat de l'Academia ordenat per nivell:
Merlina - 9
Thorin - 8
Lira - 6

En aquesta fase heu de demostrar que les funcionalitats noves funcionen correctament amb dades de prova.

1. Carregueu diversos personatges de tipus diferents.
2. Executeu almenys una cerca i un filtre.
3. Mostreu una estadística general de l’Academia.
4. Proveu una ordenació.
5. Si voleu, creeu un Equip a partir de personatges seleccionats de l’Academia.

Quan el programa funcioni, respon aquestes preguntes per justificar les decisions de disseny que has pres.

1. Quin avantatge té rebre un projecte base ja implementat en lloc de començar-lo completament des de zero?
2. Per què les operacions de cerca, filtre i ordenació tenen sentit dins la classe Academia?
3. Quina relació hi ha entre l’Academia i l’Equip dins d’aquest nou plantejament?
4. Quines parts del projecte anterior s’han pogut reutilitzar sense modificar-les?

Aquest bloc us pot servir de suport quan arribeu a la part d’ordenació o quan vulgueu entendre millor algunes decisions de disseny.

Què és una interfície?

Una interfície en Java és un contracte: defineix mètodes que una classe es compromet a implementar. No serveix per guardar estat com una classe normal, sinó per indicar quin comportament ofereix.

public interface OrdenablePerNivell {
    void ordenarPerNivell();
}

Quan una classe implementa una interfície, ho indiquem amb la paraula clau implements.

public class Academia implements OrdenablePerNivell {
    @Override
    public void ordenarPerNivell() {
        // implementacio del metode
    }
}

Comparable i Comparator

Comparable s’utilitza quan una classe té un ordre natural. Per exemple, si decidim que els personatges s’han d’ordenar per nom de manera predeterminada.

public class Personatge implements Comparable<Personatge> {
    @Override
    public int compareTo(Personatge altre) {
        return this.getNom().compareTo(altre.getNom());
    }
}

Comparator, en canvi, s’utilitza quan volem diferents criteris d’ordenació sense modificar la classe. És especialment útil en aquesta activitat, perquè l’Academia pot necessitar ordenar per nom, per nivell o per vida segons el cas.

personatges.sort(Comparator.comparing(Personatge::getNom));

personatges.sort(
    Comparator.comparingInt(Personatge::getNivell).reversed()
);

Idea clau: si només voleu un criteri fix, Comparable pot tenir sentit. Si voleu flexibilitat i diversos criteris, normalment us interessarà més Comparator.