t2 - 関ジャバ1月27日

つなぐ、つながる、つないでなんぼ！Web 　フレームワーク「 T2 　」の紹介

Copyright　　2010　　The　Team　T2　Framework　and　the　others　All　Rights　Reserved.

Go　Tanaka<[email protected]>


自己紹介

　　　　田中豪 ( 　たなかごう )

Blog: http://d.hatena.ne.jp/tan_go238/

Twitter: http://twitter.com/tan_go238/


「Ｔ２」って何？

リクエストをかしこく捌く！

つなぐ、つながる！

シンプルでわかりやすい！

他のフレームワークと「つなげて」使うことを前提としたフレームワーク

特徴特徴


シンプルで分かりやすい

アノテーションベース

@Page(“/hello”)public class Hoge {

@GET@ActionPath(“/world”)public Navigation helloWorld(){

…}

}

http://yoursite.com/app/hello/world

きれいな URL!


そもそも、そんなにたくさんの機能はない

シンプルで分かりやすい

DI コンテナ（シンプルな内部コンテナをデフォルトで使用）

DB フレームワークValidation フレームワークトランザクション制御　（ t2-ext にもある）

自分の使いやすいものを使ってね！


つなぐ、つながる！

自分の使いやすいものをつなげて使おう！

DI コンテナ　 Seasar, Spring, Guice, Lucy, 内部 DI コンテナ

OR マッパー　 S2Dao, DBFlute, Doma, Hibernate, iBatis

テンプレートエンジン　 JSP, ZPT, Mayaa...

サンプルもいっぱいあるよ！


リクエストをかしこく捌く！

様々なリクエスト対応したメソッドを呼び出せる！

AMF や Ajax のリクエストが捌ける

URL パスやリクエストパラメータで切り替えができる

GET や POST でメソッドの切り替えができる

レスポンスの種類も色々あるよ！


機能紹介

メソッドアノテーション

引数アノテーション

引数の型

T2 の基本的な使い方は以下の３つをおさえておけばＯＫ！


メソッドアノテーションとは？

リクエストとメソッドのマッピングを行います



…}

}

順番も重要


メソッドアノテーションとは？

@GET, @POST

@ActionPath

@ActionParam

@Ajax

@Amf

@Default

メソッドアノテーション一覧


@GET と @ActionPath を使ったサンプル




…}

}

http://yoursite.com/app/hello/world




@POST@ActionParampublic Navigation add(WebContext context){

…}

}

@POST と @ActionParam を使ったサンプル

<form name="addForm" action="/{cx}/hello” method="post"> <input type="text" name="arg1" /><br /> <input type="submit" name="add" value=" 送信 "/></form>

@ActionParam だけだとメソッド名＝ボタンの name 属性と認識


@ActionParam

@ActionParam はサブミットされたボタンを認識するためのアノテーション

@ActionParam("hoge") のように書いている場合、

hoge という name 属性を持つボタンが押されたときに動きます


@Page(“/hello”)public class Hoge { @POST @ActionParam(“hoge”) public Navigation foo(WebContext context){

… }}


@ActionParam


@Page(“/hello”)public class Hoge { @POST @ActionParam(“add.x”) public Navigation imgTest(WebContext context){

… }}

T2 のサンプルには下記のように @ActionParam に .x がついたものがあるが

これは画像を使った input type=image のときに IE が name 属性

add の名前に対して .x をつけてポストしてくるため

<input type=“image” name=“add” ～


@Ajax を使ったサンプル（１）


@Page("/ajaxJQuery")public class AjaxJQueryPage { @Ajax @POST public Navigation execute(WebContext context) { 　　　　 String hoge = context.getRequest().getAttribute("hoge"); return Json.convert(hoge + " is jQuery."); }}

HTTP ヘッダで Ajax のリクエストを判別


@Ajax を使ったサンプル（２）【 jQuery 】

$(funcion() { $("#submit").click(function() { $.ajax( { "url" : "{cx}/ajaxJQuery/execute", "type" : "post", "data" : { "hoge" : $("#hoge").val() }, "success" : function(response) { var o = eval("(" + response + ")"); $("#foo").text(o); }, "error": function(xmlHttpReq, status, e) { $("#foo").text("error"); } } ); return false; } );});

メソッドアノテーションメソッドアノテーション



@Amf を使ったサンプル（１）

@Page("amftest")public class AmfTestPage {

@Amf public Navigation findAll() { List<Bar> ret = new ArrayList<Bar>(); ・・・ return AmfResponse.to(ret); }}



@Amf 　　を使ったサンプル（２）【 AS 】

<mx:RemoteObject id="remote" destination="amftest" endpoint="t2.amf"/>

～

public function creationCompleteHandler(e:FlexEvent):void { document.button.addEventListener(MouseEvent.CLICK, function(e:MouseEvent):void { var token:AsyncToken = document.remote.findAll(); token.addResponder(new AsyncResponder(resultHandler, faultHandler)); });}public function resultHandler(e:ResultEvent, o:Object=null):void { var bar:ArrayCollection = e.result as ArrayCollection; ・・・}public function faultHandler(e:FaultEvent, o:Object=null):void { Alert.show("error : " + e.message);}

endpoint 属性は特に指定はない



@Amf

T2 の AMF 通信は AMF3 かつリモーティングに限定

Messaging( データプッシュ ) などもしたい場合は BlazeDS を使用

AmfContext の切り替えはクラスパス上に blazeds のクラスがあるかどうか

BlazeDS を使う時は blazeds-common.jarblazeds-core.jar および設定が必要だよ！


どのメソッドの条件にも該当しなかった場合、

@Default がついたメソッドが呼び出されます


@Default

Page("hoge")public class HogePage {

@Default public Navigation index() { return Forward.to("/jsp/index.jsp"); }}


引数アノテーションとは？

リクエストパラメータなどといった特定の値を引数アノテーションによって取得します

引数アノテーションに適切なパラメータ名を書いておけば、 T2 が自動的にセットしてくれます

@Page("requestparam")public class RequestParamPage { @GET @Ajax public Navigation execute( @RequestParam("ff") String foo, @RequestParam("bb") String bar) { return Json.convert( new String[] { foo, bar }); } }}



@RequestParam

@RequestHeader

@SessionAttr

@Upload

@Form

@Index

@Var

引数アノテーション一覧


@RequestParam


リクエスト内にある特定のパラメータを取得することができる

@Page("requestparam")public class RequestParamPage { @GET @Ajax public Navigation execute( @RequestParam("ff") String foo, @RequestParam("bb") String bar) { return Json.convert( new String[] { foo, bar }); } }}



@RequestHeader

リクエスト内のヘッダーを取得することができる

@Page("/requestheader")public class RequestHeaderPage {

@POST @ActionParam public Navigation execute1(@RequestHeader Map<String,String> map, WebContext context) { }

@POST @ActionParam public Navigation execute2(　　　　　　　 @RequestHeader(key = "content-type") String header, WebContext context) { }}



@SessionAttr

セッション内の指定した属性の値を取得することができる

@Page("session")public class SessionPage { @POST @ActionParam public Navigation message( @SessionAttr("msg1") String message1, @SessionAttr("msg2", nullable = false) String message2, WebContext context) { Request request = context.getRequest(); Session session = context.getSession(); request.setAttribute("message1", message1); request.setAttribute("message2", message2); return Forward.to("/jsp/sessionAttr.jsp"); }}

nullable 属性を false にすると例外が発生し、このメソッドは呼び出されません



@Upload

ファイルがアップロードされたときに、明示的にどのファイルかを指定できる

@Page("upload")public class UploadPage { @POST @ActionParam public Navigation upload( @Upload("ff") UploadFile file, HttpServletRequest request) {

System.out.println("file:" + file.getName()); System.out.println("size:" + file.getSize()); System.out.println(file.getContentType()); request.setAttribute(file.getName() + " is uploaded."); return Forward.to("/jsp/upload.jsp"); }}


@Form

@Form は、サブミットされた FORM の値全てを Java のオブジェクトに

マッピングしてもらうためのアノテーションです


@Page("/form")public class FormPage { @POST @ActionParam public Navigation withForm( @Form AddForm dto, WebContext context, ErrorInfo errorInfo) { Request request = context.getRequest(); if (errorInfo.hasError()) { request.setAttribute("message",Constants.ERR_MSG); return Forward.to("jsp/error.jsp"); } request.setAttribute("result","success"); return Forward.to("/jsp/form.jsp"); }}

<input type=“submit” name=“withForm” ～


ForEach のインデックス値を取得することができます


@Page("/foreach")public class ForeachPage { @POST @ActionParam("hoge[{index}]") public Navigation hoge(@Index int id, WebContext context) { final Integer i = Integer.valueOf(id); context.getRequest().setAttribute("msg", String.valueOf(i.intValue() + 1) + " submitted."); return Forward.to("/jsp/foreach.jsp"); }}

　引数の型は int 　または Integer である必要がある

@Index


<form method="post" action="${t:url('/foreach')}"> <c:forEach var="e" items="${hogeList}" varStatus="s"> <input type="submit" name="hoge[${s.index}]" value="${e}"/> <br /> </c:forEach> <span>${message}</span></form>

ＨＴＭＬ側 (JSP) の記述


@Index


URL の一部を引数として受け取る事ができます

引数アノテーション@Var

@Page("hoge")public class VarPage {

@Default @ActionPath("{foo}") public Navigation index(@Var("foo") String foo) { return NoOperation.noOp(); } @GET @ActionPath(“piyo/{foo}") public Navigation var(@Var("foo") String foo) { return NoOperation.noOp(); }}

ex) http://domain/cx/hoge/123

ex) http://domain/cx/hoge/piyo/123


Page 　に対しても @Var を使用することもできます

引数アノテーション@Var

@Page("/var/{aaa}/{bbb}")public class VarPage { @Default @GET public Navigation index( @Var("aaa") String string, @Var("bbb") String bbb, Request request) { System.out.println("VarPage.index() called"); System.out.println("VarPage.aaa:" + string); System.out.println("VarPage.bbb:" + bbb); request.setAttribute("var", string + " from " + bbb); return Forward.to("/jsp/var.jsp"); }}

ex) http://domain/cx/var/123/456


引数の型

欲しいインスタンスをメソッドの引数によって取得します

引数に適切なオブジェクトを書いておけば、 T2 が自動的にセットしてくれます

public　Navigation　add(HttpServletRequest　request,　HttpServletResponseresponse)

使用したいオブジェクトを引数に指定するだけ


引数の型

HttpServletRequest, HttpServletResponse, HttpSession

ServletContext

Cookie/Cookie[]

WebContext

Request, Response

UploadFile

ErrorInfo


HttpServletRequest

引数の型

@Page("/request")public class RequestPage { @POST @ActionParam public Navigation message(HttpServletRequest request) { request.setAttribute("hello", "Hello."); return Forward.to("/jsp/request.jsp"); }}

サーブレットリクエスト


引数の型

ServletContext

@Page("/hoge")public class Hoge { @Default public Navigation index(ServletContext context) { ・・・ }}

サーブレットコンテキスト


WebContext

T2のコンテキストオブジェクト。リクエストやレスポンスを丸ごと持つ

T2内部のコンテキストも含まれる

引数の型

@Page("context")public class ContextPage { @Default public Navigation index(WebContext context) { Request request = context.getRequest(); request.setAttribute("message", "hogehoge"); return Forward.to("/jsp/context.jsp"); }}


引数の型

UploadFile

アップロードされたファイルを取得することができます

@Page("upload")public class UploadPage { @POST @ActionParam public Navigation upload( UploadFile file, HttpServletRequest request) { System.out.println("file:" + file.getName()); System.out.println("size:" + file.getSize()); System.out.println(file.getContentType()); request.setAttribute(file.getName() + " is uploaded."); return Forward.to("/jsp/upload.jsp"); }}


UploadFile

引数の型

アップロードされたファイルを配列で取得することもできます

@Page("upload")public class UploadPage { @POST @ActionParam public Navigation upload(UploadFile[] files) { for (UploadFile file : files) { System.out.println("file:" + file.getName()); System.out.println("size:" + file.getSize()); System.out.println(file.getContentType()); } return Forward.to("/jsp/upload.jsp"); }}


引数の型

ErrorInfo

@Form 使用時型があわないなどの変換エラーが発生した場合、その値は null のままになります

@Form 　で変換エラーが出たときの情報を ErrorInfo が保持します

@Page("/hoge")public class HogePage { @POST @ActionParam public Navigation addWithForm( @Form inputForm dto, WebContext context, ErrorInfo errorInfo) { Request request = context.getRequest(); if (errorInfo.hasError()) { request.setAttribute("msg", Constants.ERR_MSG); return Forward.to("jsp/input.jsp"); } return Forward.to("/jsp/result.jsp"); }}


T2 をはじめよう！

手順

１． T2core.jar と依存 Jar

２． DI コンテナに必要な Jar と依存 Jar

３． ORM に必要な Jar...

４．ディレクトリ構成は ...



何？めんどくさい？？



Vili （ヴィリ）があるよ！！


Vili （ヴィリ）って？

・ Eclipse プラグインによるプロジェクト作成支援

・プロジェクトの雛形（スケルトン）を生成

・スケルトンは Maven のアーティファクトとして管理

・フラグメントを定義することで Vili で作成したプロジェクトに

　後から機能の追加もできる




引用元： http://d.hatena.ne.jp/skirnir/20091021/1256105886



Gaelyk もやりたい？


あるよ！！




T2 + Gaelyk の下準備

・ Eclipse 3.5

・ Groovy

・ GAE/J SDK

・ Eclipse Plugin (GAE/J 、 Groovy)

　　　 Google Plugin for Eclipse　　　 http://code.google.com/intl/ja/eclipse/docs/getting_started.html

　　　 GroovyEclipse Plugin　　　 http://groovy.codehaus.org/Install+GroovyEclipse+Plugin



T2 + Gaelyk のセットアップ

１． T2MeetsGaelykSetup.groovy を DL

２．ダウンロードしたスクリプトを実行する

３． Eclipse にインポート




１． T2MeetsGaelykSetup.groovy を DL

以下の URL から T2MeetsGaelykSetup.groovy をダウンロードする

　 http://code.google.com/p/t2samples/downloads/list



２．ダウンロードしたスクリプトを実行する


groovy　T2MeetsGaelykSetup.groovy　プロジェクト名



３． Eclipse にインポート

Eclipse のファイルメニューから以下の順で選択していく


File　->　Import

Existing　Projects　into　Workspace　Select　root　directory　->　Browse　->　Finish　

Package　Explorerからプロジェクト名を右クリック -> Run　As　->　Web　Application　

実行


まとめ

メリット　　敷居はそんなに低くない　　　　・わかりやすい　　　　・機能が絞られている　　　　・プロジェクト生成プラグインがある

　　 Ajax 、 AMF 通信するときに気軽に使える　　　　・追加で必要な jar や設定がない　　　　・通常のリクエストと区別できる　　デメリット　　単体で使うには機能が少ない　　　・ t2-ext もしくは誰かが作ったものが充実する必要がある

　　実績が比較的少ない　　　・使用ユーザーの介入が不可欠


まとめ

・もっとプラグインが充実して欲しい！

・もっとサンプルが充実して欲しい！

・もっと使ってくれるユーザーが欲しい！

みんながどんどん使っていくと、面白いぐらい進化しそう！

実はプラグインなど拡張するための仕組みも充実


T2 プロジェクト


　　 http://code.google.com/p/t-2/

Committer

　　 shot6 　　　　　　　　　　 http://d.hatena.ne.jp/shot6/

　　 skirnir 　　　　　　　　　 http://d.hatena.ne.jp/skirnir/

　　 c9katayama http://d.hatena.ne.jp/c9katayama/

　　 yone098 http://d.hatena.ne.jp/yone098/



designed by カネウチカズコ


ご清聴ありがとうございました！！

t2 - 関ジャバ1月27日

Documents