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と書かれた白いページであるはずです。

¹ 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要素には、ドライバーを設定するための追加属性を含めることもできます。これらには、ユーザー名やパスワードなどのパラメーターを含めることができます。これらはドライバーに依存するため、利用可能なオプションについてはデータベースドライバーのドキュメントを参照してください。