2010-06-13

Java Cloud Meeting Tokyoに参加してきました

GAE/J

懇親会とかからただいま帰宅。（22:00）
ひとまず内容を簡単にまとめ。

Seasar3

Spring の wrapper として、HOT reloading などの機能を追加する形で。
VMforce や Google App Engine for Business での Spring 公式サポートの現状を踏まえ、かつ Seasar2 との互換性を持ったプロダクトだと良いよね、という感じですかね。

slim3

次の２つのお話くらいでしたかね。
（１）複数の Entity Group を一度に更新できる”Global Transaction”が素敵です。
（２）spin up を考慮すれば、必ずしも Python > Java とは言い切れない。
　　　slim3 なら、1.3 〜 3.9 秒で spin up しますよ。

眠いのでポイント外しているかもしれませんが、ひとまず今日はここまで。

2010-06-12

【slim3】Java Cloud Meeting Tokyo

GAE/J

明日、法政大学でJava Cloud Meeting Tokyoが開催されるので参加してきます。
Seasar3 とか AWS の話もあるので、色々と楽しみです。

2010-05-30

SDKなどの更新手順

GAE/J

GAE の SDK などが古くなってきたので、新しいものに更新することにしました。
今回は、これらを Eclipse で更新する手順についてまとめます。

（１）Eclipse のメニューから、「Help」→「Software Updates」を
　　　選択します。

（２）「Available Software」タブを選択し、以下のものを選択し、
　　　「Install」を押下します。

Google Plugin for Eclipse 3.4
Google App Engine Java SDK
Google Web Toolkit SDK　（オプション）

（３）選択したものが表示されていることを確認し、
　　　「Next >」を押下します。

（４）「I accept the terms of the license agreements」を選択し、
　　　「Finish」を押下します。
　　　選択したもののインストールが開始されます。
　　　※インストールは、環境にもよりますが、
　　　　１０分以上は見込んで下さい。

（５）Eclipse の再起動を求められますので、再起動して終了です。

あとがき

後日、slim3 のバージョンアップ手順を調べてみます。

2010-04-25

【slim3】JSPでModelを表示できない？

GAE/J

BigTable から取得した Model の List を HttpServletRequest へセットし、JSP で表示しようとしているのですが、うまく表示することができません。。。

１．forEachで型認識がうまくいかない

JSTL の c:forEach を使うと、Model が String 型と認識されてしまいます。
例えば、

と定義した場合、

${model}・${f:h(model)} はＯＫ
${model.xxx}・${f:h(model.xxx)} はＮＧ

となります。
エラーメッセージは以下の通り。
javax.servlet.jsp.el.ELException: オペレータ "." を利用しましたが、クラス "java.lang.String" のオブジェクトにおいて "xxx" に対応する値が見つかりません
※getter/setter はきちんと用意しています。
同じことを SAStruts でやったときは、全く問題が発生しませんでした。
GAE のランタイム（もしくはプラグイン）の問題ですかね？

２．castに失敗する

EL ではなくスクリプトレットを使用し、List から Model を取得しようとすると、正しいはずのクラス名を指定しても ClassCastException になります。
エラーメッセージは以下のような感じです。
java.lang.ClassCastException: xxx.yyy.model.order.Order cannot be cast to xxx.yyy.model.order.Order
JSP では、Model を直接参照しない方がよいのですかね？

※GAE プラグイン・slim3 ともに、2009/11/15 頃に取得したバージョンです。
　ひょっとしてバージョンが古い？

2010-04-18

日本語の文字コードはUTF-8で！

GAE/J

slim3 でアプリを開発する際、JavaEE アプリのいつもの癖で、
JSP の文字コード指定を”Shift_JIS”にしていたところ、
入力値の表示で文字化けが発生。

さらに調べてみると、文字コードが UTF-8 でないと、
アプリを Google にアップロードする際にエラーとなる模様。

ひがさんのブログなどを確認させていただいたところ、
JSP の文字コードは UTF-8 とした方がよいみたいですね。

2010-04-11

【slim3】JSPの開発手順および注意事項

GAE/J

前回まで、slim3 の画面遷移制御用コンポーネントである
”Controller”について触れてきました。
今回は、この Controller から呼び出される／を呼び出す JSP の開発手順、およびその際の注意事項について見ていきます。

１．あらかじめ用意されているもの

slim3-blank をインストールする際、あらかじめ以下のものが用意されています。

ベースとなる JSP 部品
CSS

これらをベースに、自動生成した JSP（後述）に修正を加えていく形で、JSP を開発していくことになります。

なお、slim3-blank のインストール時に用意されているファイルについては、slim3のプロジェクト構成をご覧下さい。

（１）ベースとなるJSP部品

war ディレクトリ下に、以下の４つの JSP 部品が用意されています。

JSP ファイル名	内容
header.jsp	ヘッダー：タイトルの表示機能を持つ。
menu.jsp	メニュー用のリンクを持つ。
footer.jsp	フッター。
index.jsp	アプリの初期表示画面。上記３ファイルを include している。

header・menu・footer を使用する JSP を構築したい場合は、index.jsp をベースとすれば良いでしょう。
また、これらの JSP の文字コードは、いずれも UTF-8 となっています。

（２）CSS

war/css ディレクトリ下に、global.css が用意されています。
上述の index.jsp、および自動生成した JSP（後述）は、同ファイルを参照するようになっています。
そのため、画面のデザインを定義・変更したい場合は、通常このファイルを編集していくことになります。
（ちなみに、独自の CSS ファイルを定義・使用しても問題ありません。）

２．自動生成されるJSPの概要

個別の JSP は、gen-controller で、Controller クラスらと一緒に Ant で自動生成されます。
自動生成される JSP のポイントは、以下の５点です。

文字コードは UTF-8。
war/css/global.css を参照するようになっている。
header・menu・footer は include していない。
JSTL の各タグを使用できる。
slim3 専用の function タグを使用できる。
- 機能は、SAStruts のものとほぼ同等。

なお、gen-controller での JSP ファイル名およびパスのルールについては、こちらの「２．URL の指定方法」をご覧下さい。

【参考】自動生成されたJSP

★で注記した箇所以外は、全て同じ内容で生成されます。

<%@page pageEncoding="UTF-8" isELIgnored="false"%>
<%@taglib prefix="c"
    uri="http://java.sun.com/jsp/jstl/core"%>
<%@taglib prefix="fmt"
    uri="http://java.sun.com/jsp/jstl/fmt"%>
<%@taglib prefix="fn"
    uri="http://java.sun.com/jsp/jstl/functions"%>
<%@taglib prefix="f"
    uri="http://www.slim3.org/functions"%>




order Order←★URL をタイトルにしている



Hello order Order !!!
↑★Hello [URL で指定したもの]になっている

３．JSPからControllerを呼び出す手順

（１）リンクで呼び出す場合

<a> タグで、gen-controller で指定したものと同じパスを指定すればＯＫです。

    <a href="${f:h('/order/')}">注文</a>

ちなみに f:h() は、引数の文字列を HTML エスケープ（サニタイズ）してくれます。
※クロスサイトスクリプティングを防止してくれる、という意味です。

（２）formで呼び出す場合

<form> タグで、action 属性に gen-controller で指定したものと同じパスを指定すればＯＫです。

（ａ）入力値の設定方法
（例）テキストフィールドの場合。

    <input type="text" ${f:text("name")} />

f:text() で、テキストフィールドと HttpServletRequest 設定時のパラメータ名とを関連付けます。

（ｂ）ボタンの設定方法

    <input type="submit" value="登録"
        name="registerButton" />

複数のボタンを用意し、どれが押下されたかを判定したい場合は、ボタンに name を設定し、Controller 内で HttpServletRequest#getAttribute() を呼び出し、その name の値が取得できるか否かで判定できます。

４．注意事項

JSP の開発・使用に際しては、以下の点に注意が必要です。

（１）JSPのURL直接指定は不可

ブラウザで、JSP の URL を直接指定することはできません。
HTTP ERROR:403（アクセス禁止）になります。

メッセージから推察するに、slim3 というよりは GAE/J の仕様のようです。
ちなみに HTML は、WEB-INF 下でなければ直接参照が可能です。

よく JavaEE での開発では、直接参照されるのを避けるために、JSP を WEB-INF 下に配置したりします。
ですが、GAE/J・slim3 ではそもそも JSP を直接参照できないので、特に WEB-INF 下に配置・移動する必要性はないようです。

（２）web.xmlでjsp-configを使用できない

taglib や JavaScript の参照など、JSP 共通の定義を行えるようにするため、JavaEE では web.xml に jsp-config を設定できるようになっています。
ですが GAE/J では jsp-config の設定が認識されません。
ですので、taglib や JavaScript の参照などは、JSP に１つ１つ設定していく必要があります。

詳しくは、以下のリンクをご覧下さい。

５．JSPのhot deploy

slim3 では、JSP も hot deploy してくれます。
（１）Eclipse の同期化をさせなくても、Windows の explorer レベルでの変更を反映してくれます。
（２）JSP の文字コードの変更も反映してくれます。

ちなみに、web.xml などの Servlet の起点となるものについては、hot deploy できない模様です。

６．【参考】JSPの実装例

header・menu・footer を使用する JSP の実装例を、以下に示します。

<%@ page pageEncoding="UTF-8" isELIgnored="false" %>
<%@ taglib uri="http://www.slim3.org/functions" prefix="f" %>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>注文登録</title>
    <link rel="stylesheet" type="text/css" href="/css/global.css" />
</head>
<body>
    <%-- ◆header --%>
    <jsp:include page="header.jsp">
        <jsp:param name="title" value="注文登録" />
    </jsp:include>
    <%-- ◆menu --%>
    <jsp:include page="menu.jsp" />
    <%-- ◆メインのコンテンツ --%>
    <div id="body">
        <form action="/order/orderConfirm" method="POST">
            <table border="1" align="center">
                <tr>
                    <th>商品名</th>
                    <td><input type="text" ${f:text("name")} /></td>
                </tr>
                <tr>
                    <th>数量</th>
                    <td><input type="text" ${f:text("amount")} /></td>
                </tr>
            </table>
            <br />
            <table border="0" align="center">
                <tr>
                    <td><input type="submit" value="登録"   /></td>
                    <td>   </td>
                    <td><input type="reset"  value="クリア" /></td>
                </tr>
            </table>
        </form>
    </div>
    <%-- ◆footer --%>
    <jsp:include page="footer.jsp" />
</body>
</html>

2010-04-10

【slim3】画面遷移のための”Controller”−（３）UTの実施方法

GAE/J

前回、slim3 の画面遷移制御用コンポーネントである
”Controller”の実装方法をまとめました。
今回は、この Controller の UT の実施方法を見てみます。

１．テストクラスの概要

Controller のテストクラスは、Controller クラスと一緒に Ant で自動生成されます。
テストクラスのポイントは、以下の２点です。
（１）org.slim3.tester.ControllerTestCase を継承すること。
（２）jUnit 4.x 系でテストを実装すること。
　　　詳細は、jUnit4.x系の使い方をご覧下さい。

２．テストケースの基本的な実装手順

Controller のテストケース（テストメソッド）の基本的な実装手順は、以下の通りです。

（１）ControllerTester#start() で、Controller のパスを指定する。

ControllerTestCase には、ControllerTester 型のインスタンス変数 tester があります。
（テスト用のヘルパークラスと思えば良いでしょう。）
これの start() メソッドを呼び出し、テスト対象の Controller の run() メソッドを呼び出します。
ちなみに、start() メソッドの引数として指定するパスは、gen-controller で指定したパスと同じです。

（２）ControllerTester#getController() で、テスト対象の Controller のインスタンスを取得する。

ここで取得したテスト対象の Controller のインスタンスに対して、以下で assert を行っていきます。

（３）Null ではないことを検証する。

assertThat(is(notNullValue())) で、テスト対象の Controller のインスタンスが null ではないことを検証します。
※assertNull() と同義です。

（４）forward か redirect かを検証する。

ControllerTester#isRedirect() で、テスト対象の Controller の戻り値が forward（メソッドのもの）か redirect（メソッドのもの）かを検証します。

（５）遷移先のパスを検証する。

ControllerTester#getDestinationPath() で、遷移先のパスを検証します。

ちなみに上記は、Ant で自動的に生成されます。

３．パラメータの設定方法

検証のためにあらかじめ HttpServletRequest などにパラメータを設定しておきたい場合は、org.slim3.util.RequestLocator クラスなどを、ControllerTester#start() を実行する前に呼び出しておきます。

    HttpServletRequest request = RequestLocator.get();
    request.setAttribute("name", "iPhone");
    this.tester.start("/order/order");

RequestLocator などの使い方については、前回の「３．HttpServletRequest等へのアクセス方法」をご覧下さい。

４．validationの検証方法

想定通りに validation が機能したかを検証するためには、org.slim3.controller.validator.Errors クラスを利用します。
検証手順は、以下の通りです。

（１）リクエストから、Errors のインスタンスを取得する。

Errors のインスタンスは、リクエストにキー "errors" で登録されています。
※同インスタンスは、validation の有無および結果に関係なく登録されています。

    Errors errors =
            (Errors) request.getAttribute("errors");

（２）Errors#size() で、validation エラーの有無を検証する。

validation エラーがない場合は、size() がゼロになります。

（３）Errors#get() で、エラーメッセージを検証する。

Errors の get() メソッドにテスト対象のフィールド名を指定すると、validation エラーがあった場合に、該当するメッセージを取得・検証できます。

    assertEquals(
            "nameは必須です。",
            errors.get("name"));

ちなみに上記は、ControllerTester#start() を実行した後に呼び出せます。

５．テスト用のテーブルデータの設定方法

検証のためにあらかじめテーブル（BigTable）にデータを設定しておきたい場合は、該当する Service ないし Datastore でのデータ格納操作を、ControllerTester#start() を実行する前に呼び出しておきます。

ControllerTestCase は、Service のテストケースと同様、テスト終了後に処理をロールバックしてくれます。
そのため、単体テストの連続実行が可能となります。

６．【参考】テストの実装例

package xxx.yyy.controller.order;

import static org.hamcrest.CoreMatchers.*;
import static org.junit.Assert.*;

import javax.servlet.http.HttpServletRequest;

import org.junit.Test;
import org.slim3.controller.validator.Errors;
import org.slim3.tester.ControllerTestCase;
import org.slim3.util.RequestLocator;

public class OrderControllerTest
        extends ControllerTestCase {

    // ◆例：name が null で validation エラーになるケース
    @Test
    public void run_NameIsEmptyError() throws Exception {

        // ◆準備：リクエストの設定
        HttpServletRequest request = RequestLocator.get();
        request.setAttribute(
                "name",
                "");

        // ◆run() メソッドの呼び出し
        this.tester.start("/order/order");
        OrderController controller =
                this.tester.getController();

        // ◆Ant で自動生成される検証ロジック
        assertThat(
                controller,
                is(notNullValue()));
        assertThat(
                this.tester.isRedirect(),
                is(false));
        assertThat(
                this.tester.getDestinationPath(),
                is("/WEB-INF/view/order/order.jsp"));

        // ◆validation エラーの検証
        Errors errors =
                (Errors) request.getAttribute("errors");
        assertEquals(
                1,
                errors.size());
        assertEquals(
                "nameは必須です。",
                errors.get("name"));
    }
}

次の予定

次は、JSP の作成方法・ルールについて見ていこうと思います。