콘텐츠 대표 이미지 - iText: 너와 나의 PDF 생성 여행 - 자바 개발자를 위한 완벽 가이드 🚀

iText: 너와 나의 PDF 생성 여행 - 자바 개발자를 위한 완벽 가이드 🚀

🔍 PDF 문서가 필요한 순간, 자바 개발자라면 iText를 만나야 할 때!

안녕? 오늘은 자바 개발자라면 꼭 알아야 할 PDF 조작의 마법사, iText 라이브러리에 대해 함께 알아볼 거야. 보고서부터 청구서, 티켓까지 - PDF는 현대 비즈니스의 필수품이잖아. 이 글을 통해 iText로 PDF를 자유자재로 다루는 방법을 배워보자!

📚 목차

  1. iText란 무엇인가? - PDF 세계로의 첫걸음
  2. iText 시작하기 - 설치부터 첫 PDF 생성까지
  3. PDF 문서 기본 구조 이해하기
  4. 텍스트와 폰트 다루기 - 글꼴의 마법
  5. 표와 이미지 삽입하기 - 시각적 요소 더하기
  6. PDF 양식과 대화형 요소 만들기
  7. 기존 PDF 수정 및 병합하기
  8. PDF 보안과 암호화 적용하기
  9. 고급 기능과 실전 프로젝트
  10. iText 대안과 비교 분석
  11. 자주 묻는 질문과 문제 해결

1. iText란 무엇인가? - PDF 세계로의 첫걸음 🌱

iText는 자바와 .NET 환경에서 PDF 문서를 생성하고 조작할 수 있는 오픈소스 라이브러리야. 2000년에 Bruno Lowagie에 의해 처음 개발되었고, 지금은 전 세계 수많은 개발자들이 사용하는 강력한 PDF 솔루션이 되었어.

🌟 iText의 주요 특징

1. 다양한 PDF 조작 기능 - 생성, 수정, 분할, 병합까지 PDF와 관련된 거의 모든 작업 가능

2. 크로스 플랫폼 지원 - 자바뿐만 아니라 .NET, Android 등 다양한 환경에서 사용 가능

3. 높은 성능과 안정성 - 대용량 PDF 처리에도 뛰어난 성능 발휘

4. 풍부한 커뮤니티와 문서화 - 20년 이상의 역사로 축적된 방대한 예제와 문서

5. 기업용 솔루션 - 상업적 라이선스를 통한 추가 기능과 지원 제공

PDF는 1993년 어도비에서 개발한 이후 문서 교환의 표준이 되었어. iText는 이런 PDF를 프로그래밍 방식으로 자유롭게 다룰 수 있게 해주는 마법 지팡이 같은 존재지. 웹 애플리케이션에서 동적으로 PDF 보고서를 생성하거나, 기존 PDF에 워터마크를 추가하거나, 양식을 채우는 등의 작업을 자동화할 수 있어.

Java iText PDF Library PDF iText 작동 원리 코드 작성 PDF 생성

iText의 역사와 발전

iText의 역사는 꽤 흥미로워. 처음에는 Bruno Lowagie가 개인 프로젝트로 시작했는데, 지금은 iText Group NV라는 회사가 되어 전 세계적으로 사용되는 PDF 솔루션이 되었어. 2009년까지는 MPL/LGPL 라이선스였지만, 이후 AGPL로 변경되었고, 상업적 라이선스도 제공하고 있어.

2000년 - Bruno Lowagie에 의해 iText 프로젝트 시작
2008년 - iText Software Corp 설립
2009년 - 라이선스가 MPL/LGPL에서 AGPL로 변경
2015년 - iText 7 출시, 완전히 재설계된 아키텍처 도입
2020년 - iText DITO 출시, 템플릿 기반 PDF 생성 솔루션

현재 iText는 iText 5와 iText 7 두 가지 주요 버전이 있어. iText 5는 레거시 버전이지만 여전히 많이 사용되고, iText 7은 완전히 재설계된 최신 버전이야. 이 글에서는 주로 iText 7을 기준으로 설명할 거야.

재능넷에서도 PDF 문서 자동화 관련 프로젝트를 의뢰하는 경우가 많은데, 이런 프로젝트에서 iText는 정말 강력한 도구로 활용되고 있어. 특히 다양한 재능을 거래하는 플랫폼에서 계약서나 인보이스 같은 문서를 자동으로 생성해야 할 때 iText의 가치가 빛나지!

2. iText 시작하기 - 설치부터 첫 PDF 생성까지 🚀

자, 이제 실제로 iText를 사용해보자! 먼저 프로젝트에 iText를 추가하는 방법부터 알아볼게.

Maven으로 iText 설치하기

Java 프로젝트에서는 보통 Maven이나 Gradle을 통해 라이브러리를 관리해. Maven을 사용한다면 pom.xml에 다음 의존성을 추가하면 돼:


<dependencies>
    <!-- iText 7 Core -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itext7-core</artifactId>
        <version>7.2.3</version>
        <type>pom</type>
    </dependency>
</dependencies>
    

Gradle로 iText 설치하기

Gradle을 사용한다면 build.gradle 파일에 다음을 추가해:


dependencies {
    implementation 'com.itextpdf:itext7-core:7.2.3'
}
    

iText 7은 모듈화된 구조를 가지고 있어서, 필요한 모듈만 선택적으로 추가할 수도 있어. 주요 모듈은 다음과 같아:

  1. kernel: 핵심 기능을 제공하는 기본 모듈
  2. layout: 고급 레이아웃 기능 제공
  3. forms: PDF 양식 작업을 위한 모듈
  4. pdfa: PDF/A 표준 준수를 위한 모듈
  5. sign: 디지털 서명 기능
  6. barcodes: 바코드 생성 기능
  7. font-asian: 아시아 언어 폰트 지원

💡 TIP: 전체 iText 7 Core를 추가하면 모든 모듈이 포함되지만, 프로젝트 크기를 줄이고 싶다면 필요한 모듈만 선택적으로 추가하는 것이 좋아!

첫 번째 PDF 문서 만들기

이제 iText를 사용해서 간단한 PDF 문서를 만들어볼게. 다음은 "Hello, World!" 텍스트가 포함된 기본 PDF를 생성하는 코드야:


import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;

import java.io.FileNotFoundException;

public class HelloWorld {
    public static void main(String[] args) throws FileNotFoundException {
        // PDF 파일 경로 지정
        String dest = "hello_world.pdf";
        
        // PdfWriter 객체 생성
        PdfWriter writer = new PdfWriter(dest);
        
        // PdfDocument 객체 생성
        PdfDocument pdf = new PdfDocument(writer);
        
        // Document 객체 생성
        Document document = new Document(pdf);
        
        // 문서에 내용 추가
        document.add(new Paragraph("Hello, World!"));
        
        // 문서 닫기
        document.close();
        
        System.out.println("PDF created successfully!");
    }
}
    

이 코드를 실행하면 현재 디렉토리에 "hello_world.pdf"라는 파일이 생성되고, 그 안에는 "Hello, World!" 텍스트가 포함되어 있을 거야. 정말 간단하지? 🎉

import com.itextpdf.*; public class HelloWorld { public static void main() { // Create PDF PdfWriter writer = new PdfWriter(); PdfDocument pdf = new PdfDocument(); Document document = new Document(); document.add(new Paragraph( "Hello, World!")); document.close(); } } Hello, World! Generated with iText Page 1 첫 번째 PDF 생성 과정

iText 코드 구조 이해하기

위 코드에서 사용된 주요 클래스들을 간단히 설명할게:

  1. PdfWriter: PDF 파일을 디스크에 쓰는 역할을 담당해. 파일 경로나 OutputStream을 인자로 받아.
  2. PdfDocument: PDF 문서의 구조를 관리하는 클래스로, 페이지 추가/삭제, 메타데이터 설정 등을 담당해.
  3. Document: 실제 콘텐츠를 추가하기 위한 고수준 클래스야. Paragraph, Table, Image 같은 요소들을 추가할 수 있어.
  4. Paragraph: 텍스트 단락을 나타내는 요소로, 텍스트 내용과 스타일을 포함해.

iText 7의 구조는 PDF 생성 과정을 직관적으로 이해할 수 있게 설계되어 있어. 기본적으로 다음과 같은 계층 구조를 가지고 있지:

1. 최하위 레벨: PdfWriter/PdfReader - 파일 입출력 담당

2. 중간 레벨: PdfDocument - PDF 구조 관리

3. 최상위 레벨: Document - 콘텐츠 추가 및 스타일링

이런 계층 구조 덕분에 코드가 명확하고 유지보수하기 쉬워. 각 계층은 자신의 역할에만 집중하고, 다른 계층과는 깔끔하게 분리되어 있거든.

⚠️ 주의사항: Document 객체를 사용한 후에는 반드시 close() 메서드를 호출해야 해! 그렇지 않으면 PDF 파일이 제대로 생성되지 않을 수 있어.

이제 기본적인 PDF 생성 방법을 배웠으니, 다음 섹션에서는 PDF 문서의 구조에 대해 더 자세히 알아보자!

3. PDF 문서 기본 구조 이해하기 📑

PDF 문서를 효과적으로 다루려면 그 기본 구조를 이해하는 것이 중요해. PDF는 단순한 텍스트 파일이 아니라 복잡한 객체 구조를 가진 바이너리 파일이거든. iText로 작업하기 전에 PDF의 기본 구성 요소들을 알아보자.

PDF 문서의 핵심 구성 요소

  1. 페이지(Pages): PDF 문서의 기본 단위로, 각 페이지는 독립적인 콘텐츠를 가짐
  2. 콘텐츠 스트림(Content Streams): 페이지에 표시될 텍스트, 이미지, 그래픽 등의 실제 내용
  3. 리소스(Resources): 폰트, 이미지, 색상 공간 등 콘텐츠 렌더링에 필요한 자원
  4. 문서 카탈로그(Document Catalog): 문서의 루트 객체로, 페이지 트리, 아웃라인, 메타데이터 등 참조
  5. 메타데이터(Metadata): 문서 제목, 작성자, 생성 날짜 등의 정보

iText를 사용할 때는 이런 저수준 구조를 직접 다룰 필요는 없어. 라이브러리가 이 모든 것을 추상화해서 제공하니까. 하지만 기본 개념을 이해하면 더 효과적으로 PDF를 다룰 수 있어.

PDF 문서 구조 Document Catalog Pages Tree Page 1 Content Stream Page 2 Content Stream Page 3 Content Stream Resources (Fonts, Images, Color Spaces)

iText에서의 문서 구조 다루기

iText에서는 PDF 문서 구조를 다음과 같은 클래스들로 표현해:


// 새 PDF 문서 생성
PdfDocument pdfDoc = new PdfDocument(new PdfWriter("document.pdf"));

// 문서 정보(메타데이터) 설정
pdfDoc.getDocumentInfo().setTitle("My First PDF");
pdfDoc.getDocumentInfo().setAuthor("Java Developer");
pdfDoc.getDocumentInfo().setSubject("Using iText");
pdfDoc.getDocumentInfo().setKeywords("PDF, iText, Java");
pdfDoc.getDocumentInfo().setCreator("iText Example");

// 새 페이지 추가
PdfPage page = pdfDoc.addNewPage();

// Document 객체로 콘텐츠 추가
Document document = new Document(pdfDoc);
document.add(new Paragraph("This is page 1"));

// 두 번째 페이지 추가
pdfDoc.addNewPage();
document.add(new Paragraph("This is page 2"));

// 문서 닫기
document.close();
    

위 코드에서 볼 수 있듯이, iText는 PDF의 복잡한 내부 구조를 추상화해서 개발자가 쉽게 다룰 수 있게 해줘. PdfDocument 클래스는 PDF의 전체 구조를 관리하고, Document 클래스는 콘텐츠 추가를 담당해.

페이지 크기와 여백 설정

PDF 문서를 만들 때 가장 기본적인 설정 중 하나는 페이지 크기와 여백이야. iText에서는 다음과 같이 설정할 수 있어:


// A4 크기의 페이지 생성
PdfDocument pdfDoc = new PdfDocument(new PdfWriter("document.pdf"));

// 페이지 크기와 여백 설정
Document document = new Document(pdfDoc, PageSize.A4);
document.setMargins(20, 20, 20, 20);

// 콘텐츠 추가
document.add(new Paragraph("This is a document with A4 page size and 20pt margins"));

document.close();
    

iText는 다양한 표준 페이지 크기를 PageSize 클래스에 미리 정의해 두었어:

PageSize.A4 - 가장 일반적인 크기 (210 × 297 mm)
PageSize.LETTER - 미국 표준 레터 크기 (8.5 × 11 inches)
PageSize.A3 - A4보다 큰 크기 (297 × 420 mm)
PageSize.A5 - A4보다 작은 크기 (148 × 210 mm)

물론 사용자 정의 크기도 만들 수 있어:


// 사용자 정의 페이지 크기 (단위: 포인트)
Rectangle customPageSize = new Rectangle(400, 600);
Document document = new Document(pdfDoc, customPageSize);
    

💡 알아두면 좋은 점: PDF에서 모든 측정 단위는 기본적으로 포인트(pt)를 사용해. 1인치는 72포인트야. iText에서는 다른 단위를 포인트로 변환하는 유틸리티 메서드도 제공해.

문서 메타데이터 설정

PDF 문서의 메타데이터는 문서에 대한 추가 정보를 제공해. 제목, 작성자, 키워드 등을 설정할 수 있어:


PdfDocument pdfDoc = new PdfDocument(new PdfWriter("document.pdf"));

// 메타데이터 설정
pdfDoc.getDocumentInfo().setTitle("Annual Report");
pdfDoc.getDocumentInfo().setAuthor("Finance Department");
pdfDoc.getDocumentInfo().setSubject("Financial Performance 2023");
pdfDoc.getDocumentInfo().setKeywords("finance, annual report, 2023");
pdfDoc.getDocumentInfo().setCreator("iText Library");
    

이런 메타데이터는 PDF 리더에서 문서 속성으로 확인할 수 있고, 검색 엔진이나 문서 관리 시스템에서도 활용돼.

PDF 문서 구조에 대한 이해는 복잡한 문서를 만들 때 특히 중요해. 재능넷에서 프리랜서로 활동하면서 PDF 자동화 프로젝트를 맡게 된다면, 이런 기본 구조를 이해하고 있으면 훨씬 수월하게 작업할 수 있을 거야!

4. 텍스트와 폰트 다루기 - 글꼴의 마법 ✨

PDF 문서에서 텍스트는 가장 기본적이면서도 중요한 요소야. iText를 사용하면 다양한 스타일과 폰트로 텍스트를 꾸밀 수 있어. 이번 섹션에서는 텍스트 스타일링과 폰트 적용 방법을 자세히 알아볼게.

기본 텍스트 추가하기

가장 간단한 방법은 Paragraph 객체를 사용하는 거야:


Document document = new Document(pdfDoc);

// 기본 텍스트 추가
document.add(new Paragraph("이것은 기본 텍스트입니다."));

// 여러 줄의 텍스트 추가
Paragraph paragraph = new Paragraph()
    .add("첫 번째 줄입니다.")
    .add(new Text("\n두 번째 줄입니다."))
    .add(new Text("\n세 번째 줄입니다."));
document.add(paragraph);
    

텍스트 스타일링

iText에서는 텍스트의 색상, 크기, 굵기 등 다양한 스타일을 적용할 수 있어:


// 텍스트 스타일링
Paragraph styledParagraph = new Paragraph();

// 굵은 텍스트
Text boldText = new Text("이것은 굵은 텍스트입니다.").setBold();
styledParagraph.add(boldText).add("\n");

// 기울임 텍스트
Text italicText = new Text("이것은 기울임 텍스트입니다.").setItalic();
styledParagraph.add(italicText).add("\n");

// 밑줄 텍스트
Text underlineText = new Text("이것은 밑줄 텍스트입니다.").setUnderline();
styledParagraph.add(underlineText).add("\n");

// 색상이 있는 텍스트
Text coloredText = new Text("이것은 빨간색 텍스트입니다.")
    .setFontColor(ColorConstants.RED);
styledParagraph.add(coloredText).add("\n");

// 크기가 다른 텍스트
Text largeText = new Text("이것은 큰 텍스트입니다.")
    .setFontSize(20);
styledParagraph.add(largeText);

document.add(styledParagraph);
    
일반 텍스트 이것은 굵은 텍스트입니다. 이것은 기울임 텍스트입니다. 이것은 밑줄 텍스트입니다. 이것은 빨간색 텍스트입니다. 이것은 큰 텍스트입니다. 텍스트 스타일링 예제

폰트 사용하기

PDF에서 폰트는 매우 중요한 요소야. iText는 기본 폰트와 사용자 정의 폰트를 모두 지원해:


// 표준 폰트 사용
Paragraph standardFontParagraph = new Paragraph("이것은 Times-Roman 폰트입니다.")
    .setFont(PdfFontFactory.createFont(StandardFonts.TIMES_ROMAN))
    .setFontSize(12);
document.add(standardFontParagraph);

// 사용자 정의 폰트 사용 (TTF 파일)
PdfFont customFont = PdfFontFactory.createFont("path/to/font.ttf", PdfEncodings.IDENTITY_H);
Paragraph customFontParagraph = new Paragraph("이것은 사용자 정의 폰트입니다.")
    .setFont(customFont)
    .setFontSize(12);
document.add(customFontParagraph);
    

📝 폰트 관련 참고사항:

1. 표준 폰트: PDF에는 14개의 표준 폰트(Helvetica, Times-Roman, Courier 등)가 내장되어 있어.

2. 임베딩: 사용자 정의 폰트를 사용할 때는 PDF에 폰트를 임베딩하는 것이 좋아. 그래야 다른 시스템에서도 동일하게 보여.

3. 인코딩: 한글이나 중국어 같은 비영어 문자를 사용할 때는 IDENTITY_H 인코딩을 사용해야 해.

한글 폰트 사용하기

한글을 포함한 문서를 만들 때는 특별한 주의가 필요해. 다음은 한글 폰트를 사용하는 예제야:


// 한글 폰트 사용 (나눔고딕 예시)
PdfFont koreanFont = PdfFontFactory.createFont("fonts/NanumGothic.ttf", PdfEncodings.IDENTITY_H, true);

Paragraph koreanParagraph = new Paragraph("안녕하세요! 이것은 한글 텍스트입니다.")
    .setFont(koreanFont)
    .setFontSize(12);
document.add(koreanParagraph);
    

한글 폰트를 사용할 때는 반드시 IDENTITY_H 인코딩을 사용해야 해. 그리고 세 번째 파라미터를 true로 설정하면 폰트가 PDF에 임베딩돼서 어떤 시스템에서 열어도 제대로 보여.

텍스트 정렬과 간격 조정

문단의 정렬과 간격도 쉽게 조정할 수 있어:


// 왼쪽 정렬 (기본값)
Paragraph leftAligned = new Paragraph("이 텍스트는 왼쪽 정렬입니다.")
    .setTextAlignment(TextAlignment.LEFT);
document.add(leftAligned);

// 가운데 정렬
Paragraph centerAligned = new Paragraph("이 텍스트는 가운데 정렬입니다.")
    .setTextAlignment(TextAlignment.CENTER);
document.add(centerAligned);

// 오른쪽 정렬
Paragraph rightAligned = new Paragraph("이 텍스트는 오른쪽 정렬입니다.")
    .setTextAlignment(TextAlignment.RIGHT);
document.add(rightAligned);

// 양쪽 정렬
Paragraph justified = new Paragraph("이 텍스트는 양쪽 정렬입니다. 긴 문장을 작성하면 텍스트가 양쪽에 맞춰 정렬됩니다.")
    .setTextAlignment(TextAlignment.JUSTIFIED);
document.add(justified);

// 줄 간격 설정
Paragraph lineSpaced = new Paragraph("이 문단은 줄 간격이 1.5배입니다.\n두 번째 줄입니다.\n세 번째 줄입니다.")
    .setMultipliedLeading(1.5f);
document.add(lineSpaced);
    

고급 텍스트 스타일링: 스타일 객체 사용

여러 곳에서 동일한 스타일을 재사용하고 싶다면 Style 객체를 활용할 수 있어:


// 스타일 객체 생성
Style titleStyle = new Style()
    .setFontSize(18)
    .setBold()
    .setFontColor(ColorConstants.BLUE);

Style normalStyle = new Style()
    .setFontSize(12)
    .setFontColor(ColorConstants.BLACK);

// 스타일 적용
Paragraph title = new Paragraph("제목입니다").addStyle(titleStyle);
document.add(title);

Paragraph content = new Paragraph("일반 내용입니다").addStyle(normalStyle);
document.add(content);
    

이런 방식으로 스타일을 정의하면 문서 전체에서 일관된 디자인을 유지하기 쉬워져. 특히 긴 문서나 템플릿 기반 문서를 만들 때 매우 유용해.

💼 실무 예시: 재능넷에서 프리랜서 계약서 템플릿을 만든다고 가정해보자. 계약서의 제목, 소제목, 일반 텍스트, 중요 조항 등 각각의 스타일을 미리 정의해두면, 수백 개의 계약서를 자동으로 생성할 때도 일관된 디자인을 유지할 수 있어.

텍스트와 폰트는 PDF 문서의 기본이자 핵심이야. 이제 다음 섹션에서는 표와 이미지를 추가하는 방법을 알아볼게!

5. 표와 이미지 삽입하기 - 시각적 요소 더하기 🖼️

텍스트만으로는 정보를 효과적으로 전달하기 어려울 때가 있어. 그럴 때 표와 이미지는 정보를 구조화하고 시각적으로 전달하는 데 큰 도움이 돼. iText를 사용하면 PDF에 표와 이미지를 쉽게 추가할 수 있어.

표(Table) 만들기

iText에서는 Table 클래스를 사용해 표를 만들 수 있어. 다음은 간단한 표를 만드는 예제야:


// 3열 표 생성
Table table = new Table(3);

// 헤더 추가
table.addHeaderCell("이름");
table.addHeaderCell("나이");
table.addHeaderCell("직업");

// 데이터 행 추가
table.addCell("홍길동");
table.addCell("30");
table.addCell("개발자");

table.addCell("김철수");
table.addCell("25");
table.addCell("디자이너");

table.addCell("이영희");
table.addCell("28");
table.addCell("마케터");

// 문서에 표 추가
document.add(table);
    

위 코드는 3열 표를 만들고, 헤더와 3개의 데이터 행을 추가하는 예제야. 결과는 다음과 같아:

이름 나이 직업 홍길동 30 개발자 김철수 25 디자이너 이영희 28 마케터

표 스타일링

표의 너비, 셀 패딩, 테두리, 배경색 등을 설정해서 더 보기 좋은 표를 만들 수 있어:


// 표 생성 및 너비 설정
Table styledTable = new Table(3).useAllAvailableWidth();

// 셀 패딩 설정
styledTable.setMarginTop(20);
styledTable.setMarginBottom(20);
styledTable.setPadding(10);
styledTable.setTextAlignment(TextAlignment.CENTER);

// 헤더 스타일링
Cell headerCell1 = new Cell().add("제품명")
    .setBackgroundColor(ColorConstants.LIGHT_GRAY)
    .setBold()
    .setPadding(5);
Cell headerCell2 = new Cell().add("가격")
    .setBackgroundColor(ColorConstants.LIGHT_GRAY)
    .setBold()
    .setPadding(5);
Cell headerCell3 = new Cell().add("수량")
    .setBackgroundColor(ColorConstants.LIGHT_GRAY)
    .setBold()
    .setPadding(5);

styledTable.addHeaderCell(headerCell1);
styledTable.addHeaderCell(headerCell2);
styledTable.addHeaderCell(headerCell3);

// 데이터 셀 스타일링
styledTable.addCell(new Cell().add("노트북").setPadding(5));
styledTable.addCell(new Cell().add("1,500,000원").setPadding(5));
styledTable.addCell(new Cell().add("2").setPadding(5));

styledTable.addCell(new Cell().add("스마트폰").setPadding(5));
styledTable.addCell(new Cell().add("900,000원").setPadding(5));
styledTable.addCell(new Cell().add("3").setPadding(5));

// 셀 병합 예제
Cell mergedCell = new Cell(1, 3).add("총액: 4,200,000원")
    .setTextAlignment(TextAlignment.RIGHT)
    .setPadding(5)
    .setBackgroundColor(ColorConstants.LIGHT_GRAY);
styledTable.addCell(mergedCell);

document.add(styledTable);
    

위 코드에서는 표의 너비, 셀 패딩, 배경색 등을 설정했고, 마지막에는 3개 열을 병합한 셀도 추가했어. 이런 식으로 복잡한 레이아웃의 표도 만들 수 있어.

이미지 추가하기

PDF에 이미지를 추가하는 것도 매우 간단해. iText는 다양한 이미지 형식(JPEG, PNG, GIF, BMP 등)을 지원해:


// 이미지 파일에서 이미지 생성
ImageData imageData = ImageDataFactory.create("path/to/image.jpg");
Image image = new Image(imageData);

// 이미지 크기 조정
image.setWidth(300);
image.scaleToFit(300, 200);

// 이미지 정렬
image.setHorizontalAlignment(HorizontalAlignment.CENTER);

// 문서에 이미지 추가
document.add(image);
    

이미지 URL에서 직접 이미지를 가져올 수도 있어:


// URL에서 이미지 생성
String imageUrl = "https://example.com/image.jpg";
ImageData imageData = ImageDataFactory.create(new URL(imageUrl));
Image image = new Image(imageData);
document.add(image);
    

💡 TIP: 이미지 크기를 조정할 때는 다음 두 가지 방법이 있어:

1. setWidth()/setHeight(): 정확한 크기를 지정

2. scaleToFit(): 최대 크기를 지정하고 비율 유지

일반적으로 비율을 유지하는 것이 이미지 왜곡을 방지할 수 있어 좋아!

표 안에 이미지 넣기

표와 이미지를 결합해서 더 복잡한 레이아웃을 만들 수도 있어:


// 2열 표 생성
Table imageTable = new Table(2).useAllAvailableWidth();

// 첫 번째 셀에 이미지 추가
ImageData productImage = ImageDataFactory.create("product.jpg");
Image img = new Image(productImage).scaleToFit(100, 100);
Cell imageCell = new Cell().add(img).setBorder(Border.NO_BORDER);
imageTable.addCell(imageCell);

// 두 번째 셀에 제품 정보 추가
Cell infoCell = new Cell().setBorder(Border.NO_BORDER);
infoCell.add(new Paragraph("제품명: 프리미엄 노트북").setBold());
infoCell.add(new Paragraph("가격: 1,500,000원"));
infoCell.add(new Paragraph("평점: ★★★★☆"));
imageTable.addCell(infoCell);

document.add(imageTable);
    

이런 방식으로 제품 카탈로그, 명함, 프로필 카드 등 다양한 레이아웃을 만들 수 있어.

실전 예제: 인보이스 만들기

표와 이미지를 활용한 실전 예제로, 간단한 인보이스를 만들어 볼게:


// 인보이스 문서 생성
Document document = new Document(pdfDoc, PageSize.A4);
document.setMargins(36, 36, 36, 36);

// 회사 로고 추가
ImageData logoData = ImageDataFactory.create("company_logo.png");
Image logo = new Image(logoData).scaleToFit(150, 50);
logo.setHorizontalAlignment(HorizontalAlignment.RIGHT);
document.add(logo);

// 인보이스 제목
document.add(new Paragraph("인보이스").setFontSize(24).setBold());
document.add(new Paragraph("인보이스 번호: INV-2023-001").setFontSize(12));
document.add(new Paragraph("발행일: 2023-06-15").setFontSize(12));
document.add(new Paragraph("\n"));

// 고객 정보
Table customerTable = new Table(2).useAllAvailableWidth();
customerTable.addCell(new Cell().add("청구 대상:").setBold().setBorder(Border.NO_BORDER));
customerTable.addCell(new Cell().add("결제 정보:").setBold().setBorder(Border.NO_BORDER));

Cell customerInfoCell = new Cell().setBorder(Border.NO_BORDER);
customerInfoCell.add(new Paragraph("홍길동"));
customerInfoCell.add(new Paragraph("서울시 강남구 테헤란로 123"));
customerInfoCell.add(new Paragraph("전화: 010-1234-5678"));
customerTable.addCell(customerInfoCell);

Cell paymentInfoCell = new Cell().setBorder(Border.NO_BORDER);
paymentInfoCell.add(new Paragraph("결제 방법: 계좌이체"));
paymentInfoCell.add(new Paragraph("은행: 우리은행"));
paymentInfoCell.add(new Paragraph("계좌번호: 1234-5678-9012"));
customerTable.addCell(paymentInfoCell);

document.add(customerTable);
document.add(new Paragraph("\n"));

// 제품 목록 표
Table productTable = new Table(4).useAllAvailableWidth();
productTable.setTextAlignment(TextAlignment.CENTER);

// 헤더
productTable.addHeaderCell(new Cell().add("제품명").setBold().setBackgroundColor(ColorConstants.LIGHT_GRAY));
productTable.addHeaderCell(new Cell().add("단가").setBold().setBackgroundColor(ColorConstants.LIGHT_GRAY));
productTable.addHeaderCell(new Cell().add("수량").setBold().setBackgroundColor(ColorConstants.LIGHT_GRAY));
productTable.addHeaderCell(new Cell().add("금액").setBold().setBackgroundColor(ColorConstants.LIGHT_GRAY));

// 제품 항목
productTable.addCell("웹사이트 디자인");
productTable.addCell("500,000원");
productTable.addCell("1");
productTable.addCell("500,000원");

productTable.addCell("로고 디자인");
productTable.addCell("300,000원");
productTable.addCell("1");
productTable.addCell("300,000원");

productTable.addCell("호스팅 서비스 (1년)");
productTable.addCell("120,000원");
productTable.addCell("1");
productTable.addCell("120,000원");

// 합계
Cell totalLabelCell = new Cell(1, 3).add("합계:")
    .setTextAlignment(TextAlignment.RIGHT)
    .setBold();
productTable.addCell(totalLabelCell);
productTable.addCell(new Cell().add("920,000원").setBold());

document.add(productTable);
document.add(new Paragraph("\n"));

// 감사 메시지
document.add(new Paragraph("이용해 주셔서 감사합니다!").setTextAlignment(TextAlignment.CENTER));

document.close();
    

이런 식으로 표와 이미지를 조합하면 전문적인 비즈니스 문서를 쉽게 만들 수 있어. 재능넷에서 프리랜서 활동을 하면서 클라이언트에게 인보이스나 견적서를 자동으로 생성해 보내는 시스템을 구축한다면, 이런 기능이 매우 유용할 거야!

다음 섹션에서는 PDF 양식과 대화형 요소를 만드는 방법에 대해 알아볼게.

6. PDF 양식과 대화형 요소 만들기 📝

PDF는 단순히 정보를 표시하는 것 외에도 사용자와 상호작용할 수 있는 다양한 기능을 제공해. 양식 필드, 버튼, 체크박스 등의 대화형 요소를 추가하면 사용자가 직접 PDF에 정보를 입력하고 제출할 수 있어. iText를 사용하면 이런 대화형 PDF를 쉽게 만들 수 있어.

기본 양식 필드 추가하기

먼저 양식(Form) 필드를 추가하는 기본적인 방법을 알아보자:


// PdfAcroForm 객체 가져오기
PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);

// 텍스트 필드 추가
Rectangle textFieldRect = new Rectangle(100, 700, 200, 20);
PdfTextFormField textField = PdfTextFormField.createText(
    pdfDoc, textFieldRect, "fullName", "");
textField.setPlaceholder("이름을 입력하세요");
form.addField(textField);

// 체크박스 추가
Rectangle checkBoxRect = new Rectangle(100, 650, 20, 20);
PdfButtonFormField checkBox = PdfFormField.createCheckBox(
    pdfDoc, checkBoxRect, "agreement", "Yes", PdfFormField.TYPE_CHECK);
form.addField(checkBox);

// 라디오 버튼 그룹 추가
PdfButtonFormField radioGroup = PdfFormField.createRadioGroup(
    pdfDoc, "gender", "");

Rectangle maleRect = new Rectangle(100, 600, 20, 20);
PdfFormField male = PdfFormField.createRadioButton(
    pdfDoc, maleRect, radioGroup, "M");

Rectangle femaleRect = new Rectangle(150, 600, 20, 20);
PdfFormField female = PdfFormField.createRadioButton(
    pdfDoc, femaleRect, radioGroup, "F");

form.addField(radioGroup);

// 콤보 박스(드롭다운) 추가
Rectangle comboBoxRect = new Rectangle(100, 550, 150, 20);
String[] options = {"선택하세요", "학생", "회사원", "자영업", "기타"};
PdfChoiceFormField comboBox = PdfFormField.createComboBox(
    pdfDoc, comboBoxRect, "occupation", "선택하세요", options);
form.addField(comboBox);

// 버튼 추가
Rectangle buttonRect = new Rectangle(100, 500, 100, 30);
PdfButtonFormField button = PdfFormField.createPushButton(
    pdfDoc, buttonRect, "submit", "제출");
form.addField(button);
    

위 코드는 다양한 양식 필드(텍스트 필드, 체크박스, 라디오 버튼, 콤보 박스, 버튼)를 추가하는 예제야. 각 필드는 문서 내의 특정 위치(Rectangle)에 배치돼.

회원 가입 양식 이름: 이름을 입력하세요 이메일: 성별: 남성 여성 직업: 선택하세요 ▼ 개인정보 수집에 동의합니다. 제출 PDF 양식 예제

양식 필드에 자바스크립트 액션 추가하기

PDF 양식은 자바스크립트를 통해 동적인 기능을 추가할 수 있어. 예를 들어, 버튼을 클릭했을 때 특정 동작을 수행하거나, 필드 값이 변경되었을 때 다른 필드를 업데이트하는 등의 기능을 구현할 수 있어:


// 버튼에 자바스크립트 액션 추가
PdfButtonFormField submitButton = PdfFormField.createPushButton(
    pdfDoc, new Rectangle(100, 400, 100, 30), "submit", "제출");

// 자바스크립트 액션 정의
String javaScript = 
    "app.alert('양식이 제출되었습니다!');" +
    "this.submitForm('https://example.com/submit', false, false, true);";

// 버튼에 액션 설정
submitButton.setAction(PdfAction.createJavaScript(javaScript));
form.addField(submitButton);

// 필드 값 변경 시 이벤트 처리
PdfTextFormField priceField = PdfTextFormField.createText(
    pdfDoc, new Rectangle(100, 350, 100, 20), "price", "0");

PdfTextFormField quantityField = PdfTextFormField.createText(
    pdfDoc, new Rectangle(210, 350, 100, 20), "quantity", "0");

PdfTextFormField totalField = PdfTextFormField.createText(
    pdfDoc, new Rectangle(320, 350, 100, 20), "total", "0");
totalField.setReadOnly(true);

// 가격이나 수량이 변경되면 총액 계산
String calculateTotal = 
    "var price = this.getField('price').value;" +
    "var quantity = this.getField('quantity').value;" +
    "var total = price * quantity;" +
    "this.getField('total').value = total;";

priceField.setAdditionalAction(PdfName.K, PdfAction.createJavaScript(calculateTotal));
quantityField.setAdditionalAction(PdfName.K, PdfAction.createJavaScript(calculateTotal));

form.addField(priceField);
form.addField(quantityField);
form.addField(totalField);
    

위 코드에서는 두 가지 자바스크립트 액션을 추가했어:

  1. 제출 버튼을 클릭하면 알림 메시지를 표시하고 양식을 서버로 제출
  2. 가격이나 수량 필드의 값이 변경되면 자동으로 총액을 계산

⚠️ 주의사항: PDF의 자바스크립트는 일반 웹 자바스크립트와 다소 차이가 있어. 또한 PDF 리더마다 지원하는 기능이 다를 수 있으니 주요 PDF 리더(Adobe Acrobat, PDF-XChange 등)에서 테스트해보는 것이 좋아.

양식 데이터 미리 채우기

때로는 PDF 양식을 생성할 때 일부 필드에 기본값을 미리 채워야 할 경우가 있어. iText에서는 다음과 같이 할 수 있어:


// 양식 필드 생성
PdfTextFormField nameField = PdfTextFormField.createText(
    pdfDoc, new Rectangle(100, 700, 200, 20), "name", "");
PdfTextFormField emailField = PdfTextFormField.createText(
    pdfDoc, new Rectangle(100, 650, 200, 20), "email", "");
PdfTextFormField phoneField = PdfTextFormField.createText(
    pdfDoc, new Rectangle(100, 600, 200, 20), "phone", "");

// 양식에 필드 추가
form.addField(nameField);
form.addField(emailField);
form.addField(phoneField);

// 필드 값 설정
form.getField("name").setValue("홍길동");
form.getField("email").setValue("hong@example.com");
form.getField("phone").setValue("010-1234-5678");
    

이 방법은 데이터베이스나 외부 시스템에서 가져온 정보로 PDF 양식을 자동으로 채울 때 매우 유용해. 예를 들어, 고객 정보로 계약서 양식을 미리 채우거나, 주문 정보로 배송 라벨을 생성하는 등의 작업을 자동화할 수 있어.

양식 필드 스타일링

양식 필드의 외관도 커스터마이징할 수 있어:


// 스타일이 적용된 텍스트 필드
PdfTextFormField styledTextField = PdfTextFormField.createText(
    pdfDoc, new Rectangle(100, 500, 200, 30), "styledField", "");

// 필드 스타일 설정
styledTextField.setBorderWidth(2);
styledTextField.setBorderColor(ColorConstants.BLUE);
styledTextField.setBackgroundColor(ColorConstants.LIGHT_GRAY);
styledTextField.setFontSize(12);
styledTextField.setFontColor(ColorConstants.DARK_GRAY);
styledTextField.setJustification(PdfFormField.ALIGN_CENTER);

form.addField(styledTextField);
    

이런 식으로 테두리, 배경색, 폰트 크기, 텍스트 정렬 등을 설정해서 양식의 시각적 일관성과 가독성을 높일 수 있어.

실전 예제: 간단한 설문조사 양식 만들기

이제 배운 내용을 활용해서 간단한 설문조사 양식을 만들어보자:


// 문서 생성
PdfDocument pdfDoc = new PdfDocument(new PdfWriter("survey_form.pdf"));
Document document = new Document(pdfDoc);

// 제목 추가
document.add(new Paragraph("고객 만족도 설문조사").setFontSize(20).setBold()
    .setTextAlignment(TextAlignment.CENTER));
document.add(new Paragraph("귀하의 소중한 의견을 들려주세요.").setFontSize(12)
    .setTextAlignment(TextAlignment.CENTER));
document.add(new Paragraph("\n"));

// 기본 정보 섹션
document.add(new Paragraph("1. 기본 정보").setFontSize(14).setBold());
document.add(new Paragraph("\n"));

// AcroForm 객체 가져오기
PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);

// 이름 필드
document.add(new Paragraph("이름:"));
Rectangle nameRect = new Rectangle(100, 650, 200, 20);
PdfTextFormField nameField = PdfTextFormField.createText(
    pdfDoc, nameRect, "name", "");
form.addField(nameField);

// 이메일 필드
document.add(new Paragraph("이메일:"));
Rectangle emailRect = new Rectangle(100, 620, 200, 20);
PdfTextFormField emailField = PdfTextFormField.createText(
    pdfDoc, emailRect, "email", "");
form.addField(emailField);

// 만족도 평가 섹션
document.add(new Paragraph("\n2. 서비스 만족도 평가").setFontSize(14).setBold());
document.add(new Paragraph("다음 항목에 대한 만족도를 선택해주세요."));
document.add(new Paragraph("\n"));

// 서비스 품질 평가
document.add(new Paragraph("서비스 품질:"));
PdfButtonFormField qualityGroup = PdfFormField.createRadioGroup(
    pdfDoc, "quality", "");

// 1점부터 5점까지의 라디오 버튼
for (int i = 1; i <= 5; i++) {
    Rectangle radioRect = new Rectangle(100 + (i-1)*30, 550, 20, 20);
    PdfFormField radio = PdfFormField.createRadioButton(
        pdfDoc, radioRect, qualityGroup, String.valueOf(i));
    document.add(new Paragraph(String.valueOf(i))
        .setFixedPosition(105 + (i-1)*30, 530, 20));
}
form.addField(qualityGroup);

// 가격 만족도 평가
document.add(new Paragraph("\n가격 만족도:"));
PdfButtonFormField priceGroup = PdfFormField.createRadioGroup(
    pdfDoc, "price", "");

// 1점부터 5점까지의 라디오 버튼
for (int i = 1; i <= 5; i++) {
    Rectangle radioRect = new Rectangle(100 + (i-1)*30, 500, 20, 20);
    PdfFormField radio = PdfFormField.createRadioButton(
        pdfDoc, radioRect, priceGroup, String.valueOf(i));
    document.add(new Paragraph(String.valueOf(i))
        .setFixedPosition(105 + (i-1)*30, 480, 20));
}
form.addField(priceGroup);

// 추가 의견
document.add(new Paragraph("\n3. 추가 의견").setFontSize(14).setBold());
document.add(new Paragraph("개선사항이나 추가 의견을 자유롭게 작성해주세요:"));

Rectangle commentRect = new Rectangle(100, 400, 400, 60);
PdfTextFormField commentField = PdfTextFormField.createMultilineText(
    pdfDoc, commentRect, "comment", "");
form.addField(commentField);

// 제출 버튼
Rectangle submitRect = new Rectangle(250, 320, 100, 30);
PdfButtonFormField submitButton = PdfFormField.createPushButton(
    pdfDoc, submitRect, "submit", "제출하기");
submitButton.setBackgroundColor(ColorConstants.BLUE);
submitButton.setBorderColor(ColorConstants.BLUE);
submitButton.setFontColor(ColorConstants.WHITE);

// 제출 버튼에 자바스크립트 액션 추가
String submitJS = "app.alert('설문에 참여해주셔서 감사합니다!');";
submitButton.setAction(PdfAction.createJavaScript(submitJS));
form.addField(submitButton);

document.close();
    

이 예제는 이름, 이메일 입력 필드, 서비스 품질과 가격에 대한 평가를 위한 라디오 버튼, 추가 의견을 위한 멀티라인 텍스트 필드, 그리고 제출 버튼이 포함된 설문조사 양식을 생성해. 이런 대화형 PDF는 고객 피드백 수집, 주문 양식, 신청서 등 다양한 비즈니스 용도로 활용할 수 있어.

재능넷과 같은 플랫폼에서는 프리랜서와 클라이언트 간의 계약서, 프로젝트 요구사항 문서, 피드백 양식 등을 PDF로 자동화하면 업무 효율성을 크게 높일 수 있어!

7. 기존 PDF 수정 및 병합하기 🔄

지금까지는 새로운 PDF를 처음부터 만드는 방법을 알아봤어. 하지만 실무에서는 기존 PDF를 수정하거나 여러 PDF를 하나로 병합해야 하는 경우가 많아. 이번 섹션에서는 iText를 사용해 기존 PDF를 다루는 방법을 알아볼게.

기존 PDF 파일 열기

먼저 기존 PDF 파일을 여는 방법부터 알아보자:


// 기존 PDF 파일 열기
PdfReader reader = new PdfReader("input.pdf");
PdfWriter writer = new PdfWriter("output.pdf");
PdfDocument pdfDoc = new PdfDocument(reader, writer);

// 이제 pdfDoc을 사용해 PDF를 수정할 수 있음

// 작업 완료 후 문서 닫기
pdfDoc.close();
    

위 코드는 'input.pdf' 파일을 열고, 수정 후 'output.pdf'로 저장하는 기본 구조야. PdfReader는 입력 파일을 읽고, PdfWriter는 출력 파일을 쓰는 역할을 해.

페이지 추가 및 삭제

기존 PDF에서 페이지를 추가하거나 삭제하는 방법은 다음과 같아:


// 기존 PDF 열기
PdfDocument pdfDoc = new PdfDocument(
    new PdfReader("input.pdf"), 
    new PdfWriter("output.pdf")
);

// 새 페이지 추가
pdfDoc.addNewPage();

// 특정 위치에 페이지 추가
pdfDoc.addNewPage(2); // 2번 위치에 새 페이지 추가

// 페이지 삭제
pdfDoc.removePage(3); // 3번 페이지 삭제

pdfDoc.close();
    

💡 TIP: PDF에서 페이지 번호는 1부터 시작해. 즉, 첫 번째 페이지는 1번, 두 번째 페이지는 2번이야.

여러 PDF 병합하기

여러 PDF 파일을 하나로 병합하는 것은 보고서, 계약서 등을 만들 때 매우 유용해:


// 출력 PDF 생성
PdfWriter writer = new PdfWriter("merged.pdf");
PdfDocument pdfDoc = new PdfDocument(writer);

// 첫 번째 PDF 병합
PdfReader reader1 = new PdfReader("document1.pdf");
PdfDocument pdfDoc1 = new PdfDocument(reader1);
pdfDoc1.copyPagesTo(1, pdfDoc1.getNumberOfPages(), pdfDoc);
pdfDoc1.close();

// 두 번째 PDF 병합
PdfReader reader2 = new PdfReader("document2.pdf");
PdfDocument pdfDoc2 = new PdfDocument(reader2);
pdfDoc2.copyPagesTo(1, pdfDoc2.getNumberOfPages(), pdfDoc);
pdfDoc2.close();

// 세 번째 PDF 병합
PdfReader reader3 = new PdfReader("document3.pdf");
PdfDocument pdfDoc3 = new PdfDocument(reader3);
pdfDoc3.copyPagesTo(1, pdfDoc3.getNumberOfPages(), pdfDoc);
pdfDoc3.close();

pdfDoc.close();
    

이 코드는 세 개의 PDF 파일('document1.pdf', 'document2.pdf', 'document3.pdf')을 순서대로 병합해서 'merged.pdf'라는 새 파일을 만들어. copyPagesTo() 메서드는 소스 문서의 특정 페이지 범위를 대상 문서로 복사해.

PDF 1 PDF 2 PDF 3 병합된 PDF PDF 1 내용 PDF 2 내용 PDF 3 내용 PDF 병합 과정

특정 페이지만 추출하기

때로는 큰 PDF에서 특정 페이지만 추출해야 할 때가 있어:


// 원본 PDF 열기
PdfDocument sourcePdf = new PdfDocument(new PdfReader("source.pdf"));

// 새 PDF 생성
PdfDocument targetPdf = new PdfDocument(new PdfWriter("extracted.pdf"));

// 특정 페이지만 복사 (예: 2, 5, 7페이지)
sourcePdf.copyPagesTo(2, 2, targetPdf); // 2페이지
sourcePdf.copyPagesTo(5, 5, targetPdf); // 5페이지
sourcePdf.copyPagesTo(7, 7, targetPdf); // 7페이지

// 문서 닫기
sourcePdf.close();
targetPdf.close();
    

이 코드는 원본 PDF에서 2, 5, 7페이지만 추출해서 새 PDF를 만들어. 비연속적인 페이지도 추출할 수 있다는 게 장점이야.

PDF에 워터마크 추가하기

문서 보안이나 브랜딩을 위해 PDF에 워터마크를 추가하는 것은 매우 일반적인 작업이야:


// 기존 PDF 열기
PdfDocument pdfDoc = new PdfDocument(
    new PdfReader("input.pdf"), 
    new PdfWriter("watermarked.pdf")
);

// 모든 페이지에 워터마크 추가
Document document = new Document(pdfDoc);
int numberOfPages = pdfDoc.getNumberOfPages();

// 워터마크 텍스트 생성
Paragraph watermark = new Paragraph("CONFIDENTIAL")
    .setFontColor(ColorConstants.LIGHT_GRAY)
    .setFontSize(60)
    .setOpacity(0.5f);

// 각 페이지에 워터마크 추가
for (int i = 1; i <= numberOfPages; i++) {
    // 페이지 크기 가져오기
    Rectangle pageSize = pdfDoc.getPage(i).getPageSize();
    
    // 워터마크 위치 설정 (페이지 중앙, 대각선으로)
    float x = pageSize.getWidth() / 2;
    float y = pageSize.getHeight() / 2;
    
    // 워터마크 추가
    document.showTextAligned(watermark, x, y, i, 
        TextAlignment.CENTER, VerticalAlignment.MIDDLE, 45);
}

document.close();
    

이 코드는 모든 페이지의 중앙에 반투명한 "CONFIDENTIAL" 워터마크를 45도 각도로 추가해. 워터마크는 회사 로고, 기밀 표시, 초안 표시 등 다양한 용도로 활용할 수 있어.

PDF 페이지 회전하기

때로는 PDF 페이지의 방향을 변경해야 할 때가 있어:


// 기존 PDF 열기
PdfDocument pdfDoc = new PdfDocument(
    new PdfReader("input.pdf"), 
    new PdfWriter("rotated.pdf")
);

// 특정 페이지 회전 (예: 2페이지를 90도 회전)
pdfDoc.getPage(2).setRotation(90);

// 모든 페이지 회전
for (int i = 1; i <= pdfDoc.getNumberOfPages(); i++) {
    pdfDoc.getPage(i).setRotation(90);
}

pdfDoc.close();
    

setRotation() 메서드는 0, 90, 180, 270도 값을 받아 페이지를 회전시켜. 이 기능은 가로 방향 콘텐츠를 세로 방향으로 변경하거나, 스캔된 문서의 방향을 수정할 때 유용해.

실전 예제: PDF 문서 분할 및 병합 유틸리티

이제 배운 내용을 활용해서 PDF를 분할하고 병합하는 유틸리티 클래스를 만들어보자:


public class PdfUtility {
    
    /**
     * PDF 파일을 여러 개의 작은 PDF로 분할
     * @param inputPath 입력 PDF 경로
     * @param outputFolder 출력 폴더 경로
     * @param pagesPerFile 파일당 페이지 수
     */
    public static void splitPdf(String inputPath, String outputFolder, int pagesPerFile) throws IOException {
        PdfDocument sourcePdf = new PdfDocument(new PdfReader(inputPath));
        int totalPages = sourcePdf.getNumberOfPages();
        
        for (int i = 0; i < totalPages; i += pagesPerFile) {
            int startPage = i + 1;
            int endPage = Math.min(i + pagesPerFile, totalPages);
            
            String outputPath = outputFolder + "/split_" + startPage + "_to_" + endPage + ".pdf";
            PdfDocument targetPdf = new PdfDocument(new PdfWriter(outputPath));
            
            sourcePdf.copyPagesTo(startPage, endPage, targetPdf);
            targetPdf.close();
            
            System.out.println("Created: " + outputPath);
        }
        
        sourcePdf.close();
    }
    
    /**
     * 여러 PDF 파일을 하나로 병합
     * @param inputPaths 입력 PDF 경로 목록
     * @param outputPath 출력 PDF 경로
     */
    public static void mergePdfs(List<String> inputPaths, String outputPath) throws IOException {
        PdfDocument targetPdf = new PdfDocument(new PdfWriter(outputPath));
        
        for (String inputPath : inputPaths) {
            PdfDocument sourcePdf = new PdfDocument(new PdfReader(inputPath));
            sourcePdf.copyPagesTo(1, sourcePdf.getNumberOfPages(), targetPdf);
            sourcePdf.close();
        }
        
        targetPdf.close();
        System.out.println("Merged PDF created: " + outputPath);
    }
    
    /**
     * PDF에 페이지 번호 추가
     * @param inputPath 입력 PDF 경로
     * @param outputPath 출력 PDF 경로
     */
    public static void addPageNumbers(String inputPath, String outputPath) throws IOException {
        PdfDocument pdfDoc = new PdfDocument(
            new PdfReader(inputPath), 
            new PdfWriter(outputPath)
        );
        
        Document document = new Document(pdfDoc);
        int numberOfPages = pdfDoc.getNumberOfPages();
        
        // 각 페이지에 페이지 번호 추가
        for (int i = 1; i <= numberOfPages; i++) {
            Rectangle pageSize = pdfDoc.getPage(i).getPageSize();
            
            // 페이지 하단 중앙에 페이지 번호 추가
            Paragraph pageNumber = new Paragraph(String.format("Page %d of %d", i, numberOfPages))
                .setFontSize(10);
            
            float x = pageSize.getWidth() / 2;
            float y = 20; // 하단에서 20포인트 위
            
            document.showTextAligned(pageNumber, x, y, i, 
                TextAlignment.CENTER, VerticalAlignment.BOTTOM, 0);
        }
        
        document.close();
        System.out.println("Added page numbers: " + outputPath);
    }
    
    // 메인 메서드 예시
    public static void main(String[] args) {
        try {
            // PDF 분할 예시
            splitPdf("large_document.pdf", "./output", 10);
            
            // PDF 병합 예시
            List<String> filesToMerge = Arrays.asList(
                "document1.pdf", 
                "document2.pdf", 
                "document3.pdf"
            );
            mergePdfs(filesToMerge, "merged_document.pdf");
            
            // 페이지 번호 추가 예시
            addPageNumbers("document.pdf", "document_with_page_numbers.pdf");
            
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
    

이 유틸리티 클래스는 세 가지 주요 기능을 제공해:

  1. 큰 PDF를 여러 개의 작은 PDF로 분할
  2. 여러 PDF를 하나로 병합
  3. PDF에 페이지 번호 추가

이런 기능은 대용량 보고서 처리, 문서 아카이빙, 출판 준비 등 다양한 비즈니스 시나리오에서 유용하게 활용할 수 있어. 재능넷에서 문서 관리 시스템을 구축하거나 프리랜서 프로젝트에서 문서 자동화 솔루션을 개발할 때 이런 유틸리티가 큰 도움이 될 거야!

8. PDF 보안과 암호화 적용하기 🔒

PDF 문서에는 종종 민감한 정보가 포함되어 있어서 보안이 중요해. iText는 암호 보호, 권한 제한, 디지털 서명 등 다양한 보안 기능을 제공해. 이번 섹션에서는 PDF에 보안을 적용하는 방법을 알아볼게.

암호 보호 설정하기

가장 기본적인 보안 방법은 PDF에 암호를 설정하는 거야:


// 암호로 보호된 PDF 생성
WriterProperties writerProperties = new WriterProperties();

// 문서 열기 암호 설정
byte[] userPassword = "user123".getBytes();
writerProperties.setStandardEncryption(
    userPassword, 
    null,  // 소유자 암호는 null (사용자 암호와 동일)
    EncryptionConstants.ALLOW_PRINTING, 
    EncryptionConstants.ENCRYPTION_AES_128
);

// PDF 생성
PdfWriter writer = new PdfWriter("protected.pdf", writerProperties);
PdfDocument pdfDoc = new PdfDocument(writer);
Document document = new Document(pdfDoc);

document.add(new Paragraph("이 문서는 암호로 보호되어 있습니다."));
document.add(new Paragraph("암호: user123"));

document.close();
    

위 코드는 "user123"이라는 암호로 보호된 PDF를 생성해. 이 PDF를 열려면 사용자가 암호를 입력해야 해.

사용자 권한 제한하기

PDF에는 두 종류의 암호가 있어:

  1. 사용자 암호(User Password): 문서를 열기 위한 암호
  2. 소유자 암호(Owner Password): 문서의 권한을 변경하기 위한 암호

소유자 암호를 설정하고 사용자 권한을 제한하는 방법은 다음과 같아:


// 권한이 제한된 PDF 생성
WriterProperties writerProperties = new WriterProperties();

byte[] userPassword = "user123".getBytes();
byte[] ownerPassword = "owner456".getBytes();

// 권한 설정 (인쇄만 허용, 편집/복사 불가)
writerProperties.setStandardEncryption(
    userPassword, 
    ownerPassword, 
    EncryptionConstants.ALLOW_PRINTING, 
    EncryptionConstants.ENCRYPTION_AES_256
);

PdfWriter writer = new PdfWriter("restricted.pdf", writerProperties);
PdfDocument pdfDoc = new PdfDocument(writer);
Document document = new Document(pdfDoc);

document.add(new Paragraph("이 문서는 권한이 제한되어 있습니다."));
document.add(new Paragraph("인쇄는 가능하지만 편집이나 복사는 불가능합니다."));

document.close();
    

이 코드는 사용자가 문서를 열고 인쇄할 수는 있지만, 내용을 복사하거나 편집할 수는 없도록 제한해. EncryptionConstants 클래스는 다양한 권한 옵션을 제공해:

  1. ALLOW_PRINTING: 인쇄 허용
  2. ALLOW_DEGRADED_PRINTING: 저해상도 인쇄 허용
  3. ALLOW_MODIFY_CONTENTS: 내용 수정 허용
  4. ALLOW_COPY: 내용 복사 허용
  5. ALLOW_MODIFY_ANNOTATIONS: 주석 수정 허용
  6. ALLOW_FILL_IN: 양식 필드 채우기 허용
  7. ALLOW_SCREENREADERS: 스크린 리더 접근 허용
  8. ALLOW_ASSEMBLY: 문서 조립 허용
  9. ALLOW_ALL: 모든 작업 허용

여러 권한을 조합하려면 비트 OR 연산자(|)를 사용해:


// 인쇄와 복사는 허용하지만 편집은 불가능하게 설정
int permissions = EncryptionConstants.ALLOW_PRINTING | EncryptionConstants.ALLOW_COPY;

writerProperties.setStandardEncryption(
    userPassword, 
    ownerPassword, 
    permissions, 
    EncryptionConstants.ENCRYPTION_AES_256
);
    
🖨️ 인쇄 ✏️ 편집 📋 복사 📝 주석 PDF 권한 제한 예시

디지털 서명 추가하기

디지털 서명은 문서의 진위성과 무결성을 보장하는 고급 보안 기능이야. iText에서는 다음과 같이 디지털 서명을 추가할 수 있어:


// 키스토어에서 인증서 로드
KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());
ks.load(new FileInputStream("keystore.p12"), "password".toCharArray());
String alias = ks.aliases().nextElement();
PrivateKey pk = (PrivateKey) ks.getKey(alias, "password".toCharArray());
Certificate[] chain = ks.getCertificateChain(alias);

// 서명된 PDF 생성
PdfReader reader = new PdfReader("document.pdf");
PdfSigner signer = new PdfSigner(
    reader, 
    new FileOutputStream("signed.pdf"), 
    new StampingProperties()
);

// 서명 모양 설정
Rectangle rect = new Rectangle(400, 200, 200, 100);
PdfSignatureAppearance appearance = signer.getSignatureAppearance()
    .setReason("문서 승인")
    .setLocation("서울")
    .setReuseAppearance(false)
    .setPageRect(rect)
    .setPageNumber(1);

// 서명 생성
IExternalSignature pks = new PrivateKeySignature(pk, DigestAlgorithms.SHA256, null);
IExternalDigest digest = new BouncyCastleDigest();

signer.signDetached(digest, pks, chain, null, null, null, 0, PdfSigner.CryptoStandard.CMS);
    

⚠️ 주의사항: 디지털 서명을 사용하려면 BouncyCastle 라이브러리가 필요해. Maven이나 Gradle 의존성에 다음을 추가해야 해:


// Maven
<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcprov-jdk15on</artifactId>
    <version>1.70</version>
</dependency>
<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcpkix-jdk15on</artifactId>
    <version>1.70</version>
</dependency>
      

PDF 암호화 수준

iText는 다양한 암호화 알고리즘과 수준을 지원해:

  1. ENCRYPTION_AES_128: AES 128비트 암호화 (PDF 1.7)
  2. ENCRYPTION_AES_256: AES 256비트 암호화 (PDF 2.0)
  3. ENCRYPTION_AES_256_V3: AES 256비트 암호화 (PDF 2.0 개선 버전)

보안이 중요한 문서라면 최신 AES 256비트 암호화를 사용하는 것이 좋아:


writerProperties.setStandardEncryption(
    userPassword, 
    ownerPassword, 
    permissions, 
    EncryptionConstants.ENCRYPTION_AES_256
);
    

기존 PDF의 보안 설정 변경하기

기존 PDF의 보안 설정을 변경하는 것도 가능해. 예를 들어, 암호로 보호된 PDF의 암호를 제거하거나 변경할 수 있어:


// 암호로 보호된 PDF 열기
ReaderProperties readerProperties = new ReaderProperties();
readerProperties.setPassword("oldPassword".getBytes());
PdfReader reader = new PdfReader("protected.pdf", readerProperties);

// 새로운 보안 설정으로 저장
WriterProperties writerProperties = new WriterProperties();
// 새 암호 설정 또는 암호 제거
writerProperties.setStandardEncryption(
    "newPassword".getBytes(),  // 새 암호 설정
    null,
    EncryptionConstants.ALLOW_ALL,  // 모든 권한 허용
    EncryptionConstants.ENCRYPTION_AES_256
);

// 또는 암호 완전히 제거
// WriterProperties writerProperties = new WriterProperties();

PdfWriter writer = new PdfWriter("new_security.pdf", writerProperties);
PdfDocument pdfDoc = new PdfDocument(reader, writer);
pdfDoc.close();
    

위 코드는 "oldPassword"로 보호된 PDF를 열고, "newPassword"로 암호를 변경하거나 주석 처리된 부분처럼 암호를 완전히 제거할 수 있어.

실전 예제: 보안 PDF 생성기

이제 배운 내용을 활용해서 다양한 보안 설정을 적용할 수 있는 유틸리티 클래스를 만들어보자:


public class PdfSecurityUtil {
    
    /**
     * 사용자 암호로 보호된 PDF 생성
     * @param inputPath 입력 PDF 경로
     * @param outputPath 출력 PDF 경로
     * @param userPassword 사용자 암호
     */
    public static void protectWithUserPassword(
            String inputPath, String outputPath, String userPassword) throws IOException {
        
        // 보안 설정
        WriterProperties writerProperties = new WriterProperties();
        writerProperties.setStandardEncryption(
            userPassword.getBytes(), 
            null,  // 소유자 암호는 null (사용자 암호와 동일)
            EncryptionConstants.ALLOW_ALL, 
            EncryptionConstants.ENCRYPTION_AES_256
        );
        
        // PDF 처리
        PdfReader reader = new PdfReader(inputPath);
        PdfWriter writer = new PdfWriter(outputPath, writerProperties);
        PdfDocument pdfDoc = new PdfDocument(reader, writer);
        pdfDoc.close();
        
        System.out.println("Created password-protected PDF: " + outputPath);
    }
    
    /**
     * 권한이 제한된 PDF 생성
     * @param inputPath 입력 PDF 경로
     * @param outputPath 출력 PDF 경로
     * @param userPassword 사용자 암호
     * @param ownerPassword 소유자 암호
     * @param allowPrinting 인쇄 허용 여부
     * @param allowCopy 복사 허용 여부
     * @param allowModify 수정 허용 여부
     */
    public static void createRestrictedPdf(
            String inputPath, String outputPath, 
            String userPassword, String ownerPassword,
            boolean allowPrinting, boolean allowCopy, boolean allowModify) throws IOException {
        
        // 권한 설정
        int permissions = 0;
        if (allowPrinting) {
            permissions |= EncryptionConstants.ALLOW_PRINTING;
        }
        if (allowCopy) {
            permissions |= EncryptionConstants.ALLOW_COPY;
        }
        if (allowModify) {
            permissions |= EncryptionConstants.ALLOW_MODIFY_CONTENTS;
        }
        
        // 보안 설정
        WriterProperties writerProperties = new WriterProperties();
        writerProperties.setStandardEncryption(
            userPassword.getBytes(), 
            ownerPassword.getBytes(), 
            permissions, 
            EncryptionConstants.ENCRYPTION_AES_256
        );
        
        // PDF 처리
        PdfReader reader = new PdfReader(inputPath);
        PdfWriter writer = new PdfWriter(outputPath, writerProperties);
        PdfDocument pdfDoc = new PdfDocument(reader, writer);
        pdfDoc.close();
        
        System.out.println("Created restricted PDF: " + outputPath);
    }
    
    /**
     * PDF 암호 제거
     * @param inputPath 입력 PDF 경로
     * @param outputPath 출력 PDF 경로
     * @param currentPassword 현재 암호
     */
    public static void removePassword(
            String inputPath, String outputPath, String currentPassword) throws IOException {
        
        // 암호로 보호된 PDF 열기
        ReaderProperties readerProperties = new ReaderProperties();
        readerProperties.setPassword(currentPassword.getBytes());
        PdfReader reader = new PdfReader(inputPath, readerProperties);
        
        // 암호 없이 저장
        PdfWriter writer = new PdfWriter(outputPath);
        PdfDocument pdfDoc = new PdfDocument(reader, writer);
        pdfDoc.close();
        
        System.out.println("Removed password from PDF: " + outputPath);
    }
    
    // 메인 메서드 예시
    public static void main(String[] args) {
        try {
            // 사용자 암호로 보호
            protectWithUserPassword(
                "document.pdf", 
                "protected_document.pdf", 
                "user123"
            );
            
            // 권한 제한 설정
            createRestrictedPdf(
                "document.pdf", 
                "restricted_document.pdf", 
                "user123",  // 사용자 암호
                "owner456", // 소유자 암호
                true,       // 인쇄 허용
                false,      // 복사 불허용
                false       // 수정 불허용
            );
            
            // 암호 제거
            removePassword(
                "protected_document.pdf", 
                "unprotected_document.pdf", 
                "user123"
            );
            
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
    

이 유틸리티 클래스는 세 가지 주요 기능을 제공해:

  1. 사용자 암호로 PDF 보호
  2. 권한 제한이 있는 PDF 생성
  3. 기존 PDF의 암호 제거

이런 보안 기능은 기밀 문서, 계약서, 재무 보고서 등 민감한 정보가 포함된 PDF를 다룰 때 매우 중요해. 재능넷에서 프리랜서와 클라이언트 간의 계약서나 중요 문서를 안전하게 관리하는 데 이런 기능이 유용하게 활용될 수 있어!

9. 고급 기능과 실전 프로젝트 🚀

지금까지 iText의 기본적인 기능들을 살펴봤어. 이제 더 복잡한 실무 시나리오에서 활용할 수 있는 고급 기능과 실전 프로젝트에 대해 알아보자!

HTML을 PDF로 변환하기

웹 페이지나 HTML 콘텐츠를 PDF로 변환해야 할 때가 많아. iText에서는 pdfHTML 확장 모듈을 사용해 이 작업을 수행할 수 있어:


// pdfHTML 의존성 추가 필요
// implementation 'com.itextpdf:html2pdf:4.0.3'

// HTML을 PDF로 변환
public static void convertHtmlToPdf(String html, String pdfPath) throws IOException {
    // PDF 문서 생성
    PdfWriter writer = new PdfWriter(pdfPath);
    PdfDocument pdf = new PdfDocument(writer);
    pdf.setDefaultPageSize(PageSize.A4);
    
    // HTML을 PDF로 변환
    ConverterProperties properties = new ConverterProperties();
    HtmlConverter.convertToPdf(html, pdf, properties);
    
    System.out.println("HTML to PDF conversion completed: " + pdfPath);
}

// 사용 예시
String html = 
    "<html>" +
    "<head>" +
    "  <style>" +
    "    body { font-family: Arial, sans-serif; }" +
    "    h1 { color: #1a73e8; }" +
    "    .container { padding: 20px; }" +
    "    table { border-collapse: collapse; width: 100%; }" +
    "    table, th, td { border: 1px solid #ddd; padding: 8px; }" +
    "    th { background-color: #f2f2f2; }" +
    "  </style>" +
    "</head>" +
    "<body>" +
    "  <div class='container'>" +
    "    <h1>HTML to PDF 변환 예제</h1>" +
    "    <p>이 HTML 콘텐츠는 PDF로 변환됩니다.</p>" +
    "    <table>" +
    "      <tr><th>이름</th><th>나이</th><th>직업</th></tr>" +
    "      <tr><td>홍길동</td><td>30</td><td>개발자</td></tr>" +
    "      <tr><td>김철수</td><td>25</td><td>디자이너</td></tr>" +
    "      <tr><td>이영희</td><td>28</td><td>마케터</td></tr>" +
    "    </table>" +
    "  </div>" +
    "</body>" +
    "</html>";

convertHtmlToPdf(html, "html_to_pdf.pdf");
    

HTML 파일에서도 변환할 수 있어:


// HTML 파일을 PDF로 변환
public static void convertHtmlFileToPdf(String htmlPath, String pdfPath) throws IOException {
    // HTML 파일 읽기
    File htmlFile = new File(htmlPath);
    
    // PDF 문서 생성
    PdfWriter writer = new PdfWriter(pdfPath);
    PdfDocument pdf = new PdfDocument(writer);
    
    // 변환 속성 설정
    ConverterProperties properties = new ConverterProperties();
    // 기본 경로 설정 (상대 경로의 이미지 등을 처리하기 위함)
    properties.setBaseUri(htmlFile.getParent());
    
    // HTML을 PDF로 변환
    HtmlConverter.convertToPdf(new FileInputStream(htmlFile), pdf, properties);
    
    System.out.println("HTML file to PDF conversion completed: " + pdfPath);
}
    

이 기능은 웹 콘텐츠를 보관하거나, 웹 기반 보고서를 PDF로 내보내거나, 이메일 템플릿을 PDF 첨부 파일로 변환할 때 매우 유용해.

PDF/A 표준 준수 문서 생성

PDF/A는 장기 보존을 위한 PDF 표준이야. 정부 기관이나 아카이브에서 많이 사용돼. iText로 PDF/A 문서를 생성하는 방법은 다음과 같아:


// PDF/A-3b 문서 생성
public static void createPdfA(String outputPath) throws IOException {
    // 출력 스트림 생성
    PdfWriter writer = new PdfWriter(outputPath);
    PdfDocument pdf = new PdfDocument(writer);
    
    // PDF/A-3b 준수 설정
    PdfADocument pdfA = new PdfADocument(
        writer, 
        PdfAConformanceLevel.PDF_A_3B, 
        new PdfOutputIntent(
            "Custom", "", "http://www.color.org", 
            "sRGB IEC61966-2.1", 
            new FileInputStream("sRGB_CS_profile.icm")
        )
    );
    
    Document document = new Document(pdfA);
    
    // 폰트 임베딩 (PDF/A에서는 필수)
    PdfFont font = PdfFontFactory.createFont(
        StandardFonts.HELVETICA, 
        PdfEncodings.WINANSI, 
        true
    );
    
    // 내용 추가
    document.add(new Paragraph("이 문서는 PDF/A-3b 표준을 준수합니다.")
        .setFont(font));
    
    document.close();
    System.out.println("PDF/A document created: " + outputPath);
}
    

💡 참고: PDF/A 문서를 생성하려면 색상 프로파일(ICC 프로파일)이 필요해. 위 예제에서는 'sRGB_CS_profile.icm' 파일을 사용했는데, 이 파일은 인터넷에서 무료로 다운로드할 수 있어.

바코드 및 QR 코드 생성

iText의 barcodes 모듈을 사용하면 다양한 바코드와 QR 코드를 PDF에 추가할 수 있어:


// 바코드 생성
public static void addBarcodes(String outputPath) throws IOException {
    PdfDocument pdfDoc = new PdfDocument(new PdfWriter(outputPath));
    Document document = new Document(pdfDoc);
    
    // 제목 추가
    document.add(new Paragraph("바코드 및 QR 코드 예제").setFontSize(20).setBold());
    document.add(new Paragraph("\n"));
    
    // 1D 바코드 (Code128) 생성
    Barcode128 code128 = new Barcode128(pdfDoc);
    code128.setCode("1234567890");
    code128.setSize(12);
    code128.setBaseline(10);
    
    // 바코드 이미지 생성 및 추가
    Image code128Image = new Image(code128.createFormXObject(pdfDoc));
    document.add(new Paragraph("Code 128 바코드:"));
    document.add(code128Image);
    document.add(new Paragraph("\n"));
    
    // QR 코드 생성
    BarcodeQRCode qrCode = new BarcodeQRCode("https://www.jaenung.net");
    
    // QR 코드 이미지 생성 및 추가
    Image qrCodeImage = new Image(qrCode.createFormXObject(pdfDoc));
    qrCodeImage.setWidth(100);
    qrCodeImage.setHeight(100);
    document.add(new Paragraph("QR 코드:"));
    document.add(qrCodeImage);
    
    document.close();
    System.out.println("PDF with barcodes created: " + outputPath);
}
    

이 기능은 제품 카탈로그, 티켓, 배송 라벨, 명함 등 다양한 문서에 활용할 수 있어.

바코드 및 QR 코드 예제 Code 128 바코드: 1234567890 QR 코드: 바코드 및 QR 코드 예제

PDF에 책갈피(북마크) 추가

긴 문서에서는 책갈피(북마크)가 탐색을 쉽게 해줘. iText에서는 다음과 같이 책갈피를 추가할 수 있어:


// 책갈피가 있는 PDF 생성
public static void createPdfWithBookmarks(String outputPath) throws IOException {
    PdfDocument pdfDoc = new PdfDocument(new PdfWriter(outputPath));
    Document document = new Document(pdfDoc);
    
    // 목차 생성
    PdfOutline rootOutline = pdfDoc.getOutlines(false);
    
    // 첫 번째 장
    document.add(new Paragraph("1. 서론").setFontSize(20).setBold());
    PdfOutline chapter1 = rootOutline.addOutline("1. 서론");
    chapter1.addDestination(PdfExplicitDestination.createFitH(pdfDoc.getPage(1), 800));
    
    document.add(new Paragraph("이것은 서론입니다. 문서의 개요와 목적을 설명합니다."));
    document.add(new Paragraph("\n"));
    
    // 1.1 섹션
    document.add(new Paragraph("1.1 연구 배경").setFontSize(16).setBold());
    PdfOutline section1_1 = chapter1.addOutline("1.1 연구 배경");
    section1_1.addDestination(PdfExplicitDestination.createFitH(pdfDoc.getPage(1), 700));
    
    document.add(new Paragraph("연구 배경에 대한 설명입니다."));
    document.add(new Paragraph("\n"));
    
    // 1.2 섹션
    document.add(new Paragraph("1.2 연구 목적").setFontSize(16).setBold());
    PdfOutline section1_2 = chapter1.addOutline("1.2 연구 목적");
    section1_2.addDestination(PdfExplicitDestination.createFitH(pdfDoc.getPage(1), 600));
    
    document.add(new Paragraph("연구 목적에 대한 설명입니다."));
    document.add(new Paragraph("\n"));
    
    // 두 번째 장을 위한 새 페이지
    document.add(new AreaBreak(AreaBreakType.NEXT_PAGE));
    
    // 두 번째 장
    document.add(new Paragraph("2. 이론적 배경").setFontSize(20).setBold());
    PdfOutline chapter2 = rootOutline.addOutline("2. 이론적 배경");
    chapter2.addDestination(PdfExplicitDestination.createFitH(pdfDoc.getPage(2), 800));
    
    document.add(new Paragraph("이론적 배경에 대한 설명입니다."));
    document.add(new Paragraph("\n"));
    
    // 2.1 섹션
    document.add(new Paragraph("2.1 관련 연구").setFontSize(16).setBold());
    PdfOutline section2_1 = chapter2.addOutline("2.1 관련 연구");
    section2_1.addDestination(PdfExplicitDestination.createFitH(pdfDoc.getPage(2), 700));
    
    document.add(new Paragraph("관련 연구에 대한 설명입니다."));
    
    document.close();
    System.out.println("PDF with bookmarks created: " + outputPath);
}
    

이 코드는 계층적 책갈피 구조를 가진 PDF를 생성해. 책갈피는 PDF 리더의 북마크 패널에 표시되어 사용자가 쉽게 문서를 탐색할 수 있게 해줘.

실전 프로젝트: 인보이스 생성 시스템

이제 배운 내용을 종합해서 실제 비즈니스에서 활용할 수 있는 인보이스 생성 시스템을 만들어보자:


public class InvoiceGenerator {
    
    // 인보이스 데이터 클래스
    public static class InvoiceData {
        private String invoiceNumber;
        private String date;
        private String dueDate;
        private String customerName;
        private String customerAddress;
        private String customerEmail;
        private List<InvoiceItem> items;
        private double taxRate;
        
        // 생성자, getter, setter 생략
    }
    
    // 인보이스 항목 클래스
    public static class InvoiceItem {
        private String description;
        private int quantity;
        private double unitPrice;
        
        // 생성자, getter, setter 생략
        
        public double getTotal() {
            return quantity * unitPrice;
        }
    }
    
    /**
     * 인보이스 PDF 생성
     * @param data 인보이스 데이터
     * @param logoPath 로고 이미지 경로
     * @param outputPath 출력 PDF 경로
     */
    public static void generateInvoice(InvoiceData data, String logoPath, String outputPath) throws IOException {
        // PDF 문서 생성
        PdfWriter writer = new PdfWriter(outputPath);
        PdfDocument pdf = new PdfDocument(writer);
        Document document = new Document(pdf);
        
        // 폰트 설정
        PdfFont headerFont = PdfFontFactory.createFont(StandardFonts.HELVETICA_BOLD);
        PdfFont bodyFont = PdfFontFactory.createFont(StandardFonts.HELVETICA);
        
        // 로고 추가
        if (logoPath != null && !logoPath.isEmpty()) {
            ImageData logoData = ImageDataFactory.create(logoPath);
            Image logo = new Image(logoData).scaleToFit(150, 50);
            logo.setHorizontalAlignment(HorizontalAlignment.RIGHT);
            document.add(logo);
        }
        
        // 인보이스 제목
        document.add(new Paragraph("인보이스")
            .setFont(headerFont)
            .setFontSize(24)
            .setBold());
        
        // 인보이스 정보
        Table infoTable = new Table(2).useAllAvailableWidth();
        infoTable.setMarginTop(20);
        
        // 왼쪽 열: 인보이스 정보
        Cell infoCell = new Cell().setBorder(Border.NO_BORDER);
        infoCell.add(new Paragraph("인보이스 번호: " + data.invoiceNumber).setFont(bodyFont));
        infoCell.add(new Paragraph("발행일: " + data.date).setFont(bodyFont));
        infoCell.add(new Paragraph("지불 기한: " + data.dueDate).setFont(bodyFont));
        infoTable.addCell(infoCell);
        
        // 오른쪽 열: 고객 정보
        Cell customerCell = new Cell().setBorder(Border.NO_BORDER);
        customerCell.add(new Paragraph("청구 대상:").setFont(headerFont).setBold());
        customerCell.add(new Paragraph(data.customerName).setFont(bodyFont));
        customerCell.add(new Paragraph(data.customerAddress).setFont(bodyFont));
        customerCell.add(new Paragraph(data.customerEmail).setFont(bodyFont));
        infoTable.addCell(customerCell);
        
        document.add(infoTable);
        document.add(new Paragraph("\n"));
        
        // 항목 테이블
        Table itemTable = new Table(new float[]{4, 1, 2, 2}).useAllAvailableWidth();
        itemTable.setMarginTop(20);
        
        // 테이블 헤더
        itemTable.addHeaderCell(new Cell().add(new Paragraph("설명").setFont(headerFont))
            .setBackgroundColor(ColorConstants.LIGHT_GRAY));
        itemTable.addHeaderCell(new Cell().add(new Paragraph("수량").setFont(headerFont))
            .setBackgroundColor(ColorConstants.LIGHT_GRAY)
            .setTextAlignment(TextAlignment.CENTER));
        itemTable.addHeaderCell(new Cell().add(new Paragraph("단가").setFont(headerFont))
            .setBackgroundColor(ColorConstants.LIGHT_GRAY)
            .setTextAlignment(TextAlignment.RIGHT));
        itemTable.addHeaderCell(new Cell().add(new Paragraph("금액").setFont(headerFont))
            .setBackgroundColor(ColorConstants.LIGHT_GRAY)
            .setTextAlignment(TextAlignment.RIGHT));
        
        // 항목 추가
        double subtotal = 0;
        for (InvoiceItem item : data.items) {
            itemTable.addCell(new Cell().add(new Paragraph(item.description).setFont(bodyFont)));
            itemTable.addCell(new Cell().add(new Paragraph(String.valueOf(item.quantity)).setFont(bodyFont))
                .setTextAlignment(TextAlignment.CENTER));
            itemTable.addCell(new Cell().add(new Paragraph(String.format("%,.0f원", item.unitPrice)).setFont(bodyFont))
                .setTextAlignment(TextAlignment.RIGHT));
            itemTable.addCell(new Cell().add(new Paragraph(String.format("%,.0f원", item.getTotal())).setFont(bodyFont))
                .setTextAlignment(TextAlignment.RIGHT));
            
            subtotal += item.getTotal();
        }
        
        // 소계, 세금, 합계
        double tax = subtotal * data.taxRate;
        double total = subtotal + tax;
        
        itemTable.addCell(new Cell(1, 3).add(new Paragraph("소계").setFont(headerFont))
            .setTextAlignment(TextAlignment.RIGHT)
            .setBorder(Border.NO_BORDER));
        itemTable.addCell(new Cell().add(new Paragraph(String.format("%,.0f원", subtotal)).setFont(bodyFont))
            .setTextAlignment(TextAlignment.RIGHT));
        
        itemTable.addCell(new Cell(1, 3).add(new Paragraph("세금 (" + (data.taxRate * 100) + "%)").setFont(headerFont))
            .setTextAlignment(TextAlignment.RIGHT)
            .setBorder(Border.NO_BORDER));
        itemTable.addCell(new Cell().add(new Paragraph(String.format("%,.0f원", tax)).setFont(bodyFont))
            .setTextAlignment(TextAlignment.RIGHT));
        
        itemTable.addCell(new Cell(1, 3).add(new Paragraph("합계").setFont(headerFont).setBold())
            .setTextAlignment(TextAlignment.RIGHT)
            .setBorder(Border.NO_BORDER));
        itemTable.addCell(new Cell().add(new Paragraph(String.format("%,.0f원", total)).setFont(headerFont).setBold())
            .setTextAlignment(TextAlignment.RIGHT)
            .setBackgroundColor(ColorConstants.LIGHT_GRAY));
        
        document.add(itemTable);
        document.add(new Paragraph("\n"));
        
        // 결제 정보
        document.add(new Paragraph("결제 정보").setFont(headerFont).setBold());
        document.add(new Paragraph("계좌번호: 123-456-789012 (우리은행)").setFont(bodyFont));
        document.add(new Paragraph("예금주: 주식회사 재능넷").setFont(bodyFont));
        document.add(new Paragraph("\n"));
        
        // 감사 메시지
        document.add(new Paragraph("이용해 주셔서 감사합니다!")
            .setFont(bodyFont)
            .setTextAlignment(TextAlignment.CENTER)
            .setItalic());
        
        // QR 코드 추가 (결제 링크 등)
        BarcodeQRCode qrCode = new BarcodeQRCode("https://www.jaenung.net/pay?invoice=" + data.invoiceNumber);
        Image qrCodeImage = new Image(qrCode.createFormXObject(pdf));
        qrCodeImage.setWidth(80);
        qrCodeImage.setHeight(80);
        qrCodeImage.setHorizontalAlignment(HorizontalAlignment.CENTER);
        document.add(qrCodeImage);
        
        // 문서 닫기
        document.close();
        System.out.println("Invoice generated: " + outputPath);
    }
    
    // 사용 예시
    public static void main(String[] args) {
        try {
            // 인보이스 데이터 생성
            InvoiceData invoice = new InvoiceData();
            invoice.invoiceNumber = "INV-2023-001";
            invoice.date = "2023-06-15";
            invoice.dueDate = "2023-06-30";
            invoice.customerName = "홍길동";
            invoice.customerAddress = "서울시 강남구 테헤란로 123";
            invoice.customerEmail = "hong@example.com";
            invoice.taxRate = 0.1; // 10% 세금
            
            // 인보이스 항목 추가
            List<InvoiceItem> items = new ArrayList<>();
            
            InvoiceItem item1 = new InvoiceItem();
            item1.description = "웹사이트 디자인";
            item1.quantity = 1;
            item1.unitPrice = 500000;
            items.add(item1);
            
            InvoiceItem item2 = new InvoiceItem();
            item2.description = "로고 디자인";
            item2.quantity = 1;
            item2.unitPrice = 300000;
            items.add(item2);
            
            InvoiceItem item3 = new InvoiceItem();
            item3.description = "호스팅 서비스 (1년)";
            item3.quantity = 1;
            item3.unitPrice = 120000;
            items.add(item3);
            
            invoice.items = items;
            
            // 인보이스 생성
            generateInvoice(invoice, "company_logo.png", "invoice.pdf");
            
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
    

이 인보이스 생성 시스템은 다음과 같은 기능을 제공해:

  1. 회사 로고 추가
  2. 인보이스 및 고객 정보 표시
  3. 항목 목록과 가격 계산
  4. 세금 및 합계 계산
  5. 결제 정보 표시
  6. QR 코드를 통한 결제 링크 제공

이런 시스템은 재능넷과 같은 플랫폼에서 프리랜서가 클라이언트에게 전문적인 인보이스를 자동으로 생성해 보낼 때 매우 유용해. 데이터베이스에서 정보를 가져와 수백 개의 인보이스를 한 번에 생성할 수도 있어!

이처럼 iText의 고급 기능을 활용하면 다양한 비즈니스 요구사항을 충족하는 PDF 솔루션을 개발할 수 있어. 다음 섹션에서는 iText의 대안과 비교 분석을 해볼게.

10. iText 대안과 비교 분석 🔍

iText는 강력한 PDF 라이브러리지만, 프로젝트의 요구사항과 예산에 따라 다른 라이브러리가 더 적합할 수도 있어. 이번 섹션에서는 iText의 주요 대안들을 살펴보고 각각의 장단점을 비교해볼게.

주요 PDF 라이브러리 비교

  1. iText

    장점: 강력한 기능, 높은 성능, 풍부한 문서화, 오랜 역사와 안정성

    단점: AGPL 라이선스(상업적 사용 시 유료), 복잡한 API

    적합한 경우: 엔터프라이즈급 애플리케이션, 복잡한 PDF 처리, 상업적 라이선스 구매 가능한 경우

  2. Apache PDFBox

    장점: Apache 라이선스(무료), 오픈소스, 다양한 기능

    단점: iText보다 성능이 다소 떨어짐, 문서화가 덜 풍부함

    적합한 경우: 오픈소스 프로젝트, 무료 라이선스가 필요한 경우, 기본적인 PDF 처리

  3. OpenPDF

    장점: LGPL/MPL 라이선스(대부분의 상업적 사용 무료), iText 5.x의 포크

    단점: 최신 PDF 기능 지원이 제한적, 개발 속도가 느림

    적합한 경우: iText 5.x 코드베이스를 사용하는 프로젝트, 무료 라이선스가 필요한 경우

  4. PdfJS-Express

    장점: 웹 기반, 사용하기 쉬운 API, 뷰어 기능 포함

    단점: 유료, 서버 측 PDF 생성에는 적합하지 않음

    적합한 경우: 웹 애플리케이션, PDF 뷰어 기능이 필요한 경우

  5. JasperReports

    장점: 보고서 생성에 특화, 디자이너 도구 제공

    단점: PDF 조작보다는 보고서 생성에 중점

    적합한 경우: 비즈니스 보고서, 데이터 시각화가 필요한 경우

기능 완성도 성능 사용 편의성 라이선스 문서화 iText Apache PDFBox OpenPDF PDF 라이브러리 비교

라이선스 비교

PDF 라이브러리를 선택할 때 라이선스는 매우 중요한 고려사항이야. 특히 상업적 프로젝트에서는 라이선스 비용이 큰 영향을 미칠 수 있어:

  1. iText

    AGPL v3 라이선스: 소스 코드를 공개하지 않으려면 상업용 라이선스 구매 필요

    상업용 라이선스: 기업 규모와 사용 범위에 따라 가격이 다름 (수천 달러부터)

  2. Apache PDFBox

    Apache License 2.0: 상업적 사용, 수정, 배포 모두 무료

    소스 코드 공개 의무 없음

  3. OpenPDF

    LGPL/MPL 라이선스: 라이브러리 자체를 수정하지 않는 한 소스 코드 공개 의무 없음

    대부분의 상업적 사용 무료

  4. JasperReports

    LGPL 라이선스: 기본 버전은 무료

    JasperReports Server: 상업용 라이선스 필요

성능 비교

대용량 PDF를 처리하거나 많은 수의 PDF를 생성해야 하는 경우 성능은 중요한 요소야:

PDF 생성 속도 (1000페이지 문서 기준, 상대적 비교)

  1. iText: 가장 빠름 (기준)
  2. Apache PDFBox: iText보다 약 20-30% 느림
  3. OpenPDF: iText보다 약 15-25% 느림
  4. JasperReports: 복잡한 보고서의 경우 iText보다 훨씬 느릴 수 있음

메모리 사용량

  1. iText: 효율적인 메모리 관리
  2. Apache PDFBox: 대용량 파일 처리 시 더 많은 메모리 사용
  3. OpenPDF: iText 5.x 기반으로 비슷한 메모리 효율성

사용 편의성 비교

개발자 경험과 학습 곡선도 중요한 고려사항이야:

  1. iText

    학습 곡선: 가파름 (특히 iText 7)

    API 일관성: 높음 (iText 7에서 크게 개선됨)

    문서화: 매우 풍부 (책, 튜토리얼, 예제 코드 다수)

  2. Apache PDFBox

    학습 곡선: 중간

    API 일관성: 중간

    문서화: 적절하지만 iText보다 덜 포괄적

  3. OpenPDF

    학습 곡선: iText 5.x와 동일 (상대적으로 완만)

    API 일관성: 중간

    문서화: iText 5.x 문서 참조 가능

  4. JasperReports

    학습 곡선: 보고서 디자인에 초점을 맞추면 가파름

    디자이너 도구: JasperSoft Studio 제공 (시각적 디자인 가능)

    문서화: 풍부함

어떤 라이브러리를 선택해야 할까?

프로젝트 요구사항에 따라 적합한 라이브러리가 달라질 수 있어:

iText를 선택해야 하는 경우:

  1. 엔터프라이즈급 애플리케이션을 개발 중이고 상업적 라이선스 비용을 감당할 수 있는 경우
  2. 최신 PDF 기능과 높은 성능이 필요한 경우
  3. 복잡한 PDF 조작이 필요한 경우 (양식, 디지털 서명 등)
  4. 풍부한 문서와 커뮤니티 지원이 중요한 경우

Apache PDFBox를 선택해야 하는 경우:

  1. 무료 오픈소스 라이선스가 필수적인 경우
  2. 기본적인 PDF 생성 및 조작 기능만 필요한 경우
  3. Apache 생태계의 다른 프로젝트와 통합이 필요한 경우

OpenPDF를 선택해야 하는 경우:

  1. 기존에 iText 5.x를 사용하고 있고 무료 라이선스가 필요한 경우
  2. iText와 유사한 API를 원하지만 AGPL 라이선스는 피하고 싶은 경우

JasperReports를 선택해야 하는 경우:

  1. 데이터 기반 보고서 생성이 주요 목적인 경우
  2. 시각적 보고서 디자이너 도구가 필요한 경우
  3. 다양한 출력 형식(PDF, Excel, HTML 등)을 지원해야 하는 경우

실제 사용 사례별 추천

몇 가지 일반적인 사용 사례에 따른 추천 라이브러리를 알아보자:

  1. 인보이스/영수증 생성

    추천: iText 또는 OpenPDF

    이유: 템플릿 기반 문서 생성에 적합하며, 표와 이미지 처리가 우수함

  2. 대용량 보고서 생성

    추천: JasperReports 또는 iText

    이유: 데이터 시각화와 복잡한 레이아웃 처리에 강함

  3. 기존 PDF 수정/주석 추가

    추천: Apache PDFBox 또는 iText

    이유: 기존 PDF 조작 기능이 풍부함

  4. PDF 양식 생성 및 처리

    추천: iText

    이유: 가장 강력한 양식 처리 기능 제공

  5. PDF 분할/병합/압축

    추천: Apache PDFBox 또는 iText

    이유: 문서 조작 기능이 우수함

재능넷과 같은 플랫폼에서는 다양한 PDF 요구사항이 있을 수 있어. 프리랜서 계약서, 인보이스, 프로젝트 보고서 등 여러 종류의 문서를 다뤄야 한다면 iText의 종합적인 기능이 유리할 수 있어. 하지만 라이선스 비용이 부담된다면 Apache PDFBox나 OpenPDF도 좋은 대안이 될 수 있어.

결국 가장 중요한 것은 프로젝트의 구체적인 요구사항과 제약 조건을 고려해서 적합한 라이브러리를 선택하는 거야. 각 라이브러리의 장단점을 잘 이해하고 프로젝트에 맞는 최선의 선택을 하는 것이 중요해!

11. 자주 묻는 질문과 문제 해결 ❓

iText를 사용하면서 자주 발생하는 질문과 문제들에 대한 해결책을 모아봤어. 이 섹션을 통해 개발 과정에서 마주칠 수 있는 여러 난관을 쉽게 극복할 수 있을 거야!

Q1: iText 5와 iText 7의 주요 차이점은 무엇인가요?

A: iText 7은 iText 5를 완전히 재설계한 버전이야. 주요 차이점은 다음과 같아:

  1. 모듈화된 구조: iText 7은 핵심 기능과 추가 기능이 분리된 모듈 구조를 가짐
  2. 개선된 API: 더 직관적이고 일관된 API 디자인
  3. 고급 레이아웃 기능: 더 복잡한 레이아웃과 스타일링 지원
  4. 확장성: 사용자 정의 렌더러, 이벤트 핸들러 등을 통한 더 나은 확장성
  5. 향상된 문서화: 더 포괄적인 문서와 예제

하지만 iText 5와 iText 7은 API가 완전히 다르기 때문에, 기존 코드를 마이그레이션하려면 상당한 수정이 필요해.

Q2: 한글이 포함된 PDF를 생성할 때 글자가 깨지는 문제는 어떻게 해결하나요?

A: 한글 문제는 주로 폰트 관련 이슈야. 다음과 같이 해결할 수 있어:


// 한글 폰트 사용 (나눔고딕 예시)
PdfFont koreanFont = PdfFontFactory.createFont(
    "fonts/NanumGothic.ttf",  // 폰트 파일 경로
    PdfEncodings.IDENTITY_H,  // 유니코드 인코딩
    true                      // 폰트 임베딩
);

// 한글 텍스트 추가
Paragraph paragraph = new Paragraph("안녕하세요! 한글 텍스트입니다.")
    .setFont(koreanFont);
document.add(paragraph);
        

주요 포인트:

  1. 한글을 지원하는 폰트 파일(TTF)을 사용해야 함
  2. IDENTITY_H 인코딩을 사용해야 함
  3. 폰트를 임베딩해야 모든 시스템에서 제대로 표시됨

Q3: OutOfMemoryError가 발생할 때 어떻게 해결하나요?

A: 대용량 PDF를 처리할 때 메모리 부족 오류가 발생할 수 있어. 다음 방법으로 해결해보자:

  1. JVM 힙 메모리 증가: -Xmx 옵션을 사용해 JVM 힙 크기 증가 (예: -Xmx1024m)
  2. 청크 처리: 대용량 문서를 작은 청크로 나눠서 처리
  3. 리소스 해제: 사용 후 Document, PdfDocument 등의 객체를 명시적으로 close()
  4. 이미지 최적화: 이미지 크기와 해상도 최적화
  5. 부분 모드 사용: PdfWriter.setFullCompression(false) 설정으로 메모리 사용량 감소

예시 코드:


// 청크 처리 예시
public void processLargeDocument(String src, String dest) throws IOException {
    // 입력 PDF 열기
    PdfDocument srcDoc = new PdfDocument(new PdfReader(src));
    int n = srcDoc.getNumberOfPages();
    srcDoc.close();
    
    // 청크 크기 (한 번에 처리할 페이지 수)
    final int CHUNK_SIZE = 100;
    
    // 출력 PDF 생성
    PdfDocument pdfDoc = new PdfDocument(new PdfWriter(dest));
    
    // 청크 단위로 처리
    for (int i = 0; i < n; i += CHUNK_SIZE) {
        int endPage = Math.min(i + CHUNK_SIZE, n);
        
        // 청크 읽기
        PdfDocument chunkDoc = new PdfDocument(
            new PdfReader(src, new ReaderProperties().setPartialRead(true).setRangeBegin(i + 1).setRangeEnd(endPage))
        );
        
        // 페이지 복사
        chunkDoc.copyPagesTo(1, chunkDoc.getNumberOfPages(), pdfDoc);
        
        // 청크 문서 닫기
        chunkDoc.close();
        
        // 메모리 정리 유도
        System.gc();
    }
    
    // 최종 문서 닫기
    pdfDoc.close();
}
        

Q4: PDF에 페이지 번호를 어떻게 추가하나요?

A: 페이지 번호는 다음과 같이 추가할 수 있어:


// 페이지 번호 추가
public void addPageNumbers(String src, String dest) throws IOException {
    PdfDocument pdfDoc = new PdfDocument(
        new PdfReader(src), 
        new PdfWriter(dest)
    );
    Document document = new Document(pdfDoc);
    
    int numberOfPages = pdfDoc.getNumberOfPages();
    
    // 모든 페이지에 페이지 번호 추가
    for (int i = 1; i <= numberOfPages; i++) {
        // 페이지 크기 가져오기
        Rectangle pageSize = pdfDoc.getPage(i).getPageSize();
        
        // 페이지 번호 텍스트 생성
        Paragraph footer = new Paragraph(String.format("페이지 %d / %d", i, numberOfPages))
            .setFontSize(10);
        
        // 페이지 하단 중앙에 배치
        float x = pageSize.getWidth() / 2;
        float y = pageSize.getBottom() + 30;
        
        document.showTextAligned(footer, x, y, i, 
            TextAlignment.CENTER, VerticalAlignment.BOTTOM, 0);
    }
    
    document.close();
}
        

이 코드는 각 페이지 하단 중앙에 "페이지 X / Y" 형식의 페이지 번호를 추가해.

Q5: iText의 라이선스 요구사항은 무엇인가요?

A: iText 7은 AGPL v3 라이선스로 제공돼. 이 라이선스의 주요 요구사항은:

  1. AGPL 라이선스 하에서 사용할 경우:
    • 소프트웨어를 수정하면 수정 사항을 공개해야 함
    • iText를 사용하는 전체 애플리케이션의 소스 코드를 AGPL로 공개해야 함
    • 네트워크를 통해 서비스를 제공하는 경우에도 소스 코드 공개 의무가 있음
  2. 상업적 라이선스를 구매한 경우:
    • 소스 코드 공개 의무 없음
    • 기술 지원 및 추가 기능 제공
    • 라이선스 비용은 사용 사례와 기업 규모에 따라 다름

내부 사용이나 비상업적 프로젝트라도 AGPL 요구사항을 충족해야 하므로, 소스 코드를 공개하기 어려운 상업적 프로젝트에서는 상업적 라이선스 구매를 고려해야 해.

Q6: PDF 문서의 크기를 어떻게 최적화할 수 있나요?

A: PDF 크기를 줄이는 여러 방법이 있어:

  1. 이미지 최적화: 해상도 조정, 압축률 증가
  2. 폰트 서브셋팅: 사용된 문자만 포함
  3. 객체 스트림 압축: 내부 객체 압축
  4. 중복 리소스 제거: 동일한 이미지/폰트 재사용

예시 코드:


// PDF 최적화 예시
public void optimizePdf(String src, String dest) throws IOException {
    // 읽기/쓰기 설정
    WriterProperties writerProperties = new WriterProperties();
    writerProperties.setCompressionLevel(CompressionConstants.BEST_COMPRESSION);
    
    PdfDocument pdfDoc = new PdfDocument(
        new PdfReader(src), 
        new PdfWriter(dest, writerProperties)
    );
    
    // 이미지 최적화 설정
    PdfOptimizer optimizer = new PdfOptimizer(pdfDoc);
    OptimizerProperties properties = new OptimizerProperties();
    properties.setImageQuality(0.5f);  // 이미지 품질   <pre><code>
    properties.setImageDpi(96);  // 이미지 해상도 제한
    properties.setCompressContentStreams(true);  // 콘텐츠 스트림 압축
    
    // 최적화 실행
    optimizer.optimize(properties);
    
    pdfDoc.close();
}
        

참고: PdfOptimizer 클래스는 iText pdfOptimizer 확장 모듈이 필요해.

Q7: PDF 문서에 하이퍼링크를 어떻게 추가하나요?

A: 내부 링크와 외부 URL 모두 쉽게 추가할 수 있어:


// 외부 URL 링크 추가
public void addExternalLink(Document document) {
    // 링크 텍스트 생성
    Text linkText = new Text("재능넷 방문하기")
        .setFontColor(ColorConstants.BLUE)
        .setUnderline();
    
    // 링크 액션 설정
    PdfAction action = PdfAction.createURI("https://www.jaenung.net");
    linkText.setAction(action);
    
    // 문서에 링크 추가
    document.add(new Paragraph(linkText));
}

// 내부 링크(문서 내 다른 위치로 이동) 추가
public void addInternalLink(Document document, PdfDocument pdfDoc) {
    // 대상 생성 (3페이지로 이동)
    PdfDestination destination = PdfExplicitDestination.createFitH(pdfDoc.getPage(3), 0);
    
    // 링크 텍스트 생성
    Text linkText = new Text("3페이지로 이동")
        .setFontColor(ColorConstants.BLUE)
        .setUnderline();
    
    // 링크 액션 설정
    PdfAction action = PdfAction.createGoTo(destination);
    linkText.setAction(action);
    
    // 문서에 링크 추가
    document.add(new Paragraph(linkText));
}
        

Q8: PDF 문서에 머리글과 바닥글을 어떻게 추가하나요?

A: 모든 페이지에 일관된 머리글과 바닥글을 추가하는 방법은 다음과 같아:


// 머리글과 바닥글 추가
public void addHeaderAndFooter(String src, String dest) throws IOException {
    PdfDocument pdfDoc = new PdfDocument(
        new PdfReader(src), 
        new PdfWriter(dest)
    );
    Document document = new Document(pdfDoc);
    
    int numberOfPages = pdfDoc.getNumberOfPages();
    
    // 모든 페이지에 머리글과 바닥글 추가
    for (int i = 1; i <= numberOfPages; i++) {
        Rectangle pageSize = pdfDoc.getPage(i).getPageSize();
        
        // 머리글 추가
        Paragraph header = new Paragraph("회사 기밀 문서")
            .setFontSize(10)
            .setItalic();
        
        // 바닥글 추가
        Paragraph footer = new Paragraph("© 2023 재능넷 - 모든 권리 보유")
            .setFontSize(10);
        
        // 페이지 상단에 머리글 배치
        document.showTextAligned(header, pageSize.getWidth() / 2, pageSize.getTop() - 30, i,
            TextAlignment.CENTER, VerticalAlignment.BOTTOM, 0);
        
        // 페이지 하단에 바닥글 배치
        document.showTextAligned(footer, pageSize.getWidth() / 2, pageSize.getBottom() + 30, i,
            TextAlignment.CENTER, VerticalAlignment.BOTTOM, 0);
    }
    
    document.close();
}
        

더 복잡한 머리글/바닥글이 필요하다면 이벤트 핸들러를 사용할 수도 있어:


// 이벤트 핸들러를 사용한 머리글/바닥글
public void addHeaderAndFooterWithEvents(String dest) throws IOException {
    PdfWriter writer = new PdfWriter(dest);
    PdfDocument pdfDoc = new PdfDocument(writer);
    Document document = new Document(pdfDoc);
    
    // 이벤트 핸들러 등록
    pdfDoc.addEventHandler(PdfDocumentEvent.END_PAGE, new HeaderFooterHandler());
    
    // 문서 내용 추가
    for (int i = 0; i < 50; i++) {
        document.add(new Paragraph("테스트 내용 " + i));
    }
    
    document.close();
}

// 머리글/바닥글 이벤트 핸들러
class HeaderFooterHandler implements IEventHandler {
    @Override
    public void handleEvent(Event event) {
        PdfDocumentEvent docEvent = (PdfDocumentEvent) event;
        PdfDocument pdfDoc = docEvent.getDocument();
        PdfPage page = docEvent.getPage();
        Rectangle pageSize = page.getPageSize();
        
        PdfCanvas canvas = new PdfCanvas(page);
        
        // 머리글
        canvas.beginText()
            .setFontAndSize(PdfFontFactory.createFont(StandardFonts.HELVETICA), 10)
            .moveText(pageSize.getWidth() / 2, pageSize.getTop() - 20)
            .showText("회사 기밀 문서")
            .endText();
        
        // 바닥글
        canvas.beginText()
            .setFontAndSize(PdfFontFactory.createFont(StandardFonts.HELVETICA), 10)
            .moveText(pageSize.getWidth() / 2, pageSize.getBottom() + 20)
            .showText("페이지 " + pdfDoc.getPageNumber(page) + " / " + pdfDoc.getNumberOfPages())
            .endText();
    }
}
        

Q9: PDF 문서에서 텍스트를 어떻게 추출하나요?

A: iText를 사용해 PDF에서 텍스트를 추출하는 방법은 다음과 같아:


// PDF에서 텍스트 추출
public String extractText(String pdfPath) throws IOException {
    PdfDocument pdfDoc = new PdfDocument(new PdfReader(pdfPath));
    StringBuilder text = new StringBuilder();
    
    // 모든 페이지의 텍스트 추출
    for (int i = 1; i <= pdfDoc.getNumberOfPages(); i++) {
        PdfPage page = pdfDoc.getPage(i);
        
        // 텍스트 추출 전략 생성
        LocationTextExtractionStrategy strategy = new LocationTextExtractionStrategy();
        
        // 페이지에서 텍스트 추출
        String pageText = PdfTextExtractor.getTextFromPage(page, strategy);
        text.append(pageText).append("\n");
    }
    
    pdfDoc.close();
    return text.toString();
}
        

참고: 텍스트 추출은 PDF 구조에 따라 결과가 달라질 수 있어. 특히 복잡한 레이아웃이나 스캔된 PDF에서는 정확도가 떨어질 수 있어.

Q10: PDF 생성 시 메모리 사용량을 줄이는 방법은 무엇인가요?

A: 대용량 PDF를 생성할 때 메모리 사용량을 최적화하는 방법은 다음과 같아:

  1. 부분 쓰기 모드 사용: 페이지를 생성하자마자 디스크에 쓰기
  2. 이미지 최적화: 필요한 해상도로만 이미지 로드
  3. 리소스 즉시 해제: 사용 후 즉시 객체 닫기
  4. 청크 처리: 데이터를 작은 단위로 처리

예시 코드:


// 메모리 최적화 PDF 생성
public void createLargeDocumentOptimized(String dest, int numberOfPages) throws IOException {
    // 부분 쓰기 모드 활성화
    WriterProperties writerProperties = new WriterProperties();
    writerProperties.useSmartMode();
    
    PdfWriter writer = new PdfWriter(dest, writerProperties);
    PdfDocument pdfDoc = new PdfDocument(writer);
    Document document = new Document(pdfDoc);
    
    // 데이터 소스 (예: 대용량 데이터베이스 결과)
    List<String> dataSource = getLargeDataSource();
    
    // 청크 단위로 처리
    int chunkSize = 100;
    for (int i = 0; i < dataSource.size(); i += chunkSize) {
        // 현재 청크 가져오기
        List<String> chunk = dataSource.subList(
            i, 
            Math.min(i + chunkSize, dataSource.size())
        );
        
        // 청크 처리
        for (String data : chunk) {
            document.add(new Paragraph(data));
            
            // 필요시 페이지 나누기
            if (document.getPdfDocument().getNumberOfPages() % 10 == 0) {
                document.add(new AreaBreak(AreaBreakType.NEXT_PAGE));
            }
        }
        
        // 메모리 정리 유도
        System.gc();
    }
    
    document.close();
}

// 대용량 데이터 소스 예시 (실제로는 DB나 파일에서 가져올 수 있음)
private List<String> getLargeDataSource() {
    List<String> data = new ArrayList<>();
    // 대량의 데이터 생성...
    return data;
}
        

Q11: PDF 문서에 목차(TOC)를 어떻게 생성하나요?

A: 목차는 북마크와 내부 링크를 조합해서 만들 수 있어:


// PDF에 목차 추가
public void createPdfWithTOC(String dest) throws IOException {
    PdfDocument pdfDoc = new PdfDocument(new PdfWriter(dest));
    Document document = new Document(pdfDoc);
    
    // 목차 페이지 생성
    document.add(new Paragraph("목차").setFontSize(20).setBold());
    
    // 목차 항목 (나중에 채울 예정)
    List<Paragraph> tocItems = new ArrayList<>();
    Map<String, Integer> pageNumbers = new HashMap<>();
    
    // 목차 자리 표시자 추가
    for (int i = 1; i <= 5; i++) {
        String title = i + ". 장 제목 " + i;
        Paragraph tocItem = new Paragraph(title);
        tocItems.add(tocItem);
        document.add(tocItem);
    }
    
    // 목차와 본문 사이 페이지 나누기
    document.add(new AreaBreak(AreaBreakType.NEXT_PAGE));
    
    // 본문 내용 생성
    for (int i = 1; i <= 5; i++) {
        String title = i + ". 장 제목 " + i;
        
        // 현재 페이지 번호 저장
        pageNumbers.put(title, pdfDoc.getNumberOfPages());
        
        // 장 제목 추가
        document.add(new Paragraph(title).setFontSize(18).setBold());
        
        // 내용 추가
        for (int j = 0; j < 5; j++) {
            document.add(new Paragraph("이것은 " + i + "장의 내용입니다. 단락 " + (j+1)));
        }
        
        // 페이지 나누기
        if (i < 5) {
            document.add(new AreaBreak(AreaBreakType.NEXT_PAGE));
        }
    }
    
    // 문서의 첫 페이지로 돌아가서 목차 항목에 링크 추가
    document.setPage(1);
    
    // 목차 항목 업데이트
    for (int i = 0; i < tocItems.size(); i++) {
        String title = (i+1) + ". 장 제목 " + (i+1);
        int pageNum = pageNumbers.get(title);
        
        // 원래 목차 항목 제거
        document.remove(tocItems.get(i));
        
        // 페이지 번호와 함께 새 목차 항목 생성
        Paragraph newTocItem = new Paragraph();
        newTocItem.add(new Text(title));
        newTocItem.add(new Tab());
        
        // 페이지 번호 텍스트에 링크 추가
        Text pageNumText = new Text(String.valueOf(pageNum));
        PdfAction action = PdfAction.createGoTo(
            PdfExplicitDestination.createFitH(pdfDoc.getPage(pageNum), 0)
        );
        pageNumText.setAction(action);
        newTocItem.add(pageNumText);
        
        // 탭 설정
        newTocItem.addTabStops(new TabStop(580, TabAlignment.RIGHT, new DottedLine()));
        
        // 업데이트된 목차 항목 추가
        document.add(newTocItem);
    }
    
    document.close();
}
        

문제 해결 팁

iText를 사용하면서 자주 발생하는 문제와 해결 방법을 정리했어:

1. ClassNotFoundException 또는 NoClassDefFoundError

원인: 필요한 iText 모듈이 클래스패스에 없음

해결책: 필요한 모듈을 의존성에 추가. iText 7은 모듈화되어 있으므로 필요한 기능에 따라 적절한 모듈을 추가해야 함

2. 폰트 관련 문제

원인: 폰트 파일을 찾을 수 없거나 잘못된 인코딩 사용

해결책:

  • 폰트 파일 경로 확인
  • 비ASCII 문자(한글 등)에는 IDENTITY_H 인코딩 사용
  • 폰트 임베딩 활성화

3. 이미지가 표시되지 않거나 깨짐

원인: 이미지 파일 경로 오류, 지원되지 않는 이미지 형식, 메모리 부족

해결책:

  • 이미지 파일 경로 확인
  • 지원되는 이미지 형식 사용 (JPEG, PNG, GIF, BMP, TIFF)
  • 대용량 이미지는 크기 조정 후 사용

4. 레이아웃 문제 (내용 잘림, 페이지 넘침)

원인: 페이지 크기, 여백, 요소 크기 설정 오류

해결책:

  • 적절한 페이지 크기와 여백 설정
  • 요소의 너비를 페이지 너비에 맞게 조정
  • 긴 콘텐츠는 자동 줄바꿈 활성화
  • 테이블의 경우 useAllAvailableWidth() 메서드 사용

5. PDF가 열리지 않거나 손상됨

원인: 문서를 제대로 닫지 않음, 스트림 오류, 잘못된 PDF 구조

해결책:

  • document.close() 호출 확인
  • try-with-resources 구문 사용
  • 예외 처리 시에도 리소스가 닫히도록 finally 블록 사용

도움 받을 수 있는 리소스

iText 사용 중 문제가 발생했을 때 참고할 수 있는 리소스들이야:

  1. 공식 문서: iText API 문서
  2. 튜토리얼: iText 7 Knowledge Base
  3. 샘플 코드: GitHub의 iText 7 예제
  4. 커뮤니티 포럼: Stack Overflow의 iText 7 태그
  5. 책: "iText 7: Building Blocks" (iText 팀 저)

iText는 강력하지만 때로는 복잡한 라이브러리야. 문제가 발생했을 때 당황하지 말고, 위의 리소스를 참고하면 대부분의 문제를 해결할 수 있을 거야. 또한 재능넷 커뮤니티에서도 다른 개발자들의 경험을 공유받을 수 있으니 적극 활용해보자!

결론: PDF의 마법사가 되어보자 🧙‍♂️

지금까지 iText를 사용한 PDF 생성과 조작의 세계를 함께 탐험했어. iText는 단순한 PDF 라이브러리를 넘어, 비즈니스 문서 자동화의 강력한 도구라는 것을 알게 되었을 거야.

배운 내용 요약

  1. iText의 기본 개념과 구조
  2. 텍스트, 이미지, 표 등의 요소 추가 방법
  3. 양식과 대화형 요소 생성 방법
  4. 기존 PDF 수정 및 병합 기술
  5. PDF 보안과 암호화 적용 방법
  6. 고급 기능과 실전 프로젝트 구현
  7. 대안 라이브러리와의 비교 분석
  8. 문제 해결 방법과 최적화 기법

이제 너는 PDF 문서를 자유자재로 다룰 수 있는 능력을 갖추게 되었어. 이 지식을 활용하면 다음과 같은 다양한 비즈니스 문제를 해결할 수 있어:

  • 자동화된 보고서 생성 시스템 구축
  • 맞춤형 인보이스와 견적서 생성
  • 디지털 계약서 작성 및 관리
  • 보안 문서 배포 시스템 개발
  • 문서 아카이빙 및 관리 솔루션 구현
  • 데이터 기반 문서 템플릿 시스템 구축

재능넷과 같은 플랫폼에서 활동하는 프리랜서라면, 이런 PDF 자동화 기술은 클라이언트에게 제공할 수 있는 강력한 부가가치 서비스가 될 수 있어. 계약서 자동 생성, 맞춤형 보고서, 전문적인 인보이스 등을 제공하면 클라이언트의 만족도를 크게 높일 수 있지!

물론 iText 학습은 여기서 끝이 아니야. PDF 기술은 계속 발전하고 있고, iText도 새로운 기능을 지속적으로 추가하고 있어. 공식 문서와 커뮤니티를 통해 최신 동향을 파악하고, 실제 프로젝트에 적용해보면서 경험을 쌓아가는 것이 중요해.

다음 단계로 추천하는 학습 경로

  1. 실제 비즈니스 요구사항에 맞는 PDF 솔루션 구현해보기
  2. iText 추가 모듈 (pdfHTML, pdfSweep, pdfXFA 등) 탐구하기
  3. PDF/A, PDF/UA 같은 PDF 표준에 대해 학습하기
  4. 클라우드 서비스와 연동한 PDF 생성 시스템 구축해보기
  5. 머신러닝과 결합한 지능형 문서 처리 시스템 개발하기

마지막으로, PDF 문서 자동화는 단순히 기술적인 문제가 아니라 비즈니스 프로세스를 개선하고 효율성을 높이는 전략적 도구라는 점을 기억하자. 기술을 위한 기술이 아니라, 실제 문제를 해결하고 가치를 창출하는 데 초점을 맞추는 것이 중요해.

이제 너만의 PDF 마법을 펼쳐볼 시간이야! 🚀

댓글 작성

이 글에 대한 여러분의 생각을 들려주세요

댓글 0
댓글을 불러오는 중입니다.

아직 댓글이 없습니다.