Test for pdfbox special characters : U+2002 ('enspace')

Author: fugerit79

CHANGELOG.md

@@ -9,5 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Test for pdfbox special characters : U+2002 ('enspace')
+- Module pdfbox 
 - AgeCheck with tests
 

code-samples-base/src/main/java/org/fugerit/java/code/samples/time/AgeCheck.java renamed to code-samples-base/src/main/java/org/fugerit/java/code/samples/pdfbox2/AgeCheck.java

@@ -1,4 +1,4 @@
-package org.fugerit.java.code.samples.time;
+package org.fugerit.java.code.samples.pdfbox2;
 
 import java.time.LocalDate;
 import java.time.temporal.ChronoUnit;

code-samples-base/src/test/java/test/org/fugerit/java/code/samples/time/TestAgeCheck.java renamed to code-samples-base/src/test/java/test/org/fugerit/java/code/samples/pdfbox2/TestAgeCheck.java

@@ -1,7 +1,7 @@
-package test.org.fugerit.java.code.samples.time;
+package test.org.fugerit.java.code.samples.pdfbox2;
 
 import lombok.extern.slf4j.Slf4j;
-import org.fugerit.java.code.samples.time.AgeCheck;
+import org.fugerit.java.code.samples.pdfbox2.AgeCheck;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 

code-samples-pdfbox2/src/main/java/org/fugerit/java/code/samples/pdfbox2/SpecialCharacters.java

@@ -0,0 +1,48 @@
+package org.fugerit.java.code.samples.pdfbox2;
+
+import org.apache.pdfbox.pdmodel.PDDocument;
+import org.apache.pdfbox.pdmodel.PDPage;
+import org.apache.pdfbox.pdmodel.PDPageContentStream;
+import org.apache.pdfbox.pdmodel.font.PDFont;
+import org.apache.pdfbox.pdmodel.font.PDType0Font;
+
+import java.io.*;
+
+/**
+ * Handling of special characters
+ *
+ * In this example we have : U+2002 ('enspace')
+ *
+ * See the Unit test for usage
+ */
+public class SpecialCharacters {
+
+    private void generatePDFWorker(OutputStream os, PDDocument document, PDFont font, String line) throws IOException {
+        PDPage currentPage = new PDPage();
+        PDPageContentStream cs = new PDPageContentStream( document, currentPage );
+        cs.setFont( font, 14 );
+        cs.setLeading(12);
+        cs.beginText();
+        cs.newLineAtOffset(25, 550);
+        cs.showText( line );
+        cs.endText();
+        cs.stroke();
+        cs.close();
+        document.addPage( currentPage );
+        document.save( os );
+    }
+
+    public void generatePDF(OutputStream os, InputStream fontIS, String line) throws IOException {
+        try (PDDocument document = new PDDocument()) {
+            PDType0Font font = PDType0Font.load( document, fontIS );
+            this.generatePDFWorker( os, document, font, line );
+        }
+    }
+
+    public void generatePDF(OutputStream os, PDFont font, String line) throws IOException {
+        try (PDDocument document = new PDDocument()) {
+           this.generatePDFWorker( os, document, font, line );
+        }
+    }
+
+}

code-samples-pdfbox2/src/main/java/org/fugerit/java/code/samples/time/AgeCheck.java

@@ -0,0 +1,55 @@
+package test.org.fugerit.java.code.samples.pdfbox2;
+
+import lombok.extern.slf4j.Slf4j;
+import org.apache.pdfbox.pdmodel.font.PDType1Font;
+import org.fugerit.java.code.samples.pdfbox2.SpecialCharacters;
+import org.fugerit.java.core.lang.helpers.ClassHelper;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+
+/*
+ * Proof of Concept to handle special characters like  U+2002 ('enspace')
+ *
+ * PdfBox bundled font, PDType1Font.HELVETICA will cause an exception :
+ * java.lang.IllegalArgumentException: U+2002 ('enspace') is not available in the font Helvetica, encoding: WinAnsiEncoding
+ * (see method testWithPdfBoxFontHelvetica)
+ *
+ * Whereas some externally loaded font with the PDType0Font API will not.
+ * (see method testWithExternalHelvetica)
+ *
+ */
+@Slf4j
+class TestSpecialCharacters {
+
+    private static final String TEST_LINE = "Row with special character :  .";      // test line with U+2002 ('enspace')
+
+    @Test
+    void testWithPdfBoxFontHelvetica() throws IOException {
+        try (FileOutputStream fos = new FileOutputStream( "target/test_font_from_pdfbox.pdf" )) {
+            SpecialCharacters sp = new SpecialCharacters();
+            Assertions.assertThrows( IllegalArgumentException.class, () -> {
+                sp.generatePDF( fos, PDType1Font.HELVETICA, TEST_LINE );
+            });
+        }
+
+    }
+
+    @Test
+    void testWithExternalHelvetica() throws IOException {
+        File pdfFile = new File( "target/test_font_external.pdf" );
+        log.info( "pdfFile: {}, delete: {}", pdfFile, pdfFile.delete() );
+        Assertions.assertFalse( pdfFile.exists() );
+        try ( InputStream fontIS = ClassHelper.loadFromClassLoader( "font/Helvetica.ttf" );
+                FileOutputStream fos = new FileOutputStream( pdfFile ) ) {
+            SpecialCharacters sp = new SpecialCharacters();
+            sp.generatePDF( fos, fontIS, TEST_LINE );
+        }
+        Assertions.assertTrue( pdfFile.exists() );
+    }
+
+}

code-samples-pdfbox2/src/test/java/test/org/fugerit/java/code/samples/pdfbox2/TestSpecialCharacters.java

@@ -11,7 +11,7 @@
 		<relativePath/>
 	</parent>
 
-	<name>Fugerit Code Samples</name>
+	<name>Fugerit Code Samples PDFBOX 2</name>
 	<description>My code samples.</description>
 	<version>1.0.0-SNAPSHOT</version>
 	<packaging>pom</packaging>