1 |
============================================================== |
2 |
=== SCHMITZM README (2011-01-27, Martin Schmitz) === |
3 |
=== === |
4 |
=== http://wald.intevation.org/projects/xulu/ === |
5 |
=== http://wald.intevation.org/projects/schmitzm/ === |
6 |
============================================================== |
7 |
|
8 |
This file contains some informations about... |
9 |
|
10 |
(1) the structure of the SCHMITZM library |
11 |
(2) the dependencies of the SCHMITZM library |
12 |
(3) localization in SCHMITZM |
13 |
|
14 |
----------------------------------------------------------- |
15 |
(1) Structure of the SCHMITZM library |
16 |
----------------------------------------------------------- |
17 |
Since version 2.5-SNAPSHOT the SCHMITZM library is divided |
18 |
into 4 modules: |
19 |
|
20 |
* schmitzm-core |
21 |
Contains core functionalities with only dependencies to |
22 |
JDK and (small) core libraries (e.g. MigLayout, Log4J, |
23 |
JDom, ...). |
24 |
|
25 |
* schmitzm-gt |
26 |
Contains extensions for Geotools with depencency to |
27 |
schmitzm-core and Geotools. |
28 |
|
29 |
* schmitzm-jfree |
30 |
COntains extensions for core JFreeChart with depencency |
31 |
to schmitzm-core and JFreeChart. |
32 |
|
33 |
* schmitzm-jfree-gt |
34 |
Contains geo-extensions for JFreeChart (create chart from |
35 |
shapefile) so there are depencencies to schmitzm-core, |
36 |
schmitzm-jfree and schmitzm-gt. |
37 |
|
38 |
|
39 |
----------------------------------------------------------- |
40 |
(2) Dependencies to other libraries |
41 |
----------------------------------------------------------- |
42 |
Because SCHMITZM is not an executable application, but an |
43 |
library for experienced programmers, I renounced to put all |
44 |
necessary libraries to the project. |
45 |
Since SCHMITZM is compatible with MAVEN from version 2.1 upward, |
46 |
this should no longer a big problem. |
47 |
For these users who do not want to use MAVEN, here is an |
48 |
overview. I expect that the SCHMITZM developer/builder is able |
49 |
to include these dependencies to its individual Java (Eclipse) |
50 |
project: |
51 |
|
52 |
* schmitzm-core |
53 |
- JRE/JDK 1.6 (http://www.oracle.com/technetwork/java) |
54 |
- JAI plus ImageIO (if not already included in your JRE/JDK) |
55 |
- JavaX-Mail (http://www.oracle.com/technetwork/java/javamail/index.html) |
56 |
- JNLP (http://www.oracle.com/technetwork/java/javase/javawebstart/index.html) |
57 |
- JINI (jini-ext-2.1.jar) |
58 |
- Apache Log4j (http://logging.apache.org/log4j/) |
59 |
- Apache Commons CLI (http://commons.apache.org/cli/) |
60 |
- Apache Commons IO (http://commons.apache.org/io/) |
61 |
- JDom (http://www.jdom.org/) |
62 |
- MigLayout (http://www.miglayout.com/) |
63 |
|
64 |
* schmitzm-gt |
65 |
- schmitzm-core |
66 |
- Geotools 2.6.5 (http://www.geotools.org) |
67 |
- Colt (http://acs.lbl.gov/~hoschek/colt/) |
68 |
Note: Because gt2-2.6.5 already includes jai_codec-1.1.3.jar and |
69 |
jai_imageio-1.1.jar it is recommended only to include from |
70 |
JAI: |
71 |
- clipwrapper_jiio.jar |
72 |
- jai_core.jar |
73 |
- mlibwrapper_jai.jar |
74 |
|
75 |
* schmitzm-jfree |
76 |
- schmitzm-core |
77 |
- jFreeChart (http://www.jfree.org/jfreechart/) |
78 |
|
79 |
* schmitzm-jfree-gt |
80 |
- schmitzm-core |
81 |
- schmitzm-jfree |
82 |
- schmitzm-gt |
83 |
|
84 |
----------------------------------------------------------- |
85 |
(3) Localization in SCHMITZM library |
86 |
----------------------------------------------------------- |
87 |
Localization is done by the SCHMITZM class ResourceProvider, which is |
88 |
an extension to standard Java ResourceBundle. |
89 |
For example ResourceProvider.getString(..) allowes to specify |
90 |
additional parameters to fill wildcards ${0}, ${1}, ${2}, ... in the |
91 |
localization strings (see ResourceProvider class for more details). |
92 |
|
93 |
The SCHMITZM library contains resource bundles in the following |
94 |
packages, each located in sub-folders <package>/resource/locales (below |
95 |
src/main/resources of each module): |
96 |
|
97 |
- de.schmitzm.data -> DataResourceBundle |
98 |
- de.schmitzm.lang -> LangResourceBundle |
99 |
- de.schmitzm.swing -> SwingResourceBundle |
100 |
- de.schmitzm.geotools.feature -> FeatureResourceBundle |
101 |
- de.schmitzm.geotools.gui -> GTResourceBundle |
102 |
- de.schmitzm.jfree -> JFreeResourceBundle |
103 |
|
104 |
If you want SCHMITZM to provide an additional language, you have to |
105 |
translate all of these ResourceBundles. |
106 |
|
107 |
|
108 |
=========================================================== |
109 |
http://wald.intevation.org/projects/xulu/ |
110 |
http://wald.intevation.org/projects/schmitzm/ |
111 |
=========================================================== |