Word용 GroupDocs Conversion Java로 PDF에 글꼴 삽입
이 포괄적인 튜토리얼에서는 GroupDocs Conversion Java가 DOCX 파일을 PDF로 변환하면서 PDF에 글꼴 삽입을 어떻게 수행하는지 알아볼 수 있습니다. 법률 문서 파이프라인을 구축하든, 전자책을 출판하든, 기업 보고서를 생성하든, 아래 단계는 결과 PDF가 모든 장치에서 원본 Word 파일과 정확히 동일하게 보이도록 보장합니다.
빠른 답변
- 변환을 처리하는 라이브러리는 무엇인가요? GroupDocs Conversion for Java.
- 누락된 글꼴을 교체할 수 있나요? 예 – 글꼴 대체 설정을 사용하세요.
- 프로덕션에 라이선스가 필요합니까? 상업용 라이선스가 필요합니다; 무료 체험을 이용할 수 있습니다.
- 지원되는 Java 버전은 무엇인가요? JDK 8 이상.
- 배치 변환이 가능한가요? 물론입니다 – 변환기를 루프에 감싸거나 API의 배치 기능을 사용하세요.
GroupDocs Conversion Java란?
GroupDocs Conversion Java는 Microsoft Office 없이도 DOCX, PPTX, XLSX, PDF 등을 포함한 70+ 이상의 문서 형식을 변환하는 고성능 API입니다. 개발자에게 렌더링, 레이아웃 및 PDF에 글꼴 삽입 기능에 대한 세밀한 제어를 제공하며, 일반 서버에서 500페이지 DOCX를 30초 미만에 처리합니다.
변환 중에 사용자 지정 글꼴을 사용하는 이유
올바른 글꼴을 삽입하면 PDF가 모든 장치에서 동일하게 표시되고, “글꼴 대체” 문제를 없애며, 브랜드 가이드라인을 준수합니다. 이 방법은 변환 후 PDF를 수동으로 조정해야 하는 팀의 재작업을 **40 %**까지 감소시킵니다.
사전 요구 사항
- Java Development Kit (JDK) – 버전 8 이상.
- Maven for dependency management.
- An IDE (IntelliJ IDEA, Eclipse, or VS Code).
GroupDocs.Conversion for Java 설정
시작하려면 Maven 프로젝트에 GroupDocs 저장소와 변환 종속성을 추가합니다.
<repositories>
<repository>
<id>repository.groupdocs.com</id>
<name>GroupDocs Repository</name>
<url>https://releases.groupdocs.com/conversion/java/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion</artifactId>
<version>25.2</version>
</dependency>
</dependencies>
라이선스 획득
무료 체험으로 시작하거나 임시 라이선스를 받아 확장 테스트를 진행할 수 있습니다. 상업적 사용을 위해서는 정식 라이선스를 구매하는 것을 고려하세요. 옵션을 확인하려면 GroupDocs Licensing 페이지를 방문하세요.
기본 초기화 및 설정
종속성을 추가한 후, 소스 DOCX 파일을 가리키는 Converter 인스턴스를 생성합니다.
Converter는 문서 변환 작업을 관리하는 주요 클래스입니다.
import com.groupdocs.conversion.Converter;
// Initialize with a document path
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx");
구현 가이드
아래는 기본 글꼴 PDF 설정 및 사용자 지정 글꼴 대체를 정의하는 단계별 안내입니다.
단계 1: 변환 경로 및 로드 옵션 정의
먼저 PDF가 저장될 위치를 지정하고 글꼴 처리를 제어하는 로드 옵션을 구성합니다.setAutoFontSubstitution은 변환 중 자동 글꼴 추측을 비활성화합니다.setDefaultFont는 원본 글꼴이 없을 때 사용되는 대체 글꼴을 지정합니다.setFontSubstitutes는 사용할 수 없는 글꼴을 제공한 대체 글꼴에 매핑합니다.
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;
import com.groupdocs.conversion.contracts.FontSubstitute;
// Output PDF path
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertedWordToPdf.pdf";
// Configure load options for Word documents
double autoFontSubstitution(false); // Disable automatic font substitution
defaultFont("resources/fonts/Helvetica.ttf"); // Set a default fallback font
// Prepare font substitutes list
List<FontSubstitute> fontSubstitutes = new ArrayList<>();
fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial")); // Substitute Tahoma with Arial
fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial")); // Substitute Times New Roman with Arial
// Apply the substitutes to load options
setFontSubstitutes(fontSubstitutes);
직접 답변
setAutoFontSubstitution(false)를 설정하여 자동 추측을 비활성화하고, setDefaultFont("Helvetica.ttf")로 신뢰할 수 있는 대체 글꼴을 제공합니다. 마지막으로 setFontSubstitutes(...)를 사용해 누락된 글꼴을 알려진 대체 글꼴에 매핑합니다. 이렇게 하면 소스 DOCX의 모든 문자가 출력 PDF에서 일치하는 글리프로 매핑됩니다.
설명
setAutoFontSubstitution(false): 라이브러리의 자동 추측을 끄고 전체 제어를 제공합니다.setDefaultFont("Helvetica.ttf"): 요청된 글꼴을 찾을 수 없을 때 범용 대체 글꼴을 제공합니다.setFontSubstitutes(...): 누락된 글꼴을 대상 시스템에 존재하는 대체 글꼴에 매핑합니다.
단계 2: PDF 변환 옵션 구성
이제 PDF 전용 옵션 객체를 생성합니다.PdfConvertOptions는 글꼴 삽입 및 압축과 같은 PDF 출력 매개변수를 정의합니다.setEmbedFonts는 선택한 글꼴을 생성된 PDF에 삽입하도록 활성화합니다.
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
// Initialize PDF conversion options
double options = new PdfConvertOptions();
직접 답변
PdfConvertOptions를 인스턴스화하고, 필요에 따라 setEmbedFonts(true)로 글꼴 삽입을 활성화한 뒤, 파일 크기와 품질의 균형을 맞추도록 압축 설정을 조정합니다. 이러한 옵션을 통해 최종 PDF를 시각적 정확성과 저장 용량 요구사항에 맞게 세밀하게 조정할 수 있습니다.
나중에 PdfConvertOptions를 확장하여 페이지 크기, 여백 또는 압축 설정을 조정할 수 있습니다.
단계 3: 변환 수행
마지막으로 앞서 정의한 로드 옵션과 변환 옵션을 사용하여 변환을 실행합니다.convert(source, target, loadOptions, pdfOptions)는 지정된 설정으로 변환을 실행합니다.
// Convert Word document to PDF with specified font settings
converter.convert(convertedFile, () -> loadOptions, options);
직접 답변
converter.convert(sourcePath, targetPath, loadOptions, pdfOptions)를 호출합니다. API는 DOCX를 읽고, 지정한 글꼴 규칙을 적용하며, 선택한 글꼴을 삽입하고, 원본 타이포그래피를 정확히 보존한 PDF를 작성합니다.
API는 DOCX를 읽고, 글꼴 규칙을 적용한 뒤, 선택된 글꼴을 삽입한 PDF를 작성합니다.
실용적인 적용 사례
- Legal Document Management – 법원 제출용 PDF에 정확한 타이포그래피를 유지합니다.
- Publishing Industry – 전자책 및 카탈로그 전반에 걸쳐 브랜드 글꼴을 일관되게 유지합니다.
- Corporate Reports – 이해관계자용 PDF가 기업 스타일 가이드를 따르도록 보장합니다.
- Educational Material – 강의 노트를 변환하면서 맞춤 학술 글꼴을 유지합니다.
성능 고려 사항
- Memory Management – 대용량 DOCX 파일은 많은 힙을 소모할 수 있으므로 JVM 메모리를 모니터링하고
-Xmx조정을 고려하세요. - Batch Processing – 변환 로직을 루프에 감싸거나 GroupDocs 배치 API를 사용해 여러 파일을 효율적으로 처리합니다.
- Resource Allocation – 다수의 문서를 병렬 변환할 때 충분한 CPU 코어를 할당합니다.
- Throughput – 4코어 VM에서 이 라이브러리는 글꼴을 삽입하면서 분당 최대 12개의 300페이지 문서를 처리할 수 있습니다.
일반적인 문제와 해결책
| Issue | Solution |
|---|---|
| 글꼴이 대체되지 않음 | 제공한 경로에 글꼴 파일이 존재하는지, FontSubstitute 이름이 소스 DOCX의 정확한 글꼴 패밀리 이름과 일치하는지 확인하세요. |
| 메모리 부족 오류 | JVM 힙 크기를 (-Xmx2g 이상) 늘리거나 파일을 더 작은 배치로 처리하세요. |
| PDF에 글꼴이 삽입되지 않음 | setDefaultFont가 TrueType(.ttf) 또는 OpenType(.otf) 파일을 가리키고, 라이선스가 글꼴 삽입을 허용하는지 확인하세요. |
| 변환 후 페이지 레이아웃이 올바르지 않음 | 원본 Word 페이지 크기에 맞추려면 PdfConvertOptions.setPageSize(...)를 사용하세요. |
| 매우 큰 파일의 변환이 느림 | 메모리 부담을 줄이려면 PdfConvertOptions.setStream(true)로 스트리밍 모드를 활성화하세요. |
자주 묻는 질문
Q: GroupDocs.Conversion을 라이선스를 구매하지 않고 사용할 수 있나요?
A: 예, 무료 체험으로 시작하거나 평가용 임시 라이선스를 받을 수 있습니다.
Q: 글꼴이 올바르게 대체되지 않을 경우 어떻게 해야 하나요?
A: 글꼴 파일에 접근할 수 있는지 확인하고 setFontSubstitutes에 올바르게 참조했는지 확인하세요. 정확한 글꼴 패밀리 이름을 다시 확인하십시오.
Q: 대용량 문서의 변환 성능을 어떻게 향상시킬 수 있나요?
A: 문서를 배치 처리하고, 시스템 리소스를 모니터링하며, JVM 힙 크기를 늘리고, 스트리밍 모드를 활성화하세요.
Q: Word 외에 다른 문서 유형도 변환할 수 있나요?
A: 물론입니다. GroupDocs Conversion은 이미지, 스프레드시트, 프레젠테이션 등 다양한 형식을 지원합니다.
Q: GroupDocs.Conversion에 대한 추가 문서는 어디에서 찾을 수 있나요?
A: 자세한 API 레퍼런스를 보려면 공식 가이드인 GroupDocs Java Conversion Docs를 방문하세요.
결론
이제 PDF에 글꼴 삽입을 수행하면서 DOCX를 PDF로 변환하는 GroupDocs Conversion Java 기반의 완전한 프로덕션 준비 솔루션을 갖추었습니다. 글꼴 대체와 기본 글꼴을 설정함으로써 모든 PDF가 뷰어나 플랫폼에 관계없이 원본 Word 문서의 모습을 정확히 반영하도록 보장합니다.
다음 단계
PdfConvertOptions에 PDF/A 준수 또는 이미지 압축과 같은 추가 옵션을 실험해 보세요.- 배치 변환을 탐색하여 대규모 문서 파이프라인을 자동화하세요.
- 공식 문서에서 전체 API를 검토하여 워터마크나 디지털 서명과 같은 고급 기능을 활용하세요.
마지막 업데이트: 2026-07-14
테스트 환경: GroupDocs.Conversion 25.2
작성자: GroupDocs
리소스
- 문서: GroupDocs Java Conversion Docs
- API 레퍼런스: GroupDocs API Reference
- 다운로드: Get GroupDocs.Conversion
- 구매: Buy a License
- 무료 체험: Trial Downloads
- 임시 라이선스: Request Temporary License
- 지원: GroupDocs Support Forum
