ETJ / Inline-Java-0.63 / README 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

              
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                                    (see Note 2)
  % 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. Also, you may set
either the JAVA_HOME or the PERL_INLINE_JAVA_J2SDK environment variable to 
/your/java/dir instead of using the J2SDK Makefile.PL parameter.
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.52 is a minor upgrade that includes:
    - Fixed JNI on cygwin (many thanks to Eric Rybski for the patch)
    - Improved installation. 'make java' is now performed automatically.
    - Fixed problems with disappearing exceptions by localizing $@.
    - 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.
Please send questions and comments to Patrick LeBoutillier <patl@cpan.org>.
Copyright (c) 2001-2005, Patrick LeBoutillier. All Rights Reserved.