Format data YAML

Apa YAML digunakake?

Format data teks liyane yaiku YAML ( Yet Another Markup Language ; mengko, YAML Ain't Markup Language ). Iki digunakake kanggo serialize obyek kanggo transmisi liwat jaringan (kaya XML lan JSON digunakake cara iki). Amarga bisa diwaca manungsa, uga digunakake kanggo nulis file konfigurasi, contone, kanggo Docker, Kubernetes, Ansible, lsp. Nalika YAML kudu disimpen ing file (contone, file konfigurasi), kita nggunakake salah siji saka loro. ekstensi: .yaml utawa .yml.

Sintaksis basa

Ing XML, kurung sudut ( <> ) digunakake kanggo nemtokake tag. Ing JSON, kita nggunakake kurung kriting ( {} ). YAML nggunakake garis anyar lan indentasi.

Data kasebut disimpen minangka pasangan kunci-nilai, ing ngendi kunci kasebut minangka senar, lan nilai kasebut bisa macem-macem jinis data (string, nomer, bener / salah, array, lsp.). Tombol ditulis tanpa tanda petik.

Ayo goleki carane informasi disimpen ing YAML:

int number = 5

double number = 4.3

boolean valid = false

String city = "New York"

String line = "aaa\nbbb"

// comment

public class Person {
  String name = "Dennis";
  int age = 32;
}

var ages =
    List.of(1, 3, 5, 9, 78, -5);

class Person {
    String name;
    int age;

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }
}
…
List<Person> people = List.of(
        new Person("Ian", 21),
        new Person("Marina", 25),
        new Person("Owen", 73)      );

Kaya ing Jawa, unsur dhaptar bisa dadi dhaptar, yaiku, obyek bisa dipasang ing siji liyane. Tanda hubung sing nuduhake unsur sabanjure dhaptar bisa diimbangi sacara horisontal relatif marang tombol induk, utawa dumunung langsung ing ngisor. Sing utama yaiku kabeh unsur duwe format sing padha. Iki bakal mbantu ngindhari kebingungan lan hierarki nesting sing ambigu.

Ana rong nuansa liyane nalika nggarap nilai teks:

1. Teks multiline. Kita bisa nyimpen teks kaya iki:

   multilineTeks: "baris 1\nbaris 2\n....baris n"

   Nanging bakal banget ora nyenengake kanggo nyoba maca. Dadi ana | simbol (pipe), sing bisa digunakake kanggo nulis teks kanthi beda:

   multilineTeks: |
    larik 1
    larik 2
    ....
    larik n

   Sampeyan bakal setuju yen pilihan kapindho luwih trep, ta?

2. Garis dawa. Yen sampeyan pengin tetep teks ing siji baris nanging uga pengin pas ing ruang kerja IDE kang katon, sampeyan bisa nggunakake > (luwih saka) simbol.

   singlelineText: >
    miwiti
    ...
    terus baris padha
    ...
    pungkasan

   Kabeh teks bakal dianggep minangka siji baris.

Yen sampeyan kudu nulis sawetara struktur data YAML dadi siji file, sampeyan kudu misahake karo --- (telung tanda hubung). Ing laku, ana arang perlu kanggo iki, nanging paling apik kanggo ngerti kamungkinan iki.

Tuladha dokumen YAML

Ayo nggawe sawetara struktur data Jawa (kelas) lan obyek sing cocog, lan nyoba kanggo makili obyek minangka YAML.

class Family {
   private Date weddingDate;
   private Person wife;
   private Person husband;
   private List<Person> children;

   // Getters and setters are omitted
}

class Person {
   private final String name;
   private final boolean isWoman;
   private int age;

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

// Getters and setters are omitted

}

public static void main(String[] args) {
   Person wife = new Person("Ann", 37, true);
   Person husband = new Person("Alex", 40, false);
   var children = List.of(
           new Person("Iris", 12, true),
           new Person("Olivia", 5, true)
   );
   Date weddingDate = new Date(/* some long */);

   Family family = new Family();
   family.setWeddingDate(weddingDate);
   family.setWife(wife);
   family.setHusband(husband);
   family.setChildren(children);
}

Perwakilan sing sah ing YAML: