WebOTX Manual V11.1 (第6版) 目次を表示

---

3. 環境設定

start /d "%~dp0" .\eclipse.exe -vm "C:\Program Files\Java\jdk1.8.0_141\bin\javaw.exe" -data workspace

start /d "%~dp0" .\eclipse.exe -vm "%AS_JAVA%\bin\javaw.exe" -data "C:\TMP\workspace"

-vmargs -Xmx768m

3.7. デバッグする際のサーバ側の設定

3.7.1. 「サーバでデバッグ」でデバッグ

3.7.1.1. Localの場合

Expressとテスト用サーバーのデバッグ設定

Expressとテスト用サーバー以外のデバッグ設定

-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=4005

3.7.1.2. Remoteの場合

Expressとテスト用サーバーのデバッグ設定

Expressとテスト用サーバー以外のデバッグ設定

3.7.2. Eclipseでデバッグ

3.7.2.1. Eclipseの「デバッグの構成」でデバッグ

あらかじめWebOTXサーバのデバッグモードを有効にしておきます。詳細は「「サーバでデバッグ」でデバッグ」を参照して下さい。

Eclipseのメニューから、実行 > デバッグ構成をクリックし、リモートJavaアプリケーションの右クリックメニュー新規をクリックし、接続タブを設定し、デバッグボタンをクリックします。

図1.2.7.2-2

ソースコード上でブレークポイントを張り、アプリケーションを配備して実行します。

図1.2.7.2-3

3.7.2.2. 各アプリケーション特有のデバッグ方法

• Webサービスアプリケーションの開発 のデバッグについては、「デバッグ」を参照してください。
• Webアプリケーションの開発のデバッグについては、「デバッグ」を参照してください。
• EJBアプリケーションの開発のデバッグについては、「デバッグ」を参照してください。
• コネクタアプリケーション開発のデバッグについては、「デバッグ」を参照してください。

3.8. Maven実行環境の準備

4. Eclipseとは

図1.3-1

4.1. Java プロジェクトの新規作成

図1.3.1-1

図1.3.1-2

図1.3.1-3

図1.3.1-4

図1.3.1-5

4.2. Java ソースの新規作成

図1.3.2-1

図1.3.2-2

図1.3.2-3

図1.3.2-4

図1.3.2-5

図1.3.2-6

package com.nec.sample;
public class StringMaker {

  /** プレフィックス */
  private String prefix;

  /**
   * プレフィックスを返す。
   * @return プレフィックス
   */
   public String getPrefix() {
     return prefix;
   }

  /**
   * プレフィックスと引数baseを連結した文字列を返す。
   * @param base 元となる文字列
   * @return 連結した文字列
   */
   public String makeString(String base){
     /* 新しい文字列 */
     String newString;

     newString = prefix + base;
     return newString;
   }

  /**
   * プレフィックスを設定する。
   * @param string プレフィックス
   */

   public void setPrefix(String string){
     prefix = string;
   }
}
          

図1.3.2-7

4.3. Java プロジェクトで JUnit を使用するための準備

図1.3.3-1

図1.3.3-2

図1.3.3-3

図1.3.3-4

図1.3.3-5

図1.3.3-6

4.4. テスト・クラスの新規作成

図1.3.4-1

図1.3.4-2

図1.3.4-3

図1.3.4-4

図1.3.4-5

図1.3.4-6

package com.nec.sample;

import static org.junit.Assert.*;

import org.junit.Test;

public class StringMakerTest {

	/**
	    * MakeString()のテスト。
	    * 事前にsetPrefix(arg1)で文字列を設定し、makeString(arg2)を
	    * 呼び出すことにより、返却される文字列がarg1、arg2の順に結合された
	    * 文字列であることをテストする。
	    */
	@Test
	public void testMakeString() {
		StringMaker obj = new StringMaker();

		obj.setPrefix("Mr.");
		assertEquals("Mr.Smith", obj.makeString("Smith"));
	}

	/**
	 * setPrefix()とgetPrefix()のテスト。
	 * privateメンバprefixのsetter,getterのテストを行う。
	 */
	@Test
	public void testSetGetPrefix() {
		StringMaker obj = new StringMaker();

		obj.setPrefix("pre");
		assertEquals("pre", obj.getPrefix());
	}
}
          

図1.3.4-7

4.5. テストの実行

図1.3.5-1

図1.3.5-2

図1.3.5-3

4.6. Ant 実行のための build.xml 作成

図1.3.6-1

図1.3.6-2

図1.3.6-3

<?xml version="1.0" encoding="Shift_JIS"?>
<project name="sample1" default="all" basedir=".">

  <!-- 環境依存のプロパティ定義 -->
  <!--property file="build.properties" /-->
 
  <!-- プロパティの定義 -->
  <property name="jar.name" value="sample.jar"/>
  <property name="src" value="src"/>
  <property name="build" value="build"/>
  <property name="jar.dir" value="${build}/jar"/>
  <property name="classes" value="${build}/classes"/>
  <property name="ECLIPSE_HOME" value="../../"/>
 
  <!-- 単体テスト用プロパティの定義 -->
  <property name="test.jar.name" value="sampletest.jar"/>
  <property name="test.src" value="testsrc"/>
  <property name="test.classes" value="${build}/testclasses"/>
  <property name="test.report.dir" value="${build}/report"/>
 
  <!-- クラスパスの定義 -->
  <path id="JUnit 4.libraryclasspath">
    <pathelement location="${ECLIPSE_HOME}/plugins/org.junit_4.10.0.v4_10_0_v20120426-0900/junit.jar"/>
    <pathelement location="${ECLIPSE_HOME}/plugins/org.hamcrest.core_1.1.0.v20090501071000.jar"/>
  </path>
  <path id="sample1.classpath">
    <pathelement location="bin"/>
    <path refid="JUnit 4.libraryclasspath"/>
  </path>
 
  <!-- ターゲット -->
  <target name="all" depends="${jar.name}"/>
 
  <target name="${jar.name}" depends="compile">
    <mkdir dir="${jar.dir}"/>
    <jar jarfile="${jar.dir}/${jar.name}" basedir="${classes}"/>
  </target>
 
  <target name="compile">
    <mkdir dir="${classes}"/>
    <javac srcdir="${src}" destdir="${classes}" includeantruntime="false"/>
  </target>
 
  <target name="${test.jar.name}" depends="test.compile">
    <mkdir dir="${jar.dir}"/>
    <jar jarfile="${jar.dir}/${test.jar.name}" basedir="${test.classes}"/>
  </target>
 
  <target name="test.compile">
    <mkdir dir="${test.classes}"/>
    <javac srcdir="${test.src}" destdir="${test.classes}" includeantruntime="false">
     <classpath refid="sample1.classpath"/>
    </javac>
  </target>
 
  <target name="unit.test.report" depends="unit.test">
    <junitreport todir="${test.report.dir}">
      <fileset dir="${test.report.dir}">
       <include name="TEST-*.xml"/>
    </fileset>
      <report format="frames" todir="${test.report.dir}/html"/>
   </junitreport>
  </target>
 
  <target name="unit.test" depends="${jar.name},${test.jar.name}">
    <mkdir dir="${test.report.dir}"/>
    <junit printsummary="yes" haltonfailure="no">
     <classpath refid="sample1.classpath"/>
     <formatter type="xml" />
     <batchtest fork="yes" todir="${test.report.dir}">
       <fileset dir="${test.src}">
         <include name="**/*Test.java" />
       </fileset>
     </batchtest>
    </junit>
  </target>
 
  <target name="clean">
    <delete dir="${build}"/>
  </target> 
</project>
          

4.7. Eclipse 上からの Ant 実行

Caution
本節で説明している、ターゲット "unit.test.report" を含む Ant ビルドを Eclipse 上で実行した場合にエラーが発生する事があります。
その場合、 [ 1. Developer(with Developer's Studio) > 注意制限事項 > 注意事項 > Eclipse 上からの Ant 実行エラーについて ] をご覧下さい。

図1.3.7-1

図1.3.7-2

図1.3.7-3

図1.3.7-4

図1.3.7-5

4.8. プロジェクトの共用 （CVS）

図1.3.8-1

図1.3.8-2

図1.3.8-3

図1.3.8-4

図1.3.8-5

図1.3.8-6

図1.3.8-7

図1.3.8-8

図1.3.8-9

図1.3.8-10

Caution
Antを実行していない場合は、buildフォルダーは表示されません。
パッケージ・エクスプローラーにbuildフォルダーが表示されていない場合には、「sample1」プロジェクトで右クリックを行い、ポップアップメニューから 更新 を実行します。

図1.3.8-11

図1.3.8-12

図1.3.8-13

図1.3.8-14

図1.3.8-15

4.8.1. プロジェクトのチェックアウト

図1.3.8.1-1

図1.3.8.1-2

図1.3.8.1-3

図1.3.8.1-4

図1.3.8.1-5

4.8.2. ファイルの修正とコミット

図1.3.8.2-1

図1.3.8.2-2

Memo
「リポジトリーと同期化」を行い、同期化ビュー（発信モード）で確認してから「コミット」する方法もあります。

図1.3.8.2-3

4.8.3. ファイルの修正履歴の確認

図1.3.8.3-1

図1.3.8.3-2

図1.3.8.3-3

4.8.4. ファイルの更新

図1.3.8.4-1

図1.3.8.4-2

Memo
「リポジトリーと同期化」を行い、同期化ビュー（着信モード）で確認してから「更新」する方法もあります。

4.8.5. ファイルの追加

図1.3.8.5-1

図1.3.8.5-2

図1.3.8.5-3

図1.3.8.5-4

図1.3.8.5-5

図1.3.8.5-6

図1.3.8.5-7

図1.3.8.5-8

4.8.6. ファイルの削除

図1.3.8.6-1

図1.3.8.6-2

図1.3.8.6-3

図1.3.8.6-4

図1.3.8.6-5

図1.3.8.6-6

4.8.7. タグ付け

図1.3.8.7-1

図1.3.8.7-2

図1.3.8.7-3

4.8.8. ブランチの作成

図1.3.8.8-1

図1.3.8.8-2

図1.3.8.8-3

図1.3.8.8-4

図1.3.8.8-5

4.9. プロジェクトの共用 （SVN)

4.9.1. Subversionの特長

4.9.1.1. アトミックコミットとチェンジセット

SVNでは、コミット単位にリポジトリツリーのリビジョン番号がカウントアップされますので、コミットによってバージョン管理を行うことができます。このリビジョンごとの差分を「チェンジセット」といいます。

関連のある修正内容(バグ修正、仕様変更対応)で複数のファイル修正を行った場合、この複数のファイルをまとめてコミットします。こうすることで、複数のファイルに対する変更をチェンジセットとしてひとまとめにし、1つの論理的な単位にすることでき、開発者はそれらの変更をよりよく系統立て、その変更を追跡可能になります。例えば、開発者がリビジョン１１である機能追加をコミットしたならば、他の開発者は容易にその変更をみることができます。また複数のファイル修正をまとめてコミットすることができるためアトミックなコミットが可能となります。

4.9.1.2. 推奨ディレクトリ構成

SVNでは、プロジェクトルートの下にtrunk、branches、tagsの３つのディレクトリを作成する以下のようなディレクトリ構成を推奨しています。

図1.3.9.1-1

プロジェクトルートの下にtrunk、branches、tagsの３つのサブディレクトリを作成します。各サブディレクトリは以下のように使用します。

• trunk　･･･　プロジェクトの主な開発が行われるディレクトリです。
• branches 　・・・　主な開発ラインから分岐したさまざまな名前の付いたブランチを作るための場所です。
• tags　・・・　タグ付けしたコピーを置くためのディレクトリです。決して修正はされないようなブランチを入れるためのディレクトリです。

4.9.2. Subversionクライアント

4.9.3. Subclipseを使用した開発

図1.3.9.3-1

1. インポート

   Eclipseからサーバのリポジトリへアクセスし、リソースを登録（インポート）します。この作業はプロジェクトチーム内で、最初に誰かが１回だけ行います。

2. チェックアウト

   リポジトリからリソースを取得(チェックアウト)します。この操作は、開発者が開発参加時に１度行います。(インポートした方は、この操作は不要となります)

3. リポジトリと同期化

   開発中は、各開発者がコードを変更したら開発者のワークスペース上のファイルとSVNのリポジトリ上のソースを同期化させ、同じ状態にします。SVNを利用した開発では、リポジトリ上の最新の状態を作業ワークスペースに反映させる「更新」と、ワークスペース上のファイルに加えた変更をリポジトリに反映させる「コミット」と呼ばれる作業によってファイルの同期を取ります。

4. タグ/ブランチ作成

   リビジョン番号はコミットの際にSVNによって自動的に付与されます。開発を進めていくと、リビジョン番号もカウントアップされていき、リビジョン番号だけによって開発の作業内容を把握していくことが困難となってきます。このため、タグとブランチという機能が提供されています。

   • タグ

     ある時点のプロジェクト全体の状態を、タグ付けしてまとめて保存しておきます。タグ付けすることで、タグ付けした時点のファイルをまとめて取得することや、現状の状態との比較することが容易に行えます。 例えば、新バージョンの開発が終わってリリースするときなどにタグを作成します。このようにすることで、リリースしたあるバージョンのソースを全部取得したい場合に、すぐに取得することができます。 SVNでは、すべてのタグをtagsフォルダに置きます。

   • ブランチ

     現在リリースしたバージョンをメンテナンスしながら次のバージョンの開発をするといった、並行開発を行う場合にブランチ(分岐)を作成します。あるバージョンでリリース後、そのメンテナンスをメインの開発(trunk)から独立して進めるために、リリースしたリソースを基点として分岐させ、そこからtrunkとは独立に編集・コミットが可能となります。 また、プロトタイプ開発のように試験的にソースコードを変更する際にブランチを作成し、ブランチ上で試行を進めます。開発のメイン ブランチをコンパイラ エラーやバグなどで混乱させることなく、新しい機能を試行するために使用します。 SVNでは、すべてのブランチをbranchesフォルダに置きます。

4.9.4. Subclipse機能説明

4.9.4.1. リポジトリの設定

図1.3.9.4-1

図1.3.9.4-2

図1.3.9.4-3

4.9.4.2. 新規ディレクトリ作成

図1.3.9.4-5

図1.3.9.4-6

図1.3.9.4-7

4.9.4.3. プロジェクトの共用

プロジェクトの共用とはSVNリポジトリにプロジェクトを登録する作業です。この作業は、最初にプロジェクト作成した人がSVNリポジトリに対して1度だけ行います。

本章ではEclipseのJavaプロジェクト[JavaProj]を共有する手順を説明します。

パッケージ・エクスプローラでSVNリポジトリに登録したいプロジェクト[JavaProj]を選択し、右クリックメニュー [チーム] ＞ [プロジェクトの共用] を選択します。

図1.3.9.4-9

図1.3.9.4-10

図1.3.9.4-11

図1.3.9.4-12

図1.3.9.4-13

図1.3.9.4-14

図1.3.9.4-15

図1.3.9.4-16

図1.3.9.4-17

4.9.4.4. プロジェクトのチェックアウト

SVNリポジトリに格納されているプロジェクトをチェックアウトする手順を説明します。

本章ではSVNリポジトリ「http://localhost/svn/test/JavaProj/trunk」に格納されているプロジェクトをEclipseのJavaプロジェクトの「JavaProj」プロジェクトとしてチェックアウトします。

まずSVNリポジトリ・ビューでチェックアウトしたいフォルダを選択して右クリックメニューで[チェックアウト] を選択します。ここでは「JavaProj」-「trunk」フォルダを選択します。「trunk」フォルダには、開発作業におけるメインとなる開発ラインのリソースが格納されています。

図1.3.9.4-18

4.9.4.5. ファイルの修正とコミット

ファイルの修正を行いコミットする例を示します。ここではSVNサーバからチェックアウトを行ったJavaProjプロジェクトのTest.javaに修正を加えてコミットを行う例を示します。

SVNリポジトリの管理下に置かれたリソースはローカルで修正変更が行われコミットの前の状態のものには、「>」のアイコンが付きます。これは再帰的に変更されたリソースが属する上位フォルダに伝播します。以下の例ではTest.javaに変更が加わった場合、上位のフォルダ、プロジェクトにも「>」のアイコンが付くことが確認できます。

図1.3.9.4-20

図1.3.9.4-21

図1.3.9.4-22

図1.3.9.4-23

Memo
「リポジトリーと同期化」を行い、同期化ビュー（着信モード）で確認してから「更新」する方法もあります。

4.9.4.6. 修正履歴の確認

図1.3.9.4-24

図1.3.9.4-25

4.9.4.7. ファイルの更新

図1.3.9.4-26

4.9.4.8. ファイルの追加

ファイルの追加を行うにはまずワークスペースに対して行い、次にSVNリポジトリにワークスペース上のファイルの追加・コミットを行います。

まず新規のソースファイルを作成します。以下ではソースフォルダのsampleパッケージにTest2.javaを追加します。

図1.3.9.4-27

図1.3.9.4-28

図1.3.9.4-29

図1.3.9.4-30

図1.3.9.4-31

図1.3.9.4-32

4.9.4.9. ファイルの削除

図1.3.9.4-33

図1.3.9.4-34

図1.3.9.4-35

図1.3.9.4-36

図1.3.9.4-37

図1.3.9.4-38

4.9.4.10. ブランチ/タグの作成

SVNではブランチをbranchesディレクトリ、タグをtagsディレクトリへ作成します。またSVNではブランチの作成とタグの作成は同じ作業となります。ここではタグの作成の方法を記載します。

プロジェクトでタグを管理するtagsディレクトリを作成します。SVNでは、すべてのタグはtagsディレクトリに置き管理します。SVNリポジトリビューでタグを作成するプロジェクトディレクトリを選択し、右クリックメニュー [新規] ＞ [フォルダー] を選択します。

図1.3.9.4-39

図1.3.9.4-40

図1.3.9.4-41

図1.3.9.4-42

図1.3.9.4-43

図1.3.9.4-44

4.10. TCP/IPモニターの利用

4.10.1. TCP/IPモニターの表示

図1.3.10-1

図1.3.10-2

4.10.2. TCP/IPモニターの起動

図1.3.10-3

図1.3.10-4

図1.3.10-5

Memo
ローカル・モニター・ポートにローカルのモニターのポートを入力します。 ポートにモニターするサービスのポートを入力します。

TCP/IPモニターの設定画面で新規作成したモニターを選択して、起動をクリックします。

4.10.3. TCP/IPモニターの利用

図1.3.10-6

4.11. Mavenプロジェクトの新規作成

4.11.1. 新規作成ウィザードの実行

4.11.2. Mavenアーキタイプの選択

4.11.3. MavenプロジェクトのMaven GAVの設定

4.11.4. ソース作成

4.11.5. pom.xml編集

4.11.6. ビルド実行

4.11.7. 実行結果の確認

4.11.8. 出力ファイルの確認

4.12. Mavenプロジェクトへの移行

1. Mavenでは依存ライブラリの定義をpom.xmlで行う為、Mavenプロジェクトに変換する前に依存関係の情報を収集しておく必要があります。
   依存関係の確認方法として、次のような方法があります。
   • 「コンテナ向けアプリケーション検証機能」のレポート「Dependencies (依存関係)」
   • Eclipseで作成した非Mavenプロジェクトの場合は.classpathファイル
2. WebOTX Developerにて、既存プロジェクトをMavenプロジェクトに変換します。
   既存プロジェクトの右クリックメニュー[構成] > [Convert to Maven Project]を実行してください。
3. プロジェクトディレクトリ直下に作成されるpom.xmlを編集し、予め収集した依存関係の情報を基に、依存ライブラリの定義を行います。
   

   <dependencies>
     <dependency>
         <groupId>依存ライブラリのgroupId</groupId>
         <artifactId>依存ライブラリのartifactId</artifactId>
         <version>依存ライブラリのversion</version>
         <scope>provided</scope>
     </dependency>
     ※上記<dependency>を１セットとして必要分を定義します。
   </dependencies>
   

mvn install:install-file -Dfile=<配置するライブラリファイルパス> -DgroupId=<groupId> -DartifactId=<artifactId> -Dversion=<version> -Dpackaging=jar