JSON 파일을 작성 해볼까?!

 

 

 

JSON(JavaScript Object Notation)은 데이터를 저장하거나 교환하기 위해

사용하는 가볍고 읽기 쉬운 형식이다.

특히 웹 개발에서 API 데이터 송수신에 자주 쓰인다.

어찌 보면 쉽고, 간단하지만 놓칠 수 있는 부분까지 작성해보려 한다!

 

 

 

 

 

 

 

1. JSON이란 뭘까?

 

 

JSON은 사람이 읽기 쉽고, 컴퓨터도 해석하기 쉬운 텍스트 기반 데이터 형식이다.

자바스크립트에서 객체를 작성하는 방식과 거의 똑같아서 배우기도 쉽고 작성도 간단하다.

특히 XML보다 간결하고, 읽기 쉽다는 장점 때문에 최근 더욱 인기가 높아졌다.

 

 

 

 

2. JSON의 기본 문법

 

 

JSON 파일을 작성할 때는 몇 가지 규칙만 알면 된다.

 

• 데이터는 키(key)와 값(value)이 한 쌍으로 구성된다.
• 키는 항상 따옴표(" ")로 묶어준다.
• 각 키와 값은 콜론(:)으로 연결한다.
• 데이터 항목끼리는 쉼표(,)로 구분한다.
• 전체 데이터는 중괄호({})로 묶는다.

 

 

예를 들면 다음과 같다.

{
  "name": "홍길동",
  "age": 30,
  "isDeveloper": true,
  "skills": ["JavaScript", "Python", "React"]
}

 

 

 

 

 

 

 

 

 

3. JSON 데이터 타입

 

JSON에서 사용할 수 있는 데이터 타입은 몇 가지로 제한되어 있다.

 

 

• 문자열(String): 텍스트 데이터를 큰따옴표로 묶는다.
• 숫자(Number): 정수, 실수 모두 가능하다.
• 불리언(Boolean): 참(true) 또는 거짓(false)을 나타낸다.
• 배열(Array): 여러 개의 데이터를 대괄호([]) 안에 나열한다.
• 객체(Object): 중괄호({})로 키와 값을 쌍으로 표현한다.
• 널(null): 값이 없음을 나타낸다.

 

 

 

 

 

4. JSON을 언제 사용하면 좋을까?

 

 

• 서버와 클라이언트 간 데이터 송수신을 할 때
• 설정 파일을 간단히 저장하고 읽고 싶을 때
• 여러 언어 간 데이터를 쉽게 공유하고자 할 때
• 데이터베이스에서 데이터를 주고받을 때
• 프로젝트 간 설정을 관리하고 공유할 때

 

 

특히 API를 사용할 때 JSON이 주된 포맷이며, REST API는 JSON을 가장 많이 사용한다.

 

 

 

 

5. JSON 작성할 때 자주 나는 오류!

 

 

• JSON에서는 주석을 달 수 없다. (정말 필요하다면 다른 방법으로 주석을 기록해야 한다.)
• 마지막 데이터 항목 뒤에는 쉼표(,)를 붙이면 안 된다. (이거 은근 자주 실수하는 부분!)
• 문자열은 반드시 큰따옴표("")를 사용해야 한다.

 

 

잘못된 예시:

{
  name: '홍길동',  // 키에 따옴표가 없음
  "age": 30,
}

올바른 예시:

{
  "name": "홍길동",
  "age": 30
}

 

 

 

 

6. JSON을 쉽게 작성하고 검증할 수 있는 도구

 

JSON을 작성하고 문법이 올바른지 바로 확인할 수 있는 편리한 웹사이트들도 있다.

대표적으로:

• JSONLint
• JSON Formatter
• JSON Editor Online

이런 사이트에서 JSON을 붙여 넣으면 잘못된 부분을

즉시 알려줘서 편리하다. 특히 JSON Editor Online은

실시간으로 수정 및 확인이 가능해서 더욱 좋다.

 

또한, visual studio code Extention에서도 여러 도구들을 찾아볼 수 있다!

 

 

 

7. JSON 활용 예시

 

 

 

JSON은 다양한 상황에서 쓰인다.

위에서 언급했던 대표적인 예시 API를 사용할 때,

REST API에서 사용자 정보를 요청했을 때 응답받는 JSON 예시:

{
  "user": {
    "id": 101,
    "name": "김개발",
    "email": "developer@example.com",
    "roles": ["admin", "editor"],
    "preferences": {
      "notifications": true,
      "theme": "dark"
    }
  }
}

이렇게 명확하고 간단한 구조로 인해 JSON은 데이터를 전달하고 관리하기에 매우 유용하다.

 

 

정리하며

 

 

JSON은 개발을 편하게 또는 여러 데이터들을 정리할 때 필수적인 데이터 형식이다.

간단한 규칙만 기억하면 어렵지 않게 사용할 수 있다.

이렇게 여러 가지를 정리해 놓고 헷갈릴 때마다 봐야겠다!