INTRODUCTION: Inline::Java - Write Perl classes in Java. Inline::Java lets you write Perl classes in Java. Example: use Inline Java => <<'END'; class JAxH { public JAxH(String x){ System.out.println("Just Another " + x + " Hacker") ; } } END new JAxH('Inline') ; When run, this complete program prints: Just Another Inline Hacker ------------------------------------------------------------------------------- JNI (JAVA NATIVE INTERFACE) EXTENSION: Inline::Java now provides a JNI extension that allows you to load the Java virtual machine as shared object instead of running it as a separate process. See README.JNI for more information on building the JNI extension. ------------------------------------------------------------------------------- INSTALLATION: - This module requires Inline version 0.44 or higher to be installed. - It also requires a version of the Java SDK 1.2 or higher to be installed. You can get the latest Java SDK from Sun Microsystems at http://java.sun.com. Follow the provided instructions in order to install the Java SDK properly. To install Inline::Java do this: % perl Makefile.PL J2SDK=/your/java/dir (see Note 1) % make java (see Note 2) % make % make test (see Note 3, 4) % make install You have to 'make install' before you can run it successfully. Note 1: Under Win95/98/Me, you may need to do 'cd ..' to get back to the your original directory after the command has completed. Note 2: Use nmake on Win32. Note 3: If you have built the JNI extension and want the test suite to use it, you will need to set the PERL_INLINE_JAVA_JNI environment variable to 1 BEFORE running 'make test'. Note 4: When testing Inline::Java, it's always a good idea to run 'make test' twice. The first time you test the building and loading of a module, the second time you test loading of an already built module. ------------------------------------------------------------------------------- FEATURES FOR THIS VERSION: Inline::Java version 0.51 is a major upgrade that includes: - Several major speed optimizations. - Introduction of support for I/O mapping between Perl and Java (Inline::Java::Handle) - Applied patches by Andrew Bruno and Tim Bunce for MAC OSX - JNI fix for system property passing (thanks to Brian Gugliemetti and Jason Stelzer) - Added NATIVE_DOUBLES configuration option to avoid loss of precision when passing double values between Perl and Java - New interface for processing callbacks from java to perl. - Added support for java.lang.CharSequence as a primitive type. Any Perl scalar passed as a java.lang.CharSequence will instantiate a java.lang.String on the Java side - Added BUILD_JNI, BUILD_PERL_NATIVES, BUILD_PERL_INTERPRETER and JVM_LIB_TYPE build configuration options to help with automated builds - Added BIND configuration option. See docs for details. Note: The Java JVM server noe listens on localhost by default (instead of 0.0.0.0). - Other minor bug fixes See CHANGES for a full change list. ------------------------------------------------------------------------------- INFORMATION: = For more information on Inline::Java, see 'perldoc Inline::Java'. = For information about Inline, see 'perldoc Inline'. = For information on using Java, visit http://java.sun.org. Inline::Java's mailing list is inline@perl.org. To subscribe, send an email to inline-subscribe@perl.org. Inline::Java's home page is http://inline.perl.org/java/. Please send questions and comments to Patrick LeBoutillier . Copyright (c) 2001-2005, Patrick LeBoutillier. All Rights Reserved.