Java에서 HTML을 XLSX로 변환

Mon, 03 Aug 2026 11:38:22 +0000

HTML 보고서를 Excel 스프레드시트로 변환하는 것은 Java‑기반 웹 애플리케이션에서 사용자가 분석 데이터나 청구서를 다운로드하도록 해야 할 때 자주 요구되는 작업입니다. GroupDocs.Conversion Cloud SDK for Java은 로컬 Office 설치 없이도 형식 변환의 무거운 작업을 처리하는 강력한 API를 제공합니다. 이 가이드에서는 SDK를 설정하고, 변환 코드를 작성하며, cURL을 사용한 REST 인터페이스를 통해 동일한 서비스를 호출하는 방법을 보여줍니다. 마지막으로 HTML‑to‑XLSX 변환을 서버, 서블릿, Spring Boot 앱 또는 다중 스레드 Java 서비스에 삽입할 준비가 됩니다.

Java에서 HTML 보고서를 XLSX로 내보내기 - 요구 사항

많은 기업 포털은 사용자가 오프라인 분석을 위해 XLSX 워크북으로 내보내고자 하는 동적 HTML 대시보드를 생성합니다. 일반적인 요구 사항은 다음과 같습니다:

클라우드 스토리지에 저장되었거나 실시간으로 생성된 HTML 소스에 액세스합니다.
변환 중에 테이블 구조, cell 스타일 및 숫자 형식을 보존합니다.
Microsoft Office를 설치하지 않고도 백엔드 서버, 서블릿 컨테이너 또는 마이크로서비스 내부에서 변환을 실행할 수 있습니다.

수동 복사‑붙여넣기 또는 클라이언트‑사이드 라이브러리는 특히 대용량 보고서나 높은 동시성 시나리오(예: Java에서 HTML을 XLSX로 변환하는 서버)와 같은 경우 일관된 서식을 보장할 수 없습니다.

GroupDocs.Conversion Cloud SDK for Java를 활용한 내보내기 요구 충족

SDK는 HTML을 입력으로, XLSX를 출력으로 지원하는 클라우드 기반 변환 엔진을 제공하여 로컬 Office 구성 요소가 필요하지 않습니다. 요구 사항에 부합하는 주요 기능은 다음과 같습니다:

Cloud processing - 무거운 변환이 GroupDocs 서버에서 실행되며, Java의 HTML to XLSX 변환 서블릿이나 Spring Boot 웹 애플리케이션에 이상적입니다.
Configurable options - XlsxConvertOptions를 통해 원본 서식을 보존하고, 워크시트 이름을 설정하며, 셀 데이터 유형을 제어할 수 있습니다.
Thread‑safe client - Java에서 HTML to XLSX 변환 멀티스레딩에 적합하며, 고처리량 배치 작업을 가능하게 합니다.

자세한 내용은 공식 문서와 API 참조를 참조하십시오.

Java에서 HTML을 XLSX로 변환: 구현

GroupDocs.Conversion Cloud SDK 설치

Maven 프로젝트에 SDK를 추가하세요:


    com.groupdocs
    groupdocs-conversion-cloud
    23.12

또는 설치 명령을 실행하십시오:

mvn install com.groupdocs:groupdocs-conversion-cloud

API 클라이언트 초기화

자격 증명을 사용하여 ApiClient를 생성하고 ConversionApi를 인스턴스화합니다.

import com.groupdocs.conversion.cloud.ApiClient;
import com.groupdocs.conversion.cloud.api.ConversionApi;

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
ConversionApi conversionApi = new ConversionApi(apiClient);

소스 파일 정보 설정

기본 클라우드 스토리지에 있는 HTML 파일을 지정합니다.

import com.groupdocs.conversion.cloud.model.FileInfo;

FileInfo sourceFile = new FileInfo();
sourceFile.setFilePath("input.html");          // path in the cloud storage
sourceFile.setStorageName("DefaultStorage");   // optional

XLSX 변환 옵션 구성

원본 서식을 보존하는 등 옵션을 조정합니다.

import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;

XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
xlsxOptions.setPreserveOriginalFormatting(true);

변환 수행 및 결과 가져오기

요청을 빌드하고 실행하여 출력 경로를 얻습니다.

import com.groupdocs.conversion.cloud.model.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertDocumentResponse;

ConvertDocumentRequest request = new ConvertDocumentRequest();
request.setFileInfo(sourceFile);
request.setFormat("xlsx");                     // target format
request.setConvertOptions(xlsxOptions);
request.setOutputPath("output.xlsx");          // desired output path

try {
    ConvertDocumentResponse response = conversionApi.convertDocument(request);
    System.out.println("Conversion successful. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error during conversion: " + e.getMessage());
    e.printStackTrace();
}

Java를 사용하여 HTML 문서를 XLSX로 변환 - 전체 코드 예제

아래 예제는 모든 조각을 하나의 실행 가능한 클래스에 결합합니다.

import com.groupdocs.conversion.cloud.ApiClient;
import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.model.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertDocumentResponse;
import com.groupdocs.conversion.cloud.model.FileInfo;
import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;

public class HtmlToXlsxConversionExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        ConversionApi conversionApi = new ConversionApi(apiClient);

// Define source HTML file information
        FileInfo sourceFile = new FileInfo();
        sourceFile.setFilePath("input.html");          // path in the cloud storage
        sourceFile.setStorageName("DefaultStorage");   // optional, use default if omitted

// Set conversion options specific to XLSX output
        XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
        // Example option: preserve original formatting (if needed)
        xlsxOptions.setPreserveOriginalFormatting(true);

// Build conversion request
        ConvertDocumentRequest request = new ConvertDocumentRequest();
        request.setFileInfo(sourceFile);
        request.setFormat("xlsx");                     // target format
        request.setConvertOptions(xlsxOptions);
        request.setOutputPath("output.xlsx");          // desired output path in cloud storage

try {
            // Perform conversion
            ConvertDocumentResponse response = conversionApi.convertDocument(request);
            System.out.println("Conversion successful. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error during conversion: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

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

REST 및 cURL을 사용하여 HTML에서 XLSX 내보내기 실행

Java 코드를 작성하지 않고 REST API를 직접 호출하여 동일한 변환을 수행할 수 있습니다. 흐름은 SDK 단계와 동일합니다: 토큰을 얻고, HTML 파일을 업로드하고, 변환을 요청하고, XLSX 결과를 다운로드합니다.

액세스 토큰 가져오기

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

소스 HTML 업로드

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/html" \
     --data-binary @input.html

변환 요청

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": {
               "filePath": "input.html",
               "storageName": "DefaultStorage"
           },
           "outputPath": "output.xlsx",
           "format": "xlsx",
           "convertOptions": {
               "preserveOriginalFormatting": true
           }
         }'

XLSX 결과 다운로드

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

전체 매개변수 목록 및 추가 예제는 공식 API 문서를 참조하십시오.

결론

Java에서 HTML을 XLSX로 변환하는 작업은 GroupDocs.Conversion Cloud SDK for Java의 클라우드 기반 처리를 활용하면 간단해집니다. SDK는 HTML 테이블 파싱, 스타일 처리 및 표준을 준수하는 XLSX 파일 생성의 복잡성을 추상화하여 서버‑측, 서블릿‑기반 또는 Spring Boot 웹 애플리케이션에 이상적입니다. 전용 변환 서버, 마이크로서비스 또는 다중 스레드 배치 프로세서를 구축하든, 동일한 API가 부하에 맞게 확장됩니다. 평가를 위해 임시 라이선스 페이지에서 임시 라이선스를 획득하고, 프로덕션 사용을 위한 가격 세부 정보를 검토하십시오. 이 가이드의 코드와 cURL 예제를 사용하면 이제 모든 Java 솔루션에 HTML을 XLSX로 내보내는 기능을 통합할 수 있습니다.

FAQs

Java 서블릿에서 HTML을 XLSX로 변환하려면 어떻게 해야 하나요?
업로드된 HTML 파일을 수신하고, GroupDocs.Conversion Cloud SDK for Java를 사용하여 convertDocument를 호출하며, 결과 XLSX 스트림을 HTTP 응답에 다시 쓰는 서블릿을 생성합니다. SDK의 스레드‑안전 클라이언트는 서블릿 컨테이너 내에서 잘 작동합니다.

HTML을 XLSX 변환을 Java에서 마이크로서비스로 실행할 수 있나요?
예. 변환 로직을 가벼운 Spring Boot 애플리케이션에 패키징하고, REST 엔드포인트를 노출한 다음 SDK가 실제 형식 변환을 처리하도록 합니다. 이 접근 방식은 Java에서 HTML을 XLSX로 변환하는 마이크로서비스 패턴에 적합합니다.

HTML을 멀티스레드 Java 애플리케이션에서 XLSX로 변환할 수 있나요?
SDK는 스레드 안전하도록 설계되었으므로, 병렬로 여러 변환 작업을 시작할 수 있어 Java 시나리오에서 대량 HTML을 XLSX로 변환하는 서버에 유용합니다.

GroupDocs.Conversion Cloud SDK for Java에 대한 라이선스 자세한 정보를 어디서 찾을 수 있나요?
임시 라이선스 페이지를 방문하여 평가 키를 얻고, 정식 라이선스 옵션에 대한 가격 페이지를 확인하십시오. 두 링크 모두 제품 메인 페이지에 제공됩니다.

html to xlsx on Document Processing REST APIs | GroupDocs Cloud