ローカルでの実行環境は必ず必要ではありません。しかし、ローカルで実行すると、サーバーのリソースを節約し、テストの時、外の開発者との干渉を最小化することができます。

参考としてサンプルプロジェクトのローカル実行環境設定は、Windows XPを基準にします。

システム要求事項

JDKインストール

サンプルプロジェクトでは、JDK6 バージョンを使います。

JDK ダウンロード

1. URL = http://java.sun.com/javase/downloads/index.jsp

2. “Java SE Development Kit (JDK)” 項目を探してダウンロードしてください。

3. ダウンロードした JDK(jdk-6u16-windows-i586.exe)を実行します。

4. 次のような画面からJDKをインストールするパスを選択して、Nextボタンをクリックします。

5. インストールが始まります。

6. 自動でJREをインストールします。 次のような画面からJREをインストールするパスを選択して、Nextボタンをクリックします。

7. インストールが始まります。

8. Finishボタンを押すとインストールが完了します。

環境変数のセッティング

1. “システムのプロパティ” > “詳細設定”タブ > “環境変数”ボタン > システム環境変数欄の“新規”ボタンをクリックしてください。

2. 新しいシステム変数の入力ウィンドウに、以下のように入力します。

• 変数名=JAVA_HOME,変数値=[JDKインストールパス]

• 変数名=JRE_HOME,変数値=[JREインストールパス]

3. 入力を終えると、次のようにシステム変数欄に表示されます。

TOMCAT(WAS) インストール

サンプルプロジェクトでは 5.5.28 バージョンを使います。

TOMCATダウンロード

1. URL = http://tomcat.apache.org/download-55.cgi

インストール

1. 適当なディレクトリにダウンロードしてから圧縮を解凍します。

2. 解凍したフォルダを適当な位置に移動します。

   サンプルプロジェクトでは “C:\ apache-tomcat-5.5.28”にしました。

3. これで WASがインストールされました。

XPLATFORM HTML5のインストール

War ファイルを使った新規 Contextインストール

XPLATFORM HTML5の warファイルを利用してインストールする方法を説明します。 次の説明は、Apache Tomcatを基準にした説明です。 他のWeb Application Serverは、該当WASのマニュアルを参照してください。

1. 1段階 : XPLATFORM HTML5のwarファイルコピー

   XPLATFORM HTML5のwarファイルを、適当なディレクトリにコピーします。 Warファイルは、XPLATFORM HTML5 配布版に含まれたxplatform9-ajax.war です。

   サンプルプロジェクトでは、パスを“C:\XAE\xplatform9-ajax.war”にしました。

2. 2段階 : Tomcatの Context設定ファイル作成

   <Tomcat Home>/conf/Catalina/localhost/xplatform9-ajax.xmlファイルを、次のような内容で作成します。

   例えば、Warファイルを“C:\XAE\xplatform9-ajax.war”にコピーした場合は、次のように作成してください。

<?xml version="1.0" encoding="UTF-8"?>
<Context path="/xplatform9-ajax" docBase="C:/XAE/xplatform9-ajax.war">
</Context>

3. 3段階: Tomcat 起動

   Tomcatの起動は、“<Tomcat Home>/bin/startup.bat”ファイルを実行します。

   Tomcatの終了は、“<Tomcat Home>/bin/shutdown.bat”ファイルを実行することで、終了します。

Jar ファイルを使った既存 Contextインストール

XPLATFORM HTML5のjarファイルを利用してインストールする方法を説明します。 既存のContextを維持したまま、XPLATFORM HTML5ライブラリファイル(jar)をコピーしてインストールすることができます。
例えば、既にインストールされたウェブアプリケーションの名前を“myajax”にして、インストールパスを“<Tomcat Home>/webapps/myajax”にします。

1. 1段階 : XPLATFORM HTML5の jarファイルをコピー

   XPLATFORM HTML5のjarファイルを、既存Contextのライブラリディレクトリにコピーします。 例題のプロジェクトでは、 <Tomcat Home>/webapps/myajax/WEB-INF/lib ディレクトリに、XPLATFORM HTML5 jarファイルをコピーしました。

2. 2段階 : 外部依存ライブラリコピー

   XPLATFORM HTML5の外部依存ライブラリを、既存Contextのライブラリディレクトリにコピーします。 例題のプロジェクトでは、<Tomcat Home>/webapps/myajax/WEB-INF/libディレクトリに、XPLATFORM HTML5の外部依存ライブラリをコピーします。 外部ライブラリリストは、下端の“4.4.3 インストール用ファイル”を参照してください。

3. 3段階 : web.xml 変更

   Web.xmlの内容に、次のような Servlet 設定を追加します。

   例題のプロジェクトでは、<Tomcat Home>/webapps/myajax/WEB-INF/web.xmlにあります。

<servlet>
</servlet>
<servlet>
<servlet-name>LoadResource</servlet-name>
<servlet-class>com.tobesoft.xplatform.ajax.service.LoadResourceServlet</servlet-class>
<init-param>
<!-- StreamLog を出力するかどうか指定 -->
<param-name>streamLog</param-name> 
<param-value>false</param-value> 
</init-param>
<init-param>
<!-- サーボスの実行時間を出力するかどうかを指定 -->
<param-name>elapsedTime</param-name>
<param-value>false</param-value> 
</init-param>
</servlet>
<servlet>
<servlet-name>ImageFilter</servlet-name>
<servlet-class>com.tobesoft.xplatform.service.ImageFilterServlet</servlet-class>
<init-param><param-name>cacheDir</param-name>
</init-param>
</servlet>
<servlet>
<servlet-name>ForwardRequest</servlet-name>
<servlet-class>com.tobesoft.xplatform.service.ForwardRequestServlet</servlet-class>
</servlet>

< -- 画像を加工して新しいイメージを返します（Stretch対応）-- >
<servlet-mapping>
<servlet-name>ImageFilter</servlet-name>
<url-pattern>/services/ImageFilter</url-pattern>
</servlet-mapping>

< -- 要求されたデータを他のサービス(url)に転送し、他のサービス(url)から受信されたデータに応答する中間伝達者の役割のHttpServletです -- >
<servlet-mapping>
<servlet-name>ForwardRequest</servlet-name>
<url-pattern>/services/ForwardRequest</url-pattern>
</servlet-mapping>
</web-app>

4. 4段階: Tomcat起動

   Tomcatの起動は、“<Tomcat Home>/bin/startup.bat”ファイルを実行します。

   Tomcatの終了は、“<Tomcat Home>/bin/shutdown.bat”ファイルを実行することで、終了します。

インストール用ファイル

XPLATFORM HTML5 サーバーインストールのためのファイルは、次のとおりです。

1. XPLATFORM HTML5

   次は XPLATFORM HTML5のインストールファイルです。

次はXPLATFORM HTML5の外部依存ライブラリです。

2. XPLATFORM HTML5 Imagefilter

   次は XPLATFORM HTML5 Imagefilterのインストールファイルです。

次はXPLATFORM HTML5の外部依存ライブラリです。

3. XPLATFORM HTML5 Exportexcel

   次は XPLATFORM HTML5 Exportexcelのインストールファイルです。

次はXPLATFORM HTML5 Exportexcelの外部依存ライブラリです。

4. 外部オプションライブラリ

   次はXPLATFORM HTML5の外部オプションライブラリです。

ライセンスファイル

次はライセンスファイルの種類です。

X-API ライセンスの登録

プロジェクトコンパイルと配布のためにX-APIライセンスを登録する必要があります。
X-APIのライセンスファイル名は “XPLATFORM_Server_License.xml”です。

X-API 使用に対するライセンス適用は、二つの方法があります。

1. ライセンスファイルを jarファイルと同じ位置に置く。

2. ライセンスファイルをクラスパスに置く。

二つの位置に同時にライセンスファイルが存在する場合には、 1) を優先的に適用されます。jarファイルと同じ位置に置く場合、パスは一般的にWeb Applicationの/WEB-INF/libになります。クラスパスに置く場合、一般的にWebApplicationの/WEB-INF/classesになります。

ライセンスが登録されていない場合のコンパイルエラーメッセージ

• TOMCATコンソール画面

• UX-Studioでのエラーメッセージ

ライセンスファイルをjarファイルと同じ位置に置く場合

1. サンプルプロジェクトで“C:\XAE\xplatform9-ajax.war”に置いてTOMCATを実行すると、“<Tomcat Home>/webapps/xplatform9-ajax” ディクトリが生成されます。

2. ライセンスファイル(XPLATFORM_Server_License.xml)を

   “<Tomcat Home>/webapps/xplatform9-ajax/WEB-INF/lib”に置きます。

ライセンスファイルをクラスパスに置く場合

1. ライセンスファイル(XPLATFORM_Server_License.xml)を、

   “<Tomcat Home>/webapps/xplatform9-ajax/WEB-INF/classes”パスに置いておきます。

   もしも該当パスが存在しない場合は、フォルダを生成してください。