EclipseでJavaEE7の開発環境構築方法

NetBeansによるJavaEE開発の記事はたくさん見かけますが、Eclipseの設定の記事があまりないようなのでご紹介します。EclipseでJSFやJPAを利用したい方は参考にしてください。

1 利用環境
2 Eclipseの設定
3 サーバーアダプタの追加
- 3.1 2018/08/20 追記
4 アプリケーションサーバーのダウンロードと設定
5 Eclipseのサーバー設定
6 サーバービューの表示
7 GlassFishサーバーのホットデプロイ設定
8 GlassFishサーバーの起動と停止方法

利用環境

Windows7(64bit)
Eclipse4.5(～4.8 別記事で紹介)
Java 1.8.0_40
JavaEE7
- GlassFish4.1.1(またはPayara4.1系でも可)

Eclipseの設定

今回はEclipse4.5を使いますが、任意のEclipseを利用してください。

ダウンロードからインストールまではこちらの記事を参照し設定してください。

サーバーアダプタの追加

JavaEEサーバーにGlassFishを利用します。

但し、Eclipseのデフォルト設定では利用することが出来ないためサーバーアダプタを追加しEclipseからGlassFishを利用できるようにします。

Eclipseのバージョンによってはサーバーアダプタ側が対応していないケースがあります。その場合はEclipseのバージョンを落として対応してみてください。

Eclipseを起動します。

メニューバーから「ウィンドウ」 ⇒ 「設定] を選択します。

設定画面が表示されるので、左のメニューから「サーバー」⇒「ランタイム環境」を選択します。サーバー・ランタイム環境から「追加」ボタンを押します。

画面右上にある「Show downloadable server adapters(追加サーバー・アダプターのダウンロード)」をクリックします。

「GlassFish Tools」を選択し「次へ」ボタンを押します。

「使用条件の条項に同意します」を選択して「完了」ボタンを押します。

ダイアログがでるので「OK」ボタンを押すとインストールを開始します。インストールには時間がかかるので気長に待ちます。

インストール完了後本ダイアログが表示されます。「はい」ボタンを押してEclipseを再起動します。

2018/08/20 追記

Eclipse4.6でのGlassFish Toolsのインストールは下記を参照

Eclipse4.6(Neon)へのGlassFish Toolsインストール方法

Eclipse4.6(Neon)へのGlassFish Toolsのインストール方法がそれ以前のEclipseから変わっているようなので以下...

ittoybox.com

Eclipse4.7,4.8でのGlassFish Toolsのインストールは下記を参照

Eclipse4.8(Photon)へのGlassFish Toolsのインストール

EclipseでJavaEE開発をする際はGlassFish Toolsをインストールしていると思いますが、Eclipse4.8(Photo...

ittoybox.com

アプリケーションサーバーのダウンロードと設定

今回はJavaEE7対応なのでアプリケーションサーバーにはGlassFish4.1.1を利用します。

ただしGlassFish4.1.1にはいくつか問題があります。

管理コンソールでデータソース(DBへの接続設定)の設定ができない（バグによるもの）
CDI利用時にトランザクション開始時のエラーがすべてTransactionExceptionになってエラー内容が分かりにくい（エラーハンドリングできない）
etc

このようなケースで悩まれる場合はGlassFish からフォークした「Payara」を使えば解決です。今回はGlassFishのを使った説明としますが、Payaraでもほぼ同じ構成のため同じように設定してもらえればOKです。

以下からzip版のモジュールをダウンロードし任意の場所に解凍します。

GlassFish（glassfish-4.1.1.zipをダウンロード）
Payara

このまま利用するとサーバー立ち上げ時や、コンソールに日本語を出力した際に文字化けが発生するので以下の設定を追加します。

{インストールディレクトリ}/glassfish4/glassfish/domains/domain1/config/domain.xml

に「-Dfile.encoding=UTF-8」を追加

java-configの中にjvm-optionsを指定している箇所があるので任意の場所に以下一行を追加します。


<jvm-options>-Dfile.encoding=UTF-8</jvm-options>

追加例

<java-config classpath-suffix="" debug-options="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=9009" system-classpath="">
・・・省略・・・
 <jvm-options>-Dcom.ctc.wstx.returnNullForDefaultNamespace=true</jvm-options>
 <jvm-options>-Dfile.encoding=UTF-8</jvm-options>
</java-config>