GroupDocs.Merger Java를 사용하여 페이지 시작 동작을 관리하면서 암호화된 PDF 파일 병합하는 방법
암호화된 PDF 파일을 병합하고 문서 흐름을 깔끔하게 유지해야 할 때, 페이지 시작 동작을 제어하는 것이 필수적입니다. 이 튜토리얼에서는 원하지 않는 빈 페이지가 발생하는 이유, 각 소스가 새 페이지에서 시작할지 현재 페이지에서 계속할지를 GroupDocs.Merger에 어떻게 지정하는지, 그리고 북마크, 섹션 구분, PDF/A 호환성을 유지하는 옵션을 알아봅니다. 계약 조립 엔진, 자동 보고 파이프라인, 대량 문서 마이그레이션 도구를 구축하든, 이러한 설정을 마스터하면 최종 출력에 대한 정확한 제어가 가능합니다.
빠른 답변
- 페이지 시작 동작이란? 새로 병합된 문서가 새 페이지에서 시작할지 현재 페이지에서 계속될지를 결정합니다.
- 왜 중요한가요? 잘못된 설정은 원하지 않는 빈 페이지를 삽입하거나 내용이 잘릴 수 있습니다.
- GroupDocs.Merger에서 어떻게 관리하나요?
MergeOptions객체의PageStart옵션을 사용합니다. - 병합 중에 북마크를 유지할 수 있나요? 예—
PreserveBookmarks플래그를 활성화합니다. - PDF/A에 호환성 모드가 필요합니까? PDF/A‑1b 또는 PDF/A‑2b 호환성이 필요할 때
ComplianceMode를 활성화합니다.
“페이지 시작 동작 관리”란 무엇인가요?
페이지 시작 동작을 관리한다는 것은 병합기에 각 소스 문서가 새 페이지(PageStart.NewPage)에서 시작할지 동일 페이지(PageStart.Continue)에서 계속될지를 명시적으로 지정하는 것을 의미합니다. 이 제어를 통해 예상치 못한 공백을 없애고 내용이 자연스럽게 흐르도록 하며, 특히 장, 부록 또는 여러 계약서를 하나의 PDF로 결합할 때 읽기 경험을 방해하는 빈 페이지 삽입을 방지합니다.
이 작업에 GroupDocs.Merger를 사용하는 이유
GroupDocs.Merger는 30개 이상의 입력 및 출력 형식을 지원합니다—PDF, DOCX, PPTX, HTML 및 일반 이미지 형식을 포함—따라서 수동 변환 없이 이기종 파일을 결합할 수 있습니다. 이 라이브러리는 수백 페이지에 달하는 문서를 메모리에서 처리하여 전체 디스크 로드를 피하고, 단순 파일 연결 방식에 비해 대량 배치에서 최대 40 %의 속도 향상을 제공합니다.
전제 조건
- Java 17 이상
- Maven 또는 Gradle을 통해 추가된 GroupDocs.Merger for Java
- 유효한 GroupDocs 라이선스(테스트용 임시 라이선스 사용 가능)
사용 가능한 튜토리얼
문서를 결합할 때 페이지 시작 동작 관리 방법
MergeOptions 클래스는 각 소스 파일을 정확히 어떻게 추가할지 지정할 수 있게 해줍니다. PageStart.Continue를 설정하면 같은 페이지에 내용이 이어지고, PageStart.NewPage를 설정하면 페이지 구분을 강제합니다. 그런 다음 구성된 옵션을 Merger.merge()에 전달하면—PDF, Word 파일, PowerPoint 데크 등 어떤 수의 문서에서도 페이지 시작을 제어할 수 있습니다.
MergeOptions는 GroupDocs.Merger가 각 들어오는 문서를 어떻게 처리할지 알려주는 구성 객체입니다. PageStart는 문서가 새 페이지(NewPage)에서 시작할지 현재 페이지(Continue)에서 계속될지를 지정하는 열거형입니다. PreserveBookmarks는 true일 경우 소스 문서의 원래 북마크를 병합된 출력에 유지하는 부울 플래그입니다. PreserveSectionBreaks는 병합 중 Word 문서의 섹션 구분 마커를 유지합니다. ComplianceMode는 결과 PDF에 대한 PDF/A 호환성 수준(e.g., PdfA_1b, PdfA_2b)을 설정하는 열거형입니다.
- 페이지 시작 설정:
options.setPageStart(PageStart.Continue);– 추가 빈 페이지 없이 내용이 이어지게 합니다. - 북마크 유지:
options.setPreserveBookmarks(true);– 소스 파일의 탐색 포인트를 유지합니다. - 섹션 구분 유지:
options.setPreserveSectionBreaks(true);– 복잡한 레이아웃을 가진 Word 문서에 필수적입니다. - PDF/A 호환성 활성화:
options.setComplianceMode(ComplianceMode.PdfA_1b);– 병합된 PDF가 보관 표준을 충족하도록 합니다.
추가 리소스
- GroupDocs.Merger for Java 문서
- GroupDocs.Merger for Java API 레퍼런스
- GroupDocs.Merger for Java 다운로드
- GroupDocs.Merger 포럼
- 무료 지원
- 임시 라이선스
일반적인 문제 및 해결책
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| 병합 후 예상치 못한 빈 페이지 | PageStart 기본값은 NewPage입니다 | MergeOptions에서 PageStart.Continue를 설정합니다. |
| 북마크가 사라짐 | PreserveBookmarks가 활성화되지 않음 | 병합 옵션을 구성할 때 PreserveBookmarks 플래그를 활성화합니다. |
| PDF/A 호환성 오류 | 호환성 모드가 설정되지 않음 | 옵션에서 ComplianceMode.PdfA_1b(또는 적절한 레벨)를 사용합니다. |
| Word 병합 시 섹션 구분이 손실됨 | PreserveSectionBreaks가 비활성화됨 | 원본 레이아웃을 유지하려면 PreserveSectionBreaks를 켭니다. |
| 암호화된 PDF 병합 실패 | 비밀번호가 제공되지 않음 | 파일을 병합 대기열에 추가하기 전에 PdfLoadOptions를 통해 비밀번호를 제공합니다. |
자주 묻는 질문
Q: PDF와 Word 파일을 하나의 병합으로 결합할 수 있나요?
A: 예. GroupDocs.Merger는 지원되는 형식을 자동으로 변환하고 지정한 페이지 시작 동작을 존중합니다.
Q: Word 문서의 기존 섹션 구분을 어떻게 유지하나요?
A: MergeOptions에서 PreserveSectionBreaks 옵션을 활성화하면 원본 섹션 레이아웃을 유지합니다.
Q: 암호화된 PDF를 병합할 수 있나요?
A: 물론입니다. 각 PDF를 병합 대기열에 추가하기 전에 비밀번호를 제공하면 됩니다.
Q: 페이지 시작 동작을 사용하면 성능에 영향을 미치나요?
A: 영향은 최소이며, 라이브러리는 페이지 레이아웃 결정을 메모리에서 처리하고 추가 I/O가 없습니다.
Q: 개발 빌드에 라이선스가 필요합니까?
A: 테스트용으로는 임시 라이선스로 충분합니다. 프로덕션에서는 전체 라이선스를 사용하면 모든 평가 제한이 해제됩니다.
마지막 업데이트: 2026-10-22
테스트 환경: GroupDocs.Merger 23.11 for Java
작성자: GroupDocs