Project

General

Profile

Download (5.42 KB) Statistics
| Branch: | Tag: | Revision:
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
(3-3/5)