ANNOUNCE: Inline::Java 0.21

[email protected] ("Patrick LeBoutillier") Mon, 14 May 2001 13:36:50 -0400
Newsgroups perl.jpl,perl.inline
Message-ID <[email protected]>
------=_NextPart_000_0029_01C0DC7A.EDD5DA70
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

I've just uploaded Inline::Java 0.21 to CPAN.

It is a minor upgrade that includes class 'studying', small bug fixes =
and some performance improvements.

The next release should be Inline 0.40 compatible.

Patrick

-------------------------------------------------------------------------=
---------------------------------------------------------
INTRODUCTION:

Inline::Java - Write Perl classes in Java.

Inline::Java lets you write Perl classes in Java.

Example:

    use Inline Java =3D> <<'END',
     class JAxH {
   public JAxH(String x){
    System.out.println("Just Another " + x + " Hacker") ;
   }
     }
 END
   =20
    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=20
virtual machine as shared object instead of running it as a separate =
process.=20
This extension works without problems on MSWin32 systems, but requires=20
rebuilding Perl on Solaris (and possibly in Linux as well) because of=20
threading issues.

See README.JNI for more information on building the JNI extension.


-------------------------------------------------------------------------=
------
INSTALLATION:

- This module requires Inline version 0.31 or higher to be installed.
- It also requires a version of the Java SDK 1.2 or higher to be=20
  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
make             (see Note 2)
make test        (see Note 3, 4, 5)
make install

You have to 'make install' before you can run it successfully.=20


Note 1: Use nmake on Windows systems. If you are using the COMMAND.COM =
shell
under Windows, Inline::Java will try to detect it. If it doesn't,=20
you should set the PERL_INLINE_JAVA_COMMAND_COM environment variable=20
to a true value. You also will need set this whenever you use the module
later on.

Note 2: On Win95/98/Me, you might get and error when doing 'nmake'. If =
so,
edit 'Makefile' and go the the indicated line. Remove the '@[' and ']' =
lines
around the 'subdirs' rule's commands. Rerun 'nmake'.

Note 3: In order for 'make test' to run properly, you should put the=20
directory to your Java binaries in either your PATH environment variable =

or in the PERL_INLINE_JAVA_BIN environment variable. 'make test' will =
remind you=20
if you don't do this.

Note 4: If you have built the JNI extension and want the test suite to =
use=20
it, you will need to set the PERL_INLINE_JAVA_JNI environment variable =
to 1=20
BEFORE running 'make test'.

Note 5: 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=20
time you test loading of an already built module.


-------------------------------------------------------------------------=
------
FEATURES:

WARNING: THIS IS ALPHA SOFTWARE. It is incomplete and possibly =
unreliable.=20
         It is also possible that some elements of the interface (API) =
will=20
         change in future releases.

Inline::Java version 0.21 is a minor upgrade that includes:
+ 'Studying' of external classes
+ Default no-arg constructors for public ('studied') classes
+ Caching of class information increases performance

Inline::Java version 0.20 is a major upgrade that includes:
+ All public member variables are now exported to Perl.
+ Arrays can now be passed as method parameters and assigned to=20
  member variables.
+ Type casting is now available to force the selection of specific
  method signatures.
+ Optional JNI (Java Native Interface) extension improves performance.
+ Increased stability on Win32.

Inline::Java version 0.01 includes:
+ All classes and their public methods are exported to Perl, relative
  to your current package.
+ All objects (except arrays) and primitive Java types are supported as
  method parameters.


-------------------------------------------------------------------------=
------
INFORMATION:

=3D For more information on Inline::Java, see 'perldoc Inline::Java'.
=3D For information about Inline, see 'perldoc Inline'.
=3D For information on using Java, visit http://java.sun.org

The Inline::Java mailing list is [email protected].=20
Send email to [email protected] to subscribe.

Please send questions and comments to "Patrick LeBoutillier" =
<[email protected]>

Copyright (c) 2001, Patrick LeBoutillier. All Rights Reserved. =20


------=_NextPart_000_0029_01C0DC7A.EDD5DA70
Content-Type: text/html;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META http-equiv=3DContent-Type content=3D"text/html; =
charset=3Diso-8859-1">
<META content=3D"MSHTML 5.50.4522.1800" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D2>I've just&nbsp;uploaded Inline::Java =
0.21 to=20
CPAN.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>It is a minor =
upgrade&nbsp;that&nbsp;includes class=20
'studying',&nbsp;small bug fixes and&nbsp;some performance=20
improvements.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>The next release should be Inline 0.40=20
compatible.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Patrick</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial=20
size=3D2>----------------------------------------------------------------=
------------------------------------------------------------------</FONT>=
</DIV>
<DIV><FONT face=3DArial size=3D2>INTRODUCTION:</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT><FONT face=3DArial =
size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Inline::Java - Write Perl classes in=20
Java.</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT><FONT face=3DArial =
size=3D2></FONT>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Inline::Java lets you write Perl =
classes in=20
Java.</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>Example:</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>&nbsp;&nbsp;&nbsp; use Inline Java =
=3D&gt;=20
&lt;&lt;'END',<BR>&nbsp;&nbsp;&nbsp;&nbsp; class JAxH=20
{<BR>&nbsp;&nbsp;&nbsp;public JAxH(String=20
x){<BR>&nbsp;&nbsp;&nbsp;&nbsp;System.out.println("Just Another " + x + =
"=20
Hacker") ;<BR>&nbsp;&nbsp;&nbsp;}<BR>&nbsp;&nbsp;&nbsp;&nbsp;=20
}<BR>&nbsp;END<BR>&nbsp;&nbsp;&nbsp; <BR>&nbsp;&nbsp;&nbsp; new =
JAxH('Inline')=20
;</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>When run, this complete program=20
prints:</FONT></DIV>
<DIV>&nbsp;</DIV>
<DIV><FONT face=3DArial size=3D2>&nbsp;&nbsp;&nbsp; Just Another Inline=20
Hacker</FONT></DIV>
<DIV><FONT face=3DArial size=3D2></FONT>&nbsp;</DIV><FONT face=3DArial =
size=3D2>
<DIV><BR>----------------------------------------------------------------=
---------------<BR>JNI=20
(JAVA NATIVE INTERFACE) EXTENSION:</DIV>
<DIV>&nbsp;</DIV>
<DIV>Inline::Java now provides a JNI extension that allows you to load =
the Java=20
<BR>virtual machine as shared object instead of running it as a separate =

process. <BR>This extension works without problems on MSWin32 systems, =
but=20
requires <BR>rebuilding Perl on Solaris (and possibly in Linux as well) =
because=20
of <BR>threading issues.</DIV>
<DIV>&nbsp;</DIV>
<DIV>See README.JNI for more information on building the JNI =
extension.</DIV>
<DIV>&nbsp;</DIV>
<DIV><BR>----------------------------------------------------------------=
---------------<BR>INSTALLATION:</DIV>
<DIV>&nbsp;</DIV>
<DIV>- This module requires Inline version 0.31 or higher to be =
installed.<BR>-=20
It also requires a version of the Java SDK 1.2 or higher to be =
<BR>&nbsp;=20
installed. You can get the latest Java SDK from Sun =
Microsystems<BR>&nbsp; at <A=20
href=3D"http://java.sun.com">http://java.sun.com</A>. Follow the =
provided=20
instructions in order<BR>&nbsp; to install the Java SDK properly.</DIV>
<DIV>&nbsp;</DIV>
<DIV>To install Inline::Java do this:</DIV>
<DIV>&nbsp;</DIV>
<DIV>perl=20
Makefile.PL<BR>make&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=
&nbsp;&nbsp;&nbsp;=20
(see Note 2)<BR>make test&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (see =
Note 3,=20
4, 5)<BR>make install</DIV>
<DIV>&nbsp;</DIV>
<DIV>You have to 'make install' before you can run it successfully. =
</DIV>
<DIV>&nbsp;</DIV>
<DIV><BR>Note 1: Use nmake on Windows systems. If you are using the =
COMMAND.COM=20
shell<BR>under Windows, Inline::Java will try to detect it. If it =
doesn't,=20
<BR>you should set the PERL_INLINE_JAVA_COMMAND_COM environment variable =
<BR>to=20
a true value. You also will need set this whenever you use the =
module<BR>later=20
on.</DIV>
<DIV>&nbsp;</DIV>
<DIV>Note 2: On Win95/98/Me, you might get and error when doing 'nmake'. =
If=20
so,<BR>edit 'Makefile' and go the the indicated line. Remove the <A=20
href=3D"mailto:'@['">'@['</A> and ']' lines<BR>around the 'subdirs' =
rule's=20
commands. Rerun 'nmake'.</DIV>
<DIV>&nbsp;</DIV>
<DIV>Note 3: In order for 'make test' to run properly, you should put =
the=20
<BR>directory to your Java binaries in either your PATH environment =
variable=20
<BR>or in the PERL_INLINE_JAVA_BIN environment variable. 'make test' =
will remind=20
you <BR>if you don't do this.</DIV>
<DIV>&nbsp;</DIV>
<DIV>Note 4: If you have built the JNI extension and want the test suite =
to use=20
<BR>it, you will need to set the PERL_INLINE_JAVA_JNI environment =
variable to 1=20
<BR>BEFORE running 'make test'.</DIV>
<DIV>&nbsp;</DIV>
<DIV>Note 5: When testing Inline::Java, it's always a good idea to run =
'make=20
test'<BR>twice. The first time you test the building and loading of a =
module,=20
the second <BR>time you test loading of an already built module.</DIV>
<DIV>&nbsp;</DIV>
<DIV><BR>----------------------------------------------------------------=
---------------<BR>FEATURES:</DIV>
<DIV>&nbsp;</DIV>
<DIV>WARNING: THIS IS ALPHA SOFTWARE. It is incomplete and possibly =
unreliable.=20
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; It is also possible =
that=20
some elements of the interface (API) will=20
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; change in future=20
releases.</DIV>
<DIV>&nbsp;</DIV>
<DIV>Inline::Java version 0.21 is a minor upgrade that includes:<BR>+ =
'Studying'=20
of external classes<BR>+ Default no-arg constructors for public =
('studied')=20
classes<BR>+ Caching of class information increases performance</DIV>
<DIV>&nbsp;</DIV>
<DIV>Inline::Java version 0.20 is a major upgrade that includes:<BR>+ =
All public=20
member variables are now exported to Perl.<BR>+ Arrays can now be passed =
as=20
method parameters and assigned to <BR>&nbsp; member variables.<BR>+ Type =
casting=20
is now available to force the selection of specific<BR>&nbsp; method=20
signatures.<BR>+ Optional JNI (Java Native Interface) extension improves =

performance.<BR>+ Increased stability on Win32.</DIV>
<DIV>&nbsp;</DIV>
<DIV>Inline::Java version 0.01 includes:<BR>+ All classes and their =
public=20
methods are exported to Perl, relative<BR>&nbsp; to your current =
package.<BR>+=20
All objects (except arrays) and primitive Java types are supported =
as<BR>&nbsp;=20
method parameters.</DIV>
<DIV>&nbsp;</DIV>
<DIV><BR>----------------------------------------------------------------=
---------------<BR>INFORMATION:</DIV>
<DIV>&nbsp;</DIV>
<DIV>=3D For more information on Inline::Java, see 'perldoc =
Inline::Java'.<BR>=3D=20
For information about Inline, see 'perldoc Inline'.<BR>=3D For =
information on=20
using Java, visit <A =
href=3D"http://java.sun.org">http://java.sun.org</A></DIV>
<DIV>&nbsp;</DIV>
<DIV>The Inline::Java mailing list is <A=20
href=3D"mailto:[email protected]">[email protected]</A>. <BR>Send email to =
<A=20
href=3D"mailto:[email protected]">[email protected]</A> =
to=20
subscribe.</DIV>
<DIV>&nbsp;</DIV>
<DIV>Please send questions and comments to "Patrick LeBoutillier" &lt;<A =

href=3D"mailto:[email protected]">[email protected]</A>&gt;</DIV>
<DIV>&nbsp;</DIV>
<DIV>Copyright (c) 2001, Patrick LeBoutillier. All Rights =
Reserved.&nbsp;=20
<BR></FONT></DIV></BODY></HTML>

------=_NextPart_000_0029_01C0DC7A.EDD5DA70--