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 <patl@cpan.org>.

Copyright (c) 2001-2005, Patrick LeBoutillier. All Rights Reserved.