1
|
|
2
|
Information on Apache FOP dependencies
|
3
|
=========================================
|
4
|
|
5
|
$Id$
|
6
|
|
7
|
The Apache Licenses can also be found here:
|
8
|
http://www.apache.org/licenses/
|
9
|
|
10
|
|
11
|
Normal Dependencies
|
12
|
----------------------
|
13
|
|
14
|
- Apache Jakarta Commons IO
|
15
|
|
16
|
commons-io-*.jar
|
17
|
http://jakarta.apache.org/commons/io/
|
18
|
(I/O routines)
|
19
|
|
20
|
Apache License v2.0
|
21
|
|
22
|
- Apache Jakarta Commons Logging
|
23
|
|
24
|
commons-logging-*.jar
|
25
|
http://jakarta.apache.org/commons/logging/
|
26
|
(Logging adapter for various logging backends like JDK 1.4 logging or Log4J)
|
27
|
|
28
|
Apache License v2.0
|
29
|
|
30
|
- Apache Avalon Framework
|
31
|
|
32
|
avalon-framework-*.jar
|
33
|
http://excalibur.apache.org/framework/
|
34
|
(Avalon Framework, maintained by the Apache Excalibur project)
|
35
|
|
36
|
Apache License v2.0
|
37
|
|
38
|
- Apache XML Graphics Commons
|
39
|
|
40
|
xmlgraphics-commons-*.jar
|
41
|
http://xmlgraphics.apache.org/
|
42
|
(Common Library for Apache Batik and Apache FOP)
|
43
|
|
44
|
Apache License v2.0
|
45
|
|
46
|
- Apache Batik
|
47
|
|
48
|
batik-*.jar
|
49
|
http://xmlgraphics.apache.org/batik/
|
50
|
(SVG Implementation)
|
51
|
|
52
|
Apache License v2.0
|
53
|
|
54
|
- Apache XML Commons Externals (JAXP API)
|
55
|
|
56
|
xml-apis.jar
|
57
|
http://xml.apache.org/commons/components/external/
|
58
|
(the JAXP API, plus SAX and various W3C DOM Java bindings,
|
59
|
maintained in XML Commons Externals)
|
60
|
|
61
|
Apache License v2.0 (applies to the distribution)
|
62
|
SAX is in the public domain
|
63
|
http://www.saxproject.org/copying.html
|
64
|
W3C Software Notice and License (applies to the various DOM Java bindings)
|
65
|
W3C Document License (applies to the DOM documentation)
|
66
|
http://www.w3.org/Consortium/Legal/copyright-software
|
67
|
http://www.w3.org/Consortium/Legal/copyright-documents
|
68
|
http://www.w3.org/Consortium/Legal/
|
69
|
|
70
|
xml-apis-ext-*.jar
|
71
|
http://xml.apache.org/commons/components/external/
|
72
|
(additional DOM APIs from W3C, like SVG, SMIL and Simple API for CSS)
|
73
|
|
74
|
Apache License v2.0 (applies to the distribution)
|
75
|
W3C Software Notice and License (applies to the various DOM Java bindings)
|
76
|
W3C Document License (applies to the DOM documentation)
|
77
|
http://www.w3.org/Consortium/Legal/copyright-software
|
78
|
http://www.w3.org/Consortium/Legal/copyright-documents
|
79
|
http://www.w3.org/Consortium/Legal/
|
80
|
|
81
|
- Apache Xalan-J
|
82
|
|
83
|
xalan-*.jar and serializer-*.jar
|
84
|
http://xalan.apache.org
|
85
|
(JAXP-compliant XSLT and XPath implementation)
|
86
|
|
87
|
Apache License v2.0 (applies to Xalan-J)
|
88
|
Apache License v1.1 (applies to Apache BCEL and Apache REGEXP bundled in the JAR)
|
89
|
Historical Permission Notice and Disclaimer (applies to CUP Parser Generator)
|
90
|
http://www.opensource.org/licenses/historical.php
|
91
|
(see xalan.runtime.LICENSE.txt)
|
92
|
|
93
|
|
94
|
Special Dependencies
|
95
|
-----------------------
|
96
|
|
97
|
- Apache Xerces-J
|
98
|
|
99
|
xercesImpl-*.jar
|
100
|
http://xerces.apache.org
|
101
|
(JAXP-compliant XML parser and DOM Level 3 implementation)
|
102
|
|
103
|
Apache License v2.0
|
104
|
|
105
|
Xerces-J is not directly referenced by FOP or any of its dependencies.
|
106
|
|
107
|
|
108
|
A note on JAXP
|
109
|
-----------------------
|
110
|
|
111
|
Since Java 1.4, JAXP (Java API for XML Processing) is part of the
|
112
|
JRE/JDK. Every JVM includes the APIs and an implementation. However,
|
113
|
older JREs often contain implementations with bugs that are triggered
|
114
|
by code in Apache FOP and therefore need to be overridden. Now, since
|
115
|
JAXP is part of the class library, special precautions are necessary
|
116
|
to replace the original implementations. This is not done by simply
|
117
|
adding new JARs to the classpath as these classes would never be
|
118
|
loaded (due to Java's class loader hierarchy).
|
119
|
|
120
|
Replacing the default implementations involves understanding the
|
121
|
"Endorsed Standards Override Mechanism".
|
122
|
More information can be found here:
|
123
|
http://java.sun.com/j2se/1.4.2/docs/guide/standards/index.html
|
124
|
|
125
|
See also:
|
126
|
http://xml.apache.org/xalan-j/faq.html#faq-N100EF
|
127
|
|
128
|
Essentially, you have two different possibilities:
|
129
|
- add the replacement JARs in the jre/lib/endorsed directory of your JRE.
|
130
|
- Use the -Xbootclasspath/p: option when starting the JVM (may not be
|
131
|
available for every JVM).
|
132
|
|
133
|
|
134
|
Optional Dependencies
|
135
|
------------------------
|
136
|
|
137
|
The following libraries are not bundled with FOP and must be installed manually.
|
138
|
Please make sure you've read the license of each package.
|
139
|
|
140
|
- JAI Image I/O Tools
|
141
|
|
142
|
https://jai-imageio.dev.java.net/
|
143
|
BSD license
|
144
|
|
145
|
Note: This is not the same as JAI! Only the ImageIO-compatible codecs
|
146
|
are packaged as "Image I/O Tools". The name may be misleading.
|
147
|
|
148
|
- JAI (Java Advanced Imaging API)
|
149
|
|
150
|
http://java.sun.com/products/java-media/jai
|
151
|
Java Research License and Java Distribution License (Check which one applies to you!)
|
152
|
|
153
|
Currently used for:
|
154
|
- Grayscale error diffusion dithering in the PCL Renderer
|
155
|
|
156
|
- JEuclid (MathML implementation, for the MathML extension)
|
157
|
|
158
|
http://jeuclid.sourceforge.net/
|
159
|
http://sourceforge.net/projects/jeuclid
|
160
|
Apache License v1.1
|
161
|
|
162
|
|
163
|
|
164
|
Additional development-time dependencies
|
165
|
-------------------------------------------
|
166
|
|
167
|
- Servlet API
|
168
|
|
169
|
servlet-*.jar
|
170
|
http://jakarta.apache.org/tomcat/
|
171
|
(Servlet API, javax.servlet)
|
172
|
|
173
|
Apache License v1.1
|
174
|
|
175
|
- Apache Ant
|
176
|
|
177
|
(not bundled, requires pre-installation)
|
178
|
http://ant.apache.org
|
179
|
(XML-based build system
|
180
|
|
181
|
Apache License V2.0
|
182
|
|
183
|
- JUnit
|
184
|
|
185
|
(not bundled, provided by Apache Ant or your IDE)
|
186
|
http://www.junit.org
|
187
|
Common Public License V1.0
|
188
|
|
189
|
- XMLUnit (optional)
|
190
|
|
191
|
(not bundled, to be added to your Apache Ant installation)
|
192
|
http://xmlunit.sourceforge.net/
|
193
|
BSD style license
|