Apache PDFBox | Apache PDFBox 1.8.13 released

A page in a pdf document is represented with a COSDictionary. The entries that are available for a page can be seen in the PDF Reference and an example of a page looks like this:

<<
     /Type /Page
     /MediaBox [0 0 612 915]
     /Contents 56 0 R
 >>
-
+

java
-COSDictionary page = ...;
-COSArray mediaBox = (COSArray)page.getDictionaryObject( "MediaBox" );
-System.out.println( "Width:" + mediaBox.get( 3 ) );
-

COSDictionary page = ...;
+COSArray mediaBox = (COSArray)page.getDictionaryObject( "MediaBox" );
+System.out.println( "Width:" + mediaBox.get( 3 ) );
+

As can be seen from that little example the COS model provides a low level API to access information within the PDF. In order to use the COS model successfully a good knowledge of @@ -279,11 +279,11 @@ available to access the attributes.

The same code from above to get the page width can be rewritten to use PD Model classes.

java
-PDPage page = ...;
-PDRectangle mediaBox = page.getMediaBox();
-System.out.println( "Width:" + mediaBox.getWidth() );
-

PDPage page = ...;
+PDRectangle mediaBox = page.getMediaBox();
+System.out.println( "Width:" + mediaBox.getWidth() );
+

PD Model objects sit on top of COS model. Typically, the classes in the PD Model will only store a COS object and all setter/getter methods will modify data that is stored in the http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/1f5ba131/content/1.8/faq.html ---------------------------------------------------------------------- diff --git a/content/1.8/faq.html b/content/1.8/faq.html index 84d642f..d332541 100644 --- a/content/1.8/faq.html +++ b/content/1.8/faq.html @@ -156,25 +156,25 @@

java
-log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).
-log4j:WARN Please initialize the log4j system properly.
-

log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).
+log4j:WARN Please initialize the log4j system properly.
+

This message means that you need to configure the log4j logging system. See the log4j documentation for more information.

PDFBox comes with a sample log4j configuration file. To use it you set a system property like this

java
-java -Dlog4j.configuration=log4j.xml org.apache.pdfbox.ExtractText <PDF-file> <output-text-file>
-

java -Dlog4j.configuration=log4j.xml org.apache.pdfbox.ExtractText <PDF-file> <output-text-file>
+

If this is not working for you then you may have to specify the log4j config file using a URL path, like this:

log4j.configuration=file:///<path to config file>
+

java
-PDDocument doc = new PDDocument();
-try
-{
-   doc = PDDocument.load( "my.pdf" );
-}
-finally
-{
-   if( doc != null )
-   {
-      doc.close();
-   }
-}
-

PDDocument doc = new PDDocument();
+try
+{
+   doc = PDDocument.load( "my.pdf" );
+}
+finally
+{
+   if( doc != null )
+   {
+      doc.close();
+   }
+}
+

Text Extraction

This small sample shows how to encrypt a file so that it can be viewed, but not printed..

PDDocument doc = PDDocument.load("filename.pdf");
 
-// Define the length of the encryption key.
-// Possible values are 40, 128 or 256.
-int keyLength = 256;
-
-AccessPermission ap = new AccessPermission();
-
-// disable printing, everything else is allowed
-ap.setCanPrint(false);
-
-// owner password (to open the file with all permissions) is “12345”
-// user password (to open the file but with restricted permissions, is empty here) 
-StandardProtectionPolicy spp = new StandardProtectionPolicy(“12345”, “”, ap);
-spp.setEncryptionKeyLength(keyLength);
-spp.setPermissions(ap);
-doc.protect(spp);
-
-doc.save(“filename-encrypted.pdf”);
-doc.close();
-```
+// Define the length of the encryption key.
+// Possible values are 40, 128 or 256.
+int keyLength = 256;
+    
+AccessPermission ap = new AccessPermission();
+        
+// disable printing, everything else is allowed
+ap.setCanPrint(false);
+        
+// owner password (to open the file with all permissions) is "12345"
+// user password (to open the file but with restricted permissions, is empty here) 
+StandardProtectionPolicy spp = new StandardProtectionPolicy("12345", "", ap);
+spp.setEncryptionKeyLength(keyLength);
+spp.setPermissions(ap);
+doc.protect(spp);
+        
+doc.save("filename-encrypted.pdf");
+doc.close();
+

I am getting the below Log4J warning message, how do I remove it?

java
-log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).
-log4j:WARN Please initialize the log4j system properly.
-

log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).
+log4j:WARN Please initialize the log4j system properly.
+

This message means that you need to configure the log4j logging system. See the log4j documentation for more information.

PDFBox comes with a sample log4j configuration file. To use it you set a system property like this

java
-java -Dlog4j.configuration=log4j.xml org.apache.pdfbox.ExtractText <PDF-file> <output-text-file>
-

java -Dlog4j.configuration=log4j.xml org.apache.pdfbox.ExtractText <PDF-file> <output-text-file>
+

If this is not working for you then you may have to specify the log4j config file using a URL path, like this:

log4j.configuration=file:///<path to config file>
+

java
-PDDocument doc = new PDDocument();
-try
-{
-   doc = PDDocument.load( "my.pdf" );
-}
-finally
-{
-   if( doc != null )
-   {
-      doc.close();
-   }
-}
-

PDDocument doc = new PDDocument();
+try
+{
+   doc = PDDocument.load( "my.pdf" );
+}
+finally
+{
+   if( doc != null )
+   {
+      doc.close();
+   }
+}
+

Font Handling

PDFBox 1.8.13

PDFBox 1.8.12

This is an incremental feature release based on the earlier `1.8.x` releases. - See the Release Notes for more details. + See the Release Notes for more details.

Verify

- It is essential that you verify the integrity of the downloaded files using the PGP signatures or + It is essential that you verify the integrity of the downloaded files using the PGP signatures or MD5 and SHA1 checksums. Please read Verifying Apache HTTP Server Releases for more information on why you should verify our releases.

- The PGP signatures can be verified using PGP or GPG. First download the - KEYS file as well as the .asc signature files for the + The PGP signatures can be verified using PGP or GPG. First download the + KEYS file as well as the .asc signature files for the relevant release packages. Make sure you get these - files from the main distribution directory, rather than + files from the main distribution directory, rather than from a mirror. Then verify the signatures using

Previous releases

- Previous Apache releases (starting with version `0.8.0-incubating`) are available in the release archive. - Older releases (up to version `0.7.3`) published from SourceForge are still available on + Previous Apache releases (starting with version `0.8.0-incubating`) are available in the release archive. + Older releases (up to version `0.7.3`) published from SourceForge are still available on SourceForge Files.

Latest development snapshot

Apache PDFBox 1.8.13 released (2016-12-09)

Apache PDFBox 2.0.3 released (2016-09-17)

The Apache PDFBox community is pleased to announce the release of -Apache PDFBox version 1.8.13.

Getting Help

News

Apache PDFBox 2.0.3 released (2016-09-17)

The Apache PDFBox community is pleased to announce the release of -Apache PDFBox version 2.0.3. It is available for download at:

Apache PDFBox 2.0.2 released (2016-06-09)

The Apache PDFBox community is pleased to announce the release of Apache PDFBox version 2.0.2. It is available for download at:

Apache PDFBox 1.8.11 released (2016-01-18)

The Apache PDFBox community is pleased to announce the release of +Apache PDFBox version 1.8.11.