2016-06-08

Teeda(概要〜入力/サブミット〜画面遷移)

Java Teeda

Seasarプロジェクト発のJSFをベースとしたフレームワーク Teeda

概要

機能

JSFの標準機能に加え， DIとAOPの機能を保持
POJO中心の開発スタイルを提供

モジュール構成

Teeda Core:JSFにおけるUIコンポーネント管理にSeasar2を利用する。
Teeda Extension:Teeda CoreをベースにHTMLテンプレートと規約に基づいた拡張機能を提供
Teeda Ajax:Ajaxに特化したライブラリ

　チュートリアル

http://teeda.seasar.org/ja/extension/tutorial/index.html

入力/サブミット・画面遷移

htmlに対応するのがPageクラス
htmlに定義したid属性の項目はPageクラスの属性となる →Doltengを用いれば、自動生成可能、nameにはsetter,getterが不要。
入力/サブミット・画面遷移 submit(実行ボタン)のidはPageクラスでメソッドとして定義される。
例

  <input type="submit" id="doCalcurate" value="計算実行"　/>

画面遷移

1.各コンポーネントによる遷移

＜ボタン遷移＞
input type="subimit"に指定したid値のメソッド内において返却する戻り値の型に合わせて、画面遷移する

Class型：指定したPageクラスに紐付くhtmlに遷移する
String型：JSFのナビゲーション(outcome)を指定する
Void型：遷移せずに同一画面に戻る

例

   public Class doCalculate() {
        return AddResultPage.class;
    }

＜リンク遷移＞

<a id="goAddResult" href="addResult.html?arg1=123&arg2=223">計算結果画面へ遷移する</a>

aタグの場合はhref属性をみて遷移先を決める。

2.遷移コンポーネントのidに指定できるメソッドの種類

do～クラス内メソッドを呼び出し、戻り値の型に応じた遷移を行う
go～リンクのようなクラス内メソッドを介さない遷移を行う。入力値検査は実施
jump～ go～と同様の動作。入力値検査は未実施

参考URL

Teedaチュートリアル4-3 - おおたに6号機blog
Teeda/gettingStarted - SeasarWiki

2016-06-07

DBFluteとは？

Java DBFlute

DBアクセスを行うO/Rマッパー (DBFlute Runtime)
DB周りの便利な各種ツール (DBFlute Client)

DBFlueteの特徴

ORマッパー

DBのメタ情報を元にコードを自動生成してくれ、SQL発行をタイプセーフに行うことができる。
JDBC APIのみに依存
DBのテーブル構造のまま、Javaから操作できるようにしてくれる。
- クラスフィールドとDBカラムのマッピング設定は不要
- テーブルがクラス(entity)になり、カラムがフィールドになる。
- 外部キーから関連の多重度を推測し、適切なフィールドを追加。(1:Nならば1側にListをN側にTを追加)
DBテーブル構造に対応するSQL生成コードが生成される。
- テーブルAとテーブルBに外部キーがあれば、テーブルAとテーブルBをJoinするメソッドなど

DB周りの便利な各種ツール

O/Rマッピング用コード生成ツール(jdbc,generate,sql2entity,doc,manage,regenerate)
DBスキーマを作成する(ReplaceSchema)
- DDLを実行し、Excel/CSV/TSVからデータをINSERTする。
- DDL実行前に、既存のスキーマに存在するテーブルを自動で全DROPしてくれる。

DBFluteの主要クラス

Entity
- レコード値を保持するクラス。(テーブルと1:1で対応)
- SQL発行結果を詰めたり、INSERT/UPDATEのパラメータを詰めるために使用する。
conditionBean(CB)
- クエリの組み立てに使用するクラス。(テーブルと1:1で対応)
Behavior(Bhv)
- 組み立てたCBを引数として受け取り、実際にSQL発行を行うクラス。(テーブルと1:1で対応)
- BehaviorはDIコンテナ管理下となる。ビジネスロジック側ではDIコンテナからインジェクションしてもらう。

DBFluteの利用例(CRUD)

public class ProductRepositoryTest {
  @Inject
  private ProductBhv productBhv;
  
  @Test
  public void selectRow() {
    // 条件設定Bean(CB)を生成
    ProductCB cb = productBhv.newMyConditionBean();
    
    // 「XXXXXとproduct_codeが等しい」の条件をCBへ追加
    cb.query().setProductCode_Equal("XXXXX");
    
    // 検索条件を元にselect発行、結果をproductのentityへ詰める
    Product product = productBhv.selectEntity(cb);
    
    // productのproduct_codeにXXXXXが設定されていることを確認
    assertThat(product.getProductCode(), is("XXXXX"));
  }
  
  @Test
  public void selectRows() {
    // 条件設定Bean(CB)を生成
    ProductCB cb = productBhv.newMyconditionBean();
    
    // iPadと前方一致するproduct_nameを持つ、productを検索
    cb.query().setProductName_LikePrefix("iPad"); // likeContain() 部分一致、likeSuffix() 後方一致
    
    // productを複数取得
    List<Product> products = productBhv.selectList(cb);
    
    // products内のproduct_nameのリストに「"iPad", "iPad mini", "iPad Air"」が含まれていることを確認
    assertThat(products.stream().map(Prodcut::getProductName).collect(toList()), hasItems("iPad", "iPad mini", "iPad Air"));
  }

  @Test
  public void selectJoin() {
    // 条件設定Bean(CB)を生成
    ProductCB cb = val.newMyConditionBean();
    
    // 「XXXXXとproduct_codeが等しい」の条件をCBへ追加
    cb.query().setProductCode_Equal("XXXXX");
    
    // productテーブルと関連しているmanufactureテーブルを結合
    cb.setupSelect_Manufacture();
    
    // 検索条件を元にselect発行、結果をproductのentityへ詰める
    Product product = productBhv.selectEntity(cb);
    
    // productの関連テーブルのmanufactureの名前がFoxconnであることを確認
    assertThat(product.getManufacture().getName(), is("Foxconn"));
  }
  
  @Test
  public void insert() {
    // 登録するproductの内容を作成する
    Product product = new Product();
    product.setProductCode("ZZZZZ");
    product.setProductName("iPad Nano");
    
    // 登録処理
    productBhv.insert(product);
    
    // 登録された内容を確認
    ProductCB cb = new ProductCB();
    cb.query().setProductName_LikePrefix("iPad");
    assertThat(productBhv.selectEntity(cb);
  }
  
  @Test
  public void update() {
    // 更新するproductの内容を作成する
    Product product = new Product();
    product.setProductCode("ZZZZZ");
    product.setProductName("iPad Micro");
    
    // 更新処理
    prdouctBhv.update(product);
    
    // 更新内容を確認する
    assertThat(productBhv.selectByPKValue("ZZZZZ").getProductName(), is("iPad Micro"));
  }
  
  @Test
  public void delete() {
    // 削除する内容を作成
    Product product = new Product();
    product.setProductCode("ZZZZZ");
    prodcut.setProductName("iPad Micro");
    
    // 削除処理
    productBhv.delete(product);
    
    // 削除されたかどうか確認する
    assertThat(productBhv.selectByPKValue("ZZZZZ").getProductName(), is(nullValue());
  }
}

参考URL

DBFluteをできるだけ簡単に説明してみる - taktosの日記

DBFluteって、凄いんだぜ！: Web屋のまじめな話 | 株式会社アスペア

2016-05-29

Seasar2の開発の進め方

Java Seasar2

ページ駆動開発

ページ駆動開発

HTMLで作成されたUIモックベースに開発を進める手法。Seasar2で使う開発手法。
テーブル設計、Dotengを使ってDaoの自動生成、Pageクラスの作成を行い、処理を作っていく。

ページ駆動開発の手順

UIモックを作成し、ユーザーレビュー
入出力項目の洗い出し、テーブル設計
Doltengを用い、EntityとDaoを作成
HTMLの入出力項目のタグのidにテーブル名のカラムを記述
HTMLのボタンのタグのidに処理メソッド名を記述
Doltengを用い、JavaのPageクラスを自動生成
ユーザー要件に合わせて、ロジックを記述

1,2の詳細は省きます。3〜6について詳細を以下に記載します。

3. Doltengを用い、EntityとDaoを作成

EntityとDaoの名称
Entity:テーブル名例) emp
Dao:テーブル名 + Dao 例) empDao

4. HTMLの入出力項目のタグのidにテーブル名のカラムを記述

テーブルカラム名とPageクラスのフィールドを紐付ける

<input text="text" id="empName"/>
<span id="empName">SCOTT</span>

emp_nameというテーブルカラム名の場合、empNameのようにキャメルケースでidに記述する。

5. HTMLのボタンのタグのidに処理メソッド名を記述

idへ処理用メソッド名を設定し、画面遷移を実現する。

<input type="submit" id="go〜"/>

idへ設定する処理名

内容を引き継ぐのみ：go + 画面名
入力チェックなしに遷移：jump + 画面名
何らかの処理を行う：do + 処理名

6. Doltengを用い、JavaのPageクラスを自動生成

DoktebgはHTMLとDBのメタ情報を用いてPageクラスを自動生成する。

Pageクラス
プロパティー：HTMLの入出力項目はid値をプロパティー名とする。
型はデフォルト、String。変更可能で。DBカラム型から自動設定も可能。
メソッド：id値がdoから始まっているものをメソッドとして作成する。
画面初期表示時に一度だけ呼ばれるメソッド initialize()、画面再表示時に呼ばれるメソッド prerender()はHTMLへの記述なしで自動生成される

※ jumpXxxやgoXxxはTeedaが自動的に処理するため、メソッドは作成されない。