Javaのフレームワーク Nablarch を使ってみる [ウェブアプリケーション編]

JavaのOSSフレームワーク Nablarch を使って、疎通確認 + α してみます。
Nablarchはウェブアプリケーション・Webサービス・バッチ・メッセージングと様々な用途で使用できるフレームワークです。
今回はウェブアプリケーションのプロジェクトを作ります。（他の実行制御基盤の記事を作成するかは未定です。）

環境

OS: OS X Yosemite 10.10.5
Maven: Apache Maven 3.3.3
IDE: IntelliJ IDEA 2016.2.3
Nablarch: 5u8

やること

ブランクプロジェクトを作成して、ちょっとだけ触ってみます。
DBに登録されてる情報を取得し、表示します。

手順

ブランクプロジェクトの作成方法を参考に作成します。
とりあえず、作成するには次のコマンドを叩けばいいみたいなので、叩きます。
バージョンは5u8に変更してます。

mvn archetype:generate -DarchetypeGroupId=com.nablarch.archetype -DarchetypeArtifactId=nablarch-web-archetype -DarchetypeVersion=5u8

すると、プロジェクトの情報が聞かれるので入力します。今回は手順に記載されてるものと同じものを入力します。

• groupId : com.example
• artifactId : myapp-web
• version : 0.1.0
• package : com.example (そのままエンター）

これだけで、ブランクプロジェクトができました！
さっそくIDEで開いてみましょう！

できてますね！続いて疎通確認してみます。
mavenコマンドで、clean, compile, waitt:run の３つを実行すると、ウェブアプリケーションが起動し、ブラウザで表示されます。

正常に動いてますね！
じゃあ、ちょっとだけカスタマイズしていきます。
触ってみて動作確認するだけなので、いろいろ雑ですが。。。

まず、データ取得するDBのテーブルを用意します。
ID/NAME/AGE のカラムを持ったPERSONテーブルを作成して、データを一つ挿入しておきます。今回はIntelliJのデータベースアクセス機能で実行しました。接続情報はsrc/env/dev/resources/env.config に記載されています。

次にDBから取得したものを保持するためEntityクラスを用意します。

@Entity
public class Person {
    @Id
    private String id;
    private String name;
    private Integer age;

    // getter, setterは省略
}

続いて、アクションクラス（ロジック部分）を作成します。
PERSONテーブルからデータを取得して、リクエストスコープにセットし、jspに渡します。

public class PersonAction {

    public HttpResponse search(HttpRequest request, ExecutionContext context) {
        List<Person> data = UniversalDao.findAll(Person.class);
        context.setRequestScopedVar("data", data);
        return new HttpResponse("/person/list.jsp");
    }
}

最後にjspを作成します。

    <!-- html 定型部分は省略 -->
    <table border="1">
        <tr>
            <th>名前</th>
            <th>年齢</th>
        </tr>
        <c:forEach items="${data}" var="d">
        <tr>
            <td><n:write name="d.name" /></td>
            <td><n:write name="d.age" /></td>
        </tr>
        </c:forEach>
    </table>

これで完成です。

mvn clean compile waitt:run

で実行し、ブラウザで http://localhost:9080/action/person/search にアクセスします。

表示されてますね！
ちなみに、このURLは src/main/resources/routes.xml にマッピングの指定で
<match path="/action/:controller/:action"/>
とあるので、PersonActionクラスのsearchメソッドにマッピングされます。

まとめ / 感想

細かい内容についてはNablarchの解説書の方に任せて説明を省きましたが、上記のようにサクサクっとウェブアプリケーションが作成できました。実際に開発するとなると、カスタマイズする内容がたくさんあってサクサクとはいかないとしても、動くもの（ブランクプロジェクトや実装例としてのExample）がすぐ用意できるのは触ってみやすいと感じました。
ほんとは、他のフレームワークと比較できたらよかったんですが、私が浅学のため断念しました。
今回作成したものはgithubに上げてます。