PDF에서 텍스트를 바꾸는 방법

replaceText가 어떤 매개변수를 수용합니까?

메서드 시그니처는 replaceText(PageSelection pageSelection, String oldText, String newText)입니다. 매칭은 기본적으로 대소문자를 구분합니다: "net6"와 "NET6"는 다른 문자열로 간주됩니다. 메서드를 호출하기 전에 렌더링된 PDF에서 정확한 대소문자를 확인하세요. PDF의 텍스트 콘텐츠를 먼저 추출하여 정확한 텍스트를 확인할 수 있습니다: PDF의 텍스트 콘텐츠 추출. IronPDF Java 종속성은 Maven Central에 게시되어 있으며 Java 8 이상이 필요합니다.

 :title=Replace Text on First Page
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-single-page.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key (required for production use)
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Render HTML content into a PDF document
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>.NET6</h1>");

        // Define the search and replacement strings
        String oldText = ".NET6";
        String newText = ".NET7";

        // Replace all instances of oldText on the first page only
        // PageSelection.firstPage() targets page index 0
        pdf.replaceText(PageSelection.firstPage(), oldText, newText);

        // Save the modified PDF
        pdf.saveAs("replaceText.pdf");
    }
}

 :title=Replace Text on First Page
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-single-page.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key (required for production use)
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Render HTML content into a PDF document
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>.NET6</h1>");

        // Define the search and replacement strings
        String oldText = ".NET6";
        String newText = ".NET7";

        // Replace all instances of oldText on the first page only
        // PageSelection.firstPage() targets page index 0
        pdf.replaceText(PageSelection.firstPage(), oldText, newText);

        // Save the modified PDF
        pdf.saveAs("replaceText.pdf");
    }
}

replaceText 메서드는 IronPDF의 HTML to PDF 변환 워크플로우와 자연스럽게 통합됩니다. HTML 템플릿을 먼저 렌더링한 다음, 동적 값을 삽입하기 위해 텍스트 교체를 적용합니다. 이렇게 하면 HTML을 깔끔하게 유지하면서도 개인화된 출력을 생성할 수 있습니다. 디스크에서 로드된 문서의 경우 renderHtmlAsPdf 대신 PdfDocument.fromFile에 파일 경로를 전달하세요.

출력 결과는 어떻게 나타나나요?

페이지 리스트를 사용했을 때 수정되는 페이지는 무엇입니까?

아래 예제에서는 HTML에서 세 페이지 PDF를 생성합니다. 이 대체는 페이지 0 및 2 (첫 번째 및 세 번째 페이지)에서 실행됩니다. 페이지 1 (두 번째 페이지)는 원본 텍스트를 변경하지 않고 유지됩니다. 페이지 인덱스는 항상 0부터 시작하며, 이는 Java의 0 기반 배열 규칙과 일관합니다.

 :title=Replace Text on Multiple Specific Pages
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-multiple-pages.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Build a 3-page PDF from HTML using CSS page breaks
        String html = "<p> .NET6 </p>" +
                      "<p> This is 1st Page </p>" +
                      "<div style='page-break-after: always;'></div>" +
                      "<p> This is 2nd Page</p>" +
                      "<div style='page-break-after: always;'></div>" +
                      "<p> .NET6 </p>" +
                      "<p> This is 3rd Page</p>";

        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

        String oldText = ".NET6";
        String newText = ".NET7";

        // Pages are zero-indexed: 0 = first page, 2 = third page
        // Page index 1 (second page) is intentionally excluded
        List<Integer> pages = Arrays.asList(0, 2);

        pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

 :title=Replace Text on Multiple Specific Pages
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-multiple-pages.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Build a 3-page PDF from HTML using CSS page breaks
        String html = "<p> .NET6 </p>" +
                      "<p> This is 1st Page </p>" +
                      "<div style='page-break-after: always;'></div>" +
                      "<p> This is 2nd Page</p>" +
                      "<div style='page-break-after: always;'></div>" +
                      "<p> .NET6 </p>" +
                      "<p> This is 3rd Page</p>";

        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

        String oldText = ".NET6";
        String newText = ".NET7";

        // Pages are zero-indexed: 0 = first page, 2 = third page
        // Page index 1 (second page) is intentionally excluded
        List<Integer> pages = Arrays.asList(0, 2);

        pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

        pdf.saveAs("replaceTextOnMultiplePages.pdf");
    }
}

HTML에서 다중 페이지 PDF를 생성할 때, 페이지 경계가 드는 위치를 제어하기 위해 CSS page-break-after 속성을 사용하세요. 렌더링하기 전에 사용자 정의 용지 크기와 페이지 방향을 올바르게 설정함으로써 텍스트 교체가 실행될 때 콘텐츠 위치가 기대에 부합하도록 보장합니다. 저장 후 PDF를 열고 대상 페이지만 변경되었는지 확인하여 출력을 검증합니다.

출력 결과는 어떻게 나타나나요?

이 종류의 라이브러리 중 가장 좋아하는 것은 IronPDF입니다. PDF 파일을 빠르고 효율적으로 조작할 수 있습니다. 또한 PDF/A 형식으로 내보내기 및 PDF 문서의 디지털 서명과 같은 많은 유용한 기능을 가지고 있습니다.

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

IronOCR 덕분에 연간 $40,000를 수동 프로세싱에서 절약하고 생산성을 높이며 고부가가치 작업에 자원을 활용할 수 있습니다. 강력히 추천합니다.

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

IronSuite는 우리의 운영에서 중요한 역할을 합니다. 이것들은 사업 전반에 걸쳐 효율성을 높이는 도구로, 평면도 생성 및 재고 관리 개선을 포함합니다.

데이비드 존스

리드 소프트웨어 엔지니어, Agorus Build

사례 연구 보기

단일 페이지와 다중 페이지를 타겟팅하는 메서드는 무엇인가요?

각 페이지 선택 방법은 언제 사용해야 할까요?

allPages()는 전역 찾기 및 대체에 가장 간단한 선택입니다: 전체 문서에서 대상 텍스트의 모든 인스턴스가 한 번의 호출로 대체됩니다. 페이지나 마지막 페이지의 푸터를 다루면서 본문을 건드리지 않으려면 빠른 편집에 firstPage() 또는 lastPage()를 사용하세요. 텍스트가 장이나 섹션과 같은 연속된 페이지 집합에 나타날 때 pageRange(int, int)를 선택하세요. 대상 페이지가 인접하지 않을 때 pageRange(List<Integer>)를 사용하세요. 예를 들어 페이지 1, 3, 7에만 나타나는 버전 문자열을 교체할 때 사용하세요.

병합된 PDF 또는 책갈피와 개요를 포함하는 문서 작업 시, 각 논리적 섹션의 페이지 범위를 먼저 식별한 다음, 공유된 머리글이나 바닥글을 실수로 수정하지 않도록 대상 교체를 적용합니다. IronPDF for Java API 레퍼런스에는 전체 매개변수 문서화와 함께 모든 PageSelection 오버로드가 나열되어 있습니다.

모든 페이지에서 텍스트를 한 번에 교체하려면 어떻게 해야 하나요?

PageSelection.allPages()는 문서 전반에 걸친 대체 작업을 한 번의 호출로 수행하며, 이는 전역적인 토큰 대체에 가장 효율적인 방법입니다. 아래 예제는 디스크에서 PDF를 로드하고 문서 전체에 있는 자리 표시자 토큰을 모두 교체합니다:

 :title=Replace Text on All Pages
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-all-pages.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;
import java.nio.file.Paths;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("contract-template.pdf"));

        // Replace the placeholder token on every page simultaneously
        // This is equivalent to calling replaceText for each page individually
        pdf.replaceText(PageSelection.allPages(), "{{VERSION}}", "2.0");

        // Save the updated document
        pdf.saveAs("contract-v2.pdf");
    }
}

 :title=Replace Text on All Pages
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-all-pages.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;
import java.io.IOException;
import java.nio.file.Paths;

public class App {

    public static void main(String[] args) throws IOException {

        // Set the IronPDF license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load an existing PDF from disk
        PdfDocument pdf = PdfDocument.fromFile(Paths.get("contract-template.pdf"));

        // Replace the placeholder token on every page simultaneously
        // This is equivalent to calling replaceText for each page individually
        pdf.replaceText(PageSelection.allPages(), "{{VERSION}}", "2.0");

        // Save the updated document
        pdf.saveAs("contract-v2.pdf");
    }
}

이 패턴은 템플릿 기반 워크플로우와 자연스럽게 결합되어 동일한 자리 표시자가 여러 페이지의 머리글, 바닥글 또는 본문 텍스트에 나타날 때 사용됩니다. 단일 페이지 문서의 경우, allPages()와 firstPage()가 동일한 결과를 생성합니다. 런타임에 페이지 수가 변동할 수 있을 때 allPages()를 선호하세요.

대소문자 구분 일치는 결과에 어떤 영향을 미칩니까?

replaceText는 정확하고 대소문자를 구분하여 매칭을 수행합니다. "Version 1.0", "version 1.0", "VERSION 1.0" 문자열은 서로 다른 세 개의 값으로 간주됩니다. 디스크에서 로드한 문서에서 교체를 실행하기 전에 원본 소스를 검토하거나 PDF에서 텍스트를 추출하여 프로그래밍 방식으로 검사하여 정확한 대소문자를 확인하세요.

PDF 양식에서 텍스트를 어떻게 교체하나요?

상호작용 가능한 양식 필드를 포함하는 PDF는 텍스트 값을 해당 문서의 콘텐츠 스트림과 별도로 저장합니다. 이는 PDF 사양에서 정의합니다. replaceText 메서드는 콘텐츠 스트림에서 작동하며 양식 필드 값을 수정하지 않습니다. 양식 필드 내부의 텍스트를 업데이트하려면 IronPDF의 전용 양식 생성 및 편집 API를 사용하세요. 동일한 문서에서 두 가지 접근 방식을 혼합하는 것은 안전합니다: 양식 필드 업데이트와 콘텐츠 스트림 교체는 서로 간섭하지 않습니다.

템플릿 기반 워크플로우에서 텍스트를 어떻게 업데이트하나요?

일반적인 패턴은 자리 표시자 토큰(예: {{CUSTOMER_NAME}} 또는 [INVOICE_DATE])과 함께 PDF 템플릿을 유지하고, 런타임에 실제 값으로 대체하는 것입니다. 자리 표시자마다 한 번 replaceText를 호출하고, PageSelection.allPages()를 사용하여 대체가 토큰이 나타나는 모든 위치를 포함하도록 합니다. HTML에서 생성된 문서의 경우, 이 워크플로우는 renderHtmlAsPdf 다음 일련의 대체 호출과 함께 동일하게 잘 작동합니다. PDF 워터마킹 또는 배경 및 전경을 결합하여 최종 출력에 브랜딩 또는 기밀 표식을 추가하세요.