Get Started with the Apryse Server SDK Java PDF Library Integration

You'll get started with our samples to see the output you can create when you integrate the Apryse Server SDK into your Java projects. Next, you'll create a project and integrate the Server SDK into your Java project, using the Linux platform.

Before you start:

• Install Visual Studio Code (or your preferred application) to write, edit, and debug source code.
• If you’re using VS Code, install the “Extension Pack for Java” and the “vscode-pdf” extensions that are available in the “Extensions: Marketplace” tab within VS Code. This will provide you with a full-featured Java development environment by bundling the essential tools.
• Install the latest Java Development Kit (JDK) v25 (LTS) for your platform/processor.

• Get your Apryse trial key.

In this section, you will download and run the OfficeToPDFTest PDFNet sample module, which demonstrates the SDK's document-conversion capabilities. Upon successful completion, you will have converted a DOCX document to a PDF file while leveraging the MS Office-to-PDF conversion API. You can use this module as a reference implementation when integrating similar document-conversion functionality into your own applications. By running the sample, you can quickly:

• Verify the capabilities.
• Understand how to interact with the MS Office to Conversion PDF API.
• Use it as a reference for integrating similar functionality into your own application.

1. Download the Apryse Java PDF library for Linux PDFNetJava.zip file.
2. Extract the PDFNetJava.zip file to the following location: /Home/YourName/PDFNetJava/Samples/
   Replace YourName with your user name.

3. Before running the sample, you need to add your license key to the PDFTronLicense.java file. Open Visual Studio Code, select File > Open Folder, and navigate to: /Home/YourName/PDFNetJava/Samples and select Open.

4. The Samples section opens in the Explorer pane. Scroll down and select the LicenseKey folder and click on the PDFTronLicense.java file to open.

5. In the PDFTronLicense.java file, scroll down to the line containing private static String LicenseKey = ‘YOUR_PDFTRON_LICENSE_KEY’; and replace the words in quotes with the copy of your trial license key you generated when you completed the Prerequisites instructions above. Do not change any other information in this file.

6. Save your changes and close the PDFTronLicense.java file.

7. In Visual Studio Code, from the Explorer > Samples pane, scroll down and select the OfficeToPDFTest folder.

8. Right-click on the RunTest.bat file and select Open in Integrated Terminal.

9. In the terminal, enter the following and press Enter:

1./RunTest.sh

10. When you run the RunTest.sh command, the sample code loads an Office document, converts the Office document to PDF, saves the resulting PDF, and outputs status messages to the console. For more details, you can look at additional OfficeToPDF sample code and the Convert MS Office (Word, Excel, PowerPoint) to PDF overview.

Once the sample has finished running, you will see 100% Done conversion in the terminal.

11. Type exit to close the Integrated Terminal.

12. In Visual Studio Code, from the Explorer > Samples pane, scroll down and select the TestFiles > Output folder. You will see three output PDF files (Fishermen.pdf, the_rime_of_the_ancient_mariner.pdf, and the factsheet_Arabic.pdf).

13. Click on the PDF files to see the converted output. You have successfully run the OfficeToPDFTest conversion sample!

14. Close the output PDF files.

This section provides steps to create a simple Java project that uses the Apryse SDK and the PDFNet library to programmatically generate a blank PDF document. With these steps, you can learn how to set up your environment, import the required libraries, and run a script that produces a valid PDF file—all without manual intervention. This example provides a practical foundation for more advanced document‑generation workflows.

1. In Visual Studio Code, from the Explorer pane, click on the Samples section, select the New Folder icon and enter myApp.
2. Right-click on the myApp folder, select New File and name it JAVA.

1. From the myApp folder, in the new file you just created, copy the following code and paste it into the myApp.java file to create a blank PDF page:

1import java.io.File;
2import java.io.IOException;
3import com.pdftron.common.PDFNetException;
4import com.pdftron.pdf.*;
5import com.pdftron.sdf.SDFDoc;
6import com.pdftron.sdf.ObjSet;
7import com.pdftron.sdf.Obj;
8public class myApp
9{
10    public static void main(String[] args)
11    {
12        PDFNet.initialize("YOUR_APRYSE_LICENSE_KEY");  // PDFNet must be initialized before accessing any Apryse API
13        try
14        {
15            PDFDoc doc = new PDFDoc();
16            Page page = doc.pageCreate();  // Start a new page
17            doc.pagePushBack(page);  // Add the page to the document
18            doc.save("output.pdf", SDFDoc.SaveMode.LINEARIZED, null);  // Save the document as a linearized PDF
19        }
20        catch(PDFNetException e)
21        {
22            e.printStackTrace();
23            System.out.println(e);
24        }
25        System.out.println("Hello World!");
26    }
27}

2. Scroll down to the line containing PDFNet.initialize(“YOUR_PDFTRON_LICENSE_KEY”); and replace the words in quotes with the copy of your trial license key. Save your changes.

1. Right-click on the myApp.java file and select Open in Integrated Terminal.
2. In the terminal, enter the following and press Enter to compile your application using the PDFNet library:

1javac -cp .:../../../Lib/PDFNet.jar myApp.java

Then enter the following and press Enter to run the project:

1java -Djava.library.path=../../../Lib -classpath .:../../../Lib/PDFNet.jar myApp

Keep in mind the following about the code above:

• The system logs a startup message.
• The program imports the Java SDK.
• The script defines an async main function that builds the PDF.
• The PDFNet engine runs with cleanup and license initialization.
• The program logs any errors.
• The script releases PDFNet resources and shuts down the engine.

3. In the terminal, type exit and press Enter.

4. In your Samples > myApp folder, you will see the output.pdf file you created by integrating the Apryse Server SDK!

5. You have successfully added the Apryse Server SDK to your Java project!

Now that you have successfully run an OfficeToPDFTest sample and integrated the Apryse Server SDK Java PDF Library into your application, you can try out 50+ samples depending on your needs.

6. To try additional samples, go to section 1. Run a sample > step 7 above and choose another sample to run.

1<repositories>
2    <repository>
3        <id>pdftron</id>
4        <name>PDFNet Maven</name>
5        <url>https://pdftron.com/maven/release</url>
6    </repository>
7</repositories>

1<dependencies>
2    <dependency>
3        <groupId>com.pdftron</groupId>
4        <artifactId>PDFNet</artifactId>
5        <version>11.1.0</version>
6    </dependency>
7</dependencies>

1package com.mycompany.app;
2import com.pdftron.pdf.*;
3public class App
4{
5    public static void main(String[] args)
6    {
7        PDFNet.initialize("YOUR_APRYSE_LICENSE_KEY");
8        try {
9             // YOUR CODE GOES HERE
10        } catch (Exception e) {
11        }
12        PDFNet.terminate();
13    }
14}

1mvn compile
2mvn exec:java -Dexec.mainClass=com.mycompany.app.App

1repositories {
2    maven {
3       url 'https://pdftron.com/maven/release/'
4   }
5}

1dependencies {
2    implementation 'com.pdftron:PDFNet:11.1.0'
3}

1repositories {
2    maven {
3       url 'https://pdftron.com/maven/release/'
4   }
5}
6dependencies {
7    implementation 'com.pdftron:PDFNet:11.1.0'
8}
9application {
10    mainClass = 'demo.App'
11}

1package demo;
2import com.pdftron.pdf.*;
3public class App
4{
5    public static void main(String[] args)
6    {
7        PDFNet.initialize("YOUR_APRYSE_LICENSE_KEY");
8        try {
9         // YOUR CODE GOES HERE
10        } catch (Exception e) {
11        }
12        PDFNet.terminate();
13    }
14}

1./gradlew run

You'll get started with our samples to see the output you can create when you integrate the Apryse Server SDK into your Java projects. Next, you'll create a project and integrate the Server SDK into your Java project, using the macOS platform.

Before you start:

• Install Visual Studio Code (or your preferred application) to write, edit, and debug source code.
• If you’re using VS Code, install the “Extension Pack for Java” and the “vscode-pdf” extensions that are available in the “Extensions: Marketplace” tab within VS Code. This will provide you with a full-featured Java development environment by bundling the essential tools.
• Install the latest Java Development Kit (JDK) v25 (LTS) for your platform/processor.

• Get your Apryse trial key.

In this section, you will download and run the OfficeToPDFTest PDFNet sample module, which demonstrates the SDK's document-conversion capabilities. Upon successful completion, you will have converted a DOCX document to a PDF file while leveraging the MS Office-to-PDF conversion API. You can use this module as a reference implementation when integrating similar document-conversion functionality into your own applications. By running the sample, you can quickly:

• Verify the capabilities.
• Understand how to interact with the MS Office to Conversion PDF API.
• Use it as a reference for integrating similar functionality into your own application.

1. Download the Apryse Java PDF library for macOS PDFNetJava.zip file.
2. Extract the PDFNetJava.zip file to the following location: /Home/YourName/PDFNetJava/Samples/. Replace YourName with your user name.

3. Before running the sample, you need to add your license key to the PDFTronLicense.java file. Open Visual Studio Code, select File > Open Folder, and navigate to: /Home/YourName/PDFNetJava/Samples and select Open. The Samples section opens in the Explorer pane.

4. Scroll down and select the LicenseKey folder and click on the PDFTronLicense.java file to open.

5. In the PDFTronLicense.java file, scroll down to the line containing private static String LicenseKey = ‘YOUR_PDFTRON_LICENSE_KEY’; and replace the words in quotes with the copy of your trial license key you generated when you completed the Prerequisites instructions above. Do not change any other information in this file.

6. Save your changes and close the PDFTronLicense.java file.

7. In Visual Studio Code, from the Explorer > Samples pane, scroll down and select the OfficeToPDFTest folder.

8. Right-click on the RunTest.bat file and select Open in Integrated Terminal.

9. In the terminal, enter the following and press Enter:

1./RunTest.sh

10. When you run the RunTest.sh command, the sample code loads an Office document, converts the Office document to PDF, saves the resulting PDF, and outputs status messages to the console. For more details, you can look at additional OfficeToPDF sample code and the Convert MS Office (Word, Excel, PowerPoint) to PDF overview.

Once the sample has finished running, you will see 100% Done conversion in the terminal.

11. Type exit and press Enter to close the Integrated Terminal.

12. In Visual Studio Code, from the Explorer > Samples pane, scroll down and select the TestFiles > Output folder. You will see three output PDF files (Fishermen.pdf, the_rime_of_the_ancient_mariner.pdf, and the factsheet_Arabic.pdf).

13. Click on the PDF files to see the converted output. You have successfully run the OfficeToPDFTest conversion sample!

14. Close the output PDF files.

This section provides steps to create a simple Java project that uses the Apryse SDK and the PDFNet library to programmatically generate a blank PDF document. With these steps, you can learn how to set up your environment, import the required libraries, and run a script that produces a valid PDF file—all without manual intervention. This example provides a practical foundation for more advanced document‑generation workflows.

1. In Visual Studio Code, from the Explorer pane, click on the Samples section, select the New Folder icon and enter myApp for the name.
2. Right-click on the myApp folder, select New Folder and enter JAVA for the name.
3. In the JAVA folder, select New File and name it myApp.java.

1. Copy the following code and paste it into the myApp.java file to create a blank PDF page.

1import java.io.File;
2import java.io.IOException;
3import com.pdftron.common.PDFNetException;
4import com.pdftron.pdf.*;
5import com.pdftron.sdf.SDFDoc;
6import com.pdftron.sdf.ObjSet;
7import com.pdftron.sdf.Obj;
8public class myApp
9{
10    public static void main(String[] args)
11    {
12        PDFNet.initialize("YOUR_APRYSE_LICENSE_KEY");  // PDFNet must be initialized before accessing any Apryse API
13        try
14        {
15            PDFDoc doc = new PDFDoc();
16            Page page = doc.pageCreate();  // Start a new page
17            doc.pagePushBack(page);  // Add the page to the document
18            doc.save("output.pdf", SDFDoc.SaveMode.LINEARIZED, null);  // Save the document as a linearized PDF
19        }
20        catch(PDFNetException e)
21        {
22            e.printStackTrace();
23            System.out.println(e);
24        }
25        System.out.println("Hello World!");
26    }
27}

2. Scroll down to the line containing PDFNet.initialize(“YOUR_APRYSE_LICENSE_KEY”); and replace the words in quotes with the copy of your trial license key. Save your changes.

1. Right-click on the myApp.java file and select Open in Integrated Terminal.
2. In the terminal, enter the following and press Enter to compile your application using the PDFNet library:

1javac -cp .:../../../Lib/PDFNet.jar myApp.java

Then enter the following and press Enter to run the project:

1java -Djava.library.path=../../../Lib -classpath .:../../../Lib/PDFNet.jar myApp

Keep in mind the following about the code above:

• The system logs a startup message.
• The program imports the Java SDK.
• The script defines an async main function that builds the PDF.
• The PDFNet engine runs with cleanup and license initialization.
• The program logs any errors.
• The script releases PDFNet resources and shuts down the engine.

3. Once the project has finished running, you will see: PDFNet is running in demo mode. Package V2. Hello World! in the terminal.

4. Type exit and press Enter to close the Integrated Terminal.

5. In your Samples > myApp folder, you will see the output.pdf file you created by integrating the Apryse Server SDK!

6. You have successfully added the Apryse Server SDK to your Java project!

Now that you have successfully run an OfficeToPDFTest sample and integrated the Apryse Server SDK Java PDF Library into your application, you can try out 50+ samples depending on your needs.

7. To try additional samples, go to section 1. Run a sample > step 7 above and choose another sample to run.

1import java.io.File;
2import java.io.IOException;
3import com.pdftron.common.PDFNetException;
4import com.pdftron.pdf.*;
5import com.pdftron.sdf.SDFDoc;
6import com.pdftron.sdf.ObjSet;
7import com.pdftron.sdf.Obj;
8public class myApp
9{
10    public static void main(String[] args)
11    {
12        PDFNet.initialize("YOUR_APRYSE_LICENSE_KEY");  // PDFNet must be initialized before accessing any Apryse API
13        try
14        {
15            PDFDoc doc = new PDFDoc();
16            Page page = doc.pageCreate();  // Start a new page
17            doc.pagePushBack(page);  // Add the page to the document
18            doc.save("output.pdf", SDFDoc.SaveMode.LINEARIZED, null);  // Save the document as a linearized PDF
19        }
20        catch(PDFNetException e)
21        {
22            e.printStackTrace();
23            System.out.println(e);
24        }
25        System.out.println("Hello World!");
26    }
27}

1javac -cp .:../../../Lib/PDFNet.jar myApp.java

1java -Djava.library.path=../../../Lib -classpath .:../../../Lib/PDFNet.jar myApp

1PDFNet is running in demo mode.
2Permission: write
3Hello World!

1<repositories>
2    <repository>
3        <id>pdftron</id>
4        <name>PDFNet Maven</name>
5        <url>https://pdftron.com/maven/release</url>
6    </repository>
7</repositories>

1<dependencies>
2    <dependency>
3        <groupId>com.pdftron</groupId>
4        <artifactId>PDFNet</artifactId>
5        <version>10.10.0</version>
6    </dependency>
7</dependencies>

1package com.mycompany.app;
2import com.pdftron.pdf.*;
3public class App
4{
5    public static void main(String[] args)
6    {
7        PDFNet.initialize("YOUR_APRYSE_LICENSE_KEY");
8        try {
9             // YOUR CODE GOES HERE
10        } catch (Exception e) {
11        }
12        PDFNet.terminate();
13    }
14}

1mvn compile
2mvn exec:java -Dexec.mainClass=com.mycompany.app.App

1repositories {
2    maven {
3       url 'https://pdftron.com/maven/release/'
4   }
5}

1dependencies {
2    implementation 'com.pdftron:PDFNet:10.10.0'
3}

1repositories {
2    maven {
3       url 'https://pdftron.com/maven/release/'
4   }
5}
6dependencies {
7    implementation 'com.pdftron:PDFNet:10.10.0'
8}
9application {
10    mainClass = 'demo.App'
11}

1package demo;
2import com.pdftron.pdf.*;
3public class App
4{
5    public static void main(String[] args)
6    {
7        PDFNet.initialize("YOUR_APRYSE_LICENSE_KEY");
8        try {
9         // YOUR CODE GOES HERE
10        } catch (Exception e) {
11        }
12        PDFNet.terminate();
13    }
14}

1./gradlew run