BCL easyPDF SDK
easyPDF SDK Usermanual
PDF Creator Programming API  |  Download Free Trial  |  Contact Us to Purchase

Java Support via JACOB

In the easyPDF SDK 6.3 release, we included Java support based on the JACOB Java COM bridge. This allows Java applications to utilize our rich easyPDF library.

The following Java core files are included in our distribution package:

Description File name
easyPDF Java library easypdf-jacob.jar
JACOB native 32-bit binary jacob-1.15-M3-x86.dll
JACOB native 64-bit binary jacob-1.15-M3-x64.dll
JACOB Java library jacob.jar

The files listed above can be found inside the C:\Program Files\Common Files\BCL Technologies\easyPDF 8 directory. Note that the JACOB native 64-bit binary is only installed on 64-bit Windows.

The following Java support directories are also included:

Description Directory name
Java sample codes (Vista, Win 7, 8, 8.1) C:\Users\Public\Documents\BCL Technologies\easyPDF SDK 8\Samples\Java-jacob
Java sample codes (Win XP) c:\Documents and Settings\All Users\Documents\BCL Technologies\easyPDF SDK 8\Samples\Java-jacob

Java Environment Setup

JAVA SDK setup

  1. Download and install the Java SE Development Kit 1.5 or above from http://www.oracle.com/technetwork/java/index.html
  2. Add a JAVA_HOME environment variable.

    On Windows 8 and 8.1, hit the Win key, type "view advanced" and click View advanced system settings.


    On Windows 7, go to the start menu, click on Computer, System Properties, Advanced system settings.


    On Windows XP, go to Control Panel, click on System, and proceed to the Advanced tab.

  3. Click on the Environment Variables button.


    The following dialog will pop up:


  4. Click the New button to add the JAVA_HOME environment variable. It is recommended to add this environment variable as a part of System variables. This makes the newly added environment variable to be available for every user in the system.
  5. Environment variables in the User variables will only effect a particular user. Where as the environment variables in the System variables will effect every users.
  6. Please point the JAVA_HOME environment variable to your Java SDK installation directory.
    For example:
    Variable name : JAVA_HOME
    Variable value: C:\Program Files\Java\jdk1.6.0_25


    If the JAVA_HOME environment variable has been existed on your system then you don't have to follow the above steps to create a new one. You just have to make sure it points to the right Java SDK.

  7. Add %JAVA_HOME%\bin into your PATH environment variable. Find the existing Path or PATH environment variables. Click edit and add the following information at the end: %JAVA_HOME%\bin
    You may need to use ; delimiter, in between each path contents.

    It is recommended to add this environment variable as a part of System variables. This makes the newly added environment variable to be available for every user in the system.


    If the path or the PATH environment variable does not exist then you have to need to create a new one.

easyPDF Java setup

  1. Add easyPDF-jacob.jar and jacob.jar into CLASSPATH variable.
    Go to Windows Control Panel, and click on System. Then proceed to the Advanced tab, and click on the Environment Variables button.
    Find the existing classpath or CLASSPATH environment variables. Click edit and add the following information at the end:
    C:\Program Files\Common Files\BCL Technologies\easyPDF 8\easyPDF-jacob.jar;C:\Program Files\Common Files\BCL Technologies\easyPDF 8\jacob.jar
    You may need to use ; delimiter, in between each classpath contents.

    It is recommended to add this environment variable as a part of System variables.
    This makes the newly added environment variable to be available for every user in the system.

    If the classpath or the CLASSPATH environment variable does not exist then you have to create a new one.

  2. Add easyPDF installation directory into your PATH environment variable.
    This step is required so the system can find the location of jacob-1.15-M3-x86.dll (Win32) or jacob-1.15-M3-x64.dll (x64). Find the existing Path or PATH environment variables. Click edit and add the following information at the end:
    C:\Program Files\Common Files\BCL Technologies\easyPDF 8
    You may need to use ; delimiter, in between each path contents.

    If the path or the PATH environment variable does not exist then you have to need to create a new one.

    It is recommended to add this environment variable as a part of System variables.
    This makes the newly added environment variable to be available for every user in the system.

Known Limitations

The current Java COM bridge implementation does not support the callback function feature triggered by windows events. Therefore easyPDF monitoring objects such as PrintJobMonitor, PrinterMonitor are not usable from any Java program utilizing the JACOB COM bridge.

If you need help to use monitoring feature from your Java program, please contact us at support@bcltechnologies.com, or visit our support page.