1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
|
CamlJava - an OCaml/Java interface
==================================
DESCRIPTION:
This is a very preliminary release of CamlJava, an OCaml/Java
interface based on the following schema:
Caml/C interface JNI (Java Native Interface)
Caml <------------------> C <-----------------------------> Java
Currently, CamlJava provides a low-level, weakly-typed OCaml interface
very similar to the JNI. Java object references are mapped to an
abstract type, and various JNI-like operations are provided to allow
Java method invocation, field access, and more. A basic callback
facility (allowing Java code to invoke methods on Caml objects) is
also provided, although some stub Java code must be written by hand.
In the future, a higher-level, strongly-typed interface will be
provided, whereas Java classes are mapped directly to Caml classes.
This raises fairly delicate type mapping issues, though, so don't hold
your breath.
REQUIREMENTS:
- This release of CamlJava requires Objective Caml version 3.08 or later.
- A Java implementation that supports JNI (Java Native Interface).
So far, only Sun's JDK has been tested.
INSTALLATION ON A UNIX PLATFORM:
- Edit Makefile.config to define parameters depending on your Java
installation. As distributed, the library is set up for
Sun's JDK version 1.4.1 on a Linux x86 platform.
- make
become superuser
make install
- For testing:
make tst
INSTALLATION ON A WINDOWS PLATFORM:
- Works with the MSVC port of OCaml for Windows.
GNU make and Cygwin tools are required to do the installation.
- Edit Makefile.config.msvc to define parameters depending on your Java
installation.
- make -f Makefile.msvc
make -f Makefile.msvc install
- For testing:
make -f Makefile.msvc tst
USAGE:
The module is named "Jni". A good knowledge of the JNI is assumed; see Sun's
JNI book or http://java.sun.com/products/jdk/1.2/docs/guide/jni/
Then, the comments in lib/jni.mli should make sense.
Usage: ocamlc -I +camljava jni.cma ...
or ocamlopt -I +camljava jni.cmxa ...
See the programs in test/ for examples of use.
LICENSE: GNU Library General Public License version 2.
FEEDBACK: e-mail the author, Xavier.Leroy@inria.fr.
|