1. Eclipse開発環境の構築
iPLAssをベースにWebアプリケーションを開発するために、Eclipseで利用可能なGradleプロジェクトのスケルトンが用意されています。 ここではEclipseの設定からプロジェクトの取り込み、各種設定を行った後、Webアプリケーションの起動までを説明します。
2. 事前準備
開発環境を構築するにあたり、以下のものを用意してください。
JDK | Java SE8/11 もしくは OpenJDK11 |
APサーバ | |
DBサーバ | 以下の内いずれか
|
Eclipse | Eclipse IDE for Java EE Developers 4.7.3以降 |
2.1. Tomcatの設定
ダウンロードしたインストーラ、または圧縮ファイルから、任意の場所にTomcatをインストールします。
Tomcatのインストールディレクトリにある lib フォルダに利用するDBのJDBCドライバを配置してください。
| 本番環境ではデータソースを利用したDB接続を利用する場合があります。 データソースを利用する場合、Tomcatの参照するクラスパス上にJDBCドライバを配置する必要があります。 本資料ではデータソースは利用しませんが、上記理由によりプロジェクト側ではなくTomcat側にJDBCドライバを配置します。 |
2.2. DBの設定
iPLAss用のデータベースおよびテーブルの準備ができていない場合、DBの設定が必要になります。
以下の方法のうちいずれかを実施し、データベースおよびテーブルを作成してください。
Install and Runのウィザードを利用します。
iPLAss SDKをダウンロードし、同梱されているDDLを実行し、テーブルを作成します。
| 本番環境の構築を行う際は、iPLAss SDKのDDLを利用してください。 Install and Runによる作成は推奨していません。 Java 11を利用しているなら、必ずデータベースとJDBCを最新バージョンに更新してください。Java 11で接続ポリシーがTLSv1.3に変更された為、旧バージョンでは対応されない可能性があります。 |
2.3. Eclipseの設定
ダウンロードしたインストーラを起動します。
JAVA_HOMEが設定されていない場合、javaw.exeを選択するダイアログが表示されます。 JDKのインストール先にあるjavaw.exeを選択してください。起動した画面で
Eclipse IDE for Java EE Developersを選択し、任意の場所にインストールします。インストール完了後、Eclipseを起動し、任意の場所にワークスペースを作成してください。
メニューバーから
Window > Preferenceと選択し、設定画面を開きます。エンコーディングの設定
General > WorkspaceのText file encodingをOther(UTF-8)に変更します。JDKの設定
Java > Installed JREsにインストールしたJDKがあるか確認してください。 ない場合はJDKを追加し、デフォルトに設定します。 続いてJava > Compilerを開き、Compiler compliance levelが1.8となっていることを確認してください。(Java 11 の場合は11になる)Tomcatの設定
Server > Runtime EnvironmentsにインストールしたTomcatを追加します。Apache Tomcat v8.5を選択し、事前にインストールしたTomcatのディレクトリを指定します。
3. プロジェクトの作成
プロジェクトは GitHub 上に作成されたものを利用します。
Clone or download からURLをコピーしてクローンするか、ZIPファイルをダウンロードしてください。
3.1. クローンから作成
以下の手順でプロジェクトを作成します。
クローン先のURLをコピーします。
Eclipseの
Project Explorer上で右クリックし、Import > Import…を選択します。Git > Projects from Gitを選択します。Clone URIを選択します。LocationのURIにコピーしたURIが設定されてることを確認し、AuthenticationのUserとPasswordを入力します。
masterブランチを選択します。Destinationの
DirectoryにEclipse起動時に指定したワークスペースを指定します。Wizart Project importで
Import as general projectを選択します。Project Nameを変更せずに
Finishをクリックします。
メニューバーから
Window > Perspective > Open Perspective > Other > Gitと選択し、Git Repositoryを開きます。iplass-skeletonを右クリックし、Delete Repositoryをクリックします。Delete Git repository data and historyをチェックし、OKをクリックします。削除完了後、一度プロジェクトをリフレッシュします。
| クローンから作成する場合、予めGitHubアカウントを作成する必要があります。 |
3.2. ZIPファイルから作成
以下の手順でプロジェクトを作成します。
Clone or downloadでDownload ZIPをクリックし、ZIPファイルをダウンロードします。ZIPファイルを解凍し、ワークスペースの直下に
iplass-skeletonフォルダを移動します。
Eclipseの
Project Explorer上で右クリックし、Import > Import…を選択します。General > Projects from Folder or Archiveを選択します。Import sourceにワークスペースに移動したフォルダを指定し、Detect and configure project natureのチェックを外し、Finishをクリックします。
3.3. iPLAss SDKから作成
iPLAss SDKに含まれるスケルトンプロジェクトを利用してプロジェクトを作成します。
ダウンロードサイト または有償版契約時に通知されるURLからiPLAss SDKをダウンロードします。
iPLAss SDKを解凍し、ワークスペースの直下に
iplass-skeletonフォルダを移動します。
有償版のSDKでは iplass-ee-skeleton フォルダとなっています。 |
iplass-ee-skeletonフォルダを開き、有償版契約時に配布されるgradle.propertiesを上書きします。
Eclipseの
Project Explorer上で右クリックし、Import > Import…を選択します。General > Projects from Folder or Archiveを選択します。Import sourceにワークスペースに移動したフォルダを指定し、Detect and configure project natureのチェックを外し、Finishをクリックします。
3.4. インポート後の共通設定
アプリケーション名を決め、
Refactor > Renameでプロジェクトの名前を変更します。Refactor > Moveでプロジェクトフォルダをプロジェクト名にあわせて移動します。setting.gradleのrootProject.nameをプロジェクト名にあわせて変更します。
Webアプリケーション実行時にはTomcatに配置したJDBCドライバを利用しますが、後述のテナントの作成にて、ツール実行時にJDBCドライバが必要になります。
Oracle(ojdbc8.jar)の場合
ベンダーのダウンロードサイトからjarをダウンロードし、プロジェクト直下のlibフォルダに配置します。MySQL、PostgreSQL、SQLServerのいずれかの場合
build.gradleでコメントアウトされた該当行のコメントを解除します。
プロジェクトを右クリックし、
Configure > Add Gradle Natureをクリックし、Gradleを実行できるプロジェクトに変換します。Gradle > Refresh Gradle Projectをクリックし、依存するライブラリをダウンロードします。
プロジェクトの
Propertiesを表示し、以下の操作を実施します。Web Project SettingsのContext rootをプロジェクト名にあわせて変更します。Project Facetsのうち、以下の項目をチェックし、Versionを設定します。
| Project Facet | Version |
|---|---|
Runtimes | Apache Tomcat v8.5 |
Java | 1.8 (Java 11なら 11) |
Dynamic Web Module | 3.1 |
src/resources/mtp-service-config.xmlの設定を変更します。 以下の項目を変更してください。
<serviceDefinition>
<inherits>/mtp-core-service-config-oracle.xml</inherits> (1)
<!-- If use mysql, inherits mtp-core-service-config-mysql.xml for convenience. -->
<!--
<inherits>/mtp-core-service-config-mysql.xml</inherits>
-->
<!-- If use postgresql, inherits mtp-core-service-config-postgre.xml for convenience. -->
<!--
<inherits>/mtp-core-service-config-postgre.xml</inherits>
-->
<!-- If use sqlserver, inherits mtp-core-service-config-sqlserver.xml for convenience. -->
<!--
<inherits>/mtp-core-service-config-sqlserver.xml</inherits>
-->
・・・
<service>
<interface>org.iplass.mtp.impl.rdb.connection.ConnectionFactory</interface>
<!-- DriverManager base ConnectionFactory -->
<class>org.iplass.mtp.impl.rdb.connection.DriverManagerConnectionFactory</class>
<!-- ■ your rdb setting 1 ■ -->
<!-- for oracle --> (2)
<property name="url" value="jdbc:oracle:thin:ADDRESS:PORT:DB" /> (3)
<property name="user" value="XXXXX" />
<property name="password" value="XXXXX" />
<property name="driver" value="oracle.jdbc.driver.OracleDriver" />
・・・
</service>
・・・
<service>
<interface>org.iplass.mtp.impl.lob.LobStoreService</interface>
<!--
バイナリデータをファイルに保存する場合、以下のコメントアウトを外してください。
DBがMySQL及びPostgreSQLの場合はFileLobStoreの設定は必須です。
※下記設定は、Binaryはファイル、LongTextはRDBに保存する設定です。
LongTextもファイルにする場合は、longTextStoreの設定もFileLobStoreにしてください。
-->
<!--
<property name="binaryStore" class="org.iplass.mtp.impl.lob.lobstore.file.FileLobStore"> (4)
<property name="rootDir" value="[setYourBinaryFileStoreRootPath]" /> (5)
<property name="overwriteFile" value="false" />
</property>
<property name="longTextStore" class="org.iplass.mtp.impl.lob.lobstore.rdb.RdbLobStore">
</property>
-->
・・・
</service>
・・・
<service>
<interface>org.iplass.mtp.impl.mail.MailService</interface>
・・・
<!-- ■ for develop only (additional="true) ■ -->
<!-- 送信メールをデバッグ出力する場合、以下を有効にしてください。 -->
<!--
<property name="listener" class="org.iplass.mtp.mail.listeners.LoggingSendMailListener" additional="true"/> (6)
-->
</service>
・・・
</serviceDefinition>| 1 | 利用するDBにあわせて設定ファイルを変更 |
| 2 | 利用するDBにあわせてコメント化またはコメント化解除 |
| 3 | 作成したDBにあわせて変更 |
| 4 | MySQL、PostgresSQLの場合はコメント化解除 |
| 5 | バイナリファイルの格納先パスを設定 |
| 6 | コメント化解除、ただし開発環境のみ利用すること |
以上でプロジェクトの作成は終了です。
4. テナントの作成
テナントの作成はGUIツールを使用します。
Gradleタスクの
runTenantBatchを実行します。起動した画面で
Create Default Tenantをクリックします。ダイアログで
name(テナント名)、AdminUserId(管理者ユーザID)、AdminUserPassword(管理者ユーザパスワード)を入力し、Createをクリックします。
| テナント作成時はDBA権限を持つユーザをmtp-service-config.xmlに設定してください。 |
5. 実行
サーバを起動し、ブラウザからテナントにアクセスします。
5.1. サーバの起動
プロジェクトのルートで右クリックし、
Run As > Run on Serverを実行します。 (次回以降はServerViewから起動できます。)Tomcat v8.5 Serverを選択して、[Finish]をクリックしてください。Always use this server whern running this projectをチェックしておくと、次回Server起動時にそのまま実行できます。
5.2. ログイン画面の表示
サーバ起動後、ブラウザから以下のURLにアクセスします。
http://localhost:8080/コンテキスト名/テナント名/gem/
ConetxtRootを sampleApp 、テナントを sampleTenant として作成した場合、URLは以下になります。
http://localhost:8080/sampleApp/sampleTenant/gem/
Webアプリケーションが正常に起動できた場合、以下のログイン画面が表示されます。テナント作成時に登録された管理者IDでログインしてください。

6. 次のステップ
iPLAssに初めてふれている場合、次に チュートリアル を実施してみてください。