| 1 | JFLI |
|---|
| 2 | ==== |
|---|
| 3 | |
|---|
| 4 | The Java Foreign Linker Interface (JFLI) provides an abstraction to |
|---|
| 5 | manipulate Java classes from Armed Bear Common Lisp that has been |
|---|
| 6 | ported to other Lisp implementations. |
|---|
| 7 | |
|---|
| 8 | Incorporated into ABCL from <git://github.com/mrohne/jfli>. |
|---|
| 9 | |
|---|
| 10 | |
|---|
| 11 | README |
|---|
| 12 | ------ |
|---|
| 13 | |
|---|
| 14 | jfli (http://jfli.sf.net) is a library that provides access to Java |
|---|
| 15 | from Lisp. jfli-abcl is jfli modified to work with ABCL |
|---|
| 16 | (http://armedbear-j.sf.net); it provides the same interface to Java, |
|---|
| 17 | but, since ABCL lives on the JVM, it doesn't need jni. |
|---|
| 18 | |
|---|
| 19 | jfli-abcl has an experimental NEW-CLASS macro that writes and loads a |
|---|
| 20 | Java class at runtime, and defines the usual jfli-like Lisp interface |
|---|
| 21 | to it. See the documentation of NEW-CLASS and the examples for the |
|---|
| 22 | syntax. If you want to use it, make sure that (1) asm.jar |
|---|
| 23 | (http://asm.objectweb.org) is in your classpath, and (2) the runtime |
|---|
| 24 | generated Java classes are in the Java package of the same name as the |
|---|
| 25 | Lisp package in which they're defined, like this: |
|---|
| 26 | |
|---|
| 27 | (in-package "FOO") |
|---|
| 28 | (new-class "FOO.MyClass" ...) |
|---|
| 29 | |
|---|
| 30 | Caveats: jfli-abcl inherits all the bugs from jfli; see the archives |
|---|
| 31 | of the jfli-users mailing list for a partial list. It probably also |
|---|
| 32 | adds some of its own. I'm particularly interested in the latter type. |
|---|
| 33 | |
|---|
| 34 | Please send (ABCL-specific) bug reports, suggestions, examples, |
|---|
| 35 | and whatever else you can think of, to asimon@math.bme.hu. |
|---|
| 36 | |
|---|
| 37 | # Colophon |
|---|
| 38 | |
|---|
| 39 | <> abcl:documents <urn:abcl.org/release/1.3.0-dev/contrib/jfli#0.2.0> . |
|---|
