PBJ::JNI version 0.1

PBJ stands for Peanut Butter and Jelly. It is in general used to make sandwiches. It is also known as Package to Bridge Java, which is this package.

PBJ is a suite of modules, implemented in object-oriented fashion, to let the Perl community take advantage of the Java open standards, while in the mean time staying in Perl.

PBN::JNI is the first and the basic package released in this suite. All modules in PBJ are based in PBJ::JNI:: modules. To use PBJ::JNI::, you need to know everything that is required to program with Java JNI in C. You can easily crash the program if you don't know what you are doing. So this module is not for people who want to use "pure Perl". It is in the design that all other modules based on PBJ::JNI::* in this package will have a pure Perl interface.

This version was developed using Java JDK 1.2.

FEATURES

Warning: This software is still in alpha stage. It may not be reliable and its features and APIs may change in the future releases.

• PBJ::JNI::Native module provides a directly interface to Java JNI C functions.
• PBJ::JNI::JavaVm and PBJ::JNI::JNIEnv modules provide wrapper for Java VM functions in PBJ::JNI::Native in an object-oriented fashion.
• The Java interpreter is linked with Perl so there is no other processes to manage.

LIMITATIONS

• use system malloc only
• do not work with "hotspot".

MODULES

• PBJ::JNI::JavaVM
• PBJ::JNI::JNIEnv
• PBJ::JNI::Util
• PBJ::JNI::Native

PREREQUISITES

• This library was developed by the author with Perl v5.6.1 built for i586-linux, orignally on a Mandrakes Linux version 6.1 system with 98 Megabytes of memory, and then RedHat 7.2 with 256 Megabytes for memory.
• This library is never tested on any other platform.
• The Perl used with this library must be compiled to use the system malloc suite of function.

INSTALLATION

To install this module type the following:

perl Makefile.PL
make
make test
make install

Alternatively, if you have CPAN.pm installed and are connected to the Internet, you can try to do the following

perl -MCPAN -e shell
> install PBJ::JNI

INFORMATION

Please send questions and comments to "Ping Liang" <ping@cpan.org>

COPYRIGHT AND LICENCE

Copyright (c) 2001 Ping Liang
All rights reserved.

THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

This program is licensed under the same terms as Perl itself. For more information see the README or Artistic files provided with the Perl distribution.