{"id":414,"date":"2015-12-01T11:08:53","date_gmt":"2015-12-01T19:08:53","guid":{"rendered":"https:\/\/www.pnfsoftware.com\/blog\/?p=414"},"modified":"2017-09-13T00:51:25","modified_gmt":"2017-09-13T08:51:25","slug":"scanning-pdf-files-using-jeb2","status":"publish","type":"post","link":"https:\/\/www.pnfsoftware.com\/blog\/scanning-pdf-files-using-jeb2\/","title":{"rendered":"Scanning PDF Files using JEB2"},"content":{"rendered":"

Update (9\/13\/2017): we open-sourced the PDF plugin<\/a>. A compiled JAR binary is also available<\/a>.<\/em><\/strong><\/p>\n

Update: Feb. 27: Slides – Automation How-To<\/a>
\nUpdate: Dec. 3: List of notifications<\/a><\/em><\/p>\n

In this blog post, we show how JEB2 can be used as a building block of a file analysis system. We will show how to use the Core API<\/a> to create a headless client<\/strong>. That client will scan PDF files<\/strong> using the JEB2 PDF Analysis Module<\/a>. Basics of the IUnit<\/a> and co. interfaces is also demonstrated.<\/p>\n

Source code on GitHub.<\/a><\/strong><\/p>\n

\"\"<\/a>
Sample execution output produced by the PDF Scanner<\/figcaption><\/figure>\n

As this slide deck<\/a> shows, the back-end and front-end components of JEB2 are separated. The official RCP desktop client uses the JEB2 Core API; other front-ends, like the PDF scanner, can be built using that same API.<\/p>\n

\"\"<\/a>
JEB2 HL Architecture Diagram<\/figcaption><\/figure>\n

Creating an Eclipse project<\/h1>\n

Let’s get started by creating a new code project. We will show how to do this in Eclipse.<\/p>\n

0- Check your license of JEB2.<\/strong> Make sure to use a license that supports third-party client creation and the loading of third-party plugin. If you haven’t done so, download and drop the PDF module<\/a> in your coreplugins\/<\/strong>\u00a0sub-directory.<\/p>\n

1- Clone our sample code repository:\u00a0<\/strong>git clone\u00a0https:\/\/github.com\/pnfsoftware\/jeb2-samplecode.git<\/span><\/p>\n

2- Create a new Java project.<\/strong>\u00a0The Java source folder should be rooted in the src\/ directory.<\/p>\n

3- Add the JEB2 back-end as a JAR dependency.<\/strong> The back-end software is contained\u00a0in the file bin\/cl\/jeb.jar<\/em> located within your installation folder. You may also want to link that JAR to the API documentation, contained in the doc\/apidoc.jar<\/em> file, or online at https:\/\/www.pnfsoftware.com\/jeb\/apidoc<\/em><\/p>\n

Your Package Explorer view should now look like:<\/p>\n

\"\"<\/a>
Package explorer view after setting up dependencies<\/figcaption><\/figure>\n

5- Set up the execution options.<\/strong> The required Java properties for execution (jeb.engcfg<\/em> and jeb.lickey<\/em>) can be set in the Run Configurations panel (accessible via the Run menu). Example:<\/p>\n

\"\"<\/a>
Example of a Run configuration<\/figcaption><\/figure>\n

6-\u00a0Open the com.pnf.pdfscan.PDFScanner\u00a0source file.<\/strong> You are ready to execute main().<\/p>\n

How the scanner works<\/h1>\n

Now, let’s focus on the scanner source code<\/a>.<\/p>\n