Facade を Go で
Facade は、 構造に関するデザインパターンの一つで、 複雑なクラスのシステム、 ライブラリー、 またはフレームワークに対して単純な (しかし限定された) インターフェースを提供します。
Facade は、 アプリケーションの全体としての複雑さを軽減しますが、 それと同時に望ましくない依存性を一箇所に集めるのにも役立ちます。
概念的な例
クレジットカードを使ってピザを注文した時、 その裏で何が起きているか、 我々はその複雑性を過小評価しがちです。 この工程には、 いくつものサブシステムが存在します。 主要なものだけ挙げると:
- 口座の確認
- 口座の暗証番号の確認
- クレジットまたはデビットカードの残高照会
- 注文台帳に項目作成
- 通知の送信
このような複雑なシステムは、 途中で理解できなくなったりしがちです。 またちょっでも間違ったことをすると、 簡単に異常を起こしてしまいます。 Facade パターンの概念は、 そのためにあります: 単純なインターフェースを使ってクライアントがいくつものコンポーネントと作業できるようにする。 クライアントは、 カードの詳細、 暗唱番号、 支払額そして手続きの種類だけを入力します。 ファサードは、 クライアントから内部の複雑さを隠蔽し、 それ以降の種々のコンポーネントとのやりとりを行います。
walletFacade.go: ファサード
package main import "fmt" type WalletFacade struct { account *Account wallet *Wallet securityCode *SecurityCode notification *Notification ledger *Ledger } func newWalletFacade(accountID string, code int) *WalletFacade { fmt.Println("Starting create account") walletFacacde := &WalletFacade{ account: newAccount(accountID), securityCode: newSecurityCode(code), wallet: newWallet(), notification: &Notification{}, ledger: &Ledger{}, } fmt.Println("Account created") return walletFacacde } func (w *WalletFacade) addMoneyToWallet(accountID string, securityCode int, amount int) error { fmt.Println("Starting add money to wallet") err := w.account.checkAccount(accountID) if err != nil { return err } err = w.securityCode.checkCode(securityCode) if err != nil { return err } w.wallet.creditBalance(amount) w.notification.sendWalletCreditNotification() w.ledger.makeEntry(accountID, "credit", amount) return nil } func (w *WalletFacade) deductMoneyFromWallet(accountID string, securityCode int, amount int) error { fmt.Println("Starting debit money from wallet") err := w.account.checkAccount(accountID) if err != nil { return err } err = w.securityCode.checkCode(securityCode) if err != nil { return err } err = w.wallet.debitBalance(amount) if err != nil { return err } w.notification.sendWalletDebitNotification() w.ledger.makeEntry(accountID, "debit", amount) return nil } account.go: 複雑なサブシステム (部分)
package main import "fmt" type Account struct { name string } func newAccount(accountName string) *Account { return &Account{ name: accountName, } } func (a *Account) checkAccount(accountName string) error { if a.name != accountName { return fmt.Errorf("Account Name is incorrect") } fmt.Println("Account Verified") return nil } securityCode.go: 複雑なサブシステム (部分)
package main import "fmt" type SecurityCode struct { code int } func newSecurityCode(code int) *SecurityCode { return &SecurityCode{ code: code, } } func (s *SecurityCode) checkCode(incomingCode int) error { if s.code != incomingCode { return fmt.Errorf("Security Code is incorrect") } fmt.Println("SecurityCode Verified") return nil } wallet.go: 複雑なサブシステム (部分)
package main import "fmt" type Wallet struct { balance int } func newWallet() *Wallet { return &Wallet{ balance: 0, } } func (w *Wallet) creditBalance(amount int) { w.balance += amount fmt.Println("Wallet balance added successfully") return } func (w *Wallet) debitBalance(amount int) error { if w.balance < amount { return fmt.Errorf("Balance is not sufficient") } fmt.Println("Wallet balance is Sufficient") w.balance = w.balance - amount return nil } ledger.go: 複雑なサブシステム (部分)
package main import "fmt" type Ledger struct { } func (s *Ledger) makeEntry(accountID, txnType string, amount int) { fmt.Printf("Make ledger entry for accountId %s with txnType %s for amount %d\n", accountID, txnType, amount) return } notification.go: 複雑なサブシステム (部分)
package main import "fmt" type Notification struct { } func (n *Notification) sendWalletCreditNotification() { fmt.Println("Sending wallet credit notification") } func (n *Notification) sendWalletDebitNotification() { fmt.Println("Sending wallet debit notification") } main.go: クライアント・コード
package main import ( "fmt" "log" ) func main() { fmt.Println() walletFacade := newWalletFacade("abc", 1234) fmt.Println() err := walletFacade.addMoneyToWallet("abc", 1234, 10) if err != nil { log.Fatalf("Error: %s\n", err.Error()) } fmt.Println() err = walletFacade.deductMoneyFromWallet("abc", 1234, 5) if err != nil { log.Fatalf("Error: %s\n", err.Error()) } } output.txt: 実行結果
Starting create account Account created Starting add money to wallet Account Verified SecurityCode Verified Wallet balance added successfully Sending wallet credit notification Make ledger entry for accountId abc with txnType credit for amount 10 Starting debit money from wallet Account Verified SecurityCode Verified Wallet balance is Sufficient Sending wallet debit notification Make ledger entry for accountId abc with txnType debit for amount 5