Project

General

Profile

Download (5.26 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
    Apache License v2.0 (applies to the distribution)
71
    W3C Software Notice and License (applies to the various DOM Java bindings)
72
    W3C Document License (applies to the DOM documentation)
73
        http://www.w3.org/Consortium/Legal/copyright-software
74
        http://www.w3.org/Consortium/Legal/copyright-documents
75
        http://www.w3.org/Consortium/Legal/
76

    
77
- Apache Xalan-J
78

    
79
    xalan-*.jar and serializer-*.jar
80
    http://xalan.apache.org
81
    (JAXP-compliant XSLT and XPath implementation)
82
    
83
    Apache License v2.0 (applies to Xalan-J)
84
    Apache License v1.1 (applies to Apache BCEL and Apache REGEXP bundled in the JAR)
85
    Historical Permission Notice and Disclaimer (applies to CUP Parser Generator)
86
        http://www.opensource.org/licenses/historical.php
87
        (see xalan.runtime.LICENSE.txt)
88

    
89

    
90
Special Dependencies
91
-----------------------
92

    
93
- Apache Xerces-J
94

    
95
    xercesImpl-*.jar
96
    http://xerces.apache.org
97
    (JAXP-compliant XML parser and DOM Level 3 implementation)
98
    
99
    Apache License v2.0
100
    
101
    Xerces-J is not directly referenced by FOP or any of its dependencies.
102
    
103

    
104
A note on JAXP
105
-----------------------
106

    
107
Since Java 1.4, JAXP (Java API for XML Processing) is part of the 
108
JRE/JDK. Every JVM includes the APIs and an implementation. However, 
109
older JREs often contain implementations with bugs that are triggered 
110
by code in Apache FOP and therefore need to be overridden. Now, since 
111
JAXP is part of the class library, special precautions are necessary 
112
to replace the original implementations. This is not done by simply 
113
adding new JARs to the classpath as these classes would never be 
114
loaded (due to Java's class loader hierarchy). 
115

    
116
Replacing the default implementations involves understanding the 
117
"Endorsed Standards Override Mechanism".
118
More information can be found here:
119
http://java.sun.com/j2se/1.4.2/docs/guide/standards/index.html
120

    
121
See also:
122
http://xml.apache.org/xalan-j/faq.html#faq-N100EF
123

    
124
Essentially, you have two different possibilities:
125
- add the replacement JARs in the jre/lib/endorsed directory of your JRE.
126
- Use the -Xbootclasspath/p: option when starting the JVM (may not be
127
  available for every JVM).
128

    
129

    
130
Optional Dependencies
131
------------------------
132

    
133
The following libraries are not bundled with FOP and must be installed manually.
134
Please make sure you've read the license of each package.
135

    
136
- JAI Image I/O Tools
137

    
138
    https://jai-imageio.dev.java.net/
139
    BSD license
140
    
141
    Note: This is not the same as JAI! Only the ImageIO-compatible codecs
142
    are packaged as "Image I/O Tools". The name may be misleading.
143

    
144
 - JAI (Java Advanced Imaging API) 
145

    
146
    http://java.sun.com/products/java-media/jai 	 
147
    Java Research License and Java Distribution License (Check which one applies to you!)
148
    
149
    Currently used for:
150
    - Grayscale error diffusion dithering in the PCL Renderer
151

    
152
- JEuclid (MathML implementation, for the MathML extension)
153

    
154
    http://jeuclid.sourceforge.net/
155
    http://sourceforge.net/projects/jeuclid
156
    Apache License v1.1
157

    
158

    
159

    
160
Additional development-time dependencies
161
-------------------------------------------
162

    
163
- Servlet API
164

    
165
    servlet-*.jar
166
    http://jakarta.apache.org/tomcat/
167
    (Servlet API, javax.servlet)
168
    
169
    Apache License v1.1
170

    
171
- Apache Ant
172

    
173
    (not bundled, requires pre-installation)
174
    http://ant.apache.org
175
    (XML-based build system
176
    
177
    Apache License V2.0
178

    
179
- JUnit
180

    
181
    (not bundled, provided by Apache Ant or your IDE)
182
    http://www.junit.org
183
    Common Public License V1.0
184

    
185
- XMLUnit (optional)
186

    
187
    (not bundled, to be added to your Apache Ant installation)
188
    http://xmlunit.sourceforge.net/
189
    BSD style license
(3-3/5)