HOWTO · Java
Classe interne et classe imbriquée statique en Java
En programmation informatique, une classe est un modèle qui nous permet de créer des objets de classe individuels pour accéder aux données des membres de données ou des fonctions membres. En programmation Java, une classe est définie avec le mot clé class. Nous pouvons également dire qu'une classe est un type de données défini par l'utilisateur avec des modifications personnalisées.
Sur cette page
Une classe imbriquée est déclarée à l’intérieur d’une autre classe. Java prend en charge les classes imbriquées static et les classes imbriquées non-static (classes internes). Utilisez une classe imbriquée static lorsque le type est conceptuellement lié à sa classe englobante, sans avoir besoin d’un objet de cette classe. Le mot-clé static décrit cette relation ; il ne transforme pas le type imbriqué en classe de premier niveau et ne constitue pas une frontière de sécurité.
Classes imbriquées statiques en Java
Une classe imbriquée static est un type membre déclaré dans une autre classe à l’aide du mot-clé static. On peut la désigner en utilisant le nom du type englobant, par exemple Envelope.Label, et l’instancier sans créer au préalable un objet Envelope. Cette organisation est utile lorsqu’une classe utilitaire ou un type valeur est étroitement associé à une classe et n’a pas de sens comme type de premier niveau indépendant.
Le type imbriqué possède toujours ses propres instances. Déclarer la classe imbriquée static ne rend pas ses champs ni ses méthodes static. Vous pouvez lui donner ses propres constructeurs, son état d’instance et ses méthodes, comme vous le feriez pour une classe de premier niveau.
Relation entre les classes imbriquées statiques et leur classe englobante
Une classe imbriquée static ne possède aucune référence implicite vers une instance de la classe englobante. Elle peut accéder directement aux membres static de cette classe, y compris à ses membres privés static. En revanche, elle ne peut pas utiliser directement un champ ou une méthode d’instance de la classe englobante, puisqu’aucun objet englobant ne lui est associé. Si elle a besoin de ces données, transmettez un objet englobant à un constructeur ou à une méthode, puis accédez au membre par cette référence.
La relation d’accès fonctionne aussi dans l’autre sens : le code de la classe englobante peut utiliser la classe imbriquée, y compris ses membres privés, sous réserve des règles d’accès habituelles de Java. La visibilité privée détermine quel code peut nommer un membre ; elle ne doit pas être présentée comme une fonctionnalité de sécurité.
Déclarer et instancier une classe imbriquée statique
Déclarez le type dans le corps de la classe englobante avec static class Label. Depuis l’extérieur de cette classe, désignez-le par Envelope.Label. L’exemple complet ci-dessous regroupe le type valeur imbriqué avec la classe qui l’utilise et le crée directement depuis main :
Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
public class Main {
static class Label {
private final String text;
Label(String text) {
this.text = text;
}
String display() {
return "Label: " + text;
}
}
public static void main(String[] args) {
Label label = new Label("priority");
System.out.println(label.display());
}
}
Label: priority
Comme main est une méthode static, elle crée Label sans construire Main. Le code d’une autre classe peut utiliser le nom qualifié Main.Label et appeler un constructeur accessible. Si une classe imbriquée a besoin d’informations provenant d’un objet englobant particulier, rendez cette dépendance explicite en lui transmettant cet objet.
Classes imbriquées statiques et classes internes : comparaison
Une classe interne est une classe membre non-static. Chaque objet de classe interne est associé à une instance de sa classe englobante, et son code peut faire directement référence aux membres de cette instance. Pour en créer une depuis l’extérieur de la classe englobante, créez d’abord l’objet externe, puis utilisez la forme outer.new Inner() ; le type interne se désigne par Outer.Inner.
Une classe imbriquée static n’a pas cette association ; sa création ne nécessite donc pas d’objet englobant. Depuis l’extérieur, utilisez new Outer.Nested(), ou le nom court lorsque le type est dans la portée. Selon l’API prévue, les deux formes peuvent être privées ou publiques, et toutes deux peuvent accéder aux membres privés de la classe englobante. La différence tient à la relation implicite avec une instance englobante, et non à un niveau de sécurité particulier.
Quand utiliser une classe imbriquée statique
Choisissez une classe imbriquée static lorsque le type fait logiquement partie de sa classe englobante, mais que chaque instance peut fonctionner sans objet englobant implicite. Parmi les cas courants : un petit type valeur, un générateur d’objets (builder) ou une classe utilitaire dont le sens est propre à une API englobante. Une classe imbriquée static peut toujours recevoir explicitement ses dépendances, ce qui les rend visibles pour les appelants.
Choisissez une classe interne lorsque chaque instance doit fonctionner avec l’objet englobant particulier qui l’a créée, par exemple si elle doit lire ou modifier l’état d’instance de cet objet. Si le type a un rôle général et indépendant, une classe de premier niveau peut être plus facile à réutiliser et à trouver. Fondez votre choix sur la relation requise par le code, puis choisissez la visibilité la moins large qui convient à l’usage prévu.