Welcome to the Frightening World of Java/Perl interoperability!

See below for instructions on how to install on a Windows box running
ActiveState Perl.

Version 2.x of JavaServer & Java.pm are NOT backwards compatible!!!
You MUST use a 2.x version of JavaServer with a 2.x version of Java.pm
& same for 1.x versions!

There are two parts to this:
1. The 'Backend' - which is contained in 'Java.jar'.  The backend must be
running for the 'Frontend' (part #2) to work.  Run 'install_java_server.pl'
to get this part going.  The 'main' Java class is called 'JavaServer' so
you end up running the thing as 'java -classpath <classpath> JavaServer'
JavaServer listens on a port for incoming connexions from Frontends - you
can alter the default port of 2000 by specifying it on the command line link:
java -classpath <classpath> JavaServer 8000
Will start the server listening on port 8000.  You would then need to tell
the Java Perl module to connect to port 8000 instead of the default like:
my $java = new Java(port => 8000);
More on this below.
2. The 'Frontend' - which is the Perl module 'Java.pm' which you install
as any other Perl module.

First be sure to run 'install_java_server.pl' to get your JavaServer environment
set up and happy.
Make sure 'JavaServer' is up and running before you try to run any tests!

Basically you just need to add 'Java.jar' to your classpath on the 'java'
command line (which unfortunately forces you to also add in classes.zip
manually).  Run the 'install_java_server.pl' and it will create a shell
or batch file for you (most likely) - or at least tell you what you need to
to.

Please see the javadoc on Java for LOTS more information.

JavaServer Tested On Matrix:

	JVM	1.1.8		1.2
Platorm
-------
NetBSD		Yep		<Not available>
Solaris		Yep		Yep
Windows '98	Yep		Yep
Linux		Yep		Yep

In theory - according to 'Write Once Run Anywhere' that is! - JavaServer should run no problem under any 1.1+ JVM.  It doesn't really do anything too fancy.
The 'SwingEventListener' does need Swing to be loaded (or accessible) to the
JVM to use Swing events & of course Swing classes.
You can run JavaServer just fine if Swing isn't available - it'll automatically
detect that Swing isn't available and use 'EventListener' rather than 
'SwingEventListener'.  That gets ya all the plain old AWT events.
'SwingEventListener' subclasses 'EventListener' & just adds all them bizzare
Swing events.

A great place to look is the 'test.pl' script and in the 'examples' directory.

ACTIVESTATE USERS
Thanks to John Z. for this info:
1. to install under activeperl, users needs to download nmake15. and use 
the nmake instead of make on the usual perl install. location of 
nmake15.exe is under ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe
instrtuction on how its used with activestate modules is 
www.activestate.com/Products/ActivePerl/docs/faq/ActivePerl-faq2.html