JPedalをTomcatにデプロイする

WARファイルのダウンロードまたはビルド

開始する前に、WARファイルが必要です。ダウンロードするか、自分でビルドすることができます。
このWARファイルは、JPedalサービスを動作させるために必須です。

jpedal-microservice.war ファイルをダウンロードしてください。

トライアルユーザーは、トライアル登録後、Dockerセクションでwarファイルのダウンロードを見つけることができます。

JPedal Microservice Exampleプロジェクトのコピーをビルドします。
手順はGitHubページに記載されています。

Tomcat をダウンロードしてインストールします。（テスト済みバージョン：8.5.x、9.0.x、10.0.x）
ビルドした.warファイルをapache-tomcat-x.x.x/webapps/ディレクトリにコピーします（Tomcat 10の場合はapache-tomcat-x.x.x/webapps-javaee/）。
Tomcatは起動時に、.warファイルの名前をコンテキストパスとして使用し、アプリケーションを自動的にデプロイします。
コマンドライン/ターミナルウィンドウを開き、apache-tomcat-x.x.xに移動してbin/startupコマンドを実行すると、ポート8080でサーバーが起動します。
- 詳細な手順については、Tomcatに付属のRUNNING.txtファイルを確認してください。
Webアプリが正常にデプロイされたかどうかは、ブラウザでそのURLにアクセスして確認できます。例：http://localhost:8080/jpedal-microservice。表示されるページは白い背景で、中央にJPedal Microservice Exampleと書かれているはずです。

1 Tomcat 10はJava EE 8からJakarta EE 9に移行しました。起動時にTomcat 10はwebapps-javaee内のwarファイルをJakarta Webアプリケーションに自動的に変換し、.warファイルの名前をコンテキストパスとして使用してデプロイします。

REST APIを使用してJPedal Microservice Exampleと対話できます（詳細はGitHubページを参照してください）。

注意：変換された出力の表示/ダウンロードが最初の試行で機能しない場合があります。これは通常、TomcatがWebアプリによって作成された新しいディレクトリをまだ認識していないためです。これを修正するには、単にTomcatサーバーを再起動してください。

場合によっては、プログラムの状態をデータベースに外部保存したい場合があります。例えば、サーバー障害が発生した場合にプログラムの状態を保持したい場合などです。

これを行うには、Tomcat上でデータソースを作成し、そのJNDI名をマイクロサービスの設定に追加する必要があります。

<Resource name="JNDI_NAME" auth="Container" type="javax.sql.DataSource"
      url="JDBC_URL"
      driverClassName="DRIVER_CLASS"/>

JNDI_NAMEは設定に記載する JNDI名です。通常はjdbc/で始まります。例：jdbc/myDatabase。

JDBC_URLはデータベースへのアクセスに使用するURLです。これがどのような形式である必要があるかは、データベースドライバーjarのドキュメントで確認できます。SQLite の場合は、jdbc:sqlite:/PATH/ON/DISK.dbとなります。

DRIVER_CLASSは、データベースドライバーjar内のメインドライバークラスの完全修飾クラス名です。これもデータベースドライバーjarのドキュメントで確認できます。SQLite の場合は、org.sqlite.JDBCとなります。

このresource要素には、ドライバーを設定するための追加の属性を含めることもできます。これらには、ユーザー名やパスワードなどのパラメータを含めることができます。これらはドライバー依存なので、利用可能なオプションはデータベースドライバーのドキュメントで確認できます。