[Java] Encapsulation

Qu'est-ce que l'encapsulation?

• ** N'affichez rien qui ne soit pas lié à la fonction que vous souhaitez utiliser **
• ex: TV. Le circuit à l'intérieur est une boîte noire et seules les fonctions telles que l'alimentation et l'écran sont visibles par l'utilisateur.
• Évitez de toucher par inadvertance des pièces non pertinentes
• Cachez les fonctions internes pour réaliser les fonctions de la classe et n'affichez que les fonctions que vous souhaitez utiliser

Modificateur d'accès

• Gérer s'il faut montrer un membre spécifique
• ** Imposer une contrainte la plus forte possible pour répondre aux exigences **
• Fondamentalement, package privé à moins que vous n'ayez l'intention d'accéder depuis l'extérieur du package (Java 9 ou des modules ultérieurs remplissaient l'espace entre public / privé)
• ** public **: accessible depuis toutes les classes
• ** protected **: Seules la classe actuelle, la classe dérivée et la même classe de package sont accessibles.
• ** Aucun **: accessible uniquement à partir de la même classe de package que la classe actuelle
• ** privé **: accessible uniquement à partir de la classe actuelle

Autorisations de champ

• Publier les données de classe en externe dans les champs
• Les champs d'instance ne doivent pas être déclarés publics
• ** L'autorisation / interdiction de lecture / écriture ne peut pas être contrôlée **
• Les champs sont des variables de gestion de l'état des objets
• Je souhaite limiter les modifications même si j'obtiens la valeur
• Puisque le champ n'est qu'une variable, vous pouvez obtenir et modifier sa valeur en décidant d'y accéder avec un modificateur.
• ** Classe immuable **: Classe qui est fixée dans l'état interne et ne peut pas être modifiée au moment de l'instanciation
• ** Impossible de vérifier la validité de la valeur **
• ** Gauche et droite pour changer l'état interne **
• Tout le code qui fait référence au champ age affecte, par exemple lorsque le champ age est changé en double au lieu de int
• ** → Utilisez la méthode accesseur! ** **

//Mauvais exemple
public class Person {
  public String name;
  public int age;

  public Person(String name, int age) {
    this.name = name;
    this.age = age;
  }

  public String show(){
    return String.format("%s（%d ans)\n", this.name, this.age);
  }
}

Méthode d'accesseur

• Rendre l'état interne (= champ) de l'objet inaccessible directement de l'extérieur, et réaliser un mécanisme d'acquisition et de changement via une méthode.
• Le nom de la méthode Alixer est ** get / set + majuscule au début du champ **
• Puisqu'il s'agit d'une méthode, la gestion des exceptions est également possible (lancer une instruction, etc.)
• Le traitement de la valeur est possible au moment de l'acquisition
• Seul le getter / setter peut être préparé pour rendre le champ en lecture / écriture uniquement (lecture seule recommandée)

public class Person {
  //Le champ est privé
  private String name;
  private int age;

  //getter dans le champ de nom
  public String getName() {
    return this.name;
  }
  //setter de champ de nom
  public void setName(String name) {
    this.name = name;
  }
  //getter de champ d'âge
  public int getAge() {
    return this.age;
  }
  //régleur de champ d'âge
  public void setAge(int age) {
    if (age <= 0) {
      throw new IllegalArgumentException("Veuillez indiquer l'âge sous la forme d'un nombre positif.");
    }
    this.age = age;
  }

  public String show() {
    return String.format("%s（%ré).", getName(), getAge());
  }
}

public class AccessorBasic {

  public static void main(String[] args) {
    var p = new Person();
    p.setName("Ichiro");
    p.setAge(47);
    System.out.println(p.show()); //Je suis Ichiro (47 ans).
    p.setAge(-30);  //Erreur
  }
}

Classe immuable

• Une classe dont la valeur (champ) ne change pas du tout de l'endroit où l'objet a été créé pour la première fois (recommandé)

//Déclarez la classe elle-même définitive et ne l'étendez pas
public final class Person {
  //Toute finale privée (réaffectation interdite)
  private final String name;
  private final int age;

  //Initialiser le champ final privé dans le constructeur
  public Person(String name, int age) {
    this.name = name;
    this.age = age;
  }
  //Getter
  public String getName() {
    return this.name;
  }

  public int getAge() {
    return this.age;
  }
}

public class ImmutableBasic {
  public static void main(String[] args) {
    var p = new Person("Satoshi", 10);
    System.out.println(p.getName()); //Satoshi
  }
}

• Exemple de rupture d'immuabilité
• Affectation du type de référence ** ne transmet que la référence elle-même **
• Si vous modifiez la valeur transmise dans l'argument / valeur de retour réelle, le contenu affectera le champ.
• Par exception, le type String est immuable

import java.util.Date;

public final class Person {
  private final String name;
  private final int age;
  private final Date birth;

  public Person(String name, int age, Date birth) {
    this.name = name;
    this.age = age;
    this.birth = birth;
  }

  public String getName() {
    return this.name;
  }

  public int getAge() {
    return this.age;
  }
  
  public Date getBirth() {
    return this.birth;
  }
}

//Exemple de modification de la valeur transmise à l'instance ultérieurement
import java.util.Date;
public class Main {
  public static void main(String[] args) {
    var birth = new Date();
    var p = new Person("Satoshi", 10, birth);
    System.out.println(p.getBirth());  //Tue Nov 03 11:26:33 UTC 2020
    //Mettre à jour l'objet passé lors de l'instanciation
    birth.setDate(15);
    System.out.println(p.getBirth());  //Sun Nov 15 11:26:33 UTC 2020

//Exemple de modification de la valeur obtenue à partir de l'instance
//    var p = new Person("Satoshi", 10, new Date());
//    System.out.println(p.getBirth());  //Tue Nov 03 11:29:05 UTC 2020
//    var birth = p.getBirth();
//
//    birth.setDate(15);
//    System.out.println(p.getBirth());  //Sun Nov 15 11:29:05 UTC 2020
  }
}   

Comment empêcher l'immuabilité de se rompre

• ** Copie défensive lors du passage à l'argument / valeur de retour **
• Passez un objet dupliqué au lieu de passer l'objet tel quel
• ** Convertir en immuable lors du retour comme valeur de retour **
• Convertir un champ de type StringBuilder en type String en le passant à l'extérieur

//Naissance de l'argument constructeur,Obtenez la valeur d'horodatage du champ de naissance avec la méthode getTme et créez un nouvel objet
import java.util.Date;

public final class Person {
  private final String name;
  private final int age;
  private final Date birth;

  public Person(String name, int age, Date birth) {
    this.name = name;
    this.age = age;
    //Copie défensive
    this.birth = new Date(birth.getTime());
  }

  public String getName() {
    return this.name;
  }

  public int getAge() {
    return this.age;
  }

  public Date getBirth() {
    //Copie défensive
    return new Date(this.birth.getTime());
  }
}