I've thrown Alessio's notes up onto the Wiki: it's a start, anyway...
http://trac.common-lisp.net/armedbear/wiki/JavaFfi
I'll tidy the page up a bit soon, but I'm a bit snowed under at the moment.
Cheers,
John :^P
On Mon, Oct 19, 2009 at 5:17 PM, nitralime nitralime@googlemail.com wrote:
On Mon, Oct 19, 2009 at 3:54 PM, Alessio Stalla alessiostalla@gmail.com wrote:
On Mon, Oct 19, 2009 at 3:34 PM, nitralime nitralime@googlemail.com wrote:
Thank you for this quick "cheet sheet".
I find it very sad that there are no reasonable documentation (at least something like a jump start guide). Diving into source code maybe the last resort for experts which I don't belong anyway!
If it's true that there's no existing official documentation for the Java ffi (I'm not sure), I can write it one of these days, it shouldn't take long. It will be useful to me too (I always forget the syntax of jstatic, for example).
It is a great idea!! I believe that many of us (newbies) would be grateful to you!
In general abcl's documentation is indeed quite lacking;
That is true regarding the documentation of its interaction with the jvm runtime environment which is my primary focus of interest in ABCL.
the implementation is young, the work force is scarce, and writing documentation is boring ;)
We all know it and therefore honor voluntary efforts of developers!
Regards Nik
Cheers, Alessio
Regards Nik
On Mon, Oct 19, 2009 at 2:41 PM, Alessio Stalla alessiostalla@gmail.com wrote:
On Mon, Oct 19, 2009 at 1:48 PM, nitralime nitralime@googlemail.com wrote:
Hi folks,
I'm searching for a (more systematic) documentation (or tutorial) about how to use Java libraries from ABCL.
I couldn't find anything else except the examples on
"http://trac.common-lisp.net/armedbear/browser/trunk/abcl/examples/abcl".
Is there any such tutorial (or documentation) at all?
I'm not aware of any tutorial, however if you know the Java reflection API you'll find that abcl's operators maps quite well to it. A quick "cheat sheet":
(jclass <class name>) gives you a Java class (jmethod <java class> <method names> <&rest argument types>) gives you a method (jconstructor <java class> <&rest argument types>) a constructor
(jnew <constructor> <&rest arguments>) instantiates a new Java object (jcall <method> <object> <&rest arguments>) calls a method
then there's jstatic to access static fields and methods, and iirc jfield to access fields. Oh, and jproperty-value and (setf jproperty-value) to access "properties" following the Java Bean convention (setXXX and getXXX). That's almost all; there is some more advanced stuff (e.g. manipulating Java arrays).
You can find most or all of this stuff inside Java.java
(http://trac.common-lisp.net/armedbear/browser/trunk/abcl/src/org/armedbear/l...). It's not documented but quite readable.
Also, there's an "invoke.lisp" somewhere on the net which simplifies the Java API (at the cost of some more runtime reflection). IIRC it depends on a non-abcl Java class. I also wrote my own ad-hoc NIH-syndrome-influenced Java simplification layer which is less powerful but does not depend on external stuff.
hth, Alessio