Java Support

In the easyPDF SDK ver 6.0 release, we included a Java COM bridge support based on The Java/Win32 integration project (Jawin) . This allows the Java application to utilize our rich easyPDF library.

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

Description File name
easy PDF java library easyPDF.jar
Jawin binary jawin.dll
Jawin java library jawin.jar

The files listed above can be found inside: C:\Program Files\Common Files\BCL Technologies\easyPDF 6 directory.

The following java support directories are also included:

Description Directory name
Java sample codes C:\Program Files\BCL Technologies\easyPDF SDK 6\Samples\Java
easyPDF's Java APIs documentation C:\Program Files\BCL Technologies\easyPDF SDK 6\Java APIs Documentation

 

Java Environment Setup

JAVA SDK setup

  1. Download and install the Java SE Development Kit 1.6.0_02 or above from http://java.sun.com
  2. Add JAVA_HOME environment variable. Go to Windows XP Control Panel, click on System, and proceed to the Advanced tab


  3. Click on the Environment Variables button.


  4. Click 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. 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.
  5. 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_02


    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.

  6. 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 variables does not exist then you have to need to create a new one.

easyPDF Java setup

  1. Add easyPDF.jar and jawin.jar into CLASSPATH variable.
    Go to Windows XP 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:
    For Win32: C:\Program Files\Common Files\BCL Technologies\easyPDF 6\easyPDF.jar;C:\Program Files\Common Files\BCL Technologies\easyPDF 6\jawin.jar
    For Win64: C:\Program Files (x86)\Common Files\BCL Technologies\easyPDF 6\easyPDF.jar;C:\Program Files (x86)\Common Files\BCL Technologies\easyPDF 6\jawin.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 variables 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 jawin.dll. Find the existing Path or PATH environment variables. Click edit and add the following information at the end:
    For Win32: C:\Program Files\Common Files\BCL Technologies\easyPDF 6
    For Win64: C:\Program Files (x86)\Common Files\BCL Technologies\easyPDF 6
    You may need to use ; delimiter, in between each path contents.

    If the path or the PATH environment variables 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

Currently the Java/Win32 integration project (Jawin) does not support call back function feature triggered by windows events. Therefore easyPDF monitoring objects such as PrintJobMonitor, PrinterMonitor are not usable from any Java program utilizing the Jawin 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 Web site at http://www.pdfonline.com/support/submit_support_request.htm.

Please note that currently easyPDF SDK 6 only works under the 32-bit version of JDK, which can be used under Windows 32-bit and 64-bit as well.