Skip to content

Latest commit

 

History

History
158 lines (142 loc) · 4.17 KB

003-Structures.md

File metadata and controls

158 lines (142 loc) · 4.17 KB

한 파일에 여러 도큐먼트 정의하기

  • 하나의 파일에 여러 단위의 yaml 도큐먼트를 정의한다.
  • 하나의 도큐먼트는 데이터를 직렬화 할 수 있는 한 단위이다.
  • 하나의 yaml 파일에 여러 도큐먼트를 정의한다는 것은 직렬화의 단위가 되는 대상이 여럿이라는 의미이다.
  • 하나의 도큐먼트는 하나의 JSON으로 변환 가능하다.

---

  • 하나의 파일에서 여러 별도의 yaml 코드를 정의할 때, 각각의 yaml 코드 간의 구분을 위한 문법
  • yaml 코드의 시작 지점을 만든다.
---
  • 위 코드 다음의 yaml은 다음 --- 또는 ...이 나오기 전까지 하나의 yaml 코드 단위를 가진다.

예제

# Ranking of 1998 home runs
---
- Mark McGwire
- Sammy Sosa
- Ken Griffey

# Team ranking
---
- Chicago Cubs
- St Louis Cardinals

...

  • 하나의 파일에서 여러 별도의 yaml 코드를 정의할 때, 각각의 yaml 코드 간의 구분을 위한 문법
  • yaml 코드의 끝 지점을 만든다.

예제

---
time: 20:03:20
player: Sammy Sosa
action: strike (miss)
...
---
time: 20:03:47
player: Sammy Sosa
action: grand slam
...

주석

  • 주석은 #으로 사용할 수 있다.
  • 한 행에서 #이 나온 뒤의 문자열은 주석이 되어 무시된다.

예제

---
hr: # 1998 hr ranking
- Mark McGwire
- Sammy Sosa
# 1998 rbi ranking
rbi:
- Sammy Sosa
- Ken Griffey

---
hr:
- Mark McGwire
- Sammy Sosa
rbi:
- Sammy Sosa
- Ken Griffey
  • yaml 파일을 파싱하여 직렬화를 하게 되면 위 두 문서는 동일한 직렬화 데이터를 갖는다.

노드의 반복 (Repeated nodes), 참조

  • yaml의 한 단위의 자료의 형태를 Node라고 부르며 노드에는 스칼라, 시퀀스, 매핑으로 구성되어 있다.
  • 한 단위의 노드는 재사용할 수 있는 단위로 만들 수 있다.
  • 재사용하는 단위로 만들 때는 하나의 노드의 앞에 &명칭을 사용한다.
  • *명칭을 사용하면 재사용 단위로 지정한 노드를 사용할 수 있다.

예제

---
hr:
- Mark McGwire
# Following node labeled SS
- &SS Sammy Sosa
rbi:
- *SS # Subsequent occurrence
- Ken Griffey
  • - &SS Sammy Sosa에서 스칼라 형태의 Sammy Sosa를 재사용 단위로 지정하였다.
  • 이때, 재사용 대상의 명칭은 &SS이다.
  • &SS로 재사용할 노드를 불러오면 스칼라 데이터를 저장 했으므로 스칼라 값인 Sammy Sosa가 &SS 부분에 할당된다.

복잡한 매핑

  • 매핑은 키: 벨류 형태의 키-벨류 쌍을 단수 혹은 복수개의 행에 정의하는 방식으로 사용한다.
  • 복잡한 매핑은 키에 하나의 노드를 지정하고 벨류에 하나의 노드를 지정하는 방식으로 사용할 때를 복잡한 매핑이라고 한다.
  • 복잡한 키를 만들 때는 키에 해당하는 노드 앞에 ?를 붙여주고, 벨류에 해당하는 노드 앞에 :를 붙여준다.

예제

? - Detroit Tigers
  - Chicago cubs
: - 2001-07-23

  - Detroit Tigers
  - Chicago cubs
  • 키는 행두에 ?를 앞에 붙이는 것으로 정의하며 키에 해당하는 대상 노드는 시퀀스인 경우이다.
- 2001-07-23
  • 벨류는 행두에 :를 앞에 붙이는 것으로 정의하며 벨류에 해당하는 대상 노드는 시퀀스인 경우이다.
? [ New York Yankees,
    Atlanta Braves ]
: [ 2001-07-02, 2001-08-12,
    2001-08-14 ]

[ New York Yankees,
    Atlanta Braves ]
  • 키는 행두에 ?를 붙이는 것으로 정의하며 키에 해당하는 대상 노드가 시퀀스인 경우이다.
[ 2001-07-02, 2001-08-12,
    2001-08-14 ]
  • 벨류는 행두에 :을 붙이는 것으로 정의하며 벨류에 해당하는 대상 노드가 시퀀스인 경우이다.

간편(Compact) 중첩(nested) 매핑

---
# Products purchased
- item    : Super Hoop
  quantity: 1
- item    : Basketball
  quantity: 4
- item    : Big Shoes
  quantity: 1

  item    : Super Hoop
  quantity: 1

  item    : Basketball
  quantity: 4

  item    : Big Shoes
  quantity: 1
  • 위 세개의 맵이 시퀀스를 통해서 연결 된 형태이다.