【2019年11月版】Quarkus で PDFBox もネイティブ化に挑戦！→日本語はアカン！

# Quarkus の REST API で日本語入りの PDF ファイル出力に挑戦。

Java のシステムで往々にしてあるのが **PDF出力** でありまして、業務システムで出力する PDF は当然、日本語が入ってくるわけでございます。
そして、なんで今更、しかも Quarkus でチャンレンジしようとしたかと申しますと・・・
こちら、Quarkus の本家リポジトリでプラグインの一覧でございます。

- [quarkusio/quarkus/extensions | github.com](https://github.com/quarkusio/quarkus/tree/master/extensions)

ある日、"Quarkusのプラグインって何が使えるのかしら〜？" と一覧を眺めていると・・・

...
spring-web
swagger-ui
**tika**
undertow-websockets
...

ん？！待って・・・tika？

あの、`tika` だよね？オフィス文書とかPDFから文字列抽出するライブラリ、[Apache Tika](https://tika.apache.org/)、だよね？！
そう、Tika の中には様々な形式のファイルができるようにそれに対応したライブラリが含まれているわけです。Tika はテキスト抽出がメインのライブラリなので、Tikaのインタフェースではテキストの読み込みしかできませんが、同梱のライブラリを直接、使用すればオフィス文書の読み書きだってできるのです！

そしてここに tika プラグインがあるということは・・・Tika とそれに付随するライブラリが **Native化、可能**だってことなわけですよね！？

当然、PDFからのテキスト抽出に使われている PDFBox だって使えるはず！ってわけです。これはもう、試してみるしかないでしょう！！
ついでに、日本語フォントも同梱してみて、Quarkusでちゃんと出力できるか、確認してみたいと思います！

## 1. プロジェクトの作成

以下のコマンドでプロジェクトを作成いたします。例によって、REST APIのサンプルは生成しておいてください〜

```
$ mvn io.quarkus:quarkus-maven-plugin:1.0.0.CR1:create
...
$ cd my-quarkus-project
```
(あれ、いつの間にか Quarkus のバージョンが上がってますね・・・)

続いてpom.xml にプラグインを追加します。
[前回の記事(【2019年11月版】Quarkus で Hibernate-Panache の REST API 作ってネイティブ化し Jaeger でトレース)](https://qiita.com/koinori/items/244f0ecb8fd7ecd4f34f)の構成に tikaプラグインを追加したものです。Hibernate経由でPostgreSQLに保存したデータもPDFに書き込んでみようという前衛的な構成です。

```xml:pom.xml
...
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-smallrye-opentracing</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-jdbc-postgresql</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-smallrye-metrics</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-smallrye-openapi</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-hibernate-orm-panache</artifactId>
    </dependency>
    <dependency>
      <groupId>com.fasterxml.jackson.datatype</groupId>
      <artifactId>jackson-datatype-jsr310</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-tika</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-resteasy-jsonb</artifactId>
    </dependency>
    <dependency>
      <groupId>io.opentracing.contrib</groupId>
      <artifactId>opentracing-jdbc</artifactId>
    </dependency>
...
```
もちろん Opentracing 対応です！ PDF の吐き出しにどの時間がかかるかチェックするためです。

## 2. モデルクラスとREST APIの作成

ここは前回の記事と同じ手順ですので実装コードだけご紹介します。(といっても大したことないんですが・・・)

まず、Hibernateの接続設定から。

```properties:src/main/resources/application.properties
quarkus.datasource.url = jdbc:tracing:postgresql://db:5432/mydatabase
quarkus.datasource.driver=io.opentracing.contrib.jdbc.TracingDriver
quarkus.hibernate-orm.dialect=org.hibernate.dialect.PostgreSQLDialect
quarkus.datasource.username = postgres
quarkus.datasource.password = postgres
# drop and create the database at startup (use `update` to only update the schema)
quarkus.hibernate-orm.database.generation = drop-and-create
```
接続先が docker-compose.yml で指定するサービス名 `db` になってますのでご注意！
`mvn quarkus:dev` で開発サーバー起動する場合には接続エラーになるので、その際には `docker.for.mac.host.internal` などdockerホストを参照してください。

続いてモデルクラス。

```java:src/main/java/org/acme/quarkus/sample/model/Person.java
import javax.persistence.Entity;
import java.time.LocalDate;

import io.quarkus.hibernate.orm.panache.PanacheEntity;

import com.fasterxml.jackson.annotation.JsonFormat;

@Entity
public class Person extends PanacheEntity {
  public enum Status {
    Alive, DECEASED
  }

  public String name;
  @JsonFormat(pattern = "yyyy-MM-dd")
  public LocalDate birth;
  public Status status;
}
```
お次は REST APIです。

```java:src/main/java/org/acme/quarkus/sample/PersonResource.java
package org.acme.quarkus.sample;

import javax.transaction.Transactional;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

import org.eclipse.microprofile.metrics.MetricUnits;
import org.eclipse.microprofile.metrics.annotation.Timed;
import org.eclipse.microprofile.metrics.annotation.Counted;

import org.acme.quarkus.sample.model.Person;

@Path("/person")
@Produces(MediaType.APPLICATION_JSON)
public class PersonResource {

    @POST
    @Transactional
    @Produces(MediaType.APPLICATION_JSON)
    @Counted(name = "performed_create", description = "How many it have been called.")
    @Timed(name = "checksTimer_create", description = "A measure of how long it takes to perform creating person.", unit = MetricUnits.MILLISECONDS)
    public Person create(Person person) {
        person.persist();
        return person;
    }

    @GET
    @Path("/{id}")
    @Transactional
    @Counted(name = "performed_get", description = "How many it have been called.")
    @Timed(name = "checksTimer_get", description = "A measure of how long it takes to perform getting person.", unit = MetricUnits.MILLISECONDS)
    public Person get(@PathParam("id") Long id) {
        return Person.findById(id);
    }

    @GET
    @Path("/{id}")
    @Transactional
    @Produces(MediaType.TEXT_HTML)
    @Counted(name = "performed_html", description = "How many it have been called.")
    @Timed(name = "checksTimer_html", description = "A measure of how long it takes to perform getting person.", unit = MetricUnits.MILLISECONDS)
    public Person getHTML(@PathParam("id") Long id) {
        return Person.findById(id);
    }

    @GET
    @Path("/{id}/pdf")
    @Produces("application/pdf")
    @Transactional
    @Counted(name = "performed_pdf", description = "How many it have been called.")
    @Timed(name = "checksTimer_pdf", description = "A measure of how long it takes to perform getting person.", unit = MetricUnits.MILLISECONDS)
    public Person getByPDF(@PathParam("id") Long id) {
        return Person.findById(id);
    }
}
```
今回は前回のメソッドに**PDF出力用**と、さらに**HTML出力用**のエンドポイントをお二つご用意いたしました！
**PDF出力用**が`getByPDF`、**HTML出力用**が`getHTML` となっております。(命名が適当すぎてごめんなさい。。。)
が・・・実装というかシグネチャをよくみていただくとお分かりの通りで、メソッド名以外に何が違うの？というところでありますよね？
`public Person get(@PathParam("id") Long id)`と`public Person getHTML(@PathParam("id") Long id)`と`public Person getByPDF(@PathParam("id") Long id)`、メソッド名以外は引数も戻り値も同じなんです。

何が違うのか・・・

**@Producesで示された、"返却されるコンテンツのタイプ"が違う**んです！

で、`@Produces(MediaType.APPLICATION_JSON)` については前回の記事でもできた通り`quarkus-resteasy-jsonb`プラグインのパワーで `Person` Bean をほぼ自動で JSON にすることはできました。

それ以外のメディアタイプについては？ ・・・以下の手順になります！

## 3. カスタムの MessageBodyWriter の実装。

カスタムのメディアタイプに対応するための仕組みが MessageBodyWriterインタフェースの実装となります。
まず、サンプルの実装を元にMessageBodyWriterの実装手順を解説します。

### 3-1. サンプルのHTML用MessageBodyWriterの実装

例えば `Person`BeanからHTMLを出力するカスタムのMessageBodyWriterは以下のような実装となります。

```java:src/main/java/org/acme/quarkus/sample/writer/HTMLWriter.java
package org.acme.quarkus.sample.writer;

import java.io.IOException;
import java.io.OutputStream;
import java.io.PrintWriter;
import java.io.Writer;
import java.lang.annotation.Annotation;
import java.lang.reflect.Type;

import javax.ws.rs.Produces;
import javax.ws.rs.WebApplicationException;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.MultivaluedMap;
import javax.ws.rs.ext.MessageBodyWriter;
import javax.ws.rs.ext.Provider;

import org.acme.quarkus.sample.model.Person;

@Provider
@Produces(MediaType.TEXT_HTML)
public class HTMLWriter implements MessageBodyWriter<Person> {

    @Override
    public boolean isWriteable(Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType) {
        return true;
    }

    @Override
    public void writeTo(Person t, Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType,
            MultivaluedMap<String, Object> httpHeaders, OutputStream entityStream)
            throws IOException, WebApplicationException {
                Writer writer = new PrintWriter(entityStream);
                writer.write("<html>");
                writer.write("<body>");
                writer.write("<h2>JAX-RS Message Body Writer Example</h2>");
                writer.write("<p>Id: " + t.id + "</p>");
                writer.write("<p>Name: " + t.name + "</p>");
                writer.write("</body>");
                writer.write("</html>");
        
                writer.flush();
                writer.close();
            }

}
```
ポイントとしては、

1. MessageBodyWriter<Person> で受け取るBeanの型を指定した MessageBodyWriter をimplementsする。
2. @Produces でこのMessageBodyWriterが出力するメディアタイプを宣言する。
3. @Provider でこのクラスをDIコンテナに対して**DIしてね**と宣言する。
4. `isWriteable`、`writeTo` の実装

となります。
`isWriteable` は引数のオブジェクトに対してこのMessageBodyWriterが対応可能かどうかを判断するメソッドです。PersonからHTMLを出力するだけなので適当にtrueを返しておきます。クラスに対して `@Produces` は複数の設定が可能なので、想定される型の範囲かどうかをチェックするのが本来の役目なんじゃないでしょうか。

続いて、`writeTo`メソッドが実際のコンテンツの作成処理です。ここでは HTMLタグを直打ちしてますが、このようにダウンロードさせたいデータを生成するのがこのメソッドの役割です。

### 3-2. PDF出力の準備・・・日本語フォント

それでは本丸のPDF用MessageBodyWriterです・・・の前に、今回の目的その２の**日本語対応**です。

PDFBoxが標準で対応している(Enumで宣言している)フォントの中に日本語のフォントは含まれていません。よって日本語フォントは自前でダウンロードしておく必要があります。

ついでにそのフォントファイルを開いてフォントを指定してPDFを出力する・・・のはちょっとテクニック？が必要なので以下のサイトをご紹介しておきます。

- [Apache PDFBox 文字列出力 | Hishidama's Apache PDFBox text Memo](http://www.ne.jp/asahi/hishidama/home/tech/java/pdf/pdfbox/text.html#h_font)

いつも大変お世話になっております、**ひしだまさんとこのサイト**です。

またここからリンクされている IPA フォントのページもリンクを貼っておきます。

- [IPA Font ダウンロード](http://ipafont.ipa.go.jp/old/ipafont/download.html)

今回は上記サイトからゴシックフォント用のTTCファイル(のZIP)をダウンロードして `main/resource` 以下に解凍しておきました。
フォントの実際のパスは`src/main/resources/IPAGTTC00303/ipag.ttc`となります。
プログラムから参照する場合は、`IPAGTTC00303/ipag.ttc`ですね。

フォントファイルの準備ができたところで、PDF出力処理は以下のようにいたしました。

### 3-3. PDF用MessageBodyWriterの実装

以下のようになります。

```java:src/main/java/org/acme/quarkus/sample/writer/PDFWriter.java
package org.acme.quarkus.sample.writer;

import java.io.IOException;
import java.io.OutputStream;
import java.lang.annotation.Annotation;
import java.lang.reflect.Type;

import javax.json.bind.JsonbBuilder;
import javax.ws.rs.Produces;
import javax.ws.rs.WebApplicationException;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.MultivaluedMap;
import javax.ws.rs.ext.MessageBodyWriter;
import javax.ws.rs.ext.Provider;

import org.acme.quarkus.sample.model.Person;
import org.apache.fontbox.ttf.TrueTypeCollection;
import org.apache.fontbox.ttf.TrueTypeFont;
import org.apache.fontbox.ttf.TrueTypeCollection.TrueTypeFontProcessor;
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.common.PDRectangle;
import org.apache.pdfbox.pdmodel.font.PDFont;
import org.apache.pdfbox.pdmodel.font.PDType0Font;

@Provider
@Produces("application/pdf")
public class PDFWriter implements MessageBodyWriter<Person> {

    @Override
    public boolean isWriteable(Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType) {
        return true;
    }

    @Override
    public void writeTo(Person t, Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType,
            MultivaluedMap<String, Object> httpHeaders, OutputStream entityStream)
            throws IOException, WebApplicationException {

            try(TrueTypeCollection ttc = new TrueTypeCollection(PDFWriter.class.getClassLoader().getResourceAsStream("IPAGTTC00303/ipag.ttc"))){
//                ttc.processAllFonts(ttf ->  System.out.println(ttf.getName()));

                try (PDDocument document = new PDDocument()) {
                    PDPage page = new PDPage(PDRectangle.A4);
                    document.addPage(page);
                    // PDFont font = PDType1Font.HELVETICA;
                    PDFont font = PDType0Font.load(document, ttc.getFontByName("IPAGothic"), false);
                    PDFont font_p = PDType0Font.load(document, ttc.getFontByName("IPAPGothic"), false);
                    try (PDPageContentStream cs = new PDPageContentStream(document, page)) {
                        cs.beginText();
                        cs.setFont(font_p, 12);
                        cs.newLineAtOffset(30, 600);
                        cs.showText("JSON:" + JsonbBuilder.create().toJson(t));
                        cs.newLineAtOffset(0, -100);
                        cs.showText("僕はなんだか日本語を出力してみたい気持ちに駆られたのであった。ダメね。あなたはいつもこんな調子で。");
                        cs.setFont(font, 12);
                        cs.newLineAtOffset(0, -100);
                        cs.showText("僕はなんだか日本語を出力してみたい気持ちに駆られたのであった。ダメね。あなたはいつもこんな調子で。");
                        cs.endText();
                    }
                    document.save(entityStream);
                }
               
            }
        }

}
```
ちなみに java で日本語フォントを扱う上で一番厄介なのが`getFontByName`で指定する**フォント名**ですね。これ、最初からわかるサイトとかツールとかないんでしょうか？
javaのプログラムで以下のように・・・

```java
    ttc.processAllFonts(ttf -> System.out.println(ttf.getName()));
```
とかやって中身を取り出してみないとフォントファイルに格納されている正しいフォント名の綴りがわからないんですけど？？

PDFの座標系は左下が原点(0,0)隣、上方向、右方向がプラスとなります。つまり、上からプロットすると一旦、一番上まであげて、マイナスYで下に下がっていくようなプログラムを書くことになります。
特に今回、使用した`PDPageContentStream#newLineAtOffset` は前回指定した開始位置からの相対座標となるので、(0,-100)のようにダイレクトにマイナスの値を入れていくことになります。

あとは PSF に好きに文字なり線なりを書き込んで、`entityStream`に書き込めば出来上がりです！

実際の`ダウンロードの処理=Mime type: multipart `の処置はよろしくやってくれます。これだけでもめちゃくちゃ便利ですね。。。

## 4. DB、Jaegerの用意など

ここは前回と同じですので割愛させていただきます。

## 5. ネイティブ化

今回のネイティブ化に当たって一番苦労したのが、外部リソースというかフォントファイルの取り込みです。。。
以下で手順をご紹介いたします。

### 5-1. リソースファイルの取り込み

ネイティブ化に当たって、外部リソースの含め方についてはこちらに解説があります。

- [Including resources | QUARKUS - TIPS FOR WRITING NATIVE APPLICATIONS](https://quarkus.io/guides/writing-native-applications-tips#including-resources)

`resource/META-INF`以下は Web用のリソースなので自動で取り込まれますよ〜ということと、それ以外のパスは自分でやってね！ということなので、頑張ります！

パターンについてはgithubサイトの解説の方により詳しく載っています。
- [https://github.com/oracle/graal/blob/vm-19.0.2/substratevm/RESOURCES.md](https://github.com/oracle/graal/blob/vm-19.0.2/substratevm/RESOURCES.md)

またこちらのブログ記事も非常に参考になりました。

- [GraalVMでネイティブイメージを作る時に、リソースファイルを含めるようにする](https://kazuhira-r.hatenablog.com/entry/2019/06/15/222118)

今回は必要なフォント一つだけですが、`*.ttc` を含めるように 設定用のjsonを作成しましょうか。

```json:src/main/resources/resources-config.json
{
  "resources": [
    {
      "pattern": ".*\\.ttc$"
    }
  ]
}
```

で、このファイルをネイティブビルド時に読み込まれるように applications.properties に追記します。

```properties:src/main/resources/application.properties
...
quarkus.native.additional-build-args=-H:ResourceConfigurationFiles=${project.basedir}/src/main/resources/resources-config.json
```

ちなみに、上記のプロパティは `mvn quarkus:dev` ではあっさりエラーとなり、サーバーが起動しません。。。無視してくれていいのに、無視してくれません。

### 5-2. ビルド用Dockerの準備

いつものようにネイティブのビルドには GraalVMがインストール済みのイメージを使います。
Dockerfile は以下のようになります。

```dockerfile
## Stage 1 : build with maven builder image with native capabilities
FROM quay.io/quarkus/centos-quarkus-maven:19.2.1 AS build
COPY src /usr/src/app/src
USER root
RUN chown -R quarkus /usr/src/app
USER quarkus
RUN mvn -f /usr/src/app/pom.xml -Pnative -Dmaven.test.skip=true clean package

## Stage 2 : create the docker final image
FROM registry.access.redhat.com/ubi8/ubi-minimal
WORKDIR /work/
COPY --from=build /usr/src/app/target/*-runner /work/application
RUN chmod 775 /work
EXPOSE 8080
CMD ["./application", "-Dquarkus.http.host=0.0.0.0"]
```
で、これを使用するdocker-compose.yamlを作成いたします。

```yml:docker-compose.yml
version : "3"
services:
  quarkus:
    build:
      context: .
    ports:
      - 8082:8082
    networks:
      - default
      - monitor-net
    depends_on:
      - jaeger
      - db
  db:
    image: postgres
    ports:
      - 5432:5432
    environment:
      - POSTGRES_DB=mydatabase
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
  adminer:
    image: adminer
    restart: always
    ports:
      - 8080:8080
  jaeger:
    image: jaegertracing/all-in-one
    environment:
      - COLLECTOR_ZIPKIN_HTTP_PORT=9411
    ports:
      - 5775:5775/udp
      - 6831:6831/udp
      - 6832:6832/udp
      - 5778:5778
      - 16686:16686
      - 14268:14268
      - 9411:9411

networks:
  monitor-net:
    external:
      name: dockprom_monitor-net
```
Hibernateの接続先を `db` としたので、PostgreSQLのサービス名は `db` としています。
また jaeger も同様です。

以下のコマンドでビルド＆実行致します。

```shell
$ docker-compose up -d
```

## 6. 実行、しかし！！

無事にコンテナが起動したら以下のコマンドでデータ投入とPDFのダウンロードをしてみます。

```shell
$ curl -H 'Content-Type:application/json' -d '{"name":"Alice","birth":"2010-10-11","status":"Alive"}' http://localhost:8082/person
...
$ curl -o 1.pdf -H 'content-type: application/pdf' http://localhost:8082/person/1/pdf
...
```
注意点としてはPDFやHTMLの生成ロジックはあくまで **Personのコンバーター** として実装されている、という点です。つまり、対象のレコードがなければコンバートされない＝データが返ってきません。(HTTPステータスは200で正常なのに。)

で、ここでダウンロードした PDF を開こうとすると・・・**エラーで開けません！！**
<img width="532" alt="スクリーンショット 2019-11-11 22.27.16.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/335150/5e1135bc-427e-69ac-cb95-870ccd0536b9.png">

**Oh...no...**

Quarkusのログを確認すると実行時エラーで以下のような例外が発生しています。

```
Caused by: java.io.IOException: Error: Could not find referenced cmap stream Identity-H
```
`Identity-H`とはなんぞや？と色々探してみましたが、PDFのコード変換表のようです。また、以下のfontboxに含まれるリソースとして定義ファイルがありましたが、これが見つからないようです・・・

- https://github.com/apache/pdfbox/tree/trunk/fontbox/src/main/resources/org/apache/fontbox/cmap

色々試してみたのですが、fontbox もしくは pdfboxのjarの中にあるリソースをちゃんと実行バイナリの中に含める、という設定の仕方がよくわかりませんでした・・・
(もちろん、ネイティブビルドしなければ正常にPDF出力は行えます。)

うーん、残念ですが、日本語フォントの取り扱い？はネイティブ化対応できていないようですね。
以下のようなチケットにも `PDType1Font のネイティブ対応はできたよ`的な内容から、「PDType0Fontはまだだけどね・・・」というニュアンスが勝手に伺えてしまいます。。

- https://issues.apache.org/jira/browse/PDFBOX-4548

### ちなみに

docker-composeで"quarkus"を止めて、`mvn quarkus:dev` で開発サーバーが動きますが、その時は普通に動くんですよ〜。。。
<img width="929" alt="スクリーンショット 2019-11-11 22.43.18.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/335150/7f77e1bf-0e67-f34a-e945-d0d1759a7256.png">
これは普通に OpenJDKで動いてますからね・・・普通のJavaプログラムです。はい。。。

## まとめ

ネイティブ化して日本語フォントを埋め込んだPDFを生成してみようという野心的な試みでしたが、やはりフォントの壁は厚かったですね。
Quarkusは１.０のリリースに向けて新規機能の開発は一旦、収束しちゃっているような感じですが・・・近いうちに`PDType0Font`のサポートもしてくれるといいなぁ・・・

一応、今回の成果物は以下のリポジトリにあげました。

- [pdf-japanese | quarkus-examples | github.com](https://github.com/Yoshinori-Koide-PRO/quarkus-examples/tree/pdf-japanese)

ということで、今回は以上です！