1README.zxid-java
2================
3
4This is the Java JNI module for using libzxid. This JNI module is
5tightly integrated into the main ZXID project and distribution.
6As the diretory name reflects, the package name is zxidjava so
7you would do in your .java file:
8
9  import zxidjava.*;
10
11The Java stuff lives in
12
13  zxidjava.jar            Classes to use zxid
14  zxiddemo.war            Demonstration servlet ready to deploy
15
16The Java JNI interface also needs the C library (which must be
17found by dynamic linker):
18
19  libzxidjni.so           C library implementing ZXID JNI interface
20  zxidjni.dll             Windows version of the JNI
21  zxid.dll                Windows version of ZXID core
22
23> N.B. The .jar (or .war) DOES NOT contain libzxidjni.so.  You need to
24> download and copy this file separately.  The .jar is platform
25> independent. The libzxidjni.so (or zxidjni.dll) is platform
26> dependent.
27
28Please see for further information
29
30  zxid.org
31  zxid/README.zxid
32  zxid/INSTALL.zxid
33  zxid/zxid-java.pd       Using ZXID from Java
34  zxid/zxidsrvlet.java    Ready to use SSO servlet
35  zxid/zxidappdemo.java   Example code for using SSO servlet
36  zxid/zxidhlo.java       Example code for direct SSO integration
37
38Install
39
40  cd zxid-0.40
41  make dep
42  make                   # creates libzxid
43  make javazxid
44  make zxiddemo.war      # also builds zxidjava.jar
45  cp zxiddemo.war ../apache-tomcat-5.5.20/webapps/
46  # copy libzxidjni.so to place where dynamic linking finds it
47  cp libzxidjni.so ../apache-tomcat-5.5.20/bin/
48  # On Windows you need to copy zxid.dll and zxidjni.dll
49
50Rather than program directly with the module, you probably
51want to deploy it as a Servlet, e.g. in Tomcat. For this
52the SSO servler is zxidsrvlet.java and an example payload
53application using the SSO servlet is provided in
54zxidappdemo.java
55
56You can study both for source code, or use them as template
57to develop your own code.
58
59If you get compilation errors, check SERVLET_PATH and other variables
60in Makefile (see zxid-java.pd and zxid-install.pd for details).
61
62See zxid-java.pd (or html) for further information.
63
64Copyright (c) 2013 Synergetics NV (sampo@synergetics.be), All Rights Reserved.
65Copyright (c) 2010 Sampo Kellomaki (sampo@iki.fi), All Rights Reserved.
66Copyright (c) 2006-2009 Symlabs (symlabs@symlabs.com), All Rights Reserved.
67Author: Sampo Kellomaki (sampo@iki.fi)
68NO WARRANTY, not even implied warranties.
69Licensed under Apache License 2.0, see file COPYING.
70
71--Sampo
72