開発環境の構築

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

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

JDK

Java SE8/11 もしくは OpenJDK11

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

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

JDBCドライバの配置

Tomcatのインストールディレクトリにある lib フォルダに利用するDBのJDBCドライバを配置してください。

本番環境ではデータソースを利用したDB接続を利用する場合があります。 データソースを利用する場合、Tomcatの参照するクラスパス上にJDBCドライバを配置する必要があります。 本資料ではデータソースは利用しませんが、上記理由によりプロジェクト側ではなくTomcat側にJDBCドライバを配置します。

iPLAss用のデータベースおよびテーブルの準備ができていない場合、DBの設定が必要になります。

以下の方法のうちいずれかを実施し、データベースおよびテーブルを作成してください。

  • Install and Runのウィザードを利用します。

  • iPLAss SDKをダウンロードし、同梱されているDDLを実行し、テーブルを作成します。

本番環境の構築を行う際は、iPLAss SDKのDDLを利用してください。 Install and Runによる作成は推奨していません。 Java 11を利用しているなら、必ずデータベースとJDBCを最新バージョンに更新してください。Java 11で接続ポリシーがTLSv1.3に変更された為、旧バージョンでは対応されない可能性があります。
  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 level が 1.8 となっていることを確認してください。(Java 11 の場合は 11 になる)

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

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

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

プロジェクトのインポート
  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アカウントを作成する必要があります。

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

ZIPファイルの取得
  1. Clone or download で Download 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 をクリックします。

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 をクリックします。

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

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

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

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

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

    • MySQL、PostgreSQL、SQLServerのいずれかの場合
      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 FacetVersion

Runtimes

Apache Tomcat v8.5

Java

1.8 (Java 11なら 11)

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にあわせて変更
4MySQL、PostgresSQLの場合はコメント化解除
5バイナリファイルの格納先パスを設定
6コメント化解除、ただし開発環境のみ利用すること

以上でプロジェクトの作成は終了です。

テナントの作成はGUIツールを使用します。

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

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

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

テナント作成時はDBA権限を持つユーザをmtp-service-config.xmlに設定してください。
管理者ユーザIDには4文字以上の英数字および - (マイナス) @ _ . (ピリオド)のみ入力可能です。
管理者ユーザパスワードは6文字以上の英数字および次の記号 ~!#\\$^&*+;:?/|{}\\.=_,- のみ入力可能です。

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

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

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

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

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

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

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

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

execute login

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