[java] SnakeYAML을 사용하여 YAML 파일의 문자 인코딩 처리하기

16 Nov 2023

java

YAML 파일은 텍스트 기반의 파일 형식으로 데이터를 저장하기 위해 사용됩니다. 그러나 때로는 YAML 파일의 문자 인코딩이 잘못되어 읽기가 어렵거나 예기치 않은 결과를 초래할 수 있습니다. Java에서는 SnakeYAML 라이브러리를 사용하여 이러한 문제를 해결할 수 있습니다. 이 블로그 포스트에서는 SnakeYAML을 사용하여 YAML 파일의 문자 인코딩을 처리하는 방법에 대해 설명합니다.

1. SnakeYAML 라이브러리 가져오기

먼저, SnakeYAML 라이브러리를 프로젝트에 가져와야 합니다. Maven을 사용하는 경우, pom.xml 파일에 다음 의존성을 추가하세요:

<dependencies>
    <dependency>
        <groupId>org.yaml</groupId>
        <artifactId>snakeyaml</artifactId>
        <version>1.27</version>
    </dependency>
</dependencies>

Gradle을 사용하는 경우, build.gradle 파일에 다음 종속성을 추가하세요:

dependencies {
    implementation 'org.yaml:snakeyaml:1.27'
}

2. YAML 파일의 문자 인코딩 설정하기

다음으로, YAML 파일의 문자 인코딩을 설정해야 합니다. SnakeYAML은 기본적으로 UTF-8 인코딩을 사용합니다. 따라서 UTF-8이 아닌 다른 문자 인코딩을 사용하는 경우, SnakeYAML에게 해당 인코딩을 알려주어야 합니다. 다음 코드는 YAML 파일을 로드할 때 문자 인코딩을 설정하는 예제입니다:

import org.yaml.snakeyaml.Yaml;
import org.yaml.snakeyaml.reader.UnicodeReader;

import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;

public class YamlReader {
    public static void main(String[] args) {
        try (InputStream input = new FileInputStream("config.yaml")) {
            InputStreamReader reader = new InputStreamReader(input, StandardCharsets.UTF_8);
            Yaml yaml = new Yaml(new UnicodeReader(reader));
            // YAML 파일을 읽는 코드 작성
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위 코드에서 config.yaml은 읽을 YAML 파일의 경로입니다. UnicodeReader 클래스는 문자 인코딩을 설정하기 위해 사용됩니다. 위 예제에서는 UTF-8 인코딩을 사용하고 있습니다.

3. YAML 파일 읽기

이제 SnakeYAML을 사용하여 YAML 파일을 읽을 수 있습니다. 아래 코드는 SnakeYAML을 사용하여 YAML 파일의 내용을 읽고 출력하는 간단한 예제입니다:

import org.yaml.snakeyaml.Yaml;
import org.yaml.snakeyaml.reader.UnicodeReader;

import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
import java.util.Map;

public class YamlReader {
    public static void main(String[] args) {
        try (InputStream input = new FileInputStream("config.yaml")) {
            InputStreamReader reader = new InputStreamReader(input, StandardCharsets.UTF_8);
            Yaml yaml = new Yaml(new UnicodeReader(reader));
            
            // YAML 파일 읽기
            Map<String, Object> data = yaml.load(reader);
            
            // 읽은 데이터 출력
            System.out.println(data);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

위 예제 코드를 실행하면 YAML 파일의 내용이 출력됩니다.

결론

이번 포스트에서는 Java의 SnakeYAML을 사용하여 YAML 파일의 문자 인코딩을 처리하는 방법에 대해 알아보았습니다. SnakeYAML을 사용하면 잘못된 문자 인코딩으로 인한 문제를 쉽게 해결할 수 있습니다. YAML 파일을 다루는 개발 작업에서 문자 인코딩에 주의하고 SnakeYAML을 활용해 보세요.