1. IronPDF
  2. 튜토리얼
  3. HTML을 PDF로 변환
IronPDF for JAVA를 사용하여 HTML을 PDF로 변환하는 방법

Java를 이용한 HTML을 PDF로 변환

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

이 튜토리얼은 Java 개발자가 IronPDF 라이브러리를 사용하여 HTML 콘텐츠를 픽셀 단위로 정확한 PDF(휴대용 문서 형식) 문서로 변환하는 방법을 안내합니다.

IronPDF는 모든 기능을 갖춘 PDF 변환기이자 PDF 처리 라이브러리입니다. IronPDF는 .NET 및 Java 프로그래밍 언어 모두에서 사용할 수 있습니다. 이 튜토리얼에서는 Java 애플리케이션에서 HTML 콘텐츠(파일, 마크업 등)를 변환하는 데 라이브러리를 사용하는 방법을 다룹니다. .NET 애플리케이션에서 HTML을 PDF로 변환하는 방법에 대한 튜토리얼은 HTML to PDF .NET 튜토리얼 에서 확인할 수 있습니다.

자바를 사용하여 HTML을 PDF로 변환하는 방법

Java에서 HTML을 PDF로 변환하는 방법

  1. Maven으로 구성된 Java 프로젝트에 IronPDF를 종속성으로 추가합니다.
  2. renderHtmlAsPdf 방법을 사용하여 HTML 문자열을 PDF 문서로 변환합니다.
  3. 자바를 이용하여 웹사이트 URL에서 PDF 파일 생성하기
  4. renderHtmlFileAsPdf 방법을 사용하여 HTML 파일을 PDF 파일로 변환합니다.
  5. 생성된 PDF 파일을 새 파일로 저장합니다.

시작하기

지금 바로 무료 체험판을 통해 IronPDF을 프로젝트에서 사용해 보세요.

첫 번째 단계:
green arrow pointer

1. Java용 IronPDF PDF 라이브러리 설치

Java 프로젝트에 IronPDF 라이브러리를 통합하는 방법에는 두 가지가 있습니다.

  1. Maven으로 구성된 Java 프로젝트에 IronPDF를 종속성으로 추가합니다.
  2. IronPDF JAR 파일을 다운로드하고 수동으로 프로젝트 클래스패스에 추가하십시오.

다음 섹션에서는 두 가지 설치 방법을 간략하게 설명합니다.

옵션 1: IronPDF를 Maven 종속성으로 설치

Maven을 사용하여 Java 프로젝트에 IronPDF를 설치하려면 Java 프로젝트의 pom.xml 파일의 dependency 섹션에 다음 아티팩트를 추가하십시오.

<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>
</dependencies>
<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>
</dependencies>
XML

첫 번째 아티팩트는 IronPDF 라이브러리의 최신 버전을 참조합니다. 두 번째 아티팩트는 SLF4J 구현을 참조합니다. 이 종속성은 IronPDF의 렌더링 엔진이 실행 중에 로깅 메시지를 생성할 수 있도록 하는 데 필요합니다. 소프트웨어 엔지니어는 이 종속성을 Logback 및 Log4J와 같은 다른 로깅 제공업체로 대체할 수 있습니다. 또는 로깅이 필요하지 않거나 원하지 않는 경우 해당 항목을 완전히 생략할 수도 있습니다.

자바 프로젝트의 루트 디렉토리에서 터미널을 열고 mvn install 명령어를 실행하여 앞서 언급한 라이브러리를 다운로드하세요.

옵션 2: IronPDF JAR 파일을 수동으로 설치

Maven이나 다른 종속성 관리 시스템을 사용하지 않으려는 개발자는 IronPDF 라이브러리 JAR 파일(및 선택 사항인 SLF4J 구현)을 다운로드하여 프로젝트의 클래스 경로에 수동으로 추가해야 합니다.

IronPDF JAR 파일은 IronPDF JAR 다운로드 페이지(또는 Maven 저장소)에서 직접 다운로드하십시오.

2. HTML을 PDF로 변환

이 섹션에서는 IronPDF의 핵심 기능인 HTML을 PDF로 변환하는 기능을 소개합니다.

PdfDocument 클래스는 IronPDF의 모든 PDF 문서 렌더링 및 조작 기능에 대한 진입점입니다. 이 클래스는 HTML을 PDF 문서로 변환하기 위한 강력한 메서드 세트를 포함하고 있으며, 다음 세 가지 사용 사례를 지원합니다. HTML 문자열/마크업에서 변환, HTML 파일에서 변환, URL에서 변환. 이 섹션에서는 이러한 사용 사례 각각에 대해 간략하게 설명하고, 추가 정보를 얻을 수 있는 관련 콘텐츠 링크를 제공합니다.

2.1 IronPDF 패키지 가져오기

IronPDF의 모든 변환 및 처리 구성 요소는 com.ironsoftware.ironpdf 패키지에 포함되어 있습니다.

IronPDF가 사용될 Java 소스 파일의 맨 위에 다음 import 문을 추가하여 애플리케이션 소스 코드에서 이러한 구성 요소에 접근할 수 있도록 하십시오.

// Import statement for IronPDF for Java
import com.ironsoftware.ironpdf.*;
// Import statement for IronPDF for Java
import com.ironsoftware.ironpdf.*;
JAVA

2.2. 라이선스 키 설정 (선택 사항)

IronPDF for Java는 무료로 사용할 수 있습니다. 하지만 무료 사용자의 경우, PDF 문서에 타일 형태의 배경 워터마크가 표시됩니다(아래 이미지 참조).

워터마크가 표시된 이미지

워터마크 없이 PDF를 생성하기 위해 IronPDF를 사용하려면 도서관은 유효한 라이선스 키를 사용해야 합니다. 아래 코드는 라이선스 키를 사용하여 라이브러리를 구성합니다.

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");
// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");
JAVA

PDF 파일을 생성하거나 파일 내용을 사용자 지정하기 전에 라이선스 키를 설정해야 합니다. 다른 모든 코드 줄보다 먼저 setLicenseKey 메서드를 호출하는 것이 좋습니다.

IronPDF 라이선스 페이지에서 라이선스 키를 구매하거나, 무료 평가판 라이선스 키를 받으려면 당사에 문의하십시오.

2.3 로그 파일 위치 설정 (선택 사항)

기본적으로 (SLF4J 공급자가 설치되어 있다고 가정할 때) IronPDF는 Java 애플리케이션의 루트 디렉터리에 있는 _IronPdfEngine.log_라는 텍스트 파일에 로그 메시지를 생성합니다.

로그 파일의 이름과 위치를 다르게 지정하려면 Settings.setLogPath 메서드를 사용하십시오.

// Set a log path
Settings.setLogPath(Paths.get("IronPdfEngine.log"));
// Set a log path
Settings.setLogPath(Paths.get("IronPdfEngine.log"));
JAVA

참고해 주세요Settings.setLogPath PDF 변환 및 조작 메서드를 사용하기 전에 반드시 호출해야 합니다.

2.4. HTML 문자열에서 PDF 생성하기

PdfDocument.renderHtmlAsPdf는 HTML 콘텐츠 문자열을 PDF 문서로 변환합니다.

다음 코드 예제는 단일 헤드라인 요소를 사용하여 새 파일을 생성합니다.

// Convert HTML string to PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the PDF document
pdf.saveAs("htmlstring_to_pdf.pdf");
// Convert HTML string to PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the PDF document
pdf.saveAs("htmlstring_to_pdf.pdf");
JAVA

renderHtmlAsPdf 메서드는 컴퓨터 또는 네트워크 드라이브의 폴더에 있는 이미지, 스타일시트 및 스크립트를 가져올 수 있습니다. 다음 예제는 assets 폴더에 있는 CSS 파일과 이미지를 참조하는 HTML에서 PDF 문서를 생성합니다.

// HTML string with external assets
String html = "<html><head><title>Hello world!</title><link rel='stylesheet' href='assets/style.css'></head><body><h1>Hello from IronPDF!</h1><a href='https://ironpdf.com/java/'><img src='assets/logo.png' /></a></body></html>";
// Convert HTML to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
// Save the PDF document
pdf.saveAs("output.pdf");
// HTML string with external assets
String html = "<html><head><title>Hello world!</title><link rel='stylesheet' href='assets/style.css'></head><body><h1>Hello from IronPDF!</h1><a href='https://ironpdf.com/java/'><img src='assets/logo.png' /></a></body></html>";
// Convert HTML to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
// Save the PDF document
pdf.saveAs("output.pdf");
JAVA

renderHtmlAsPdf의 두 번째 (선택적) 인수를 사용하면 개발자가 웹 자산을 참조할 기본 경로를 지정할 수 있습니다. 이 경로는 로컬 파일 시스템의 디렉터리일 수도 있고 URL 경로일 수도 있습니다.

HTML을 사용하여 PDF를 생성하는 이 코드 예제에서 renderHtmlAsPdf 메서드에 대해 자세히 알아보거나, 렌더링된 HTML을 PDF로 변환하는 과정을 더욱 세밀하게 제어하려면 PdfDocument 클래스의 API 참조 페이지를 참조하십시오.

2.5. URL에서 PDF 생성하기

개발자는 IronPDF의 PdfDocument.renderUrlAsPdf 메서드를 사용하여 온라인 웹 페이지를 PDF 문서로 변환할 수 있습니다.

다음 예제는 위키백과 문서를 PDF 콘텐츠로 변환합니다.

// Convert a URL to PDF
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the PDF document
pdf.saveAs("url_to_pdf.pdf");
// Convert a URL to PDF
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the PDF document
pdf.saveAs("url_to_pdf.pdf");
JAVA

웹 페이지를 PDF 콘텐츠로 변환하는 방법에 대한 자세한 내용은 URL을 PDF로 변환하는 코드 예제를 참조하세요.

2.6. HTML 파일에서 PDF 생성하기

IronPDF는 로컬 파일 시스템에 저장된 HTML 문서를 해당 PDF 형식으로 직접 변환할 수도 있습니다.

다음 코드 예제는 이 송장을 실제 사례로 사용하여 IronPDF가 HTML 파일을 얼마나 잘 변환하는지 보여줍니다 .

편의를 위해 송장의 HTML 마크업을 여기에 다시 게시합니다.

<html>
<head>
    <meta charset="utf-8">
    <title>Invoice</title>
    <link rel="stylesheet" href="style.css">
    <link rel="license" href="https://www.opensource.org/licenses/mit-license/">
    <script src="script.js"></script>
</head>
<body>
<header>
    <h1>Invoice</h1>
    <address contenteditable>
        <p>Jonathan Neal</p>
        <p>101 E. Chapman Ave<br>Orange, CA 92866</p>
        <p>(800) 555-1234</p>
    </address>
    <span><img alt="" src="http://www.jonathantneal.com/examples/invoice/logo.png"><input type="file" accept="image/*"></span>
</header>
<article>
    <h1>Recipient</h1>
    <address contenteditable>
        <p>Some Company<br>c/o Some Guy</p>
    ...
</body>
</html>
<html>
<head>
    <meta charset="utf-8">
    <title>Invoice</title>
    <link rel="stylesheet" href="style.css">
    <link rel="license" href="https://www.opensource.org/licenses/mit-license/">
    <script src="script.js"></script>
</head>
<body>
<header>
    <h1>Invoice</h1>
    <address contenteditable>
        <p>Jonathan Neal</p>
        <p>101 E. Chapman Ave<br>Orange, CA 92866</p>
        <p>(800) 555-1234</p>
    </address>
    <span><img alt="" src="http://www.jonathantneal.com/examples/invoice/logo.png"><input type="file" accept="image/*"></span>
</header>
<article>
    <h1>Recipient</h1>
    <address contenteditable>
        <p>Some Company<br>c/o Some Guy</p>
    ...
</body>
</html>
HTML

HTML 파일이 CSS 파일 및 JavaScript 파일과 함께 "invoices"라는 폴더에 저장되었다고 가정해 보겠습니다. IronPDF를 사용하여 다음과 같이 HTML 파일을 변환할 수 있습니다.

// Convert an HTML file to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the PDF document
pdf.saveAs("htmlfile_to_pdf.pdf");
// Convert an HTML file to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the PDF document
pdf.saveAs("htmlfile_to_pdf.pdf");
JAVA

HTML 문자열을 PDF로 변환하는 예제와 마찬가지로, IronPDF는 HTML 문서의 상대 URL을 파일 시스템상의 올바른 경로로 정확하게 변환합니다. 결과적으로 이 예제에서 생성되는 PDF 파일은 참조된 스타일시트와 스크립트가 웹 페이지에 미치는 시각적 영향을 완벽하게 담아낼 수 있습니다.

3. 추가 자료

IronPDF의 HTML을 PDF로 변환하는 기능은 아직 극히 일부만 활용했을 뿐입니다.

코드 예제 섹션에 있는 엄선된 코드 샘플을 활용하여 Java 개발용 HTML-PDF 변환기 사용 방법에 대한 이해를 더욱 높여보세요.

  1. PDF 생성 설정에 대한 이 코드 예제를 읽고 변환 과정에서 PDF 문서의 모양을 사용자 지정하는 방법을 알아보세요.
  2. 사용자 지정 머리글 및 바닥글 , 여백 크기 , 페이지 크기 , 워터마크 등을 포함하여 PDF 파일을 생성합니다.
  3. 문서에서 PDF 콘텐츠( PDF에서 텍스트 추출 및 이미지 추출 )를 추출하고, PDF 압축으로 파일 크기를 최적화하며 , IronPrint 기능을 사용하여 PDF를 프로그래밍 방식으로 인쇄합니다 .

HTML을 PDF로 변환하는 과정을 더욱 세밀하게 제어하려면 PdfDocument 클래스의 IronPDF Java API 참조 페이지를 살펴보세요.

자주 묻는 질문

자바를 사용하여 HTML 콘텐츠를 PDF로 변환하는 방법은 무엇인가요?

IronPDF의 `PdfDocument.renderHtmlAsPdf` 메서드를 사용하면 HTML 콘텐츠를 PDF 문서로 변환할 수 있습니다. 이 메서드는 HTML의 서식을 그대로 유지합니다.

자바를 이용하여 웹페이지 URL을 PDF로 직접 변환하는 것이 가능할까요?

네, IronPDF의 `PdfDocument.renderUrlAsPdf` 메서드를 사용하면 온라인 웹 페이지를 PDF 문서로 직접 변환할 수 있습니다.

Java를 사용하여 로컬 HTML 파일을 PDF로 변환하는 방법은 무엇입니까?

IronPDF를 사용하면 `PdfDocument.renderHtmlFileAsPdf` 메서드를 이용하여 로컬 시스템에 저장된 HTML 파일을 PDF 문서로 렌더링할 수 있습니다.

Java PDF 라이브러리로 생성된 PDF에서 워터마크를 제거할 수 있나요?

IronPDF로 생성된 PDF에서 워터마크를 제거하려면 PDF를 생성하기 전에 `License.setLicenseKey` 메서드를 사용하여 유효한 라이선스 키를 설정해야 합니다.

HTML을 PDF로 변환할 때 CSS와 같은 외부 파일을 포함하려면 어떻게 해야 하나요?

IronPDF는 HTML을 PDF로 변환할 때 외부 CSS 및 기타 자산을 포함하는 것을 지원합니다. HTML 콘텐츠에서 이러한 자산의 경로가 올바르게 참조되었는지 확인하십시오.

Maven을 사용하여 Java용 IronPDF를 설치하는 단계는 무엇입니까?

Maven을 사용하여 Java 프로젝트에 IronPDF를 설치하려면 프로젝트의 `pom.xml` 파일에 IronPDF 종속성을 추가하고 프로젝트 루트 디렉터리에서 `mvn install` 을 실행하십시오.

Java에서 PDF 생성 과정을 로깅하는 옵션이 있나요?

예, IronPDF는 SLF4J를 통한 로깅을 지원합니다. SLF4J 공급자가 설치되어 있는 경우, `Settings.setLogPath` 메서드를 사용하여 로그 파일 위치를 설정할 수 있습니다.

Java에서 HTML로부터 생성된 PDF의 모양을 사용자 지정할 수 있나요?

네, IronPDF를 사용하면 머리글, 바닥글, 여백을 포함한 PDF 생성 설정을 사용자 지정할 수 있습니다. 라이브러리에서 제공되는 다양한 사용자 지정 옵션을 사용하여 이를 구현할 수 있습니다.

Java에서 IronPDF를 사용하는 예제를 더 보려면 어디를 봐야 할까요?

IronPDF 웹사이트의 코드 예제 섹션과 Java API 참조 페이지에서 Java용 IronPDF 사용에 대한 더 많은 예제와 문서를 찾을 수 있습니다.

IronPDF는 HTML을 PDF로 변환하는 데 있어 .NET 10과 완벽하게 호환됩니까?

네. IronPDF는 .NET 10과 완벽하게 호환되므로 별도의 설정 없이 바로 사용할 수 있습니다. `ChromePdfRenderer.RenderHtmlAsPdf` 와 같은 HTML-PDF 변환 메서드를 .NET 10에서 활용하여 성능 향상 및 새로운 API와 같은 프레임워크 개선 사항을 누릴 수 있습니다.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
버전: 2026.2 방금 출시되었습니다