はじめに
私は業務でJakartaEE (Java EE) を使用したエンタープライズアプリケーションを開発しています。
これまでは参考書を読みながら学習し開発してきましたが、環境構築から開発手順までまとまっている、自分に合ったドキュメントがなかったので、今までの知識を連載形式でまとめていきたいと思います。
環境
※2020年3月現在のバージョンをもとに選定しています。
| 項目 | 内容 |
|---|---|
| OpenJDK ビルド | Azul Zulu 11 |
| フレームワーク | Jakarta EE 8 |
| APサーバ | payara server 5.201 |
| DBサーバ | PostgreSQL 12 |
| ビルドツール | Gradle 6.2.2 |
| IDE | Eclipse 2020-03 (Pleiades All in One) |
| OS | Windows 10 |
1. 環境構築
OpenJDK 11 インストール
今回はAzul Zuluを使用します。
payara server 5.192からJava 11対応がされたため、OpenJDK 11としています。
https://jp.azul.com/downloads/zulu-community/?&architecture=x86-64-bit&package=jdk
上記リンクから、 Java 11 (LTS) の Windows 版 msi をクリックしダウンロードします。
ダウンロードしたMSIファイルを実行します。
Next をクリックし、インストールフォルダはデフォルトのまま、 Next をクリックします。
Install をクリックし、インストールを開始します。
インストールが完了すると下の画面が表示されますので、Finish をクリックします。
次に環境変数を設定します。
Windowsの設定にて「環境変数」と検索し、「システム環境変数を編集」を選択します。
環境変数 をクリックします。
システム環境変数の 新規 をクリックします。
下記のシステム環境変数を設定します。
下表の通り入力し、OK をクリックします。
| 変数名 | 変数値 |
|---|---|
| JAVA_HOME | C:\Program Files\Zulu\zulu-11 |
コマンドプロンプトを起動し、「java -version」を実行し下記の結果が表示されればインストール完了です。
別のJDKをインストールしている場合は上記の結果とならない場合があります。
その際はシステム環境変数の設定を開き、Pathの先頭が
C:\Program Files\Zulu\zulu-11\bin
となるように変更してください。
PostgreSQL 12 インストール
データベースサーバとしてPostgreSQLを使用します。
https://www.enterprisedb.com/downloads/postgres-postgresql-downloads
Windows x86-64 の 12.2 の Download をクリックしダウンロードします。
ダウンロードしたexeファイルを実行します。
Next をクリックし、インストールフォルダはデフォルトのままで、Next をクリックします。
コンポーネントもデフォルトのままで、 Next をクリックします。
データ保管先を指定します。開発用で特に希望がなければデフォルトのまま使用します。Next をクリックします。
管理ユーザ「postgres」のパスワードを入力します。入力したら Next をクリックします。
接続ポートを設定します。指定された番号がない限り、デフォルトのまま Next をクリックします。
ロケールを設定します。「C」を選択し、 Next をクリックします。
Summaryが表示されますので、Next をクリックします。
Next をクリックして、インストールを開始します。
インストールが完了したら下の画面が表示されますので、チェックを外して Finish をクリックします。
以上でPostgreSQLのインストールは完了です。
payara server 5 インストール
Java EEアプリケーションサーバとして payara serverを使用します。
https://www.payara.fish/software/downloads/all-downloads/
ここではFullをインストールします。
Payara Server 5.201 (Full) Download をクリックすると、zipファイルがダウンロードされます。
Cドライブ直下にpayaraフォルダを作成し、その中にpayara-5.201フォルダを作成します。
※201の部分は今回のバージョンです
ダウンロードしたファイルを解凍し、解凍後のpayara5 フォルダをpayara-5.201フォルダ内に配置します。配置後の C:\payara\payara-5.201\payara5フォルダの中身は下の画面のようになります。
次に、payara serverの初期設定を行います。
コマンドプロンプトを起動し、C:\payara\payara-5.201\payara5\binフォルダに移動します。
payara serverを起動します。
asadmin start-domain と入力し、実行します。
c:\payara\payara-5.201\payara5\bin>asadmin start-domain
Waiting for domain1 to start ......................
Successfully started the domain : domain1
domain Location: C:\payara\payara-5.201\payara5\glassfish\domains\domain1
Log File: C:\payara\payara-5.201\payara5\glassfish\domains\domain1\logs\server.log
Admin Port: 4848
Command start-domain executed successfully.
管理者ログインを行います。
asadmin login と入力し、実行します。
ログインユーザはデフォルトのため空欄とします。
ログインに成功すると、[ユーザフォルダ]\.gfclient\pass ファイルが作成されます。
※パスワード情報が含まれるバイナリファイルです
c:\payara\payara-5.201\payara5\bin>asadmin login
Enter admin user name [Enter to accept default]>
Admin login information for host [localhost] and port [4848] is being overwritten with credentials provided. This is because the --savelogin option was used during create-domain command.
Login information relevant to admin user name [admin] for host [localhost] and admin port [4848] stored at [C:\Users\[ユーザ名]\.gfclient\pass] successfully.
Make sure that this file remains protected. Information stored in this file will be used by administration commands to manage associated domain.
Command login executed successfully.
管理者パスワードを変更します。
asadmin change-admin-password と入力し、実行します。
ユーザ名はデフォルトのため空欄、パスワードは設定していないため空欄のまま進み、新パスワードを入力します。
c:\payara\payara-5.201\payara5\bin>asadmin change-admin-password
Enter admin user name [default: admin]> ←何も入力せずにEnterキーを押す
Enter the admin password> ←何も入力せずにEnterキーを押す
Enter the new admin password> ←新パスワードを入力しEnterキーを押す
Enter the new admin password again> ←新パスワードを入力しEnterキーを押す
Command change-admin-password executed successfully.
再度、管理者ログインを行います。
asadmin login と入力し、実行します。
ログインユーザはデフォルトのため空欄とし、パスワードは先ほど入力した新パスワードを入力します。
ログインに成功すると、[ユーザフォルダ]\.gfclient\pass ファイルが更新されます。
c:\payara\payara-5.201\payara5\bin>asadmin login
Enter admin user name [Enter to accept default]> ←何も入力せずにEnterキーを押す
Enter admin password> ←新パスワードを入力しEnterキーを押す
Admin login information for host [localhost] and port [4848] is being overwritten with credentials provided. This is because the --savelogin option was used during create-domain command.
Login information relevant to admin user name [admin] for host [localhost] and admin port [4848] stored at [C:\Users\[ユーザ名]\.gfclient\pass] successfully.
Make sure that this file remains protected. Information stored in this file will be used by administration commands to manage associated domain.
Command login executed successfully.
管理コンソールを利用できるようにします。
asadmin enable-secure-admin と入力し、実行します。
c:\payara\payara-5.201\payara5\bin>asadmin enable-secure-admin
You must restart all running servers for the change in secure admin to take effect.
Command enable-secure-admin executed successfully.
再起動を促されますので、payara serverを再起動します。
asadmin restart-domain と入力し、実行します。
c:\payara\payara-5.201\payara5\bin>asadmin restart-domain
Successfully restarted the domain
Command restart-domain executed successfully.
Webブラウザを起動し、http://localhost:8080/ にアクセスし、下の画面が表示されるかを確認します。
https://localhost:4848/ にアクセスし、管理コンソールのログイン画面が表示されるかを確認します。
ログイン画面で User Name (上段) に admin 、Password(下段)に先ほど設定したパスワードを入力し、
ログインに成功し下の画面が表示されたらpayara serverのインストールと初期設定は終了です。
Gradle インストール
最新版をダウンロードします。
https://gradle.org/releases/
リンク先画面の下部にある、v6.2.2の binary-only のリンクをクリックし、zipファイルをダウンロードします。
Cドライブ直下にgradleフォルダを作成します。
ダウンロードしたファイルを解凍し、解凍フォルダ内のgradle-6.2.2フォルダをgradleフォルダ内に配置します。配置後の c:\gradle\gradle-6.2.2フォルダの中身は下の画面のようになります。
環境変数を設定します。
Windowsの設定にて「環境変数」と検索し、「システム環境変数を編集」を選択します。
環境変数 をクリックします。
システム環境変数の 新規 をクリックします。
下記のシステム環境変数を設定します。
下表の通り入力し、OK をクリックします。
| 変数名 | 変数値 |
|---|---|
| GRADLE_HOME | C:\gradle\gradle-6.2.2 |
システム環境変数のPathを追加します。
Pathを選択し、編集 をクリックします。
新規 をクリックし、「%GRADLE_HOME%\bin」と入力し、 OK をクリックします。
環境変数の編集画面を閉じた後にコマンドプロンプトを起動し、「gradle -version」を実行し下記の結果が表示されればインストール完了です。
Eclipse インストール・初期設定
こちらも最新版をインストールします。(Java の Full Editionが良いと思います)
http://mergedoc.osdn.jp/
ダウンロードしたzipファイルを解凍し、pleiadesフォルダをCドライブの直下に配置します。
※解凍は7-zipを使用して実施してください。
配置したら、c:\pleiades\eclipse\eclipse.exe をダブルクリックして Eclipse を起動します。
ワークスペースを選択し Eclipse が起動したら、ヘルプ > Eclipse マーケットプレース を選択します。
Eclipse マーケットプレース が起動したら、「payara tools」と入力し Enter キーを押し、検索結果から payara tools をインストールします。
次のダイアログが表示された場合は、 インストール をクリックします。
インストール完了後、Eclipseを再起動します。
再起動が完了したら、ウィンドウ > 設定 を開き、 サーバ > ランタイム環境 を選択し、開発サーバの設定を行います。
追加 をクリックします。
Payara を選択し、次へ をクリックします。
Payara Location に payara server のインストールフォルダを設定し、JavaロケーションにJDKのインストールフォルダを設定し、完了 をクリックします。その後、適用して閉じる をクリックし、設定ダイアログを閉じます。
サーバビューを開き、リンクをクリックします。
Payara > Payara をクリックし、次へ をクリックします。
パスワードを入力し、完了 をクリックします。
サーバービュー に Payara Server が追加されます。
以上で環境構築を終了します。
次章では、プロジェクトを作成します。