PDFlib Text Extraction Toolkit (TET) Manual

3.5 Java Binding
Installing the TET Java edition. TET is organized as a Java package with the name
com.pdflib.TET. This package relies on a native JNI library; both pieces must be configured
appropriately.
In order to make the JNI library available the following platform-dependent steps
must be performed:
> On Unix systems the library libtet_java.so (on Mac OS X: libtet_java.jnilib) must be
placed in one of the default locations for shared libraries, or in an appropriately configured
directory.
> On Windows the library pdf_tet.dll must be placed in the Windows system directory,
or a directory which is listed in the PATH environment variable.
The TET Java package is contained in the tet.jar file and contains a single class called tet.
In order to supply this package to your application, you must add tet.jar to your
CLASSPATH environment variable, add the option -classpath tet.jar in your calls to the
Java compiler, or perform equivalent steps in your Java IDE. In the JDK you can configure
the Java VM to search for native libraries in a given directory by setting the
java.library.path property to the name of the directory, e.g.
java -Djava.library.path=. extractor
You can check the value of this property as follows:
System.out.println(System.getProperty("java.library.path"));
Exception handling. The TET language binding for Java will throw native Java exceptions
of the class TETException. TET client code must use standard Java exception syntax:
TET tet = null;
try {
...TET method invocations...
} catch (TETException e) {
System.err.print("TET exception occurred:\n");
System.err.print("[" + e.get_errnum() + "] " + e.get_apiname() + ": " +
e.get_errmsg() + "\n");
} catch (Exception e) {
System.err.println(e.getMessage());
} finally {
if (tet != null) {
tet.delete(); /* delete the TET object */
}
}
Since TET declares appropriate throws clauses, client code must either catch all possible
exceptions or declare those itself.
26 Chapter 3: TET Library Language Bindings