Java에서 XPS를 DOCX로 변환

XPS 파일을 편집 가능한 DOCX 문서로 변환하는 것은 레거시 문서를 현대화하거나 레거시 자산을 협업 워크플로에 통합할 때 자주 필요한 작업입니다. Conholdate.Total for Java는 Java에서 XPS를 DOCX로 변환하는 작업을 간단하게 만들어 주며, 백그라운드에서 무거운 작업을 처리하는 강력한 API를 제공합니다. 이 가이드는 필요한 설정 과정을 안내하고, 완전한 Java 구현 예제를 보여주며, 최상의 결과를 얻기 위해 변환을 미세 조정하는 방법을 설명합니다. 끝까지 읽으면 애플리케이션에 신뢰할 수 있는 문서 변환 기능을 직접 삽입할 수 있게 됩니다.

Java에서 XPS를 DOCX로 변환하는 5단계

Conholdate Maven 리포지토리 및 종속성 추가: pom.xml에 Conholdate 리포지토리와 SDK 아티팩트를 포함하여 Maven이 필요한 라이브러리를 해결할 수 있도록 합니다.

<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>

XPS 문서 로드: 소스 XPS 파일을 가리키는 Converter 인스턴스를 생성합니다. 이 클래스는 핵심 변환 API의 일부입니다.

String inputPath = "input.xps";
try (Converter converter = new Converter(inputPath)) {
    // Converter ready for use
}

DOCX 변환 옵션 만들기: DocxConvertOptions를 인스턴스화하여 출력이 DOCX가 되도록 지정합니다. 필요에 따라 이 객체에 추가 속성을 설정할 수 있습니다.

DocxConvertOptions options = new DocxConvertOptions();

변환 수행: convert 메서드를 호출하여 대상 경로와 옵션 객체를 전달합니다. 이 단일 호출이 전체 변환을 처리합니다.

String outputPath = "output.docx";
converter.convert(outputPath, options);

결과 확인: 변환 후, 출력 파일이 존재하고 일반 파일인지 확인합니다. 이 간단한 검증은 경로나 권한 문제를 조기에 포착하는 데 도움이 됩니다.

File resultFile = new File(outputPath);
if (resultFile.exists() && resultFile.isFile()) {
    System.out.println("Conversion succeeded: " + resultFile.getAbsolutePath());
} else {
    System.err.println("Conversion failed.");
}

Converter 클래스에 대한 자세한 내용은 API reference를 참조하십시오.

전체 코드 예제: XPS를 DOCX로 변환하기 Conholdate.Total 사용

다음 예제는 Java에서 XPS를 DOCX로 변환하는 최소한의 엔드‑투‑엔드 구현을 보여줍니다. 여기에는 오류 처리와 검증 단계가 포함됩니다.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.DocxConvertOptions;
import java.io.File;

public class XpsToDocxConversion {
    public static void main(String[] args) {
        String inputPath = "input.xps";
        String outputPath = "output.docx";

// Load XPS document and prepare for conversion
        try (Converter converter = new Converter(inputPath)) {
            // Set conversion options for DOCX output
            DocxConvertOptions options = new DocxConvertOptions();

// Perform the conversion
            converter.convert(outputPath, options);
        } catch (Exception e) {
            System.err.println("Error during conversion: " + e.getMessage());
            e.printStackTrace();
            return;
        }

// Verify the result
        File resultFile = new File(outputPath);
        if (resultFile.exists() && resultFile.isFile()) {
            System.out.println("Conversion succeeded. Output file: " + resultFile.getAbsolutePath());
            System.out.println("File size: " + resultFile.length() + " bytes");
        } else {
            System.err.println("Conversion failed. Output file not found.");
        }
    }
}

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

환경 준비하기

Conholdate.Total for Java 사용을 시작하려면 위에 표시된 Maven 저장소와 SDK 종속성을 추가하십시오. 이 라이브러리는 Java 8 이상과 프로덕션 사용을 위한 유효한 라이선스가 필요합니다. 수동 설치를 선호하는 경우 최신 SDK 패키지를 다운로드 페이지에서 다운로드하십시오.

변환 설정 미세 조정

DocxConvertOptions는 DOCX 출력 제어를 위한 기본 객체입니다. 샘플 코드에서는 대부분의 시나리오에 적합한 기본 설정을 사용했습니다. 또한 다음과 같은 속성을 조정할 수 있습니다:

원본 레이아웃 보존 - 복잡한 XPS 파일을 변환할 때 원본 페이지 레이아웃을 유지합니다.
폰트 포함 활성화 - 결과 DOCX에 사용된 모든 폰트를 포함시켜 다른 컴퓨터에서 폰트 누락 문제를 방지합니다.

이러한 속성은 API 참조에 문서화되어 있습니다. 사용 사례가 특정 출력 특성을 요구하는 경우 convert를 호출하기 전에 이를 조정하십시오.

대용량 XPS 파일에 대한 성능 고려 사항

전체 파일 로드 대신 스트림 사용 - 매우 큰 XPS 문서의 경우, 메모리 부담을 줄이기 위해 스트리밍 방식(e.g., InputStream)을 고려하십시오.
배치 변환 - 많은 파일을 변환할 때 가능한 경우 단일 Converter 인스턴스를 재사용하여 반복 초기화 오버헤드를 피하십시오.
불필요한 옵션 피하기 - 기본값과 다른 변환 옵션만 설정하십시오; 추가 구성은 처리 시간을 늘릴 수 있습니다.

이러한 팁을 적용하면 변환 속도를 빠르게 유지하고 메모리 효율성을 높일 수 있습니다.

신뢰할 수 있는 XPS에서 DOCX 변환을 위한 실용적인 팁

변환을 시작하기 전에 입력 경로와 파일 접근성을 확인하십시오.
예외를 포착하고 로그에 기록하여 문제를 신속하게 진단하십시오; SDK는 지원되지 않는 기능에 대해 자세한 메시지를 제공합니다.
다양한 DOCX 뷰어(Word, LibreOffice)에서 출력물을 테스트하여 호환성을 보장하십시오.
SDK를 최신 상태로 유지하십시오; 최신 릴리스에는 성능 향상 및 버그 수정이 포함됩니다.

결론

Java에서 XPS를 DOCX로 변환은 이제 Conholdate.Total for Java 덕분에 간단하고 반복 가능한 프로세스가 되었습니다. 단계별로 진행하고 제공된 코드 샘플을 사용하며 구성 및 성능 권장 사항을 적용하면 모든 Java 애플리케이션에 신뢰할 수 있는 문서 변환을 통합할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 확보하는 것을 기억하세요; SDK를 평가하기 위해 임시 라이선스를 요청하고 장기 배포를 위한 가격 옵션을 검토할 수 있습니다.

자주 묻는 질문

Java를 사용하여 XPS 파일을 DOCX로 변환하려면 어떻게 해야 하나요?
Conholdate.Total for Java의 Converter 클래스를 DocxConvertOptions와 함께 사용하십시오. API는 전체 코드 예제에 표시된 대로 단일 메서드 호출로 변환을 수행합니다.

Java 코드를 작성하지 않고 XPS를 DOCX로 변환할 수 있나요?
Conholdate는 또한 문서 변환을 위한 클라우드 기반 REST API를 제공하지만, 온프레미스 Java 프로젝트의 경우 여기에서 보여준 라이브러리 접근 방식이 가장 직접적이고 성능이 뛰어난 솔루션을 제공합니다.

Conholdate.Total에서 지원하는 다른 형식은 무엇인가요?
SDK는 200개 이상의 형식을 지원하며, 여기에는 PDF, PNG, HTML 및 다양한 Office 형식이 포함됩니다. 전체 목록은 문서에서 확인하세요.

Java SDK에 대한 라이선스 정보를 어디서 찾을 수 있나요?
체험 라이선스를 위해 임시 라이선스 페이지를 방문하거나 상업적 옵션을 위해 가격 페이지를 방문하십시오.

Java에서 XPS를 DOCX로 변환하는 5단계#

전체 코드 예제: XPS를 DOCX로 변환하기 Conholdate.Total 사용#

환경 준비하기#

변환 설정 미세 조정#

대용량 XPS 파일에 대한 성능 고려 사항#

신뢰할 수 있는 XPS에서 DOCX 변환을 위한 실용적인 팁#

결론#

자주 묻는 질문#

Related Articles#