USING IRONPDF FOR JAVA

Java PDF Generator (Code Example Tutorial)

Updated August 25, 2024
Share:

This article will explore how to use IronPDF to generate new files, extract content, and save PDFs.

IronPDF for Java

IronPDF for Java is built for generating PDF documents or PDF forms from HTML code, whether from a file, HTML string, HTML pages, or URL. It generates PDF files with accuracy, and formatting is also preserved. It is designed in a way that developers find it easy to use.

IronPDF is built on top of the .NET Framework, allowing it to be a versatile tool for generating PDFs in various contexts.

IronPDF provides the following functions for generating and manipulating large documents:

  1. The ability to add and extract content from PDFs (text, images, tables, etc.)
  2. The ability to control the layout and formatting of the document (e.g., set fonts, colors, margins...)
  3. The ability to complete forms and add digital signatures

Steps to Create a PDF File in a Java Application

Prerequisites

To use IronPDF to create a PDF generating tool, the following software needs to be installed on the computer:

  1. Java Development Kit - JDK is required for building and running Java programs. If it is not installed, download the latest release from the Oracle Website.
  2. Integrated Development Environment - IDE is software that helps write, edit, and debug a program. Download any IDE for Java, e.g., Eclipse, NetBeans, IntelliJ.
  3. Maven - Maven is an automation and open-source Java tool that helps download libraries from the Central Maven Repository. Download it from the Apache Maven website.
  4. IronPDF - Finally, IronPDF is required to create PDF files in Java. This needs to be added as a dependency in your Java Maven Project. Include the IronPDF artifact along with the slf4j dependency in the pom.xml file as shown below:

    <dependency>
       <groupId>com.ironsoftware</groupId>
       <artifactId>com.ironsoftware</artifactId>
       <version>2024.9.1</version>
    </dependency>
    XML

Adding Necessary Imports

First of all, add the following line at the top of the Java main class source code file to import all the required important class methods from the IronPDF library.

import com.ironsoftware.ironpdf.*;
JAVA

Next, configure IronPDF with a valid license key to use its methods. Invoke the setLicenseKey method in the main method.

License.setLicenseKey("Your license key");
JAVA

Note: You can get a free trial license key from IronPDF to create and read PDFs.

Generate PDF Documents from HTML String

Creating PDF files from HTML string is very easy and usually takes one or two lines of code to do it. Here, an HTML code is written as a string in a variable and then passed to the renderHtmlAsPdf method found in the PdfDocument class. The following code generates a new PDF document instance:

String htmlString = "<h1>Hello World!</h1><p>This is an example of an HTML string in Java.</p>";
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlString);
JAVA

Now, use the saveAs method to save the generated PDF to a path on your local system:

pdf.saveAs(Paths.get("htmlstring.pdf"));
JAVA

The above line of code creates a PDF called "htmlstring.pdf" containing the contents of the HTML string.

The output is as follows:

Java PDF Generator (Code Example Tutorial), Figure 1: HTML String to PDF Output HTML String to PDF Output

Create PDF Documents from HTML Files

The following code creates a PDF file from an HTML file:

PdfDocument myPdf = PdfDocument.renderHtmlFileAsPdf("example.html");
myPdf.saveAs(Paths.get("html_file.pdf"));
JAVA

HTML file code:

<html>
    <head>
        <title>Example HTML File</title>
    </head>
    <body>
        <h1>HTML File Example</h1>
        <p style="font-style:Italic;">This is an example HTML file</p>
    </body>
</html>
<html>
    <head>
        <title>Example HTML File</title>
    </head>
    <body>
        <h1>HTML File Example</h1>
        <p style="font-style:Italic;">This is an example HTML file</p>
    </body>
</html>
HTML

In the above code, the renderHtmlFileAsPdf method generates PDF files from HTML files. This method accepts a string argument containing the path to the HTML file.

IronPDF renders the HTML file elements along with the CSS and JavaScript attached to it, if any. You can see in the output below that the CSS styling is also maintained by IronPDF, and the output is the same as it would have been in a web browser.

Java PDF Generator (Code Example Tutorial), Figure 2: HTML File to PDF Output HTML File to PDF Output

Generate PDF Files from URL

The renderUrlAsPdf method is used to create PDF files from a web page. It accepts the web page's URL as an argument.

PdfDocument urlToPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
urlToPdf.saveAs(Paths.get("urlToPdf.pdf"));
JAVA

Java PDF Generator (Code Example Tutorial), Figure 3: URL to PDF Output URL to PDF Output

Additional rendering options can be set to configure PDF generation. You can get more information on the Convert URL to PDF Example Code.

Generating Password Protected PDF Files

IronPDF can be used to create a password-protected PDF file with the SecurityOptions class. All file permissions can be set if you integrate the PDF functionalities of IronPDF. The code goes as follows:

SecurityOptions securityOptions = new SecurityOptions();
securityOptions.setUserPassword("shareable");
JAVA

setUserPassword is used to set a secure password. The below code sample applies password protection to the PDF document that was created in the URL to PDF example:

SecurityManager securityManager = urlToPdf.getSecurity();
securityManager.setSecurityOptions(securityOptions);
urlToPdf.saveAs("protected.pdf");
JAVA

The PDF file is now password protected. Now open the PDF file, and a password option will appear:

Java PDF Generator (Code Example Tutorial), Figure 4: Password Protected File Password Protected File

After entering the password correctly, the PDF document will open.

Java PDF Generator (Code Example Tutorial), Figure 5: PDF document PDF document

More security settings and metadata about the PDF files can be explored in the related Security and Metadata Code Example.

Summary

This article demonstrated the capability of the IronPDF library to create PDFs using multiple methods. IronPDF is a pure Java library and is powerfully built to easily work with PDF files in Java.

IronPDF's Engine makes it easy to create PDFs from various sources such as HTML files, image files, XML documents, Jasper reports, or any other input. It complies with the standard Java printing API, which facilitates document printing, and you can also digitally sign PDF files. IronPDF helps to get all the PDF-related tasks done quickly and easily.

IronPDF is not an open-source Java library. It provides a commercial license which starts from $749. You can also get a free trial of IronPDF to test it in production within your Java applications.

< PREVIOUS
Java PDF Editor Library (How to & Code Example)
NEXT >
How to Write PDF File in Java

Ready to get started? Version: 2024.9 just released

Free Maven Download View Licenses >