using System;
using System.IO; // 파일 입출력을 위한 네임스페이스
using System.Collections.Generic; // List<T>를 사용하기 위한 네임스페이스
using System.Text.Json; // JSON 직렬화 및 역직렬화를 위한 네임스페이스
// using System.Text.Json.Serialization;:
// 상태를 저장(직렬화/역직렬화)하고 싶지 않은 프로퍼티가 있다면,
// 직렬화/역직렬화 하지 않도록 [JsonIgnore] 애트리뷰트로 해당 프로퍼티 앞에서 수식하면 되는데,
// [JsonIgnore] 애트리뷰트를 사용하기 위해서 필요한 네임스페이스입니다.
/*
List를 비롯한 컬렉션들도 직렬화를 지원합니다.
예를 들어 List<NameCard> 형식의 객체도 직렬화를 통해 파일에 저장해뒀다가,
이를 역직렬화를 통해 메모리 내 컬렉션으로 불러들일 수 있습니다.
*/
namespace Serialization
{
class NameCard // NameCard 클래스 정의
{
public string Name { get; set; } // 이름을 저장할 Name 프로퍼티
public string Phone { get; set; } // 전화번호를 저장할 Phone 프로퍼티
public int Age { get; set; } // 나이를 저장할 Age 프로퍼티
}
class MainApp
{
static void Main(string[] args)
{
var fileName = "a.json"; // 파일 이름을 "a.json"으로 설정
using (Stream ws = new FileStream(fileName, FileMode.Create))
{
var list = new List<NameCard>(); // NameCard 객체를 저장할 List 생성
list.Add(new NameCard() { Name = "박상현", Phone = "010-123-4567", Age = 33 });
// NameCard 객체를 생성하고 list에 추가
list.Add(new NameCard() { Name = "김연아", Phone = "010-323-1111", Age = 22 });
// NameCard 객체를 생성하고 list에 추가
list.Add(new NameCard() { Name = "장미란", Phone = "010-555-5555", Age = 26 });
// NameCard 객체를 생성하고 list에 추가
string jsonString = JsonSerializer.Serialize<List<NameCard>>(list); // list 객체를 JSON 문자열로 '직렬화'
byte[] jsonBytes = System.Text.Encoding.UTF8.GetBytes(jsonString); // JSON 문자열을 UTF-8 인코딩으로 바이트 배열로 변환
ws.Write(jsonBytes, 0, jsonBytes.Length); // 바이트 배열을 파일에 씀
} // using 블록 종료 시 ws.Close() 자동 호출
using (Stream rs = new FileStream(fileName, FileMode.Open)) // "a.json" 파일을 읽기 모드로 염
{
byte[] jsonBytes = new byte[rs.Length]; // 파일에서 읽어온 데이터를 저장할 바이트 배열 jsonBytes 선언
rs.Read(jsonBytes, 0, jsonBytes.Length); // 파일에서 바이트 배열을 읽어옴
string jsonString = System.Text.Encoding.UTF8.GetString(jsonBytes); // 바이트 배열을 UTF-8 인코딩으로 문자열로 변환
var list2 = JsonSerializer.Deserialize<List<NameCard>>(jsonString); // JSON 문자열을 List<NameCard> 객체로 '역직렬화'
foreach (NameCard nc in list2) // list2의 각 NameCard 객체를 순회하며 출력
{
Console.WriteLine(
$"Name: {nc.Name}, Phone: {nc.Phone}, Age: {nc.Age}");
}
} // using 블록 종료 시 rs.Close() 자동 호출
}
}
}코드 설명
using System;
using System.IO; // 파일 입출력을 위한 네임스페이스
using System.Collections.Generic; // List<T>를 사용하기 위한 네임스페이스
using System.Text.Json; // JSON 직렬화 및 역직렬화를 위한 네임스페이스
namespace Serialization
{
class NameCard // NameCard 클래스 정의
{
public string Name { get; set; } // 이름을 저장할 Name 프로퍼티
public string Phone { get; set; } // 전화번호를 저장할 Phone 프로퍼티
public int Age { get; set; } // 나이를 저장할 Age 프로퍼티
}
class MainApp
{
static void Main(string[] args)
{
var fileName = "a.json"; // 파일 이름을 "a.json"으로 설정
using (Stream ws = new FileStream(fileName, FileMode.Create)) // "a.json" 파일을 쓰기 모드로 열거나 생성
{
var list = new List<NameCard>(); // NameCard 객체를 저장할 List 생성
list.Add(new NameCard() { Name = "박상현", Phone = "010-123-4567", Age = 33 }); // NameCard 객체를 생성하고 list에 추가
list.Add(new NameCard() { Name = "김연아", Phone = "010-323-1111", Age = 22 }); // NameCard 객체를 생성하고 list에 추가
list.Add(new NameCard() { Name = "장미란", Phone = "010-555-5555", Age = 26 }); // NameCard 객체를 생성하고 list에 추가
string jsonString = JsonSerializer.Serialize<List<NameCard>>(list); // list 객체를 JSON 문자열로 직렬화
byte[] jsonBytes = System.Text.Encoding.UTF8.GetBytes(jsonString); // JSON 문자열을 UTF-8 인코딩으로 바이트 배열로 변환
ws.Write(jsonBytes, 0, jsonBytes.Length); // 바이트 배열을 파일에 씀
} // using 블록 종료 시 ws.Close() 자동 호출
using (Stream rs = new FileStream(fileName, FileMode.Open)) // "a.json" 파일을 읽기 모드로 염
{
byte[] jsonBytes = new byte[rs.Length]; // 파일에서 읽어온 데이터를 저장할 바이트 배열 jsonBytes 선언
rs.Read(jsonBytes, 0, jsonBytes.Length); // 파일에서 바이트 배열을 읽어옴
string jsonString = System.Text.Encoding.UTF8.GetString(jsonBytes); // 바이트 배열을 UTF-8 인코딩으로 문자열로 변환
var list2 = JsonSerializer.Deserialize<List<NameCard>>(jsonString); // JSON 문자열을 List<NameCard> 객체로 역직렬화
foreach (NameCard nc in list2) // list2의 각 NameCard 객체를 순회하며 출력
{
Console.WriteLine(
$"Name: {nc.Name}, Phone: {nc.Phone}, Age: {nc.Age}");
}
} // using 블록 종료 시 rs.Close() 자동 호출
}
}
}코드 설명
이 C# 코드는 System.Text.Json 네임스페이스의 JsonSerializer 클래스를 사용하여 NameCard 객체의 리스트를 JSON 형식으로 파일에 쓰고 읽는 예제입니다.
NameCard클래스: 이름, 전화번호, 나이를 저장하는 프로퍼티를 가진 클래스입니다.Main메서드:var fileName = "a.json";: 파일 이름을 "a.json"으로 설정합니다.using (Stream ws = new FileStream(fileName, FileMode.Create)): "a.json" 파일을 쓰기 모드로 열거나 생성합니다.using문을 사용하면ws객체를 사용한 후 자동으로Close()메서드가 호출되어 파일이 닫힙니다.var list = new List<NameCard>();:NameCard객체를 저장할 리스트를 생성합니다.list.Add(new NameCard() { ... });:NameCard객체를 생성하고 리스트에 추가합니다.string jsonString = JsonSerializer.Serialize<List<NameCard>>(list);:NameCard객체 리스트를 JSON 문자열로 직렬화합니다.byte[] jsonBytes = System.Text.Encoding.UTF8.GetBytes(jsonString);: JSON 문자열을 UTF-8 인코딩으로 바이트 배열로 변환합니다.ws.Write(jsonBytes, 0, jsonBytes.Length);: 바이트 배열을 파일에 씁니다.using (Stream rs = new FileStream(fileName, FileMode.Open)): "a.json" 파일을 읽기 모드로 엽니다.byte[] jsonBytes = new byte[rs.Length];: 파일에서 읽어온 데이터를 저장할 바이트 배열jsonBytes를 선언합니다.rs.Read(jsonBytes, 0, jsonBytes.Length);: 파일에서 바이트 배열을 읽어옵니다.string jsonString = System.Text.Encoding.UTF8.GetString(jsonBytes);: 바이트 배열을 UTF-8 인코딩으로 문자열로 변환합니다.var list2 = JsonSerializer.Deserialize<List<NameCard>>(jsonString);: JSON 문자열을NameCard객체 리스트로 역직렬화합니다.foreach (NameCard nc in list2):list2의 각NameCard객체를 순회하며 출력합니다.
출력 결과
Name: 박상현, Phone: 010-123-4567, Age: 33
Name: 김연아, Phone: 010-323-1111, Age: 22
Name: 장미란, Phone: 010-555-5555, Age: 26byte[] jsonBytes = System.Text.Encoding.UTF8.GetBytes(jsonString)
// JSON 문자열을 UTF-8 인코딩으로 바이트 배열로 변환하는 이유?
System.Text.Encoding.UTF8.GetBytes(jsonString)는 JSON 문자열을 UTF-8 인코딩을 사용하여 바이트 배열로 변환하는 코드입니다.
왜 이렇게 변환해야 할까요?
- 파일 입출력: 파일 입출력은 기본적으로 바이트 단위로 이루어집니다. 즉, 파일에 문자열을 직접 쓸 수는 없고, 바이트 배열로 변환해야 합니다.
- 텍스트 인코딩: 문자열은 컴퓨터 내부적으로 숫자로 표현됩니다. 이때 어떤 숫자를 사용하여 어떤 문자를 표현할지 규칙이 필요한데, 이 규칙을 텍스트 인코딩이라고 합니다. 'UTF-8'은 유니코드 문자를 표현하기 위한 널리 사용되는 인코딩 방식입니다.
- 호환성: UTF-8은 다양한 언어와 문자를 지원하는 인코딩 방식이므로, 다른 시스템이나 프로그램에서 파일을 읽을 때 호환성 문제가 발생할 가능성이 적습니다.
요약하자면, 'JSON 문자열을 파일에 쓰기 위해서'는 바이트 배열로 변환해야 하고, UTF-8 인코딩을 사용하여 변환하면 다른 시스템이나 프로그램과의 호환성을 높일 수 있습니다.
