jpl/README.JUST-JNI

   1 Just-JNI (call into Java from Perl only)
   2 ----------------------------------------
   3
   4 This has been tested with:
   5
   6     Debian GNU/Linux 2.2 i386, perl 5.6.0, Kaffe (CVS, 2000-12-05 or later)
   7     RedHat 6.1, perl-5.00503-6 (RedHat RPM), IBM JDK 1.1.8
   8     Debian 2.1 SPARC, Perl 5.005_60, JDK 1.2 beta (crashes with AWT, though)
   9     Windows NT 4.0 SP4, ActivePerl 519, JDK 1.1.8, Visual C++
  10     Solaris 7, Perl 5.005_03, JDK 1.1.6, GCC 2.8.1
  11
  12 Solaris 7 Note (this probably applies to all native thread situations):
  13
  14     Native threads were tricky. I had to build my own Perl, configured with:
  15
  16     sh Configure -Dprefix=/opt/perl5.005 -Duseshrplib -Doptimize=-g \
  17                  -Uusemymalloc -D cc=gcc -Dusethreads -d
  18
  19     When Configure let me edit config.sh, I changed libs to:
  20
  21     libs='-lthread -lsocket -lnsl -ldl -lm -lposix4 -lpthread -lc -lcrypt'
  22
  23     The leading -lthread is the only thing I had to add.
  24
  25 Kaffe Note:
  26
  27 I believe that Kaffe with JIT enabled will likely be problematic.  I had a
  28 lot of trouble with it, that simply went away with interpreter-based Kaffe.
  29 FWIW, here's how I configured Kaffe:
  30
  31      env AM_CPPFLAGS=-DDEBUG CFLAGS="-O0 -ggdb" ./configure --disable-gcj \
  32                                                   --with-engine=intrp
  33
  34 Likely you don't need all that debugging stuff.
  35
  36 Also, when I build perl, I do this, to be on the safe side.  I was worried
  37 about thread interaction, but realized there was no need to build threaded
  38 perl, but I thought that the perl code should probably be reentrant, so, I
  39 did this:
  40
  41       sh ./Configure -Dcc=gcc -Doptimize='-D_REENTRANT -DDEBUGGING -ggdb'  \
  42                      -Dlibperl='libperl.so' -Duseshrplib='true'
  43
  44 Again, you likely don't need the debugging flags.
  45
  46
  47 How do I do this crazy thing?
  48 -----------------------------
  49
  50 1) Cd into the JPL directory. Type the following:
  51
  52     perl Makefile.PL
  53     make
  54     make install
  55
  56    Under windows, that's:
  57
  58     perl Makefile.PL
  59     nmake
  60     nmake install
  61
  62 3) cd into the JNI directory (cd ../JNI or cd ..\JNI)
  63
  64 4) We now need to compile and make the Closer.class available to your
  65    JPL program.  Closer is a WindowListener that closes the Frame we
  66    make in the test program.
  67
  68    It seems that we've managed to fix the problem with CLASSPATH not
  69    getting propagated to the JVM, so if '.' is in your CLASSPATH, you
  70    should be able to compile Closer.java and leave it in the current
  71    directory:
  72
  73        javac Closer.java
  74
  75      or perhaps
  76
  77        jikes Closer.java
  78
  79 5) Make the demo:
  80
  81     a) type the following:
  82
  83       for SUN's proprietary software Java:
  84
  85         env JAVA_HOME=/path/to/java perl Makefile.PL
  86         # setting the JAVA_HOME enviornment variable might not be needed
  87         # if Java is in installed in a canonical location
  88         make
  89         make test
  90
  91       for Kaffe:
  92
  93         env KAFFE_PREFIX=/kaffe/installation/prefix perl Makefile.PL
  94         # setting the KAFFE_PREFIX enviornment variable might not be needed
  95         # if Kaffe is in a canonical location
  96         make
  97         make test
  98
  99        Under Windows:
 100
 101         perl Makefile.PL
 102         nmake
 103         nmake test
 104
 105
 106     b) if all went well, type:
 107
 108         make install
 109
 110        or, under Windows:
 111
 112         nmake install
 113