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옵션을 사용하면 워크시트를 청크 단위로 처리할 수 있어 배치 변환 시나리오에 이상적입니다.