home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 February / PCWorld_2002-02_cd.bin / Software / Vyzkuste / pdflib / pdflib-4.0.1.sit / pdflib-4.0.1 / bind / java / readme.txt < prev   
Encoding:
Text File  |  2001-07-04  |  4.8 KB  |  139 lines  |  [TEXT/ttxt]
  1. General notes on the PDFlib Java binding
  2. ========================================
  3.  
  4. - Many Linux distributions include older versions of PDFlib which may
  5.   not have correct versioning information. For best results remove
  6.   any old PDFlib libraries if you want to use the latest version.
  7.  
  8. - Older JDK versions up to 1.1.8 are known to have multiple bugs with
  9.   respect to timezone interpretation. For this reason chances are that
  10.   the pdfclock example will display the wrong time on your system.
  11.  
  12. - The PDFlib Java wrapper cannot be compiled under Cygwin due to an
  13.   imcompatibility between the JNI headers and Cygwin.
  14.  
  15.  
  16. Using PDFlib with Borland/Inprise JBuilder
  17. ==========================================
  18.  
  19. - Having pdflib.java in the same directory as the project file
  20.   seems to confuse JBuilder.
  21.  
  22. - On Windows pdf_java.dll must be placed in the \winnt\system32 directory,
  23.   or some other directory contained in the PATH environment variable.
  24.   On Linux libpdf_java.so should be placed in /usr/lib or a similar
  25.   well-known (to the system) directory.
  26.  
  27. - Relative pathnames in PDFlib function calls are interpreted relative
  28.   to the JBuilder bin directory, not the project directory. Absolute
  29.   path names work. For this reason the output of the supplied PDFlib samples
  30.   may end up in some strange place.
  31.  
  32.  
  33. Using PDFlib with Allaire JRun
  34. ==============================
  35.  
  36. In order to use PDFlib with JRun the following is suggested:
  37.  
  38. - Copy PDFlib.jar and lib_java.dll to the .../JRun/servers/lib directory.
  39.  
  40. - Make sure that the lib directory is contained in the servlet.jnipath
  41.   property. This property can be set from the management console, or
  42.   specified in a local.properties file.
  43.  
  44.  
  45. Using PDFlib with J2EE-compliant servers
  46. ========================================
  47.  
  48. In order to use PDFlib with J2EE do the following:
  49.  
  50. - Add the following lines in the file $J2EE_HOME/lib/security/server.policy
  51.   in order to allow the PDFlib native library to be loaded:
  52.  
  53.   // default permissions granted to all domains
  54.   grant {
  55.           permission java.lang.RuntimePermission "loadLibrary.*";
  56.           permission java.lang.RuntimePermission "accessClassInPackage.*";
  57.           ...
  58.  
  59. - Use the deployment tool to add pdflib.jar to the project as an external
  60.   jar library.
  61.   It seems that pdflib.jar must be placed in the %J2EE_HOME%/lib directory;
  62.   otherwise the server will attempt to load the PDFlib shared library
  63.   multiply, resulting in the error message "shared library already loaded".
  64.  
  65. - pdf_java.dll or libpdf_java.so must be accessible in some system path,
  66.   e.g. \winnt\system32 or /usr/local/lib, or via PATH/LD_LIBRARY_PATH.
  67.  
  68. - The PATH and CLASSPATH variables should point to the bin subdirectories
  69.   of J2EE and JDK.
  70.  
  71.  
  72. Using PDFlib with Apache JServ
  73. ==============================
  74.  
  75. In order to use PDFlib with Apache JServ do the following:
  76.  
  77. - It is suggested to load PDFlib as early as possible. Loading PDFlib later
  78.   in the servlet (e.g., via repositories) may fail due to a different
  79.   class loader.
  80.  
  81. - Add the following (probably modified) lines to the file jserv.properties:
  82.  
  83.     wrapper.env="/usr/local/lib:/usr/lib:/lib"
  84.     wrapper.classpath=/usr/local/lib/java/pdflib.jar
  85.  
  86. - After building or installing PDFlib it may help to update the shared
  87.   library cache via
  88.  
  89.   ldconfig -v
  90.  
  91. - Restart Apache, and therefore the JVM.
  92.  
  93.  
  94. Using PDFlib with IBM WebSphere Application Server
  95. ==================================================
  96.  
  97. Servlets are loaded with a custom class loader. For this reason,
  98. the pdflib.jar file has to be located in the Application Server's
  99. classpath rather than the web application's classpath.  
  100.  
  101. To locate the pdflib.jar file in the app server's classpath, place the jar 
  102. file in the \<WAS app-server's path>\lib directory and edit the 
  103. admin.conf file.  In the admin.conf file add the path to the jar file 
  104. to the setting labeled:
  105.  
  106. com.ibm.ejs.sm.adminserver.classpath
  107.  
  108. The DLL or .so must be located somewhere on the machine's path.
  109. The winnt\system32 directory works for Windows, the bin directory
  110. of WAS on Solaris.
  111.  
  112.  
  113. Using PDFlib on Mac OS X
  114. ========================
  115.  
  116. On Mac OS X the shared PDFlib library for Java, which has a default file
  117. name of libpdf_java.dylib, must be renamed to libpdf_java.jnilib. The
  118. PDFlib build process does this automatically.
  119.  
  120. The default search path for JNI libraries on OS X is as follows:
  121.  
  122.     .:/usr/lib:/usr/lib/java:/lib:
  123.     /System/Library/Frameworks/JavaVM.framework/Versions/1.2/Libraries
  124.  
  125. You can extend the JNI search path by defining the DYLD_LIBRARY_PATH
  126. with more directories.
  127.  
  128.  
  129. Using PDFlib with Apple WebObjects
  130. ==================================
  131.  
  132. To the best of our knowledge, the following should be sufficient in order
  133. to use PDFlib with WebObjects:
  134.  
  135. - Use the java-framework-maker tool to create a new WebObjects Framework,
  136.   and select PDFlib.jar as input package.
  137.  
  138. - Add the new framework to your project.
  139.