pourquoi --- (3 tirets/hyphen) dans le fichier yaml ?

Question

J'ai donc commencé à utiliser YAML au lieu de application.properties car il est plus lisible. Je vois en YAML les fichiers commencent par --- . J'ai cherché sur Google et j'ai trouvé l'explication ci-dessous.

YAML utilise trois tirets ("---") pour séparer les directives des documents. du document. Cela permet également de signaler l'existence de l'option n'est présent.

J'ai également essayé un échantillon sans --- et a compris qu'il n'est pas obligatoire de les avoir.

Je pense que je n'ai pas une compréhension claire de ce qui suit directive y document . Quelqu'un peut-il m'expliquer à l'aide d'un exemple simple ?

Answer 1

Comme vous l'avez déjà constaté, les trois tirets --- sont utilisés pour signale le début d'un document , c'est-à-dire :

1. Pour signaler le début du document après les directives , c'est-à-dire, %YAML o %TAG conformément à la spécification actuelle. Par exemple :

   %YAML 1.2
   %TAG !foo! !foo-types/
   ---
   myKey: myValue

2. Pour signaler le début du document lorsque vous avez plusieurs documents yaml dans le même flux par exemple, un fichier yaml :

   doc 1
   ---
   doc 2

   Si le document 2 est précédé de directives, nous devons utiliser trois points. ... pour indiquer la fin du doc 1 (et le début des directives potentielles précédant le doc 2) à l'analyseur. Par exemple :

   doc 1
   ...
   %TAG !bar! !bar-types/
   ---
   doc 2

La spécification est bonne pour les implémenteurs de parseurs yaml. Cependant, je trouve que cet article plus facile à lire du point de vue de l'utilisateur.

Answer 2

Il n'est pas obligatoire de les avoir si vous ne commencez pas votre formation. YAML avec une directive. Si c'est le cas, vous devez les utiliser.

Jetons un coup d'œil à la documentation

3.2.3.4. Directives

Chaque document peut être associé à un ensemble de directives. Une directive a un nom et une séquence optionnelle de paramètres. Les directives sont des instructions au processus YAML. comme tous les autres détails de présentation, ne sont pas reflétés dans l'arbre de sérialisation YAML ou le graphe de représentation . Cette version de YAML définit deux directives, "YAML" et "TAG". Toutes les autres directives sont réservées aux futures versions de YAML.

En voici un exemple dans la documentation pour la directive YAML

%YAML 1.2 # Attempt parsing
           # with a warning
---
"foo"