json export on Conholdate Blog https://blog-qa.conholdate.com/ko/tag/json-export/ Recent content in json export on Conholdate Blog Hugo -- gohugo.io ko Tue, 15 Sep 2026 20:32:21 +0000 Java에서 Excel을 JSON으로 변환 https://blog-qa.conholdate.com/ko/total/excel-to-json-conversion-in-java/ Tue, 15 Sep 2026 20:32:21 +0000 https://blog-qa.conholdate.com/ko/total/excel-to-json-conversion-in-java/ Conholdate.Total for Java SDK를 사용하여 Java에서 Excel을 JSON으로 변환하는 방법을 배웁니다. 단계별 설정, 코드 walkthrough 및 구성 팁을 따라보세요. Excel 스프레드시트를 JSON 으로 변환하는 것은 데이터 교환 파이프라인을 구축하거나 API에 데이터를 공급할 때 자주 요구됩니다. Conholdate.Total for Java 은 Java 개발자를 위해 이 작업을 간소화하는 강력한 SDK입니다. 이 가이드에서는 라이브러리를 설정하고, 전체 구현 과정을 살펴보며, 프로젝트 요구에 맞게 변환 옵션을 세밀하게 조정하는 방법을 배웁니다.

Conholdate.Total for Java에 대한 사전 요구 사항 및 설정

시작하기 전에, 다음이 있는지 확인하십시오:

  • Java 17 이상이 설치되어 있어야 합니다.
  • Maven 3.6+ 를 사용한 종속성 관리.
  • 변환하려는 Excel 파일 (.xlsx).

Conholdate.Total Maven 저장소와 종속성을 pom.xml에 추가하세요:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

당신은 최신 JAR 파일을 다운로드 페이지에서 직접 다운로드할 수 있습니다. SDK가 준비되면 Java에서 Excel을 JSON으로 변환을 시작할 준비가 된 것입니다.

Java에서 Excel을 JSON으로 변환: 단계별 안내

1단계: 원본 Excel 문서 로드

먼저, 소스 XLSX 파일의 경로를 지정하고 Conversion 인스턴스를 생성합니다. try‑with‑resources 블록은 변환 객체가 올바르게 해제되도록 보장합니다.

String inputFile = "sample.xlsx";
try (Conversion conversion = new Conversion(inputFile)) {
    // conversion object ready
}

2단계: JSON 변환 옵션 구성

JsonConvertOptions 객체를 생성하고 pretty‑print, 헤더 포함, 사용자 정의 날짜 및 숫자 형식, 배치 크기와 같은 설정을 조정합니다. 이러한 옵션은 Java에서 Excel을 JSON으로 변환하는 방식이 최종 출력에 어떻게 영향을 주는지 제어합니다.

JsonConvertOptions jsonOptions = new JsonConvertOptions();
jsonOptions.setPrettyPrint(true);
jsonOptions.setIncludeHeaders(true);
jsonOptions.setDateFormat(JsonConvertOptions.DateFormat.CUSTOM);
jsonOptions.setCustomDateFormat("yyyy-MM-dd");
jsonOptions.setNumberFormat(JsonConvertOptions.NumberFormat.CUSTOM);
jsonOptions.setCustomNumberFormat("#.##");
jsonOptions.setRowsPerBatch(5000);

3단계: 변환 실행

대상 JSON 파일 이름을 제공하고 convert 메서드를 호출하십시오. SDK는 변환을 내부적으로 처리합니다.

String outputFile = "sample.json";
conversion.convert(outputFile, jsonOptions);

4단계: 결과 처리 및 정리

변환 후 확인 메시지를 출력합니다. 모든 예외는 잡혀서 콘솔에 출력됩니다.

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
} catch (Exception e) {
    System.err.println("Error during Excel to JSON conversion:");
    e.printStackTrace();
}

이 단계들을 통해 Java에서 Excel을 JSON으로 변환하는 작업이 완료되었으며, 생성된 JSON을 API 또는 데이터 처리 워크플로에 통합할 수 있습니다.

전체 구현: Java Excel을 JSON 변환

다음 예제는 Java에서 Conholdate.Total for Java를 사용하여 Excel을 JSON으로 변환하는 방법을 보여줍니다.

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.convert.JsonConvertOptions;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.DateFormat;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.NumberFormat;

public class ExcelToJsonDemo {
    public static void main(String[] args) {
        // Input Excel file (generic path)
        String inputFile = "sample.xlsx";
        // Desired JSON output file
        String outputFile = "sample.json";

// Perform conversion inside try‑with‑resources to ensure proper cleanup
        try (Conversion conversion = new Conversion(inputFile)) {

// Configure JSON conversion options
            JsonConvertOptions jsonOptions = new JsonConvertOptions();

// Pretty‑print the JSON for readability
            jsonOptions.setPrettyPrint(true);

// Include column headers as JSON property names
            jsonOptions.setIncludeHeaders(true);

// Define how dates and numbers should be formatted in the JSON output
            jsonOptions.setDateFormat(DateFormat.CUSTOM);
            jsonOptions.setCustomDateFormat("yyyy-MM-dd");
            jsonOptions.setNumberFormat(NumberFormat.CUSTOM);
            jsonOptions.setCustomNumberFormat("#.##");

// Optional performance tweak: limit rows processed per batch (useful for very large sheets)
            jsonOptions.setRowsPerBatch(5000);

// Execute the conversion
            conversion.convert(outputFile, jsonOptions);

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
        } catch (Exception e) {
            // Basic error handling – in production code you might want more sophisticated logging
            System.err.println("Error during Excel to JSON conversion:");
            e.printStackTrace();
        }
    }
}

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에게 문의하십시오.

변환 옵션 및 설정

SDK는 JSON 출력물을 맞춤 설정하기 위한 여러 옵션을 제공합니다:

  • Pretty Print - 들여쓰기를 추가하여 가독성을 향상시킵니다. 
    jsonOptions.setPrettyPrint(true);
  • Include Headers - 워크시트의 첫 번째 행을 속성 이름으로 사용합니다.
    setIncludeHeaders(true) (자세한 내용은 API reference를 참조하십시오.)
  • Custom Date Format - 날짜 패턴을 정의합니다, 예: "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - 숫자 정밀도를 제어합니다, 예: "#.##".
    setCustomNumberFormat("#.##").

이러한 설정을 조정하면 생성된 JSON을 다운스트림 서비스 또는 데이터베이스의 기대에 맞출 수 있습니다.

결론

이제 Java 구현에서 Excel을 JSON으로 변환하는 작업이 Conholdate.Total for Java에 의해 지원됩니다. SDK가 복잡한 작업을 처리하고, 구성 가능한 옵션을 통해 형식 및 성능을 제어할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 획득하는 것을 기억하세요; 라이브러리를 평가하려면 임시 라이선스 페이지를 요청하거나 상업적 조건을 확인하려면 전체 가격 페이지를 검토하십시오. 즐거운 코딩 되세요!

자주 묻는 질문

  • Java에서 Conholdate.Total을 사용하여 Excel을 JSON으로 변환하려면 어떻게 해야 하나요?
    Conversion 클래스와 JsonConvertOptions를 코드 예제와 같이 사용하십시오. SDK는 파일 처리를 추상화하고 단일 convert 호출을 제공합니다.

  • Excel을 JSON으로 변환할 때 날짜 및 숫자 형식을 사용자 지정할 수 있나요?
    예. setCustomDateFormat 및 setCustomNumberFormat 메서드를 사용하면 대상 시스템의 기대에 맞는 패턴을 정의할 수 있습니다.

  • Conholdate.Total for Java에 사용할 수 있는 라이선스 옵션은 무엇인가요?
    임시 평가 라이선스는 임시 라이선스 페이지에서 얻을 수 있으며, 전체 라이선스는 가격 페이지를 통해 구매할 수 있습니다.

  • 대용량 Excel 파일에 대한 배치 처리가 지원되나요?
    setRowsPerBatch 옵션을 사용하면 워크시트를 청크 단위로 처리할 수 있어 배치 변환 시나리오에 이상적입니다.

자세히 보기

]]>