[PDFBOX-1027] Modifications to permit use of PDFBOX on Google App Engine

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Won't Fix
• Affects Version/s: 1.4.0, 1.5.0
• Environment: Google App Engine
• Assignee: Unassigned
• Reporter: Ken Bowen
• Created: 02/Jun/11 15:15
• Updated: 06/Nov/14 06:26
• Resolved: 06/Nov/14 06:26

Description

This patch to PDFBox 1.4.0 accomplishes the following three items, all of which are necessary to enable the use of PDFBox on Google App Engine (GAE):

1) Moves the AWT dependency on TRANSPARENT_WHITE from class-load time to function/object-use time; previously, any attempt to load PDFBox on GAE would raise an error concerning this constant.

2) Moves the AWT colors dependency of PDJpeg from class-load time to function/object-use time; this allows, for example, execution of org.apache.pdfbox.examples.pdmodel.RubberStampWithImage on GAE with a b/w stamp image.

3) Provides a global System Property
"org.apache.pdfbox.useScratchMemory"
for controlling whether COSDocument (and hence PDDocument) make use of a scratch random access file file or a scratch random access memory buffer. This allows creation of PDF documents from streams on GAE.

Note that the patch does not introduce any GAE dependencies, potentially allowing PDFBox to also be used on other ATW-poor environments. Also, it's important to note that the greater part of the work on this patch is due to my colleague Chuck Houpt.

Issue Links

• is part of: PDFBOX-1962 Refactor the packages in the core pdfbox module