B.6.5 J2EE、Java EEアプリケーションの移行に関する注意点

Interstage Application Serverで動作するJ2EE規約やJava EE規約にしたがって作成されたアプリケーションは、本来あらゆる環境で動作することを前提としています。しかし、規約の違いにより提供機能やそれに伴う設定ファイルなどが異なるため、旧資産から移行する場合は、アプリケーション（ソースコードなど）の修正や定義変更が必要になる場合があります。

旧バージョンのワークベンチで開発していた資産を本バージョンのワークベンチに移行して、J2EE実行環境やJava EE実行環境で動作させる場合は、本マニュアルとは別に、以下のマニュアルで機能上の非互換や運用上の非互換を確認して対処してください。

Interstage Application Server 移行ガイド

J2EE、Java EEプロジェクトの自動更新

本バージョンでは、J2EE、Java EEプロジェクトの移行を以下の組み合わせにしたがって、自動更新で行うことができます。

移行前のプロジェクト	JREシステム・ライブラリー	ワークベンチのデフォルトJRE	移行後のプロジェクト
J2EE	－	JDK8	J2EE
Java EE 6	ワークスペースのデフォルトJRE	JDK8	Java EE 7
	ワークスペースのデフォルトJRE	JDK7	Java EE 6
	代替JRE：JDK7	－	Java EE 6
	代替JRE：JDK7以外	－	Java EE 7
Java EE 5	－	JDK 8	Java EE 7

JREシステム・ライブラリーは、プロジェクトのプロパティーの[Javaのビルド・パス] > [ライブラリー]タブでJREシステム・ライブラリーを選択し、[編集]ボタンで表示されるシステム・ライブラリーの値です。
ワークスペースのデフォルトJREは、[ウィンドウ] > [設定]で表示される設定ダイアログボックスの[Java] > [インストール済みのJRE]ページでチェックされているインストール済みのJREです。
自動更新は[プロジェクト] > [旧バージョンのワークスペース/プロジェクトの更新]で行われます。上記の組み合わせにないワークスペースのデフォルトJREの場合は、自動更新の対象にプロジェクト名が表示されません。

注意

ワークベンチのデフォルトJREがJDK7の際に、J2EEのプロジェクトが移行対象として表示される場合がありますが、JDK7を使用したJ2EEアプリ開発機能はサポート対象外であるため、実施しないでください。
サーバランタイムおよびターゲットランタイムを複数指定している場合、自動更新が正常に行われません。そのため、サーバランタイムとターゲットランタイムの指定をそれぞれ1つにしてから自動更新を実施するか、もしくは手動で設定変更をしてください。
自動更新で、Java EE 6またはJava EE 7のプロジェクトに更新する場合、プロジェクトファセットは以下のように設定されます。
- Java EE 6
  - EJBモジュール：3.1
  - 動的Webモジュール：3.0
  - アプリケーション・クライアント・モジュール：6.0
  - EAR：6.0
  - JPA：2.0
  - JCAモジュール：1.6
- Java EE 7
  - EJBモジュール：3.2
  - 動的Webモジュール：3.1
  - アプリケーション・クライアント・モジュール：7.0
  - EAR：7.0
  - JPA:2.1
  - JCAモジュール：1.6
プロジェクトファセットを変更したくない場合は、プロジェクトをインポート後に以下の手順で設定変更してください。
1. "Javaのバージョンを確認する"を行います。
2. "ビルドパスの定義を変更する"を行います。
3. インポートしたプロジェクトを選択して、コンテキストメニュー > [プロパティー] > [プロジェクト・ファセット]から、Interstage deployment descriptorのチェックを外して、適用します。
4. インポートしたプロジェクトを選択して、コンテキストメニュー > [プロパティー] > [ターゲット・ランタイム]から、適切なターゲット・ランタイムを指定します。
5. インポートしたプロジェクトを選択して、コンテキストメニュー > [プロパティー] > [プロジェクト・ファセット]から、適切なInterstage deployment descriptorのチェックをつけて、適用します。
自動更新は、プログラムソースやdeployment descriptorは更新しないため、必要に応じて修正してください。

J2EEアプリケーションからJava EEアプリケーションへの移行

J2EEアプリケーションをJava EEアプリケーションに移行するには、各アプリケーションの変更点を参照してアプリケーションを更新してください。

注意

以下のJ2EEアプリケーションについては注意事項があります。

Enterprise Bean (Container-managed Persistence)
CMP拡張情報ファイルはJ2EE実行環境で動作させるためのファイルです。Java EE実行環境で動作させるためには、Interstage Application Serverのマニュアルを参考にファイルを変更してください。
Webサービス
J2EE実行環境で運用していたWebサービス(JAX-RPC)は、Java EE実行環境で実行することができません。詳細はInterstage Application Serverのマニュアルを参照してください。

EJB2.0からEJB2.1への移行

EJB2.0に準拠した資産をEJB2.1準拠に移行するには、以下の手順にしたがってください。

注意

EJB2.1に移行した場合は、Interstage Application Serverではリモート環境からEJBアプリケーションにアクセスすることはできません。

1) プロジェクト新規作成

EJBプロジェクトウィザードで新規にEJBプロジェクトを作成します。このとき、ウィザードの[EJB モジュールバージョン]で[2.1]を選択してください。

2) 旧資産のインポート

インポートウィザードを使用して旧資産をインポートします。
メニューバーから[ファイル] > [インポート]を選択して、インポートウィザードを起動します。[インポートソースの選択]で[一般] > [ファイルシステム]を選択して、旧資産の必要な資産（ソースファイル、deployment descriptorなど）をインポートしてください。deployment descriptorはソースフォルダのMETA-INFフォルダ配下に格納してください。deployment descriptorは、EJBプロジェクト作成時に生成されますが、インポート時に既存資産のdeployment descriptorを上書きしてください。

ポイント

以下のフォルダはインポート対象から外してください。

.externalToolBuilders
.settings
bin
src
distribute

3) deployment descriptorの更新

deployment descriptorをEJB2.0からEJB2.1形式に変更します。変更は、deployment descriptorをXMLエディタで開き、XMLを直接変更する必要があります。

deployment descriptorのスキーマ定義をDTDからXML Schemaに変更する

以下のようにXML Schemaを定義します。

EJB2.0

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ejb-jar PUBLIC "-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 2.0//EN" "http://java.sun.com/dtd/ejb-jar_2_0.dtd">
<ejb-jar>

EJB2.1

<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar version="2.1" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd">
</ejb-jar>

タグ構成の変更

EJB2.0からEJB2.1でタグ構成、値が変更になったタグを修正します。

<small-icon>、<large-icon>タグ
アイコンの指定タグ（<small-icon>、<large-icon>）が、<icon>タグ配下に変更になったので、<icon>タグ配下に変更します。
EJB2.0
```
<small-icon>icon/small.gif</small-icon>
<large-icon>icon/large.gif</large-icon>
```
EJB2.1
```
<icon>
    <small-icon>icon/small.gif</small-icon>
    <large-icon>icon/large.gif</large-icon>
</icon>
```

<reentrant>タグ

<reentrant>タグの設定値（True or False）が、すべて小文字に変更になったので、小文字（true or false）に修正します。

EJB2.0

<prim-key-class>sample.EventPrimaryKey</prim-key-class>
<reentrant>False</reentrant>
<cmp-version>2.x</cmp-version>

EJB2.1

<prim-key-class>sample.EventPrimaryKey</prim-key-class>
<reentrant>false</reentrant>
<cmp-version>2.x</cmp-version>

<security-role-ref>、<security-identity>タグ

<security-role-ref>、<security-identity>タグの出現箇所が参照EJBタグ（<ejb-ref>、<ejb-local-ref>）と参照リソースタグ（<resource-ref>、<resource-env-ref>）の間から、参照リソースタグの後ろに変更になったので、タグの挿入位置を変更します。

EJB2.0

<ejb-local-ref>
    省略
</ejb-local-ref>
<security-role-ref>
    <role-name>Security1</role-name>
    <role-link>Security1</role-link>
</security-role-ref>
<security-identity>
    <run-as>
        <role-name>Security1</role-name>
    </run-as>
</security-identity>
<resource-ref>
    省略
</resource-ref>

EJB2.1

<ejb-local-ref>
    省略
</ejb-local-ref>
<resource-ref>
    省略
</resource-ref>
<security-role-ref>
    <role-name>Security1</role-name>
    <role-link>Security1</role-link>
</security-role-ref>
<security-identity>
    <run-as>
        <role-name>Security1</role-name>
    </run-as>
</security-identity>

Message-driven Bean関連タグの変更

Message-driven Beanの以下のタグが削除されたため、新規に追加された<activation-config>タグでプロパティ名および値として定義しなおします。

<message-selector>
<acknowledge-mode>
<message-driven-destination>
<destination-type>
<subscription-durability>

プロパティの指定方法は以下のようになります。なお、<message-driven-destination>タグは値を持ちません。

EJB2.0タグ	EJB2.1タグ
EJB2.0タグ	プロパティ名	値
message-selector	messageSelector	任意の文字列
acknowledge-mode	acknowledgeMode	以下のどちらかを指定します。 AUTO_ACKNOWLEDGE DUPS_OK_ACKNOWLEDGE
destination-type	destinationType	以下のどちらかを指定します。 javax.jms.Queue javax.jms.Topic
subscription-durability	subscriptionDurability	以下のどちらかを指定します。 Durable NonDurable

設定例を以下に示します。

<message-driven>
    省略
    <activation-config>
        <activation-config-property>
            <activation-config-property-name> messageSelector </activation-config-property-name>
            <activation-config-property-value> JMSType = 'car' AND color = 'blue'</activation-config-property-value>
        </activation-config-property>
        <activation-config-property>
            <activation-config-property-name> destinationType </activation-config-property-name>
            <activation-config-property-value> javax.jms.Topic </activation-config-property-value>
        </activation-config-property>
        <activation-config-property>
            <activation-config-property-name> subscriptionDurability </activation-config-property-name>
            <activation-config-property-value> NonDurable </activation-config-property-value>
        </activation-config-property>
    </activation-config>
</message-driven>

4) Javaソースの修正

EJB2.0からEJB2.1への移行ではソースの修正の必要はありません。

J2EEアプリケーションクライアント1.3からJ2EEアプリケーションクライアント1.4への移行

J2EEアプリケーションクライアント1.3に準拠した資産をJ2EEアプリケーションクライアント1.4準拠に移行するには、以下の手順にしたがってください。

1) プロジェクト新規作成

アプリケーションクライアントプロジェクトウィザードで新規にアプリケーションクライアントプロジェクトを作成します。[アプリケーション・クライアント・モジュールバージョン]の指定では、[1.4]を指定します。

2) 旧資産のインポート

インポートウィザードを使用して旧資産をインポートします。
メニューバーから[ファイル] > [インポート]を選択して、インポートウィザードを起動します。[インポートソースの選択]で[一般] > [ファイル・システム]を選択して、旧資産の必要な資産（ソースファイル、deployment descriptorなど）をインポートしてください。deployment descriptorはソースフォルダのMETA-INFフォルダ配下に格納してください。deployment descriptorは、アプリケーションクライアントプロジェクト作成時に生成されますが、インポート時に既存資産のdeployment descriptorを上書きしてください。

3) deployment descriptorの更新

deployment descriptorをJ2EEアプリケーションクライアント1.3からJ2EEアプリケーションクライアント1.4形式に変更します。変更は、deployment descriptorをXMLエディタで開き、XMLを直接変更する必要があります。

deployment descriptorのスキーマ定義をDTDからXML Schemaに変更する

以下のようにXML Schemaを定義します。

J2EEアプリケーションクライアント1.3

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE application-client PUBLIC "-//Sun Microsystems, Inc.//DTD J2EE Application Client 1.3//EN" "http://java.sun.com/dtd/application-client_1_3.dtd">
<application-client>

J2EEアプリケーションクライアント1.4

<?xml version="1.0" encoding="UTF-8"?>
<application-client id="Application-client_ID" version="1.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/application-client_1_4.xsd">
</application-client>

タグ構成の変更
J2EEアプリケーションクライアント1.3からJ2EEアプリケーションクライアント1.4でタグ構成、値が変更になったタグを修正します。
- <small-icon>、<large-icon>タグ
  アイコンの指定タグ（<small-icon>、<large-icon>）が、<icon>タグ配下に変更になったので、<icon>タグ配下に変更します。
  J2EEアプリケーションクライアント1.3
```
<small-icon>icon/small.gif</small-icon>
<large-icon>icon/large.gif</large-icon>
```
  J2EEアプリケーションクライアント1.4
```
<icon>
    <small-icon>icon/small.gif</small-icon>
    <large-icon>icon/large.gif</large-icon>
</icon>
```

Webアプリケーション2.3からWebアプリケーション2.4への移行

Webアプリケーション2.3に準拠した資産をWebアプリケーション2.4準拠に移行するには、以下の手順にしたがってください。

1) プロジェクト新規作成

アプリケーションクライアントプロジェクトウィザードで新規に動的 Web プロジェクトを作成します。[動的 Web モジュールバージョン]の指定では、[2.4]を指定します。

2) 旧資産のインポート

3) deployment descriptorの更新

deployment descriptorをWebアプリケーション2.3からWebアプリケーション2.4形式に変更します。変更は、deployment descriptorをXMLエディタで開き、XMLを直接変更する必要があります。

deployment descriptorのスキーマ定義をDTDからXML Schemaに変更する

以下のようにXML Schemaを定義します。

Webアプリケーション2.3

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC '-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN' 'http://java.sun.com/dtd/web-app_2_3.dtd'>

<web-app>
</web-app>

Webアプリケーション2.4

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
</web-app>

J2EE関連のテンプレートをインポートする

J2EEアプリケーション開発用に以下のテンプレートを用意しています。必要に応じてテンプレート定義ファイルをインポートしてください。

コンテキスト	名前	説明
Java	EJB Homeの参照	EJB Homeの参照処理を行う
	EJB Local Homeの参照	EJB Local Homeの参照処理を行う
	MessageProducer	イベントチャンネルにメッセージを送信する
	Point-To-Point	キューにメッセージを送信する
	Publish/Subscribe	トピックにメッセージを送信する

定義ファイルのインポートについて以下に示します。

メニューから[ウィンドウ] > [設定]を選択します。
[設定]ダイアログボックスが表示されるので、[Java] > [エディター] > [テンプレート]を選択します。
[テンプレート]ページが表示されるので、[インポート]をクリックします。
[テンプレートのインポート]ダイアログボックスが表示されるので、以下のファイルを指定して、テンプレート定義をインポートします。
```
<製品インストールフォルダ>\IDE\1202\etc\templates\templates_ejb_jms.xml
```