Eclipse を使った SIP サーブレットの開発

以下の節で、Oracle Communications Converged Application Server の SIP サーブレットを開発するために Eclipse をどのように使用するかを説明します。

概要

このドキュメントでは、Oracle Communications Converged Application Server で SIP サーブレットを開発してデプロイするためのツールとして Eclipse IDE を使用する方法を詳しく説明します。完全な開発環境を構築するためには以下のコンポーネントが必要です。まず、これらを入手してインストールしてください。

SIP サーブレットの編成

SIP サーブレットをビルドすると、最終生成物として Web アーカイブ (WAR ファイルまたはディレクトリ) が作られます。基本的な SIP サーブレット WAR ファイルには、図 10-1 に示すサブディレクトリとファイルが含まれます。

開発環境の設定

以下の手順に従って、新しい SIP サーブレットプロジェクトのための開発環境を設定してください。

新しい Oracle Communications Converged Application Server ドメインを作成します。
新しい Eclipse プロジェクトを作成します。
Ant ビルドファイルを作成します。

Oracle Communications Converged Application Server ドメインの作成

SIP サーブレットをデプロイしてテストするためには、必要に応じて再コンフィグレーションと再起動が可能な Oracle Communications Converged Application Server ドメインへのアクセスが必要です。コンフィグレーションウィザードを使用して新しいドメインを作成するには、『インストールガイド』の「管理ドメインの作成」の手順に従ってください。新しいドメインを生成するには、次のことが必要です。

デフォルト Eclipse JVM のコンフィグレーション

Eclipse の最近のバージョンでは、デフォルトでバージョン 1.5 の JRE が使用されます。Oracle Communications Converged Application Server と共にインストールされるバージョン 1.4.2 の JRE を使うように Eclipse をコンフィグレーションするには、以下の手順に従ってください。

Eclipse を起動します。
[Window｜Preferences] を選択します。
左ペインで Java カテゴリを展開し、[Installed JREs] を選択します。
[Add...] をクリックして、新しい JRE を追加します。
新しい JRE に使用する名前を JRE 名フィールドに入力します。
JRE ホームディレクトリフィールドの横にある [Browse...] ボタンをクリックします。BEA_HOME/jdk160_05 ディレクトリに移動してから [OK] をクリックします。
[OK] をクリックして、新しい JRE を追加します。
新しい JRE の横にあるチェックボックスを選択して、それをデフォルトにします。
[OK] をクリックして、ダイアログを終了します。

新しい Eclipse プロジェクトの作成

以下の手順に従って、SIP サーブレットを開発するための新しい Eclipse プロジェクトを作成し、アプリケーションのビルドとデプロイに必要な Oracle Communications Converged Application Server のライブラリを追加してください。

Eclipse を起動します。
[File｜New｜Project...] を選択します。
[Java Project] を選択し、[Next] をクリックします。
[Project Name] フィールドにプロジェクトの名前を入力します。
まだ SIP サーブレットコードを書き始めていなければ、[Location] フィールドで [Create project in workspace] を選択します。利用できるソースコードが別の場所にある場合は、[Create project at external location] を選択し、そのディレクトリを指定します。[次へ] をクリックします。
[Libraries] タブをクリックし、以下の手順に従って、必要な JAR をプロジェクトに追加します。

[Add External JAR...] をクリックします。
JAR 選択ダイアログを使って、WL_HOME/server/lib/weblogic.jar ファイルをプロジェクトに追加します。
[Add External JAR] をもう一度クリックします。
JAR 選択ダイアログを使って、WLSS_HOME/server/lib/wlss/sipservlet.jar ファイルをプロジェクトに追加します。

そのプロジェクトに必要と思われる JAR ファイルが他にもあれば、それらも追加します。
[Finish] をクリックして、新しいプロジェクトを作成します。Eclipse の Package Explorer に新しいプロジェクトの名前が表示されます。
新しいプロジェクトの名前を右クリックし、「図 10-1 SIP サーブレット WAR の内容」に示したディレクトリ構造を [New｜Folder] コマンドを使用して再作成します。

Ant ビルドファイルの作成

以下の手順に従って、プロジェクトのビルドとデプロイに使用できる Ant ビルドファイルを作成してください。

Eclipse 内でプロジェクトの名前を右クリックし、[New｜File] を選択します。
build.xml と入力し、[Finish] をクリックします。新しいウィンドウ内に空のファイルが開きます。
コードリスト 10-1 のサンプルテキストをコピーし、myDomain と myApplication を、それぞれ実際のドメイン名とアプリケーション名に置き換えます。

コードリスト 10-1 Ant ビルドファイルのコンテンツ

<?xml version="1.0" encoding="ISO-8859-1"?>

<project default="all">

  <property environment="env"/>

  <property name="beahome" value="${env.BEA_HOME}"/>

  <target name="all" depends="compile,install"/>

  <target name="compile">

    <mkdir dir="WEB-INF/classes"/>

    <javac destdir="WEB-INF/classes" srcdir="src" debug="true" debuglevel="lines,vars,source">

      <classpath>

        <pathelement path="${weblogic.jar}"/>

      </classpath>

    </javac>

  </target>

  <target name="install">

    <jar destfile="${beahome}/user_projects/domains/myDomain/applications/myApplication.war">

      <zipfileset dir="WEB-INF" prefix="WEB-INF"/>

      <zipfileset dir="WEB-INF" includes="*.html"/>

      <zipfileset dir="WEB-INF" includes="*.jsp"/>

    </jar>

  </target>

</project>

build.xml ファイルを閉じて、変更内容を保存します。
build.xml ファイルが有効であることを確認するため、[Window｜Show View｜Ant] を選択し、build.xml ファイルを Ant ビューにドラッグします。問題があれば修正します。
プロジェクト名を右クリックし、[Properties] を選択します。
左のカラムで [Builders] プロパティを選択し、[New] をクリックします。
[Ant Build tool type] を選択し、[OK] をクリックして、Ant ビルダを追加します。
[Buildfile] フィールドで、[Browse Workspace] をクリックし、作成した build.xml ファイルを選択します。
[Base Directory] フィールドで、[Browse Workspace] をクリックし、プロジェクトの最上位ディレクトリを選択します。
[JRE] タブをクリックし、[Runtime JRE] フィールドで [Separate JRE] を選択します。ドロップダウンリストまたは [Installed JREs..] ボタンを使って、インストールされているバージョン 1.4.2 の JRE を選択します。
[Environment] タブをクリックし、[New] をクリックします。新しい名前と値のペアを入力して、BEA_HOME 変数を定義します。BEA_HOME 変数は、Oracle Communications Converged Application Server ディレクトリのホームディレクトリを指していなければなりません。次に例を示します。

名前 : BEA_HOME
値 : c:\bea

[OK] をクリックして、新しい Ant ビルダをプロジェクトに追加します。
ビルダリストで [Java Builder] を選択解除して、Java ビルダをプロジェクトから削除します。
[OK] をクリックして、ビルダのコンフィグレーションを終了します。

プロジェクトのビルドとデプロイ

作成した build.xml ファイルにより、コードがコンパイルされ、WAR ファイルが作成され、WAR ファイルが開発ドメインの /applications サブディレクトリにコピーされます。Oracle Communications Converged Application Server は /applications サブディレクトリに置かれた有効なアプリケーションを自動的にデプロイします。

SIP サーブレットのデバッグ

SIP サーブレットをデバッグするためには、Oracle Communications Converged Application Server の起動時に、いくつかのデバッグオプションを有効にする必要があります。以下の手順に従って、必要なデバッグオプションを Oracle Communications Converged Application Server の起動用スクリプトに追加してください。

開発ドメインのための StartWebLogic.cmd スクリプトをテキストエディタで開きます。
次のような行を探します。

set JAVA_OPTIONS=

その下に次の行を入力します。

set DEBUG_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,address=9000,server=y,suspend=n

ファイルの最後のラインの以下に示す位置に %DEBUG_OPTS% 変数を追加してください。

"%JAVA_HOME%\bin\java" %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% %DEBUG_OPTS%

-Dweblogic.Name=%SERVER_NAME% -Dweblogic.management.username=%WLS_USER%

-Dweblogic.management.password=${WLS_PW%

-Dweblogic.management.server=${ADMIN_URL%

-Djava.security.policy="%WL_HOME%\server\lib\weblogic.policy" weblogic.Server

ファイルを保存し、スクリプトを使用して Oracle Communications Converged Application Server を再起動します。

SIP アプリケーションの開発