JIPL: Java Interface to Prolog

This package, named JIPL, gives interface between Java and Prolog.
With this package, you can

1. call Prolog predicate from Java application/applet.
2. call Java methods, access fields of object from Prolog programs.

2001/09/24 JIPL version1.3

• Fixed the case "sucsess() method not found".

2000/10/13 JIPL version1.2.1

• Fixed a sirious error in backslash treatment in the IDE.

2000/10/10 JIPL version1.2
2000/09/18 JIPL version1.2beta for JDK1.2 and JDK1.3.
• Based on K-Prolog version 5.0beta, fully ISO conforming.
• The package name is changed. New name is "com.kprolog.plc".
2000/06/01 JIPL now in kprolog.com.
1999/01/20 Release of K-Prolog User's Manual ENGLISH translation.
1998/06/10 JIPL version1.01 for Linux glibc
• Ports to Linux glibc 2.0.7-13.
1997/12/10 JIPL version1.01
• Ports to SunOS,Solaris/x86,FreeBSD2.2.2 and Linux2.0.
• Abandoned using JDK Invocation interface, for porting reasons. (The source is left over for convenience.)
• Fixed bugs in K-Prolog native interface.
1997/09/25 JIPL version1.0 final for JDK1.1.3/1.1.4
• The package name is changed. New name is "CO.jp.isac.plc".
• Class files are jar'ed.
• JIPL/IDE help refers local files, now.
1997/07/16 JIPL final beta for JDK1.1.3
• Changed to set properties through new VM initialization structure.
• Reconfigured the IDE classes. You can browse help items through Netscape or any other browser.
1997/05/20 JIPL beta1 for JDK1.1.1
• IDE example. Screen shot
  
• Changed PrologAPI naming from plcJavaXXX to javaXXX.
• Changed JIPL loading method from System.load() to System.loadLibrary().
• Bug fixes.
1997/02/19 JIPL alpha2 for JDK1.1 final
• Adopted to JDK1.1 final
1997/01/30 JIPL alpha2 for JDK1.1 beta3
• Accessing fields of object
• Exception propagation from Java to Prolog
• New entry point to background Prolog thread
• (may be)More stable usage of Global/LocalRef of JNI
• Conversion between Java Unicode and EUCJIS/SJIS kanji code
1997/01/7 JIPL alpha1

You can find K-Prolog Users manual at http://www.kprlog.com/ . There is an English version now.

---

Downloading and installation

UNIX directory candidate is /usr/local/plc/
Windows directory candidate is C:\plc\

and set the directory to environment variables PLC and PATH.
You should also set LD_LIBRARY_PATH, and may specify through 
BROWSER variable, which browser to use, if you are using UNIX,
to show help. Or, Netscape Communicator/Navigator users can
specify MOZILLA_HOME, instead.
i.e.

unix % setenv PLC /usr/local/plc
unix % setenv PATH $PLC:$PATH
unix % setenv LD_LIBRARY_PATH $PLC:$LD_LIBRARY_PATH
unix % setenv MOZILLA_HOME /usr/local/netscape
win32> set PLC=C:\plc
win32> set PATH=%PLC%;%PATH

Set the Java classpath to the directory.
For example,

unix % java -classpath $PLC:$JAVA_HOME/lib/classes.zip

---

Examples

You can find 8-Queens animation in examples/queens --

Adjust Makefile lines
PLC = 
JAVA_HOME = 
to fit with your environment.
Then

> make run

gives animated solution of 8-Queens problem.

This example is incomplete as a Java animation. My aim is to show how JIPL interfaces Prolog and Java, and omitted unnecessary code.

Another example shows how to background the prolog thread --

You can find this one in examples/client.

example/ide contains an IDE example --

In this directory,

% jipl

starts the JIPL/IDE.
Then you may try
[Reconsult] and select queens.pl,
type in "queens(Q)" to [TextField] to run the program.
To erase the board, type in "dispose".

In the class com.kprolog.plc.Plc class,
you may mainly use the methods,

startPlc(String[] args)
exec(String command)
call(String functor, Object[] args)
run()

Prolog API

javaConstructor(Class(Args,...), Instance)
    Class(+atom)    : Java class name, with full package path.
    Args(+term)     : Arguments to be passed to the constructor.
                      Don't use () if the constructor has no argument.
                      Place just an atom as Class instead.
    Instance(-term) : Instance created.

    Calls constructor of Java object.

javaMethod(ClassOrInstance, Method(Args,...), Return)
    ClassOrInstance : Class or Instance.
    Class(+atom)    : Java class name, with full package path.
    Instance(+term) : An instance.
    Args(+term)     : Arguments to be passed to the constructor.
                      Don't use () if the method has no argument.
                      Place just an atom as Method instead.
    Return(-term)   : Returned object from the method. Remain intact if 
                      the method is void type.

    Calls a static method of a class, if ClassOrInstance is an atom.
    Calls an instance method, if an instance is given.

javaGetField(ClassOrInstance, Field, Value)
    ClassOrInstance : Class or Instance.
    Class(+atom)    : Java class name, with full package path.
    Instance(+term) : An instance.
    Field(+atom)    : Field name.
    Value(-term)    : Value of the field.

    Gets the value of the field.

javaSetField(ClassOrInstance, Field, Value)
    ClassOrInstance : Class or Instance.
    Class(+atom)    : Java class name, with full package path.
    Instance(+term) : An instance.
    Field(+atom)    : Field name.
    Value(+term)    : Value to be set to the field.

    Sets the value to the field.


 Data conversion 

    Java        Prolog
    ---------------------------
    Integer     32bit integer
    Double      64bit float
    Long        (may be bignum)integer
    BigInteger  (may be bignum)integer
    String      string (list of char code)
    Array       list
    Other       address term



Development environment

% jipl

starts the JIPL/IDE.

It is a shell script or batch file, which starts sample Prolog IDE.
I abandoned using Java Invocation interface, for porting reasons.
You can use it with environment variables PLC and JAVA_HOME set.

Source is available under src/ide directory, but you can't find
any document.

I call this "IDE", but it contains no editor. 
[File]-[Edit] starts "vi" in default. With editor(EditorName) prolog
builtin, you may specify an editor you use.


Example of IDE usage.

(NOTE)

If you don't have K-Prolog commercial product,
you can't Compile(into native code objects)/Load(native code object/dll).


TODO 





License

Permission to use, copy, modify, and distribute 
this release of the software for RESEARCH/EVALUATION
purposes and without fee is hereby granted
provided that this copyright notice appears in
all copies. 
Notice that EDUCATIONAL purpose usage is NOT granted.

The Java package name, com.kprolog.plc, is reserved for
KLS Research, Inc. So you should rename the package when you
apply JIPL to other language processors.

Nobukuni Kino and KLS Research, Inc. make no warranties
about the suitability of the software, either
expressed or implied, fitness for a particular
purpose.
Nobukuni Kino and KLS Research, Inc. shall not be liable
for any damages suffered by licensee as a result
of using, modifying or distributing this software
or its derivatives.

 Commercial package

 K-Prolog Compiler version 5.0
is the full set commercial package.

Personal users may download it through HTTP.

Contact info@kprolog.com
and purchase  LICENSE FOR COMMERCIAL or EDUCATIONAL purpose. 



Please report any problems or proposals to
kino@kprolog.com
(Nobukuni Kino)
KLS Research Lab.



Ìܼ¡¤ËÌá¤ë