スライド 1

Size: px

Start display at page:

Download "スライド 1"

まいえしもかさ
6 years ago
Views:

1 WindowsForm サンプル解説 S2Container.NET, S2Dao.NET コミッタ藤井宏明 1

2 S2Container.NET の Examples フォルダに付属する WindowsSample の解説です概要アプリケーションアーキテクチャーソリューション構成プロジェクト概要サンプル説明 2

3 Ⅰ. アプリケーションアーキテクチャー 3

4 アプリケーションアーキテクチャーこのサンプルにおけるアプリケーション構造は次のような特徴をしていますレイヤーアプローチ各画面の目的に応じた柔軟なアプローチ方法をベースにしたクラス設計当然 DI コンテナ (=S2Container.NET) を使っています 4

5 レイヤーアプローチレイヤーは次のものを用意していますこの層間を Data Transfer Object(DTO) を使ってアクセスし直接アクセスを禁止します Presentation 層 Service 層 Domain 層 Presentation 層 Service 層 Domain 層 RDBMS DTO DTO 5

6 Presentation 層主として WindowsForm で構成される層です Form クラスと画面遷移インターフェイス Form クラスも dicon ファイルに含めて DI コンテナ管理にします Program クラス ( 起動用 ) S2Container を初期化していますこれ自身は DI コンテナ管理外です Seasar.Windows.S2ApplicationContext を使用してアプリケーションコンテクストによる起動にしています Seasar.Windows.S2ApplicationContext は dicon ファイルで起動フォームを指定します <component name= AppContext" class="seasar.windows.s2applicationcontext"> <arg>container</arg> <property name= MainForm > FrmMenu"</property> </component> 画面処理用ユーティリティクラス 6

7 DAO やロジックをコントロールする層です Service 層次のインターフェイス実装クラスは dicon ファイルに含めて DI コンテナで管理します IBaseService インターフェイス Service 層のインターフェイスの基底インターフェイス BaseServiceImpl クラス IBaseService の実装クラス Service 層インターフェイス IBaseService を継承する Service 層インターフェイスの実装クラス BaseServiceImpl を継承する 7

8 Service 層のメソッド設計画面で提供するサービスが何か? を考えます本当は概念モデルよりサービスを考えていくのかもしれませんが簡単に設計するためにそうは考えません画面一つに対応するサービスのインターフェイスを一つ用意します画面で発生するイベントに対応したメソッドをサービスに用意します画面のコントロール初期化用の各画面共通メソッドは IBaseService に用意します作成したサービスのインターフェイスは IBaseService を継承します画面のイベント = サービスの提供するメソッド 8

9 Domain 層サービスが必要とする Domain へアクセスする層です S2Dao.NET のインターフェイスや SQL ファイル S2Dao.NET で使用するインターフェイスや sql ファイル Domain 層のインターフェイス必要とあれば作成します Domain 層インターフェイスの実装クラス必要とあれば作成します 9

10 Domain 層のメソッド設計サービスが必要としているリソースが何か? を考えますリソースアクセスを提供する Data Access Object(DAO) を作りますリソース ( 例えば DB のテーブルや帳票 ) に 1:1 に DAO を用意しますアクセスする種類がメソッドになりますリソースアクセスの種類 = DAO の提供するメソッド 1 0

11 Logic 層 Service 層と Domain 層の間にある DAO の組み合わせを再利用する層です Logic 層のインターフェイス DAOインターフェイスの組み合わせパターンを規定するインターフェイス Logic 層インターフェイスの実装クラス DAO のインターフェイスの組み合わせを定義する実装クラス 1 1

12 実装はステートレスにする Presntation 層以外の各レイヤー ( 層 ) の実装クラスはステートレスつまり状態を持たないようにします public class HogeServiceImpl : IHogeService { private Hoge _state; private int _arg1; // プロパティ dao は省略 } 入力条件をプロパティから引数で渡すようにして結果を戻り値で取得するようにします public void GetData() { _state = _dao.getdata( _arg1 ); } public class HogeServiceImpl : IHogeService { // ただし dao は状態ではなく DI する } public Hoge GetData(int arg1) { return ( _dao.getdata( arg1 ) ); } 状態を持たないようにして生成や呼び出しの順序などの依存性を低くします 1 2

13 DTO (Data Transfer Object) 層間のデータのやり取りをするためのクラス PONO(Plain Old.NET Object) クラス普通のプライベートフィールドとそのプロパティで構成されるクラス S2Dao.NET 用のクラス 1 3

14 Ⅱ.Visual Studio ソリューション構成 1 4

15 ソリューションの構成一つのソリューションは次のプロジェクトを保持します Forms プロジェクト Exe WindowsFormを含んでおり起動用構成になっている Presentation 層に相当しますビルドイベントで Testsプロジェクトの.diconファイルをコピーします Logics プロジェクト DLL Service 層 Domain 層 DTO を含んでいます Tests プロジェクト DLL ユニットテスト用クラスと.dicon ファイルなど設定ファイルを含んでいます 1 5

16 名前空間プログラムクラスインターフェイスリソースを所在を区別するために設定します名前空間を次のように設定します ( 会社名 ).( 製品名 ).( サービス名 ) 基本的には MS の指針に従います ( サービス名 ) には Forms, Logics, Tests, Utils などが入ります 1 6

17 Forms プロジェクト画面と画面処理用クラスを含んだメインプロジェクト WindowsForm クラス Programs クラスアプリケーション起動用のクラスプロジェクトの起動用に設定されています IFormDispatcher インターフェイス画面遷移用メソッドで画面遷移をコントロールします /// <summary> /// 一覧フォームを表示する /// </summary> /// <returns> ダイアログ結果 </returns> [TargetForm(typeof (FrmEmployeeList), ModalType.Modal)] DialogResult ShowFlowA(); App.Config 設定ファイルロードする DLL を設定します Tests の.dicon ファイルをビルドイベントでコピーします 1 7

18 Logics プロジェクト Service 層や Domain 層などを構成するプロジェクトインターフェイスだけで構成します実装クラスはその下の Impl フォルダに配置します Serviceフォルダ Service 層インターフェイスを格納 Daoフォルダ Domain 層インターフェイスを格納 S2Dao.NET 用 SQL 文ファイルも一緒に格納 Logicsフォルダ Logics 層インターフェイスを格納 Dtoフォルダ DTO 用のPONOクラスを格納 1 8

19 Tests プロジェクトユニットテスト用クラスと.dicon ファイルを格納するプロジェクトユニットテストにはS2Unit.NETを使用します S2Container.NET 用設定ファイルに三種類使用する Ex.dicon DB 接続用のファイル Example.dicon DIするFormを含んだファイル ExampleLogic.dicon Logics.Implのクラスを含んだファイル (S2Unit.NETではこちらを使用) App.Config ロードするDLLを記述 VS2003では自動的にコピーしてくれないのでビルド後イベントでコピーします ( フォルダ無い場合のためにイベントで作成します ) 1 9

20 アプリケーションの起動 Programs クラス (.NET1.1 では StartMain) を使って実行しますこのクラスは名前空間と dicon ファイル名を変更してそのまま使いますサンプルの Examples.dicon の中で次のように設定しています <components> <component name="appcontext" class="seasar.windows.s2applicationcontext" > <arg>container</arg>  <property name="mainform">frmmainmenu</property> </component> <component name="frmmainmenu" class= Seasar.WindowsExample.Forms.FrmMainMenu" /> </components> 2 0

21 画面遷移画面遷移は IFormDispatcher インターフェイスを使ってコントロールしフォームに DI する public interface IFormDispatcher { /// <summary> /// フロー A のフォームを表示する /// </summary> /// <returns> ダイアログ結果 </returns> [TargetForm(typeof (FrmEmployeeList), ModalType.Modal)] DialogResult ShowFlowA(); } <component name="forminterceptorr" class="seasar.windows.aop.interceptors.forminterceptor" /> <component name="dispatcher" class= Seasar.WindowsExample.Forms.IFormDispatcher">  <aspect pointcut="show.*"> <component class="seasar.windows.aop.interceptors.forminterceptor" /> </aspect> </component> 2 1

22 WindowsForm を作るうえでの注意点 WindowsForm の作り方コンストラクタで画面の初期化をしない FormのLoadイベントメソッドで行います基本的にDIコンテナがFormを管理し Singltonなオブジェクトのため画面に値を渡すときや戻り値はプロパティを作り同名の引数をIFormDispatcher( 画面遷移インターフェイス ) の呼び出しメソッドに持たせます Service 層のインターフェイスのフィールドとそのプロパティを Formに作成すれば DIコンテナがオブジェクトを自動的にセットしてくれる 2 2

23 Ⅲ. サンプルの説明 2 3

24 サンプルで使用するテーブル 1 T_EMP( 従業員テーブル ) カラム名論理名型 N_ID 社員 ID オートナンバー S_CODE 社員コードテキスト型 S_NAME 社員名テキスト型 N_GENDER 性別 ID 数値型 D_ENTRY 入社日日付 / 時刻型 N_DEPT_ID 部門 ID 数値型 2 4

25 サンプルで使用するテーブル 2 T_DEPT( 部門テーブル ) カラム名論理名型 N_ID 部門 ID オートナンバー S_CODE 部門コードテキスト型 S_NAME 部門名テキスト型 N_SHOW_ORDER 表示順番数値型 2 5

26 サンプルで使用するテーブル 3 T_GENDER( 性別テーブル ) カラム名論理名型 N_ID 性別 ID オートナンバー S_NAME 性別名テキスト型 2 6

27 S2WindowsExample プロジェクトメニュー社員部門管理を含んだメインプロジェクト画面 (Frm~) クラスすべて Example.dicon で S2Container に登録されています Example.dicon で FrmMainMenu を起動クラスに設定しています Programs クラスアプリケーション起動用のクラスで定数で dicon ファイルを指定していますプロジェクトの起動用に設定されています二重起動を防止しています IFormDispatcher インターフェイス画面遷移コントロール用その他 App.Config 設定ファイルロードする DLL を設定します Tests の.dicon ファイルと MDB ファイルをビルドイベントでコピーしてます 2 7

28 画面の遷移画面の遷移は次のようになります cd ユーザーインターフェイス ShowMasterList ShowMasterEdit 画面遷移コントロール用インターフェイス FrmDepartmentList FrmDepartmentEdit FrmMainMenu <<interface>> IFormDispatcher + ShowDataList() : DialogResult + ShowDataEdit(Nullable<int>) : DialogResult + ShowMasterList() : DialogResult + ShowMasterEdit(Nullable<int>) : DialogResult ShowDataList ShowDataEdit FrmEmployeeList FrmEmployeeEdit 2 8

29 .dicon ファイル Ex.dicon (DB 接続設定 ) Provider やデータソース設定など Examples.dicon ( フォーム用 ) 起動フォームの設定画面遷移のインターフェイスの設定次のようにフォームを登録します ExampleLogic.dicon を include しています <component name= FrmMain" class= Seasar.WindowsExample.Forms.FrmMainMenu" /> <component class= Seasar.WindowsExample.Forms.FrmDepartmentEdit /> <component class= Seasar.WindowsExample.Forms.FrmEmployeeList /> ExampleLogic.dicon (service 層 Domain 層用 ) <component name= departmentdao" class= Seasar.WindowsExample.Logics.Dao.IDepartmentDao"> <aspect >Ex.DaoInterceptor</aspect> </component> <component class="seasar.windows.logics.service.impl.departmenteditserviceimpl" > <aspect pointcut= ExecUpdate >Ex.LocalRequiredTx</aspect> </component> 2 9

30 S2WindowsExamples.Logics プロジェクト Service 層や Domain 層などを構成するプロジェクト Service フォルダ基底サービス部門一覧性別一覧を取得する部門一覧部門修正社員一覧社員修正サービス一覧を取得する更新する削除する CSV で出力する Impl フォルダに実装クラスを配置 Dao フォルダ S2Dao.NET 用インターフェイスと SQL 文ファイル CSV 出力用インターフェイス Impl フォルダに出力用 DAO 実装クラスを配置 Dto フォルダ S2Dao.NET 用クラスに社員部門性別クラス CSV 出力用クラス 3 0

31 インターフェイスとその実装クラスです Service 層クラス図 cd Service.Impl <<interface>> Service::IBaseService BaseServiceImpl 基底のインターフェイス基底の実装クラス <<interface>> Service::IDepartmentListService <<interface>> Service::IDepartmentEditService <<interface>> Service::IEmployeeEditService <<interface>> Service::IEmployeeListService DepartmentListServiceImpl DepartmentEditServiceImpl EmployeeEditServiceImpl EmployeeListServiceImpl 3 1

32 Domain 層クラス図 S2DAO.NET 用インターフェイスと CSV 出力用クラス cd Dao.Impl S2Dao.NET 用インターフェイス <<interface>> Dao::IGenderDao <<interface>> Dao::IEmployeeCSVDao <<interface>> Dao::IOutputCSVDao <<interface>> Dao::IEmployeeDao OutputCSVDaoImpl <<interface>> Dao::IDepartmentDao 3 2

33 例 : 社員データを登録するシーケンス図 sd 社員を登録する相互作用ユーザ FrmEmployeeEdit <<interface>> IEmployeeEditService <<interface>> IEmployeeDao <<table>> T_EMP 社員データを入力する登録ボタンを押す入力データをセットする ExecUpdate( 入力社員データ ) alt 社員入力データ. 社員 ID [ == null] InsertData( 社員入力データ ) : 挿入件数 INSERT INTO ~ [!= null] GetData( 社員 ID) : 社員データ SELECT ~ alt 社員データ [!= null] UpdateData( 社員入力データ ) : 更新件数 UPDATE ~ [== null] InsertData( 社員入力データ ) : 挿入件数 INSERT ~ 登録件数完了メッセージ簡単に表示するために正確な UML ではありません 3 3

34 S2WindowsExample.Tests プロジェクトユニットテスト用クラスと dicon ファイルを格納するプロジェクトテストクラスは S2Unit.NET を使うように作成.dicon ファイルは三種類作成しビルド後イベントでコピー Ex.dicon DB 接続用のファイル Example.dicon DI するフォームを含んだファイル ExampleLogic.dicon Logics.Impl のクラスを含んだファイル (S2Unit.NET ではこちらを使用 ) データベース Access MDB を使用しビルド後イベントでコピーしています App.Config VS2003 では自動的にコピーしてくれないのでビルド後イベントで設定 3 4

35 名前空間 Seasar.WindowsExample Forms プロジェクト Seasar.WindowsExample.Forms Logics プロジェクト Seasar.WindowsExample.Logics Tests プロジェクト Seasar.WindowsExample.Test サンプルを再利用するときには既定の名前空間とフォルダ名アセンブリ名を変更してください 3 5

36 おわり S2Container.NET のページ S2Dao.NET のページ S2Windows.NET のページ html 3 6

Seasar.NET入門

Seasar.NET入門 2007 Spring Seasar.NET 入門 2007.5.27 Seasar.NET 杉本和也 2007 Spring Copyright 2004-2007 The Seasar Foundation and the others. All rights reserved. 1 杉本和也と申します高知県の株式会社アイビスに勤務していますプログラミング歴 6 年オープンソース歴 2 年