デザインパターン勉強会　第十五回：Facadeパターン

# はじめに  
本エントリーは某社内で実施するデザインパターン勉強会向けの資料となります。 
本エントリーで書籍「[Java言語で学ぶデザインパターン入門](http://www.hyuki.com/dp/)」をベースに学習を進めますが、サンプルコードはC#に置き換えて解説します。  
  
第1回：[Iteratorパターン](http://qiita.com/Nuits/items/800f080d44b52e1cae18)  
第2回：[Adapterパターン](http://qiita.com/Nanakusajp/items/747d1913b1e8bea8d340)  
第3回：[Template Methodパターン](http://qiita.com/_kyam/items/9b5722e6a9635af6e18b)  
第4回：[Factory Methodパターン](https://qiita.com/ayayo/items/3eece04bbc4b7504179a)  
第5回：[Singletonパターン](https://qiita.com/Keenag/items/cae53d55cb953562fee4)  
第6回：[Prototypeパターン](https://qiita.com/aconit96/items/9235d30a07f508886c7e)  
第7回：[Builderパターン](https://qiita.com/Uesk/items/8f12be304671e9905795)  
第8回：[Abstract Factoryパターン](https://qiita.com/buru/items/bb3930dda1bdd2b5f70b)  
第9回：[Bridgeパターン](https://qiita.com/mitakaosamu/items/cff9a39953ae03092f43)  
第10回：[Strategyパターン](https://qiita.com/a1146234/items/fdecc374b7225d99ab07)  
第11回：[Compositeパターン](https://qiita.com/Nanakusajp/items/32ed648eaadaa9910159)  
第12回：[Decoratorパターン](https://qiita.com/_kyam/items/3072a70c1f31f690e00c)  
第13回：[Visitorパターン](https://qiita.com/ayayo/items/cf63041d047ea5b676c3)  
第14回：[Chain of Responsivilityパターン](https://qiita.com/Keenag/items/6ef9cd9671aca38833d8)

  
---
  
# Facadeパターンとは  
複雑な内部処理をまとめ、システムの外側にシンプルなAPI（Application Programming Interface：ソフトウェアの機能や管理するデータなどを、外部の他のプログラムから呼び出して利用するための手順やデータ形式を定めた規約）を提供するデザインパターンを指す。
  
![Fig1.png](https://qiita-image-store.s3.amazonaws.com/0/180635/468f7298-9f46-58c8-d3fa-4929c0d5d625.png)


|役割名|役割|
|:--|:--|
|Facade|システムを構成するその他のクラスの機能をまとめたAPIをシステム外部に提供する|
|その他のクラス|各クラスで定義された機能を実装する|
|Client|Facadeを利用する|
※Facadeクラス自体をその他のクラスとみなし、再帰的にFacadeパターンを適用することも可能である。

---

# サンプルプログラムのクラス図  
![Fig2.png](https://qiita-image-store.s3.amazonaws.com/0/180635/90481e83-0a29-b670-d86f-a980bf22f91f.png)

  
---

# 各クラスの役割  
以下に各クラスの役割を示す。  

|クラス名|役割|概要|
|:---|:---|:---|
|Database|その他のクラス|ユーザー名を利用し、リソースファイルに登録されているメールアドレスの検索を行う|
|HtmlWriter|その他のクラス|指定された情報を利用し、HTMLタグを生成する|
|PageMaker|Facade|DatabaseとHtmlWriterを利用したHTMLページ作成処理を実行する|
|Program|Client|動作確認用の実行クラス|
  

---

# Databaseクラス  
ユーザー名を利用し、リソースファイルに登録されているメールアドレスの検索を行う。  

```csharp
using System;
using System.Collections.Generic;
namespace FacadePatternConsole.PageMaker
{
    /// <summary>
    /// ユーザー名を利用し、リソースファイルに登録されているメールアドレスの検索を行う
    /// </summary>
    class Database
    {
        private Database() { }

        /// <summary>
        /// ユーザ名からメールアドレスを検索する
        /// </summary>
        /// <param name="userName"></param>
        /// <returns></returns>
        public static string GetUserMailAddr(string userName)
        {
            return MailData.ResourceManager.GetString(userName);
        }
    }
}

```
---

# HtmlWriterクラス  
指定された情報を利用し、HTMLタグを生成する。   
各メソッドの機能は以下の通り。  

|メソッド名|役割|
|:---|:---|
|WriteTitle|HTMLページのタイトル部分を構成するタグ（html, head, title, body, h1）を生成する|
|WriteParagraph|HTMLページの段落を構成するタグ（p）を生成する|
|WriteLink|HTMLページのリンクを構成するタグ（a href）を生成する|
|WriteMailTo|メールアドレス部分の文字列を生成する|
|Close|body, headの末尾を生成する|


```csharp
using System;
using System.IO;

namespace FacadePatternConsole.PageMaker
{
    /// <summary>
    /// 指定された情報を利用し、HTMLタグを生成する
    /// </summary>
    class HtmlWriter:IDisposable
    {
        public StreamWriter _writer { get; set; }

        public HtmlWriter(StreamWriter writer)
        {
            this._writer = writer;
        }

        /// <summary>
        /// HTMLページのタイトル部分を構成するタグ（html, head, title, body, h1）を生成する
        /// </summary>
        /// <param name="title">HTMLページのタイトル</param>
        public void WriteTitle(string title)
        {
            _writer.Write("<html>");
            _writer.Write("<head>");
            _writer.Write("<title>" + title + "</title>");
            _writer.Write("</head>");
            _writer.Write("<body>\n");
            _writer.Write("<h1>" + title + "<h1>");
        }
        /// <summary>
        /// HTMLページの段落を構成するタグ（p）を生成する
        /// </summary>
        /// <param name="msg"></param>
        public void WriteParagraph (string msg)
        {
            _writer.Write("<p>" + msg + "</p>\n");
        }
        /// <summary>
        /// HTMLページのリンクを構成するタグ（a href）を生成する
        /// </summary>
        /// <param name="href"></param>
        /// <param name="caption"></param>
        public void WriteLink(string href, string caption)
        {
            _writer.Write("<a href=\"" + href+ "\">" + caption + "</p>\n");
        }
        /// <summary>
        /// メールアドレス部分の文字列を生成する
        /// </summary>
        /// <param name="mailAddr"></param>
        /// <param name="userName"></param>
        public void WriteMailTo(string mailAddr, string userName)
        {
            WriteLink(("mailto:" + mailAddr), userName);
        }
        /// <summary>
        /// body, headの末尾を生成する
        /// </summary>
        public void Close()
        {
            _writer.Write("</body>");
            _writer.Write("</html>\n");
        }

        public void Dispose()
        {
            _writer.Dispose();
        }
    }
}
```
---

# PageMakerクラス  
DatabaseクラスとHtmlWriterクラスを利用し、指定したユーザのWebページのHTMLを生成する。  
HTMLページの生成に必要な操作（リソースからの情報取得、HTMLタグの生成・構成）は全てPageMaker.MakeWelcomePageメソッド内で完結している。
このため、Clientは適切な引数を指定してPageMaker.MakeWelcomePageメソッドを呼び出すのみでよい。  

```csharp
using System;
using System.IO;
using System.Text;

namespace FacadePatternConsole.PageMaker
{
    /// <summary>
    /// DatabaseとHtmlWriterを利用したHTMLページ作成処理を実行する
    /// </summary>
    class PageMaker
    {
        private PageMaker() { }

        /// <summary>
        /// 指定したユーザとファイル名でHTMLページを作成する
        /// </summary>
        /// <param name="userName"></param>
        /// <param name="fileName"></param>
        public static void MakeWelcomePage(string userName, string fileName)
        {
            // メールアドレスの検索
            string mailAddr = Database.GetUserMailAddr(userName);
            // htmlの作成
            using (HtmlWriter writer = new HtmlWriter(new StreamWriter(fileName,false,Encoding.Unicode)))
            {
                writer.WriteTitle("Welcome to" + userName + "'s Page!");
                writer.WriteParagraph(userName + "のページへようこそ");
                writer.WriteParagraph("メールまってますね。");
                writer.WriteMailTo(mailAddr, userName);
                writer.Close();
            }
            // HTML出力先の表示
            Console.WriteLine(fileName + @" is created for " + mailAddr + @" (" + userName + @")");
            Console.ReadKey();
        }
    }
}
```
---
# Programクラス  
PageMakerクラスのMakeWelcomePageメソッドを呼び出し、 HTMLファイルの生成を指示する。  
HTMLファイル生成の手順はMakeWelcomePageメソッド内でカプセル化されており、Programクラス側ではMakeWelcomePageメソッドの呼び出しのみを行えばよい。


```csharp
using System;
namespace FacadePatternConsole
{
    class Program
    {
        /// <summary>
        /// 動作確認用の実行クラス
        /// </summary>
        /// <param name="args"></param>
        static void Main(string[] args)
        {
            PageMaker.PageMaker.MakeWelcomePage("Piyo_Taroh", "welcome.html");
        }
    }
}
```  
---

# 実行結果 
![Console.JPG](https://qiita-image-store.s3.amazonaws.com/0/180635/884c3128-70d1-af17-e2db-603cadaafbd6.jpeg)
![PiyoTaroh.JPG](https://qiita-image-store.s3.amazonaws.com/0/180635/f0ce1ff7-5d86-5e04-483d-48337548c87a.jpeg)


---

# Facadeパターン使用によるメリット
Facadeパターンは、複数のクラス・メソッドからなる複雑な処理をまとめて１つのAPIを提供する。この特徴より、以下の利点が得られると考えられる。

- クラス・メソッドの集合（パッケージ）の外部との結合度を下げ、再利用性を高める
- 複数の処理の集合に対し一律の窓口を提供することで、利用者側での実装負担を軽減する  

パッケージ・フレームワークの規模が大きくなればなるほどクラスやメソッドは増加し、利用したい機能についてどの操作を行えばよいかが不明瞭になりがちである。このような場合にFacadeパターンを適用し、提供したい機能と呼び出すメソッドが一対一対応するように設計するとよいだろう。

---

# サンプルコード  
以下に公開しています。  
https://github.com/aconit96/FacadePatternConsole

---