Une petite histoire sur le nom du package de l'exemple de code à publier sur Qiit, etc. Il semble bon d'utiliser un exemple de domaine.
C'est assez familier, donc inutile de le dire, mais pour le moment. Il est courant que les noms de package Java soient précédés des noms de domaine dans l'ordre inverse pour éviter la duplication du FQCN. Dans La spécification du langage Java, ce qui suit est répertorié comme «Exemple 6.1-1. Noms de packages uniques». [^ jspec].
Exemple de nom de package
com.nighthacks.java.jag.scrabble
org.openjdk.tools.compiler
net.jcip.annotations
edu.cmu.cs.bovik.cheese
gov.whitehouse.socks.mousefinder
Cela dit, appliquer les règles ci-dessus à l'exemple de code semble un peu exagéré. J'ai brièvement résumé les conditions requises pour le nom du package dans l'exemple de code.
J'ai donc eu l'idée de détourner le domaine réservé. Les domaines réservés sont gérés par l'IANA [^ iana] et peuvent être librement utilisés dans des documents, etc. selon le but. Il y a quatre domaines de premier niveau (TLD) réservés.
TLD réservé | Utilisation |
---|---|
.test | Domaine de test |
.example | Domaine illustratif |
.localhost | Domaine pour l'adresse de bouclage |
.invalid | Domaine à indiquer invalide |
L'exemple et invalide n'est-il pas juste à utiliser dans le nom de package de l'exemple de code?
Exemple
package example
public class SampleClass {
// ...
}
Jusqu'à présent, nous avons utilisé com.example
[^ example-com] comme nom de paquet, mais à partir de maintenant, nous utiliserons ʻexample`. Vous pouvez réduire 4 caractères.
Recommended Posts