← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/mapserver/jaunty-updates

« back to all changes in this revision

Viewing changes to mapscript/java/README

  • Committer: Bazaar Package Importer
  • Author(s): Fabio Tranchitella
  • Date: 2006-11-02 11:44:17 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20061102114417-pnutjb20kqzl23ua
Tags: 4.10.0-3
http://bugs.debian.org/396565
debian/control: build-depends on libpq-dev. (Closes: #396565)

Show diffs side-by-side

added added

removed removed

Lines of Context:
mapscript/java/README
4
4
Before you begin, the JAVA_HOME environment variable must be properly set
5
5
and the Java programs "java" and "javac" must be on your path.
6
6
 
 
7
To generate the SWIG wrappers you need swig > 1.3.24.
 
8
 
 
9
+----------------------------------------------------------------------------+
 
10
| IMPORTANT API CHANGE: swig 1.3.24 introduced a new way of wrapping         |
 
11
| enumerations in Java which breaks compatibility with the mapscript         |
 
12
| generated by previous versions of swig.                                    |
 
13
| This will change again in the next major version of mapserver (version 5). |
 
14
+----------------------------------------------------------------------------+
 
15
 
 
16
MAPSCRIPT Reference
 
17
-------------------
 
18
 
 
19
The complete reference documentation is available on-line:
 
20
 
 
21
http://mapserver.gis.umn.edu/docs/reference/mapscript
 
22
 
 
23
or in the file:
 
24
 
 
25
../doc/mapscript.txt
 
26
 
7
27
SWIG wrappers
8
28
-------------
9
29
 
10
30
MapServer releases, beginning with 4.2.4, contain pre-generated wrapper code
11
 
(mapscript/java/mapscript_wrap.c) and class files (mapscript/java/edu).  You
12
 
may generate your own using the "interface" target in the Java Makefile.
 
31
(mapscript/java/mapscript_wrap.c) and class files (mapscript/java/edu).
 
32
Nevertheless it is recommended that you generate your own using the "interface"
 
33
target in the Java Makefile.
 
34
 
 
35
Requires swig > 1.3.24. Version 1.3.28 or 1.3.29 are recommended.
13
36
 
14
37
Installation
15
38
------------
16
39
 
17
40
After MapServer is configured and compiled, change directory to the Java
18
 
mapscript location and execute::
 
41
mapscript location and execute:
19
42
 
20
43
    $ cd mapscript/java
 
44
    $ make interface
21
45
    $ make
22
 
    $ make test
23
 
 
24
 
Copy the shared libmapscript and mapscript.jar to the appropriate location.
 
46
    $ make test (optional)
 
47
    $ make threadtests (optional)
 
48
 
 
49
The 'make interface' step is optional, but strongly recommended, see 'SWIG Wrappers'
 
50
above for the details.
 
51
 
 
52
Copy libmapscript.so and mapscript.jar to the appropriate location.
25
53
 
26
54
Windows
27
55
-------
35
63
nmake /f makefile.vc
36
64
nmake /f makefile.vc test
37
65
 
 
66
International language support
 
67
------------------------------
 
68
 
 
69
Since May 2006 Java mapscript has complete support for international languages
 
70
usage in queries and mapscript internals. To document this improvement
 
71
we have created the examples/QueryByAttributeUnicode.java
 
72
test program which uses the ISO-8859-15 encoding.
 
73
 
 
74
http://mapserver.gis.umn.edu/bugs/show_bug.cgi?id=1753
 
75
http://thread.gmane.org/gmane.comp.gis.mapserver.user/19298/focus=19298
 
76
http://thread.gmane.org/gmane.comp.gis.mapserver.user/19213/focus=19213
 
77
 
 
78
Onlice resources
 
79
----------------
 
80
 
 
81
Java mapscript related:
 
82
 
 
83
http://mapserver.gis.umn.edu/docs/howto/javamapscript
 
84
http://mapserver.gis.umn.edu/docs/howto/java_mapscript_Tomcat_55
 
85
http://mapserver.gis.umn.edu/docs/faq/thread_safety
 
86
 
 
87
General:
 
88
 
 
89
http://mapserver.gis.umn.edu/docs
 
90