7.2. Blankプロジェクトから新規プロジェクト作成

Blankプロジェクトからの新規プロジェクトを作成する方法を説明する。

  • 前提
    • Spring Tool Suite が動作可能なこと。
    • Mavenをコマンドラインで実行可能なこと。
    • インターネットに接続できること。

この節の内容は以下のバージョンで動作確認している。

Product Version
JDK 1.7.0_40
Spring Tool Suite (STS) 3.4.0
Maven 3.0.4

Note

インターネット接続するために、プロキシサーバーを介する必要がある場合、 以下の作業を行うため、STSのProxy設定と、 MavenのProxy設定が必要である。

7.2.1. 新規プロジェクト作成

  1. プロジェクトを作成するフォルダにマンドプロンプトで移動する。

    cd C:\work

  2. Maven archetypeを利用してプロジェクトの雛形を生成する

Note

Maven Archetype Pluginのバージョンについて

Maven Archetype Plugin 3系ではarchetype:generateでMaven Central以外のリモートリポジトリを指定する場合はsettings.xmlでの設定が必須になった。

そのため、本ガイドラインでは既存ユーザが今まで通りの使い方ができるようにMaven Archetype Plugin 2.4を明示的に使用している。

mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -B^
 -DarchetypeCatalog=http://repo.terasoluna.org/nexus/content/repositories/terasoluna-gfw-releases^
 -DarchetypeGroupId=org.terasoluna.gfw.blank^
 -DarchetypeArtifactId=terasoluna-gfw-web-blank-archetype^
 -DarchetypeVersion=1.0.6.RELEASE^
 -DgroupId=example.first.application^
 -DartifactId=example-first-application^
 -Dversion=1.0.0-SNAPSHOT
パラメータ 説明
-B
batch mode (対話を省略)
-DarchetypeCatalog
Maven archetypeでプロジェクトを作成する。TERASOLUNA Global Frameworkのレポジトリを指定する。
-DarchetypeGroupId
tarasoluna.gfwのブランクプロジェクトのGroupID = org.terasoluna.gfw.blank 固定
-DarchetypeArtifactId
terasoluna-gfw-web-blank-archetype = JPA,MyBatis2は使用せずにプロジェクトを作成する場合
terasoluna-gfw-web-blank-jpa-archetype = JPAを使用するプロジェクトを作成する場合
terasoluna-gfw-web-blank-mybatis2-archetype = MyBatis2を使用するプロジェクトを作成する場合
-DarchetypeVersion
terasoluna.gfwのバージョンを指定する。
-DgroupId
作成プロジェクトのgroupIdを指定する。
-DartifactId
作成プロジェクトのartifactIdを指定する。
-Dversion
作成プロジェクトのバージョンを指定する。

  1. Spring Tool Suiteにプロジェクトをインポートする。

    [STS] -> [File] -> [Import] -> [Maven] -> [Exsiting Maven Projects] ->[ Browse…]でMaven archetypeで作成したプロジェクトを指定 -> 1つ表示されるpom.xmlにチェックが入っていることを確認して[Finish]

    以下のような状態になる。

    import blank project

  2. アプリケーションサーバに作成したプロジェクトを追加する。

    ここではデフォルトでSTSに付属するVMware vFabric tc Server Developer Edition v2.9を使用する。

    [VMware vFabric tc Server Developer Edition v2.9]を右クリック -> [Add and Remove] -> 作成したプロジェクトを選択して[Add] -> [Finish]

    以下のような状態になる。

    add server blank project

  3. アプリケーションサーバを起動する。

    Serverのスタートボタンを押して起動する。Consoleに以下が出力されれば起動成功となる。

    FrameworkServlet 'appServlet': initialization completed

    下記の出力例を見ると、Consoleにログが出力されるが、赤文字の一行上の行に”FrameworkServlet 'appServlet': initialization completed”が出力される(スクリーンキャプチャ上には表示されていない)。

    server start blank project

  4. 起動したアプリケーションにアクセスする。

    ブラウザでhttp://localhost:8080/example-first-application/にアクセスする。

    以下のような画面が表示される。

    access blank project

    「Hellow world!」が表示されれば、プロジェクトの作成準備は完了である。 ガイドラインに沿って、必要な機能を追加していくこと。

7.2.2. 簡単なEchoプロジェクトの作成

はじめてのSpring MVCアプリケーションで説明したエコーアプリケーションの作成と基本的には同じ手順となるため、ソースは割愛する。

はじめてのSpring MVCアプリケーションではspring-mvc.xmlの中で、<context:component-scan base-package="com.example.helloworld" />を設定しているが、 がBlank Projectから作成した場合は<context:component-scan base-package="example.first.application.app" />と設定される。

EchoControllerはexample.first.application.app.echoパッケージで作成すること。

echo input blank project
echo output blank project

Todo

TBD

今回はシングルプロジェクト構成での作成方法の説明をしているが、これは主に検証目的で使用されることを想定している。 実際にはマルチプロジェクト構成でプロジェクトを構築する必要がある。 マルチプロジェクト構成での作成方法は今後追記する。

Warning

Blankプロジェクトのpom.xmlに定義されている、以下の設定用はサンプルアプリケーションを簡単試すためのものであり、実際の開発で使用されることを想定していない。 実際のプロジェクトでは削除すること。

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <version>${com.h2database.version}</version>
    <scope>runtime</scope>
</dependency>