Notes to implementers / package maintainers | ![]() |
Required libraries
for IronMailer as such:
- activation-"version".jar (from Sun, for mail api)
- mail-"version".jar (from Sun, for mail api)
- log4j-"version".jar (from Jakarta, for application logging)
- servlet.jar (from Sun, for servlet api)
for Cocoon as such:
- cocoon-"version".jar (from cocoon.war)
- xml-apis.jar (from Sun)
- avalon-framework-"version".jar (from cocoon.war)
- excalibur-pool-"version".jar (from cocoon.war, for components like "Recyclable")
- logkit-"version".jar (from cocoon.war, needed at run-time for logging)
- excalibur-logger-"version".jar (from cocoon.war, needed at run-time for logging)
- excalibur-component-"version".jar (from cocoon.war, needed at run-time)
- excalibur-instrument-"version".jar (from cocoon.war, needed at run-time)
- excalibur-collections-"version".jar (from cocoon.war, needed at run-time)
- excalibur-xmlutil-"version".jar (from cocoon.war, needed at run-time)
- excalibur-monitor-"version".jar (from cocoon.war, needed at run-time)
- resolver-"version".jar (from cocoon.war, needed at run-time for components like "CatalogResolver")
- commons-collections-"version".jar (from cocoon.war, needed at run-time for components like "ArrayStack")
- jakarta-regexp-"version".jar (from cocoon.war, needed at run-time by sitemap)
- xerces-"version".jar (from xml.apache.org, get latest 2.X version)
- excalibur-datasource-"version".jar (from cocoon.war, needed at run-time for XSP's)
for PDF formatting:
- fo-"version".jar (from cocoon.war or xml.apache.org/fop)
- batik-all-"version".jar
Note
Problems have occurred when including the j2ee-api.jar. This jar has a version of the Mail API which we don't want since we already have the mail,.jar. Another problem is that it won't find the default providers (such as, for Imap) if the mail api coming from the j2ee-api is found first.
Directory structure
The structure is an adaptation of the one suggested in the Ant documentation, regarding the "war" task: http://jakarta.apache.org/ant/manual/CoreTasks/war.html and the one proposed by the Tomcat project: http://jakarta.apache.org/tomcat/tomcat-3.3-doc/appdev/source.html
Cocoon notes
XSPs (and the sitemap) may be pre-compiled by Cocoon. For this, the files must have the extension .xsp !!