1. Eclipse開発環境の構築
iPLAssをベースにWebアプリケーションを開発するために、Eclipseで利用可能なGradleプロジェクトのスケルトンが用意されています。 ここではEclipseの設定からプロジェクトの取り込み、各種設定を行った後、Webアプリケーションの起動までを説明します。
2. 事前準備
開発環境を構築するにあたり、以下のものを用意してください。
JDK |
|
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による作成は推奨していません。 |
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
となっていることを確認してください。 -
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)またはSQLServer(sqljdbc42.jar)の場合
各ベンダーのダウンロードサイトからjarをダウンロードし、プロジェクト直下のlibフォルダに配置します。 -
MySQLまたはPostgresの場合
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 |
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
を実行します。 (次回以降はServer
Viewから起動できます。) -
Tomcat v8.5 Server
を選択して、[Finish]をクリックしてください。Always use this server whern running this project
をチェックしておくと、次回Server起動時にそのまま実行できます。
5.2. ログイン画面の表示
-
サーバ起動後、ブラウザから以下のURLにアクセスします。
http://localhost:8080/コンテキスト名/テナント名/
ConetxtRootを sampleApp
、テナントを sampleTenant
として作成した場合、URLは以下になります。
http://localhost:8080/sampleApp/sampleTenant/
Webアプリケーションが正常に起動できた場合、以下のログイン画面が表示されます。テナント作成時に登録された管理者IDでログインしてください。

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