Java mapscript
==============

WARNING: Starting with version 6.1 Mapserver (and Mapscript) uses libtool to build
the shared libraries. Some files have changed names and the javamapscript.so shared
library now depends on libmapserver.so.
The easiest way way to handle the dependency is to simply use the 'make install'
target.

To generate the SWIG wrappers you need swig > 1.3.24.

MAPSCRIPT Reference
-------------------

The complete reference documentation is available on-line:

http://mapserver.gis.umn.edu/docs/reference/mapscript

or in the file:

../doc/mapscript.txt

SWIG wrappers
-------------

MapServer releases, beginning with 4.2.4, contain pre-generated wrapper code
(mapscript/java/mapscript_wrap.c) and class files (mapscript/java/edu).
Nevertheless it is recommended that you generate your own using the "interface"
target in the Java Makefile.

Requires swig > 1.3.24. Version above 1.3.28 or 1.3.29 are recommended.

Installation
------------

After MapServer is configured and compiled, change directory to the Java
mapscript location and execute:

    $ cd mapscript/java
    $ make
    $ make test (recommended)
    $ make threadtests (optional)
    $ make install (required as of 6.1)

Remember to set the appropriate variable (LD_LIBRARY_PATH, java.library.path
or edit /etc/ld.so.conf) to make sure Java can locate and load the libraries.

Windows
-------

Edit makefile.vc to match your environment.  You will need to set JAVA_HOME 
and SWIG_HOME to the appropriate variables.  You will likely need to copy 
all of the DLLs needed to run MapServer into the mapscript/java directory 
(including libmap.dll) so the mapscript.dll can see them to run.

cd mapscript/java
nmake /f makefile.vc
nmake /f makefile.vc test

International language support
------------------------------

Since May 2006 Java mapscript has complete support for international languages
usage in queries and mapscript internals. To document this improvement
we have created the examples/QueryByAttributeUnicode.java
test program which uses the ISO-8859-15 encoding.

http://mapserver.gis.umn.edu/bugs/show_bug.cgi?id=1753
http://thread.gmane.org/gmane.comp.gis.mapserver.user/19298/focus=19298
http://thread.gmane.org/gmane.comp.gis.mapserver.user/19213/focus=19213

Onlice resources
----------------

Java mapscript related:

http://mapserver.gis.umn.edu/docs/howto/javamapscript
http://mapserver.gis.umn.edu/docs/howto/java_mapscript_Tomcat_55
http://mapserver.gis.umn.edu/docs/faq/thread_safety

General:

http://mapserver.gis.umn.edu/docs

