blob: 007e14dbca322add6825944bb01ceabde1896d7c [file] [log] [blame]
<body bgcolor="#ffffff">
<H1>SWIG Java Examples</H1>
The following examples illustrate the use of SWIG with Java.
<li><a href="simple/index.html">simple</a>. A minimal example showing how SWIG can
be used to wrap a C function, a global variable, and a constant.
<li><a href="native/index.html">native</a>. Comparing the manual and the SWIG approach to calling native code.
<li><a href="typemap/index.html">typemap</a>. Modifying the Java module's default behaviour by using typemaps.
<li><a href="constants/index.html">constants</a>. This shows how preprocessor macros and
certain C declarations are turned into constants.
<li><a href="variables/index.html">variables</a>. An example showing how to access C global variables.
<li><a href="enum/index.html">enum</a>. Wrapping enumerations.
<li><a href="class/index.html">class</a>. How to wrap a simple C++ class.
<li><a href="reference/index.html">reference</a>. C++ references.
<li><a href="pointer/index.html">pointer</a>. Simple pointer handling.
<li><a href="template/index.html">template</a>. C++ templates.
<li><a href="funcptr/index.html">funcptr</a>. Pointers to functions.
<li><a href="callback/index.html">callback</a>. C++ callbacks using directors.
<li><a href="extend/index.html">extend</a>. Polymorphism using directors.
<h2>Running the examples</h2>
Please see the <a href="../../Doc/Manual/Windows.html">Windows</a> page in the main manual for information on using the examples on Windows. <p>
On Unix most of the examples work by making the Makefile before executing the program The Makefile will output the swig generated JNI c code as well as the Java wrapper classes. Additionally the JNI c/c++ code is compiled into the shared object (dynamic link library) which is needed for dynamic linking to the native code. The Makefiles also compile the Java files using javac.
Ensure that the dynamic link library file is in the appropriate path before executing the Java program. For example in Unix, must be in the LD_LIBRARY_PATH.
A Unix example:
$ make
$ export LD_LIBRARY_PATH=. #ksh
$ java runme
The examples have been extensively tested on the following platforms:
Your mileage may vary. If you experience a problem, please let us know by
contacting us on the <a href="">mailing lists</a>.