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