1. Eclipse開発環境の構築

iPLAssをベースにWebアプリケーションを開発するために、Eclipseで利用可能なGradleプロジェクトのスケルトンが用意されています。 ここではEclipseの設定からプロジェクトの取り込み、各種設定を行った後、Webアプリケーションの起動までを説明します。

2. 事前準備

開発環境を構築するにあたり、以下のものを用意してください。

JDK

Java SE8

APサーバ

Tomcat 8.5

DBサーバ

以下の内いずれか

  • Oracle 11gR2以上

  • MySQL 5.7以上

  • SQL Server 2012以上

  • PostgreSQL 9.6以上

Eclipse

Eclipse IDE for Java EE Developers 4.7.3以降
Pleiades-Eclipse - MergeDoc Project

2.1. Tomcatの設定

ダウンロードしたインストーラ、または圧縮ファイルから、任意の場所にTomcatをインストールします。

JDBCドライバの配置

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の設定

  1. ダウンロードしたインストーラを起動します。
    JAVA_HOME が設定されていない場合、 javaw.exe を選択するダイアログが表示されます。 JDKのインストール先にある javaw.exe を選択してください。

  2. 起動した画面で Eclipse IDE for Java EE Developers を選択し、任意の場所にインストールします。

  3. インストール完了後、Eclipseを起動し、任意の場所にワークスペースを作成してください。

  4. メニューバーから Window > Preference と選択し、設定画面を開きます。

    1. エンコーディングの設定
      General > Workspace のText file encodingを Other(UTF-8) に変更します。

    2. JDKの設定
      Java > Installed JREs にインストールしたJDKがあるか確認してください。 ない場合はJDKを追加し、デフォルトに設定します。 続いて Java > Compiler を開き、Compiler compliance level1.8 となっていることを確認してください。

    3. Tomcatの設定
      Server > Runtime Environments にインストールしたTomcatを追加します。 Apache Tomcat v8.5 を選択し、事前にインストールしたTomcatのディレクトリを指定します。

3. プロジェクトの作成

プロジェクトは GitHub 上に作成されたものを利用します。 Clone or download からURLをコピーしてクローンするか、ZIPファイルをダウンロードしてください。

3.1. クローンから作成

以下の手順でプロジェクトを作成します。

プロジェクトのインポート
  1. クローン先のURLをコピーします。

  2. Eclipseの Project Explorer 上で右クリックし、Import > Import…​ を選択します。

  3. Git > Projects from Git を選択します。

  4. Clone URI を選択します。

  5. LocationのURIにコピーしたURIが設定されてることを確認し、AuthenticationのUserとPasswordを入力します。

  6. master ブランチを選択します。

  7. Destinationの Directory にEclipse起動時に指定したワークスペースを指定します。

  8. Wizart Project importで Import as general project を選択します。

  9. Project Nameを変更せずに Finish をクリックします。

Gitの接続情報削除
  1. メニューバーから Window > Perspective > Open Perspective > Other > Git と選択し、 Git Repository を開きます。

  2. iplass-skeleton を右クリックし、 Delete Repository をクリックします。

  3. Delete Git repository data and history をチェックし、 OK をクリックします。

  4. 削除完了後、一度プロジェクトをリフレッシュします。

クローンから作成する場合、予めGitHubアカウントを作成する必要があります。

3.2. ZIPファイルから作成

以下の手順でプロジェクトを作成します。

ZIPファイルの取得
  1. Clone or downloadDownload ZIP をクリックし、ZIPファイルをダウンロードします。

  2. ZIPファイルを解凍し、ワークスペースの直下に iplass-skeleton フォルダを移動します。

プロジェクトのインポート
  1. Eclipseの Project Explorer 上で右クリックし、Import > Import…​ を選択します。

  2. General > Projects from Folder or Archive を選択します。

  3. Import source にワークスペースに移動したフォルダを指定し、Detect and configure project nature のチェックを外し、Finish をクリックします。

3.3. iPLAss SDKから作成

iPLAss SDKに含まれるスケルトンプロジェクトを利用してプロジェクトを作成します。

iPLAss SDKの入手
  1. ダウンロードサイト または有償版契約時に通知されるURLからiPLAss SDKをダウンロードします。

  2. iPLAss SDKを解凍し、ワークスペースの直下に iplass-skeleton フォルダを移動します。

有償版のSDKでは iplass-ee-skeleton フォルダとなっています。
設定ファイルの差し替え
  1. iplass-ee-skeleton フォルダを開き、有償版契約時に配布される gradle.properties を上書きします。

プロジェクトのインポート
  1. Eclipseの Project Explorer 上で右クリックし、Import > Import…​ を選択します。

  2. General > Projects from Folder or Archive を選択します。

  3. Import source にワークスペースに移動したフォルダを指定し、Detect and configure project nature のチェックを外し、Finish をクリックします。

3.4. インポート後の共通設定

アプリケーション名の変更
  1. アプリケーション名を決め、Refactor > Rename でプロジェクトの名前を変更します。

  2. Refactor > Move でプロジェクトフォルダをプロジェクト名にあわせて移動します。

  3. setting.gradle のrootProject.nameをプロジェクト名にあわせて変更します。

JDBC Driverの取得
  1. Webアプリケーション実行時にはTomcatに配置したJDBCドライバを利用しますが、後述のテナントの作成にて、ツール実行時にJDBCドライバが必要になります。

    • Oracle(ojdbc8.jar)またはSQLServer(sqljdbc42.jar)の場合
      各ベンダーのダウンロードサイトからjarをダウンロードし、プロジェクト直下のlibフォルダに配置します。

    • MySQLまたはPostgresの場合
      build.gradleでコメントアウトされた該当行のコメントを解除します。

Gradleの有効化
  1. プロジェクトを右クリックし、Configure > Add Gradle Nature をクリックし、Gradleを実行できるプロジェクトに変換します。

  2. Gradle > Refresh Gradle Project をクリックし、依存するライブラリをダウンロードします。

プロジェクトの設定変更
  1. プロジェクトの Properties を表示し、以下の操作を実施します。

  2. Web Project Settings のContext rootをプロジェクト名にあわせて変更します。

  3. Project Facets のうち、以下の項目をチェックし、Versionを設定します。

Project Facet Version

Runtimes

Apache Tomcat v8.5

Java

1.8

Dynamic Web Module

3.1

mtp-service-config.xmlの設定
  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ツールを使用します。

  1. Gradleタスクの runTenantBatch を実行します。

  2. 起動した画面で Create Default Tenant をクリックします。

  3. ダイアログで name(テナント名)AdminUserId(管理者ユーザID)AdminUserPassword(管理者ユーザパスワード) を入力し、 Create をクリックします。

テナント作成時はDBA権限を持つユーザをmtp-service-config.xmlに設定してください。

5. 実行

サーバを起動し、ブラウザからテナントにアクセスします。

5.1. サーバの起動

  1. プロジェクトのルートで右クリックし、 Run As > Run on Server を実行します。 (次回以降は Server Viewから起動できます。)

  2. Tomcat v8.5 Server を選択して、[Finish]をクリックしてください。 Always use this server whern running this project をチェックしておくと、次回Server起動時にそのまま実行できます。

5.2. ログイン画面の表示

  1. サーバ起動後、ブラウザから以下のURLにアクセスします。

http://localhost:8080/コンテキスト名/テナント名/

ConetxtRootを sampleApp 、テナントを sampleTenant として作成した場合、URLは以下になります。

http://localhost:8080/sampleApp/sampleTenant/

Webアプリケーションが正常に起動できた場合、以下のログイン画面が表示されます。テナント作成時に登録された管理者IDでログインしてください。

execute login

6. 次のステップ

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

開発環境の構築