Classes et responsabilités
Une classe regroupe des données et les fonctions qui les manipulent. Ce cours explique comment décider ce qui va dans une classe, et quoi faire quand elle a trop grossi.
Le problème
Dans le jeu, ButtonHandler dépasse 1 000 lignes et Map 650. Quand on cherche où se trouve une règle, on ne sait pas dans laquelle regarder, et la réponse est parfois « les deux ».
Map contient :
Python
Cinq sujets sans rapport, réunis parce qu'ils « concernent la carte ».
La notion : une seule responsabilité
Le principe s'énonce ainsi : une classe ne devrait avoir qu'une seule raison de changer.
On teste en posant la question : « pour quelles raisons vais-je devoir modifier cette classe ? »
Raison de modifier Map | Qui le demande |
|---|---|
| Changer la forme des continents | Celui qui règle la génération |
| Rendre le zoom plus fluide | Celui qui s'occupe du confort de jeu |
| Changer la couleur du brouillard | Celui qui fait le graphisme |
| Interdire les villes trop proches | Celui qui équilibre les règles |
Quatre raisons, quatre personnes différentes en théorie : quatre classes.
Reconnaître une classe trop grosse
| Signe | Dans le jeu |
|---|---|
| Plusieurs centaines de lignes | ButtonHandler, Map |
Le nom contient Handler, Manager, Utils | ButtonHandler, PlayerHandler, Saves_ |
| On décrit son rôle avec « et » | « Map génère la carte et gère la caméra et dessine » |
| Des groupes de méthodes n'utilisent pas les mêmes attributs | Les méthodes de caméra ne touchent jamais aux biomes |
| Beaucoup d'attributs | Map en a plus de vingt |
Le quatrième signe est le plus fiable. Si l'on peut tracer une frontière entre deux groupes de méthodes et d'attributs qui ne se parlent pas, ce sont deux classes.
Découper : la méthode
-
Lister les méthodes de la classe.
-
Les regrouper par sujet. Un mot par groupe.
-
Noter les attributs que chaque groupe utilise.
-
Extraire le groupe le plus indépendant dans une nouvelle classe. L'ancienne en garde une instance.
-
Vérifier que tout marche, faire un commit, recommencer.
Exemple avec la caméra :
Python
Python
Camera n'a besoin ni des cases ni des joueurs. On peut la tester seule.
Héritage ou composition
Deux façons de relier des classes.
| Héritage | Composition | |
|---|---|---|
| Se dit | « est un » | « possède un » |
| S'écrit | class Settler(Unit) | self. |
| Bon usage | Une vraie variante de la même chose | Assembler des pièces |
Quand l'héritage va bien
Python
Un colon est une unité. Tout ce qu'une unité sait faire, il le fait.
Quand l'héritage va mal
Python
Une ville n'est pas une unité : elle ne se déplace pas, n'attaque pas en bougeant. Elle hérite pourtant de move(), attack(), path_. Le projet contourne le problème en mettant son mouvement à 0, et a besoin d'une fonction pour distinguer les deux :
Python
Devoir écrire une fonction qui demande à un objet ce qu'il est vraiment est un signe que la hiérarchie ne correspond pas à la réalité.
Quand il ne faut pas de classe du tout
Farm ne contient rien de plus que Unit : seules ses statistiques diffèrent. Créer une classe par bâtiment oblige à écrire du code pour chaque ajout. Une table de données suffit :
Python
Règle pratique : une classe quand le comportement change, une donnée quand seuls les nombres changent.
Les dataclass : des classes de données sans effort
Pour une classe qui sert surtout à ranger des valeurs, Python fournit un raccourci :
Python
Python écrit __init__ à notre place, ainsi qu'un affichage lisible et la comparaison. On remplace ainsi les tuples lus par position, comme unit_data[2], par des noms : unit.hp.
À retenir
- Une classe, une raison de changer.
- Des groupes de méthodes qui ne partagent pas d'attributs sont des classes séparées.
- Héritage pour « est un », composition pour « possède un ».
- Si seuls les nombres changent, pas besoin d'une nouvelle classe.
Exercices
- Lister les méthodes de
Mapet les ranger en groupes. Combien en trouvez-vous ? - Extraire la classe
CameradeMap, sans changer le comportement du jeu. - Créer une classe
Building, faire hériterCityetFarm, et supprimerfind_en utilisantif_ is_ unit_ or_ building isinstance. - Transformer le tuple renvoyé par
Unit.enget_ unit_ data dataclass.